📒Github Blog 만들기-2

22/08/01

7월 31일자 겪은 수 많은 오류가 서막이었음을 그땐 깨닫지 못했습니다...

목표는 github로 기술 블로그를 개설하는 것.

테마를 적용하여 blog 다운 blog를 만들어 보고자 합니다.

선택한 테마는 Chirpy theme.

선택하게 된 이유는 화면이 직관적이고 깔끔하기 때문입니다.

그럼 작업하면서 막혔던 점을 기록하겠습니다.

---

Github Blog 테마 적용

👇작업 순서👇

1. [Ruby install.](https://rubyinstaller.org/downloads/)

2. github repo 생성.

3. my github repo clone.

>git clone {user repo code url} //로컬로 불러와서 작업하겠습니다.

4. jekyll install.

5. bundler 작업.

6. jekyll serve 구동.

- [x] 1~6번까지 📒Github Blog 만들기-1 참고.

7. 적용하고 싶은 테마를 선택해 해당 git repo에 가서 코드를 다운로드.

적용하고 싶은 테마는 jekyll-theme-chirpy.

8. 다운 받은 테마 폴더의 압축을 푼 후 폴더 내용을 전부 긁어서 clone한 로컬 repo에 덮어쓰기.

• 하지만 이대로 github repo로 push 하면 git repo에서 build 과정 중 에러가 뜹니다. 그러므로, Chirpy 테마를 초기화 시켜줍시다.

• 리눅스 운영체제 MAC에서는 bash를 써서 init을 하면되지만... 윈도우는 수작업이 필요했습니다. (그래서 ubuntu로 작업하고자 했으나 일단 그건 다음 기회에.)

9. 로컬 repo에서 삭제해야할 목록

• Gemfile.lock 파일.

• docs폴더 및 디렉토리. (내가 다운 받은 Chirpy 테마에는 docs가 없었다.)

• .travis.tml 파일.

• _posts.docs (.md파일들이 있는데, 보고 필요한 것만 남겨 두면 된다.)

• .github 폴더에서 workflows 폴더를 남겨두고 파일 전부를 지우기.

• .github/workflows/에서 commitlint.yml과 page-deploy.yml.hook 외에 다 지우기.

• page-deploy.yml.hook파일의 .hook를 지우기.

수작업이 끝났습니다.

10. 관리자 Ruby Prompt를 켜서 내가 작업할 폴더로 이동 후 bundler.

>cd {user git repo 폴더 위치}

>bundle install

11. _config.yml에서 url: '' 에 나의 github url 넣어주기.

url: 'http://username.github,io/'

12. github로 push!

>git add . // 이 안될 시 git add * or git add --all

>git commit -m 'history' //history title을 아무거나

>git push

그렇게 성공을 바랐으나...

실패라는 고배를 마십니다.

뜨라는 테마는 안뜨고

❗❗

---layout: home # Index page---

이 문구 외에 아무것도 적혀있지 않은 index.html 화면만 주구장창 뜨는 것.

✔️해결 방안

• 'github css 적용 안됨'으로 또 열심히 구글링 해줍시다.

• git에서 작업하는 해당 Repository의 page setting을 변경해야 했습니다.

• branch를 master가 아닌 gh-page로 바꿔줘야 한다는 것.

but 그러나 저는 여기서 또 문제가 생깁니다.

원래라면 Chirpy 테마 제작자가 구성해 놓은 CI/CD에 따라 gh-page branch가 자동으로 생성되어야하는데 아무리 기다려도 gh-page가 생겨나지 않았던 것.

또 다시 구글링한 결과

다른 사람들의 repo 생성 과정과 나의 repo 생성 과정이 어딘가 다르다는 걸 발견했습니다.

제가 repo를 생성하고 .md 파일을 자동으로 생성할 때 branch가 master로 잡혔었는데,

Chirpy 테마를 적용한 다른 블로그들은 전부 branch를 main으로 잡았던 것을 확인했습니다.

알고보니

Chirpy에서 main branch로 build시 gh-page branch가 자동으로 생성되게 제작해 놓았다고 합니다.

처음부터 main으로 branch를 잡고 가신 분들은 url만 변경해 주시면 테마가 잘 적용되실 겁니다.

✔️최종 해결 방안

• branch 기본 셋팅을 main으로 잡아주고 repo를 새로 생성한 뒤 기존의 작업을 반복했습니다.

그래도 여전히 index.html 화면만😂😂

머선129...

• .github/workflows/page-deploy.yml에서 master로 되어 있는 branch를 main으로 바꾸어 봅시다.

master --> main

바꿔준 후 다시 git 으로 push.

이번엔 잘 되려나 싶더니 git repo build 과정 중 오류가 생겼네요..??

❗❗

repo Action에서 build된 작업을 확인해 본 결과 수정한 page-deploy.yml에서 생긴 Ruby버전 관련 오류였습니다.

Error: The process '/opt/hostedtoolcache/Ruby/2.7.6/x64/bin/bundle' failed with exit code 16

현제 제 Ruby version은 3.1 입니다.

오류를 보니 Ruby 2.7 ver bunlde 과정 중 실패 한 것 같은데...

✔️해결 방안

• https://velog.io/@rails/Ruby-%EB%B2%84%EC%A0%84-%EC%97%85%EB%8D%B0%EC%9D%B4%ED%8A%B8-%ED%9B%84-ApachePassenger-%EC%97%90%EB%9F%AC-%EB%B0%9C%EC%83%9D%EC%8B%9C

이곳에서 시키는 대로도 해보았고,

gem install passenger

• https://stackoverflow.com/questions/65289800/github-actions-failing-to-install-libv8-gem-on-ubuntu-18-04-5

이곳에서 말하는 대로 Ruby version이 문제인 듯 싶어

Ruby를 downgrade하는 것 대신에

에러가 생긴

page-deploy.yml에 with ruby version을 현제 내 version과 똑같이 맞춰주기로 했습니다.(이렇게 해도 되는지 모르겠지지만...ㅎ.ㅎ)

2.7 --> 3.1

그러자...

드디어!

제대로 Chirpy 테마가 github 사이트에 적용 완료!! 🎉🎉🎉

사실 에러가 고쳐진 이유를 정확히 모르습니다.

위 github의 코멘트 처럼

Ruby version에 맞게 passenger을 새로 install 해주었기 때문일까요?

아니면 오류가 난 파일에 적힌 Ruby 버전을 직접 수작업으로 변경해 주었기 때문일까요?

---

📝추신

결과는 성공이었지만

이렇게 적용이 어려울 줄이야.

"개발자에게는 MAC환경이 최고지!"라고 여럿 개발자 분들이 말한 것처럼 Window환경에서의 github 블로그 개설, 특히 Chirpy 테마의 적용은 아주 힘들었습니다.

어려워도 적용해서 잘 사용하는 블로그들을 보니 도전 정신이 생길 수 밖에 없었어요.

그 놈의 도전 정신😂😂😂

어쩄든, 7월 31일자 기준 자정이 넘도록 Chirpy 테마의 적용을 목표로 노력한 결과 Chirpy 테마를 나의 git url으로 무사히 적용할 수 있었습니다!!

시간이 난다면 다시 한번 처음부터 작업해볼 생각입니다.

지금은 차근차근 알아가는 과정이니까! 만족!😚

---

📖참조

github jekyll Chirpy theme blog 개설

https://wlqmffl0102.github.io/posts/Making-Git-blogs-for-beginners-3/

https://seong6496.tistory.com/267?category=1009671