Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

Jekyll을 사용하여 GitHub Pages 사이트 만들기

Jekyll을 사용하여 새 리포지토리 또는 기존 리포지토리에서 GitHub Pages 사이트를 만들 수 있습니다.

이 기능을 사용할 수 있는 사용자

People with admin permissions for a repository can create a GitHub Pages site with Jekyll.

GitHub Pages는 GitHub Free 및 조직에 대한 GitHub Free가 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server가 있는 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 “GitHub 제품”을 참조하세요.

참고: 조직 소유자는 조직 소유의 리포지토리에서 GitHub Pages 사이트의 게시를 제한할 수 있습니다. 자세한 내용은 “GitHub Pages 사이트의 게시 관리”를 참조하세요.

필수 조건

Jekyll을 사용하여 GitHub Pages 사이트를 만들려면 먼저 Jekyll 및 Git을 설치해야 합니다. 자세한 내용은 Jekyll 설명서의 설치 및 “Git 설정”을 참조하세요.

Bundler를 사용하여 Jekyll을 설치하고 실행하는 것이 좋습니다. Bundler는 Ruby gem 종속성을 관리하고 Jekyll 빌드 오류를 줄이며 환경 관련 버그를 방지합니다. Bundler를 설치하려면 다음을 수행합니다.

  1. Ruby를 설치합니다. 자세한 내용은 Ruby 설명서에서 “Ruby 설치”를 참조하세요.
  2. Bundler를 설치합니다. 자세한 내용은 “Bundler”를 참조하세요.

팁: Bundler를 사용하여 Jekyll을 설치하려고 할 때 Ruby 오류가 표시되는 경우 RVM 또는 Homebrew 같은 패키지 관리자를 사용하여 Ruby 설치를 관리해야 할 수 있습니다. 자세한 내용은 Jekyll 설명서에서 "문제 해결"을 참조하세요.

사이트에 대한 리포지토리 만들기

리포지토리를 만들거나 사이트에 대한 기존 리포지토리를 선택할 수 있습니다.

리포지토리의 모든 파일이 사이트와 관련 있는 건 아닌 리포지토리에 대한 GitHub Pages 사이트를 만들려면 사이트에 대한 게시 원본을 구성할 수 있습니다. 예를 들어 사이트 원본 파일을 저장할 전용 분기 및 폴더가 있거나 사용자 지정 GitHub Actions 워크플로를 사용하여 사이트 원본 파일을 빌드하고 배포할 수 있습니다.

리포지토리를 소유하는 계정이 조직에 대해 GitHub Free 또는 GitHub Free을 사용하는 경우 리포지토리는 공용이어야 합니다.

