[mac] jekyll Chirpy-starter 로 GitHub Pages 만들기1

환경 : MacBook Pro 14  M3 macOS 15.1.1
세팅 : 이미 brew, iTerm 설치 세팅 완료된 상태. (여기까진 알아서..)
주의 : 기술 내용은 [포스팅 시점, PC환경]에 따라서 동작하지 않을 수 있음. 
'[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.

 

테마 : Chirpy

제작자 공식 GitHub :  [Official] cotes2020 (Cotes Chung)

제작자 공식 안내 가이드 : [Official] Getting Started | Chirpy

제작자 Repository 'jekyll-theme-chirpy'   < Fork

제작자 Repository 'chirpy-starter'  < Use this template

---

 

GitHub Pages Themes는 검색해보면 정보 글들이 많다.

그 중에 Chirpy가 마음에 들어서 골랐는데 원래 인기가 많은 테마라고 한다.

 

제작자의 GitHub Repository에는 여러 프로젝트가 있다.

 

1. jekyll-theme-chirpy

웬만한 설정이 들어가있는 프로젝트. 자세한 차이점은 다른 글들 찾아보면 상세히 작성해줘서 따로 찾아보진 않았다.

맨 처음에 이거로 Fork했다가 안돼서 2. starter로 시도해봤더니 됐다.

(좀 더 시도해본 결과, 결국 이 프로젝트로도 성공했다. 글 추가 작성중...)

 

2. chirpy-starter

기본 기능만 들어있는 프로젝트.

ag. 한국어 지원 파일이 없어서 따로 넣어줘야함.

 

제작자 안내가이드에도 'Option 1. Using the Starter (Recommended)' 라고 적혀 있길래

일단 2. chirpy-starter로 성공한 흐름을 적었다.

 

---

 

참고 문헌

제작자 공식 안내 가이드 : [Official] Getting Started | Chirpy

 

일단 제작자 안내대로 [제작자 stater -> 내 깃헙에서 만들기] 진행한다.

 

 

Settings 가서 이름 바꾸기 귀찮아서 그냥 바로 username.github.io 로 만들었다.

 

만들어지면, https 복사한다.

 

 

나는  탐색기/Finder에  'jekyll' 이라는 폴더를 하나 만들고  그 안에 프로젝트를 clone했다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

 

 

* 명령어 실행하다  'Could not locate Gemfile' 오류가 뜬다면,

jekyll 서버로 돌리려면 프로젝트의 Gemfile이 있는 곳에서 돌려야하는 것이다.

 

1. clone한 프로젝트에 Gemfile이 있는지 확인하고 터미널에서 파일 경로까지 이동한다.

2. 다시 명령어를 실행해본다.

 

아래가

제작자가 오픈소스로 공유해준 Chirpy starter 프로젝트를 내 Repository로 가져와서

아직 나의 GitHub 주소나, 다른 수정사항이 1도 없는

로컬에서 jekyll 서버로 보이는 상태이다.

 

GitHub Pages를 쓴다는 건

내 로컬이 켜져있을 때만 서버를 돌리는게 아니라, 이미 GitHub이 마련해준 정적 사이트 서비스를 무료로 쓰는거다.

위는 Chirpy가 제대로 보이는지 여부를 위한 테스트를 로컬에서 jekyll 서버로 돌리기만 한거고,

이제 Chirpy가 GitHub에서 서버가 돌아가야 하는 것.

 

중요한 건, 컴퓨터는 Operating System. OS가 다를 수 있다.

안드로이드 폰, 아이폰 폰은 눈에 보이는 디자인이나 기능 동작들에 있어서 필수 기능,부품들은 일반인 분엔 같아보일지라도

분명 제작사는 다른거다.

 

OS도 Windows, macOS, Linux 등이 있고 다들 태어나고 만들어진 플랫폼 platform이 달라서
그래서 GitHub Pages에 build & deploy할 때

"너 지금 빌드 배포하고 있는 OS 플랫폼이 이거 아닌 거 같아. 혹시 다른거면 설정 파일 속에 어떤 설정값 있어야만 인식하는데

그게 없어서 빌드 배포 오류나.." 라면서 안될 수 있다.

 

그래서 macOS에서 파일(_config.yml이든 md 파일을 추가수정삭제 하든)을 수정하고 배포빌드하기 전에

아래 명령어로 추가하고 commit push해야한다.

 

$ bundle lock --add-platform x86_64-linux

 

 

 

하기 전에 GitHub에 파일을 추가수정삭제하고 commit, push 하기 위한(형상관리) 준비를 하고 간다.

(termianl 명령어, fork로도 해봤는데 안되고, GitHub Desktop으로만 해야지 GitHub에 반영되는 것을 확인)

 

---

 

 

GitHub Desktop을 연다.

('[mac] jekyll Chirpy 로 GitHub Pages 만들기 전 세팅' 되어있어야함.)

 

 

Add an Exisiting Repository from your Local... 를 선택하고

Choose...를 선택한다.

 

clone한 프로젝트를 열고,  Add Repository 한다.

 

이제 clone한 경로의 파일들이 추가수정삭제된 걸 commit,push할 수 있는 준비 끝.

(아직 _config.yml이나 뭐 수정해서 commit하면 안된다!!!)

 

---

다음 글에서 GitHub Pages에 GitHub Actions로 빌드 배포하기 위한 걸 확인 후 진행한다.