Github 블로그 시작하기

점점 머리가 나빠진다. 나의 경우 글을 작성하고 다시 보고 하면서 반복적으로 봐야 공부가 된다.
메모하는 습관을 다시 기르기 위해 2018년 ice bear 테마 Github 블로그를 구축했었으나 테마가 너무 좀.. 그래서.. 새로운 테마로 새롭게 시작하고 싶었다. 그래서 기존 Repo 를 과감하게 제거하고 새로운 테마를 적용하면서 히스토리를 기록하기로 했다.

절대 Repo를 지우지 않는 것을 추천한다.
해당 Repo의 잔디는 모두 뿌리가 뽑히게 된다.🙀

추가로 stackoverflow 의 취지가 동기부여 되었다.

1. Github 설정 하기

GitHub 를 통한 블로그 생성은 Github Pages 라 한다.

1.1 Repo 생성

네이밍에 유의해서 Repo 를 만들자.

1.2 Settings 설정

만들어진 Repo 의 Settings 에 들어가자.

Pages 에 가면 설정버튼 있다. 누르자! 완료!

2. 설치

2.1 Jekyll 설치

Jekyll 에 의해 구동되어 설치가 필요하다.

gem install jekyll

2.2 테마 고르기

테마는 마음에 드는 것으로 선택하자. 검색하면 테마를 모아놓은 사이트가 아주 많다.

이 블로그의 테마 : minimal-mistakes 데모 보러 가기

minimal-mistakes 의 설치 가이드를 보면 각 설정이 있는데, 이는 테마 별로 비슷한 점도 있지만 다른 점도 있다. 이 부분은 본인이 선정한 테마의 가이드를 참고하는 것이 가장 좋다.

2.3 bundler 설치

bundler 를 설치하자. 로컬에서도 돌려볼 수 있기 때문에 매우 유용하다.

gem install bundler

만약 FilePermissionError가 발생하면 해당 사이트를 참고하자.
해당 글을 보다보면 ..zshrc, .bashrc 와 같은 내용이 있는데 맥 터미널의 경우 상단 창에 표시가 된다.
zshrc, .bashrc의 더 자세한 사항은 여기를 참고하자.

3. 로컬 서버 실행

config.yml 를 수정하면 재시작이 필요하다.
.md 파일이나 .html 파일을 수정하면 재시작이 필요없다.

3.1 로컬 서버 실행

bundle exec jekyll serve

You have already activated public_suffix 4.0.7, but your Gemfile requires public_suffix 4.0.6. Prepending bundle exec to your command may solve this

만약 위와 같은 메시지의 에러가 발생한다면 아래 명령어를 입력하면 해결 된다.

bundle clean --force

3.2 로컬 서버 종료

ctrl-c

이후엔

jekyll serve

로 서버를 실행할 수 있다!

3. 브라우저 접속

http://127.0.0.1:4000/
또는
http://localhost:4000/

여기 까지 된다면 성공!

4. Repo 에 Push 하기

git push origin master

만약 Git Token 관련 에러 가 발생하면
Settings - Developer settings - Personal access tokens - 생성
생성된 키로 이후부터 로그인 하면 된다
해당 키는 안전한 곳에 백업이 필요하다.

5. 댓글 달기

utteranc 를 사용했다.
가이드 를 보는게 가장 도움이 될 것이다.

자신의 테마에서 comments 에 대한 지원이 된다면 _config.yml 의 설정을 통해 가능 할 수도 있다.

6. Favicon 설정

favicon-generator 로 만들었다. 이미지를 첨부하면 각 환경 별 favicon 을 만들어준다.
다운로드 이후 Repo 의 Root 에 넣어준뒤 Push 하자.

참고 사이트 - 7271kim.github.com