GitHub 블로그 만들기(3)

본 문서는 GitHub 블로그 만들기 시리즈의 세번째 단계로 글 작성과 배포 방법을 담고 있다. Github 블로그를 위한 환경을 만들고 블로그를 개설하는 방법은 이전 포스트에서 확인할 수 있다.

1. 글 작성하기

---

이전 포스트에서도 언급하였지만 Markdown을 사용하여 글을 작성한다. _posts 디렉토리에 있는 마크다운 파일을 참고하여 기본 구조(front matter)를 파악하고 글을 작성하면 된다.

 ---
 title: 제목
 
 author: 작성자
 
 date: 작성일시 # YYYY-MM-DD HH:MM:SS +09:00
 
 categories: [카테고리]
 
 tags: [태그1 태그2]
 
 ---
 글 작성 테스트

로컬 빌드 command를 실행하면 확인할 수 있다.

$ bundle exec jekyll serve

오류-메인페이지

메인 페이지에서 작성한 글이 보이지 않는 경우가 발생할 수 있다.

_layout/home.html 을 열어 for post in posts 부분(line 40 정도)을 찾고 for post in site.posts로 수정하면 된다.

2. GitHub Action 빌드 및 배포

---

먼저 GitHub에 변경사항을 commit 해야 한다. commit 방법은 Repository를 처음 생성했을 때 알려주는 command line을 따라하면 된다. Fork와 같은 앱을 사용하고 있다면, 해당 앱을 사용해 commit 하면 된다.

$ git add -A                          
$ git status                          
$ git commit -m "원하는 커밋 제목"     
$ git push    

commit이 완료되면 GitHub에서 알아서 빌드를 진행한다. GitHub Action(.github/workflows/pages-deploy.yml)을 통해 빌드와 배포가 자동화되어 있다. build 과정은 GitHub의 Action 탭에서 확인할 수 있다. 성공적으로 완료되면 초록색 마커, 진행중이면 노란색 마커, 실패하면 빨간색 마커가 보인다.

변경사항, 작성한 글 등이 잘 반영되어 빌드를 마치면, https://{user_name}.github.io/에서 완성된 블로그를 확인할 수 있다.

3. 빌드 실패와 오류

---

실패할 시, 오류사항을 확인할 수 있고 오류를 해결해야 성공적으로 빌드될 것이다. 내가 겪은 오류는 따로 정리하였다. commit 전에 로컬에서 확인 후 오류가 없는지 확인하고 commit하는 것이 좋지만, 그렇게 해도 발생하는 오류들이 꽤 있는 것 같다.

• GitHub 블로그 오류(1)
  • /assets/js/dist/ does not exist
  • 제대로 작동하지 않는 .js
  • 'for' tag was never closed in {path}
  • {url} is not an HTTPS link