기존 리포지토리에서 사이트를 만들려면 "사이트 만들기" 섹션으로 건너뜁니다.

  1. 페이지의 오른쪽 위 모서리에서 드롭다운 메뉴를 사용하고 새 리포지토리를 선택합니다. 새 리포지토리를 만드는 옵션이 포함된 드롭다운 1. 소유자 드롭다운 메뉴를 사용하여 리포지토리를 소유할 계정을 선택합니다. 소유자 드롭다운 메뉴
    참고: 관리되는 사용자 계정인 경우 조직이 소유한 리포지토리에서 GitHub Pages 사이트만 게시할 수 있습니다. 자세한 내용은 “GitHub Pages 정보”를 참조하세요.
    1. 리포지토리의 이름과 설명(선택 사항)을 입력합니다. 사용자 또는 조직 사이트를 만드는 경우 리포지토리 이름은 `.github.io` 또는 `.github.io`이어야 합니다. 사용자 또는 조직 이름에 대문자가 포함된 경우 소문자로 입력해야 합니다. 자세한 내용은 “[GitHub Pages 정보](/articles/about-github-pages#types-of-github-pages-sites)”를 참조하세요. ![리포지토리 만들기 필드](/assets/images/help/pages/create-repository-name-pages.png) 1. 리포지토리 표시 여부를 선택합니다. 자세한 내용은 “[리포지토리 정보](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)”를 참조하세요. ![리포지토리 표시 여부를 선택하는 라디오 단추](/assets/images/help/repository/create-repository-public-private.png)

사이트 만들기

사이트를 만들려면 GitHub Enterprise Cloud에 사이트에 대한 리포지토리가 있어야 합니다. 기존 리포지토리에서 사이트를 만들지 않는 경우 “사이트에 대한 리포지토리 만들기”를 참조하세요.

경고: 엔터프라이즈에서 Enterprise Managed Users를 사용하지 않는 한, 사이트의 리포지토리가 프라이빗이거나 내부인 경우에도 기본적으로 GitHub Pages 사이트를 인터넷에서 공개적으로 사용할 수 있습니다. 사이트에 대한 액세스 제어를 관리하여 사이트를 비공개로 게시할 수 있습니다. 그렇지 않고 사이트의 리포지토리에 중요한 데이터가 있는 경우 게시하기 전에 데이터를 제거할 수 있습니다. 자세한 내용은 "리포지토리 정보" 및 "GitHub Pages 사이트의 표시 유형 변경"을 참조하세요.

  1. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

  2. 리포지토리의 로컬 복사본이 아직 없는 경우 사이트의 원본 파일을 저장할 위치로 이동하여 PARENT-FOLDER를 리포지토리의 폴더를 포함하려는 폴더로 변경합니다.

    $ cd PARENT-FOLDER
  3. 아직 로컬 Git 리포지토리를 초기화하지 않은 경우 Git 리포지토리를 초기화하고 REPOSITORY-NAME을 리포지토리 이름으로 변경합니다.

    $ git init REPOSITORY-NAME
    > Initialized empty Git repository in /Users/octocat/my-site/.git/
    # Creates a new folder on your computer, initialized as a Git repository
  4. 디렉터리를 리포지토리로 변경합니다.

    $ cd REPOSITORY-NAME
    # Changes the working directory
  5. 사용할 게시 원본을 결정합니다. 자세한 내용은 "GitHub Pages 사이트에 대한 게시 원본 구성"을(를) 참조하세요. 1. 사이트의 게시 원본으로 이동합니다. 자세한 내용은 "GitHub Pages 사이트에 대한 게시 원본 구성"을(를) 참조하세요. 예를 들어 기본 분기의 docs 폴더에서 사이트를 게시하도록 선택한 경우 디렉터리를 만들고 docs 폴더로 변경합니다.

    $ mkdir docs
    # Creates a new folder called docs
    $ cd docs

    gh-pages 분기에서 사이트를 게시하도록 선택한 경우 gh-pages 분기를 만들고 체크 아웃합니다.

    $ git checkout --orphan gh-pages
    # Creates a new branch, with no history or contents, called gh-pages, and switches to the gh-pages branch
    $ git rm -rf .
    # Removes the contents from your default branch from the working directory
  6. 새 Jekyll 사이트를 만들려면 다음 jekyll new 명령을 사용합니다.

    $ jekyll new --skip-bundle .
    # Creates a Jekyll site in the current directory
  7. Jekyll이 만든 Gemfile을 엽니다.

  8. 이 줄을 주석으로 처리하려면 gem "jekyll"로 시작하는 줄의 시작 부분에 ‘#’을 추가합니다.

  9. # gem "github-pages"로 시작하는 줄을 편집하여 github-pages gem을 추가합니다. 줄을 다음으로 변경합니다.

    gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins

    GITHUB-PAGES-VERSION을 지원되는 최신 버전의 github-pages gem으로 바꿉니다. “종속성 버전”에서 이 버전을 찾을 수 있습니다.

    올바른 버전 Jekyll은 github-pages gem의 종속성으로 설치됩니다.

  10. Gemfile을 저장하고 닫습니다.

  11. 명령줄에서 bundle install을 실행합니다.

  12. 필요한 경우 _config.yml 파일을 편집합니다. 리포지토리가 하위 디렉터리에서 호스트되는 경우 상대 경로에 필요합니다. 자세한 내용은 “하위 폴더를 새 리포지토리로 분할”을 참조하세요.

    domain: my-site.github.io       # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com
    url: https://my-site.github.io  # the base hostname and protocol for your site, e.g. http://example.com
    baseurl: /REPOSITORY-NAME/      # place folder name if the site is served in a subfolder
    
  13. 필요에 따라 사이트를 로컬로 테스트합니다. 자세한 내용은 “Jekyll을 사용하여 로컬로 GitHub Pages 사이트 테스트”를 참조하세요.

  14. 작업을 추가하고 커밋합니다.

    git add .
    git commit -m 'Initial GitHub pages site with Jekyll'
  15. GitHub.com에 리포지토리를 원격으로 추가합니다. USER 를 리포지토리 및 REPOSITORY 를 리포지토리의 이름으로 바꿉니다.

    $ git remote add origin https://github.com/USER/REPOSITORY.git
    
  16. GitHub Enterprise Cloud에 리포지토리를 푸시하여 BRANCH 를 작업 중인 분기의 이름으로 바꿔야 합니다.

    $ git push -u origin BRANCH
  17. 게시 원본을 구성합니다. 자세한 내용은 “GitHub Pages 사이트에 대한 게시 원본 구성”을 참조하세요. 1. GitHub Enterprise Cloud에서 사이트의 리포지토리로 이동합니다. 1. 리포지토리 이름 아래에서 설정을 클릭합니다. 리포지토리 설정 단추

  18. 사이드바의 “코드 및 자동화” 섹션에서 페이지를 클릭합니다.

  19. 필요에 따라 개인 또는 내부 리포지토리에서 프로젝트 사이트를 게시하는 경우 사이트의 표시 여부를 선택합니다. “GitHub Pages”에서 GitHub Pages 표시 여부 드롭다운 메뉴를 선택한 다음 표시 여부를 클릭합니다. 자세한 내용은 “GitHub Pages 사이트의 표시 여부 변경”을 참조하세요. 사이트의 표시 여부를 선택하는 드롭다운

      <div class="extended-markdown note border rounded-1 mb-4 p-3 color-border-accent-emphasis color-bg-accent f5">
    

    참고: GitHub Pages 사이트를 비공개로 게시하려면 조직에서 GitHub Enterprise Cloud를 사용해야 합니다. GitHub Enterprise Cloud를 체험해 보는 방법에 대한 자세한 내용은 “GitHub Enterprise Cloud 평가판 설정”을 참조하세요.

    1. 게시된 사이트를 보려면 "GitHub Pages"에서 ** 방문 사이트를** 클릭합니다. ![게시된 사이트의 URL 옆에 있는 "사이트 방문" 단추 스크린샷](/assets/images/help/pages/click-pages-url-to-preview.png)

    참고: GitHub Enterprise Cloud에 변경 내용을 푸시한 후 사이트 변경 내용이 게시되려면 최대 10분이 걸릴 수 있습니다. 한 시간 후 브라우저에 GitHub Pages 사이트 변경 내용이 반영되지 않으면 “GitHub Pages 사이트에 대한 Jekyll 빌드 오류 정보”를 참조하세요.

  20. GitHub Pages 사이트는 GitHub Actions 워크플로를 사용해 빌드 및 배포됩니다. 자세한 내용은 “워크플로 실행 기록 보기”를 참조하세요.

    참고: GitHub Actions 실행은 퍼블릭 리포지토리에 대해 무료입니다. 사용 요금은 매월 무료 사용 가능 시간(분)을 초과하는 프라이빗 및 내부 리포지토리에 적용됩니다. 자세한 내용은 “사용량 제한, 청구 및 관리”를 참조하세요.

참고: 분기에서 게시하는 경우 및 관리자 권한과 확인된 메일 주소를 가진 사람이 게시 원본으로 푸시되었는지 확인합니다.

다음 단계

사이트에 새 페이지 또는 게시물을 추가하려면 “Jekyll을 사용하여 GitHub Pages 사이트에 콘텐츠 추가”를 참조하세요.

GitHub Pages 사이트에 Jekyll 테마를 추가하여 사이트의 모양과 느낌을 사용자 지정할 수 있습니다. 자세한 내용은 “Jekyll을 사용하여 GitHub Pages 사이트에 테마 추가”를 참조하세요.