깃허브 블로그 생성

예전부터 해야지 하고 맘먹었던 블로그 생성을 드디어 했다.
유명한 플랫폼들 중에 어디를 할지 고민하다가 깃허브 블로그로 사용하기로 했다.
고민했던 플랫폼은 국내 유명 플랫폼인 티스토리, 네이버 그리고 깃허브 중에서 고민했다.

다크모드를 선호하는지라 다크버전이 있는 테마를 원했고, 깃허브에서 사용할 수 있는 여러 테마는 jekyll theme 에 있다.
처음에 택한 테마는 jekyll-theme-chrispy 였다.
루비도 처음 써보고 구글링해가며 열심히 만들었는데 계속 build failed가 떴다

빌드가 실패하면 메일과 깃허브 설정 - 깃허브 페이지에서 로그를 알려주는데, 내게 왔던 로그는

The page build failed for the `main` branch with the following error:

Page build failed. For more information, see https://docs.github.com/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites#troubleshooting-build-errors. For information on troubleshooting Jekyll see: https://docs.github.com/articles/troubleshooting-jekyll-builds If you have any questions you can submit a request at https://support.github.com/contact?repo_id=340559652&page_build_id=234801607

어디가 문제인지 알려주는 로그도 확인할 수 있습니다.

이 로그만 계속 보여서 로컬에서 확인하는 방법을 찾았다.
본인은 macOS를 사용하는 관계로 mac 기준으로 설명을 드리겠습니다.

로컬에서 확인하기

  1. teminal에서 본인의 블로그용 workspace로 이동합니다.
  2. bundle exec jekyll serve or jekyll serve --trace 명령어로 로컬에 수정사항이 반영되는 것을 실시간으로 확인 가능합니다.
  3. 실행 후에 gem jekyll version required ... 등의 오류를 확인할 수도 있는데,
    이 부분은 현재 반영하려는 블로그 워크스페이스에서 ￿￿￿￿￿￿￿￿￿￿￿￿Gemfile에서 gem "jekyll", "~> 요구하는 버전"을 파일 내부 어느곳이든 입력하면 됩니다.
  4. 제작자가 사용하기 쉽게 만든 경우에는 별 문제 없이 바로 사용 가능합니다.

로컬은 되는데 깃허브는 왜 안되는걸까

  • 간혹 로컬에서는 되는데 깃허브에 반영이 안되고 page build failed 라는 로그를 확인하게 될 경우
    로컬의 jekyll버전과 github pages jekyll version에서 제공하는 jekyll 버전이 다른지 확인해야 합니다.
  • 저의 경우에는 로컬은 jekyll version - 4.2.0 이었고, 깃허브는 3.9.0 이어서 계속 빌드 실패를 확인했습니다.
  • 열심히 구글링하면서 확인한 결과, gem "jekyll", "~> 3.8" 을 추가했더니 깃허브에 반영되는 것을 확인할 수 있었습니다.
    gem "jekyll", "~> 3.8" 3.8버전의 jekyll을 사용하라는 명령어입니다.

bundle update or bundle install

로컬에서 실행하는데 계속 오류를 뱉는다면 수정사항이 반영 안된 것일 수 있으니, bundle update or bundle install 을 실행해보세요.
mac의 경우 관리자권한이 필요한 라이브러리가 있을 수 있으니 관리자권한으로 실행하는 것을 권장합니다.

이렇게 나의 다사다난했던 블로그 생성기는 마치겠다.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.