Jekyll을 사용하여 로컬로 GitHub Pages 사이트 테스트

GitHub Pages 사이트를 로컬로 빌드하여 사이트의 변경 내용을 미리 확인하고 테스트할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

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

GitHub Pages은(는) 이제 GitHub Actions을(를) 사용하여 Jekyll 빌드를 실행합니다. 빌드의 원본으로 분기를 사용하는 경우 기본 제공 Jekyll 워크플로를 사용하려면 리포지토리에서 GitHub Actions을(를) 사용하도록 설정해야 합니다. 또는 GitHub Actions을(를) 사용할 수 없거나 사용하지 않도록 설정한 경우 원본 분기의 루트에 .nojekyll 파일을 추가하면 Jekyll 빌드 프로세스를 무시하고 콘텐츠를 직접 배포합니다. GitHub Actions 사용에 대한 자세한 내용은 "리포지토리에 대한 GitHub Actions 설정 관리"을 참조하세요.

Platform navigation

이 문서의 내용

리포지토리에 대한 읽기 권한이 있는 사용자는 로컬에서 GitHub Pages 사이트를 테스트할 수 있습니다.

필수 조건

Jekyll을 사용하여 사이트를 테스트하려면 먼저 다음을 수행해야 합니다.

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

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

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

로컬로 사이트 빌드

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

  2. 사이트의 게시 원본으로 이동합니다. 자세한 내용은 "GitHub Pages 사이트에 대한 게시 원본 구성"을(를) 참조하세요.

  3. bundle install를 실행합니다.

  4. Jekyll 사이트를 로컬로 실행합니다.

    $ bundle exec jekyll serve
> Configuration file: /Users/octocat/my-site/_config.yml
>            Source: /Users/octocat/my-site
>       Destination: /Users/octocat/my-site/_site
> Incremental build: disabled. Enable with --incremental
>      Generating...
>                    done in 0.309 seconds.
> Auto-regeneration: enabled for '/Users/octocat/my-site'
> Configuration file: /Users/octocat/my-site/_config.yml
>    Server address: http://127.0.0.1:4000/
>  Server running... press ctrl-c to stop.

    참고:

    • Ruby 3.0 이상을 설치한 경우(Homebrew를 통해 기본 버전을 설치한 경우) 이 단계에서 오류가 발생할 수 있습니다. 이러한 버전의 Ruby에는 더 이상 webrick이 설치되어 있지 않기 때문입니다.

      오류를 해결하려면 bundle add webrick 실행을 시도한 다음 bundle exec jekyll serve를 다시 실행합니다.

    • _config.yml 파일의 baseurl 필드에 GitHub 리포지토리의 링크가 포함된 경우 로컬로 빌드할 때 다음 명령을 사용하여 해당 값을 무시하고 사이트에서 localhost:4000/ 서비스를 제공할 수 있습니다.

      bundle exec jekyll serve --baseurl=""

  5. 사이트를 미리 보려면 웹 브라우저에서 http://localhost:4000으로 이동합니다.

GitHub Pages gem 업데이트

Jekyll은 자주 업데이트되는 활성 오픈 소스 프로젝트입니다. 컴퓨터의 github-pages gem이 GitHub Pages 서버의 github-pages gem과 함께 오래된 경우 사이트를 로컬로 구축할 때와 GitHub에 게시할 때와 다르게 보일 수 있습니다. 이를 방지하려면 컴퓨터에서 github-pages gem을 정기적으로 업데이트하세요.

  1. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.
  2. github-pages gem을 업데이트합니다.
    • Bundler를 설치한 경우 bundle update github-pages를 실행합니다.
    • Bundler가 설치되어 있지 않으면 gem update github-pages를 실행합니다.

추가 참고 자료