환경
- MacBook Pro(Intel Core)
- Monterey OS(Version 12.2.1)
- git version 2.32.0 (Apple Git-132)
- ruby 3.1.1p18 (2022-02-18 revision 53f5fc4236) [x86_64-darwin21]
Tools/init.sh
이전에 Jekyll serve 를 통해 로컬 서버에서 구동한 Page 는 Chirpy 의 소개 페이지 입니다.
커스텀 하기 위해 기본 컨텐츠를 지워야 합니다. 개별 변경도 가능하지만, 번거로우니 한번에 초기화 하겠습니다.
MacOS는 Terminal, WindowOS는 Git Bash 를 사용, cd 명령어로 Pages 디렉토리로 이동해 tools/init.sh 명령을 입력합니다. 그리고 다시 로컬서버를 가동시키면 기본 컨텐츠가 사라집니다.
_Config.yml
거의 대부분의 설정을 변경할 수 있습니다. 저는 VSCode 를 사용하겠습니다.
| Element | Content |
|---|---|
| lang: | Language of the webpage |
| timezone: | Your timezone |
| title: | Main title |
| tagline: | Sub-title |
| description: >- | Seo meta and the atom feed |
| url: | Fill in the protocol & hostname for your site |
| github: | Fill in your github username. |
| social.name: | Fill in your full name. |
| social.email: | Fill in your email address. |
| social.links: | Fill in your social links. |
| google_analytics: | Fill in your Google Analytics. |
| theme_mode: | Theme Mode |
| avatar: | Avatar on sidebar(Fill your Avatar image path) |
- Search Timezone: http://www.timezoneconverter.com/cgi-bin/findzone/findzone
- avatar 부분은 보통 /assets/img/ 디렉토리를 연결합니다.
- Social 의 링크부분 중 쓰지 않는 부분은 주석처리해도 무방합니다.
⚠️ Error
- Gemfile.lock
확인해 본 결과 보통의 Jekyll Theme 는 이후 GitHub 로 바로 Push 하면 즉각 적용이 가능합니다.
하지만, ‘Chirpy’ 는 현재 시점에서 Push 를 하면 _Config.yml 제대로 적용이 안되는 현상을 겪었습니다.
그래서 같은 과정을 몇번 정도 반복하며 분석해 본 결과 Tools/init.sh 명령이 .gitignore 의
Gemfile.lock 을 삭제 시키는 현상을 발견했습니다. 이후 Gemfile.lock 파일을 아예 삭제한 후 Push를 하니 정상적으로 수정내용이 반영되었습니다.
- Local server
Gemfile.lock 파일을 삭제한 후 수정 내영이 정상 반영 되었으나 아마, Gemfile.lock 이 local server 의 어떤 부분과 연관이 있는 것 같습니다. 실험 해보지는 않았지만 Gemfile.lock 파일을 삭제하면 더는 local server 에서의 구동이 불가합니다. 때문에 삭제보다는 .gitignoer 에 Gemfile.lock 추가를 권장합니다.
Push
Push 한 후, GitHub 의 Actions 탭을 확인하면 페이지 반영 결과를 확인할 수 있습니다.