태주네 블로그 (Taejoone)

사용한 jekyll template

• 깃허브 - Chirpy Starter
  • 테마 - jekyll-theme-chirpy 5.2.1
  • jekyll-4.2.2

trouble shooting (문제 해결)

대부분의 모듈 문제인 경우 강제 재설치 bundle install --redownload 로 처리된다.

bundle 'load': cannot load such file 오류 (macOS)

출처: How to fix: Fastlane bundler load error on MacOS

bundler 가 재설치 되면서 버전이 변경되는 경우, ruby가 참조를 할 수 없어 발생한다.

$ bundle --help
Traceback (most recent call last):
        1: from /opt/homebrew/opt/ruby@2/bin/bundle:23:in `<main>'
/opt/homebrew/opt/ruby@2/bin/bundle:23:in `load': cannot load such file -- /opt/homebrew/lib/ruby/gems/2.7.0/gems/bundler-2.3.21/exe/bundle (LoadError)

1. Gemfile.lock 파일을 열고
2. 맨 하단에 BUNDLED WITH 값을 오류 메시지의 bundler 버전과 같은지 확인한다.
3. 틀리면 설치된 버전값으로 수정하여 저장한다.

jellky 빌드 오류 체크

git page 에 올리기 전에 무조건 한번씩 확인하는 것이 좋다.

• 작성된 md 파일 내의 깨진 링크 또는 특수 문자 등의 문제를 체크한다.
  • 이상 없으면 깃허브 블로그 페이지에서도 문제없이 build 될 것이다.

$ ./tools/deploy.sh --dry-run

Running ["ScriptCheck", "LinkCheck", "ImageCheck", "HtmlCheck"] on ["_site"] on *.html... 
Ran on 444 files!
HTML-Proofer finished successfully.

환경 설정

• Ruby 2.7 (권장 2.x 최신버전)
• Gem : ruby 설치 할때 같이 설치됨
  • 체크 : gem environment gemdir

새로 만들 때

참고: Jekyll 에 Bundler 사용하기

$ cd {my-jekyll-website}

# bundle 은 설치 관리자
$ bundle init          # Gemfile 생성

# bundle 의 local 환경설정 (venv 같은)
$ bundle config set path 'vendor/bundle'

# 정적 웹사이트 생성 도구 jekyll 부터 받고
$ bundle add jekyll

# 초기 bundle 관련 파일 제거
$ bundle exec jekyll new --force --skip-bundle .

# 나머지 의존 패키지들 설치!!
$ bundle install

# (기본 템플릿) 웹사이트 실행 port=4000
$ bundle exec jekyll serve --host 0.0.0.0

blog 소스를 다시 다운받을 때

$ cd {my-jekyll-website}

# bundle 의 local 환경설정 (venv 같은)
$ bundle config set path 'vendor/bundle'

# 의존 패키지들 설치하기 (./vendor/bundle)
$ bundle install

수정이 필요한 파일들

.
├── _config.yml
├── _data
├── _plugins
├── _tabs
└── index.html

사용법

소스 관리

vendor 는 계속 패키지 다운로드에 따라 종속성이 있는 부분이라, .gitignore 에 등록해 주고, 계속 소스 관리를 하고 싶은 부분은 jekyll-theme-chirpy-{버전}의 하위 디렉토리 단위로 복사하면 된다.

• 예를 들어, 폰트를 바꾸고 싶다면 _sass 모듈이 필요하다.
  • _sass 디렉토를 통채로 복사한 후
  • _sass/addon/common.scss 파일을 수정
    • 최상단에 @import url({폰트-URL}); 를 넣고, body 에 font-family 를 수정

# 수정을 원하는 모듈의 최상위 디렉토리를 통채로 복사하면 된다
cp -r ./vendor/bundle/ruby/2.7.0/gems/jekyll-theme-chirpy-5.2.1/_sass ./

# ==> `_sass/addon/common.scss` 파일을 수정
body{
  ...
  font-family: 'Noto Sans KR', sans-serif;
}

Post 작성시 주의사항

Tag 대소문자 통일 (태그 충돌)

태그 페이지 생성시 대소문자 각각 index.html 생성

~~~~
tags: ["zombodb", "Postgresql"]
~~~~
tags: ["zombodb", "postgresql"]
~~~~

Conflict: The following destination is shared by multiple files.
    The written file may end up with unexpected contents.
    {blog_root_dir}/_site/tags/postgresql/index.html
      - tags/postgresql/index.html
      - tags/postgresql/index.html

    ...done in 11.610494 seconds.

참고

• jekyll-theme-chirpy 문서.