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

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

필수 조건

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

• Jekyll 사이트를 만듭니다. 자세한 내용은 Jekyll을 사용하여 GitHub Pages 사이트 만들기을(를) 참조하세요.

데이터 재사용가능.페이지.추천-번들러 %}

Note: Ensure that actual content within placeholders is accurately filled in accordance with intended use and context.

로컬로 사이트 빌드

1. 터미널터미널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 패키지 업데이트

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

데이터 재사용 가능 명령 줄.멀티 OS 터미널을 여세요 %} 1. github-pages gem을 업데이트합니다. * Bundler를 설치한 경우 bundle update github-pages를 실행합니다. * Bundler가 설치되어 있지 않으면 gem update github-pages를 실행합니다.

추가 참고 자료

• Jekyll 문서 내 GitHub Pages