#GithubBlog_주말을 활용한 Github Blog 만들기 5편_Posting 작성하기

 

# Posting 작성하기에 앞서

이번 과정에서는 포스팅을 작성하고, 빌드 및 업로드하는 과정을 살펴보도록 하겠습니다. 아직 이전 과정을 진행하지 않으신 분들은 아래의 포스팅을 순차적으로 읽고 차근차근 적용해나가시면 됩니다. 

 

#GithubBlog_주말을 활용한 Github Blog 만들기 2편_Ruby와 Jekyll 설치하기

#GithubBlog_주말을 활용한 Github Blog 만들기 2편_Ruby와 Jekyll 설치하기

---

 

#GithubBlog_주말을 활용한 Github Blog 만들기 3편_Github Repository생성부터 로컬 환경에 띄우기까지!

#GithubBlog_주말을 활용한 Github Blog 만들기 3편_Github Repository생성부터 로컬 환경에 띄우기까지!

---

#GithubBlog_주말을 활용한 Github Blog 만들기 4편 Jekyll 테마 다운 받아서 적용하기

 

 

 

 

#GithubBlog_주말을 활용한 Github Blog 만들기 4편_Jekyll 테마 다운 받아서 적용하기

 

---

# 포스팅 작성하기

1. _post 디렉토리 생성

블로그 포스팅을 작성하기 위해 먼저 root 디렉토리에 `_post` 디렉토리를 생성합니다. 디렉토리를 생성하면 아래와 같은 구조로 디렉토리가 생성됩니다.

- root
  - _post
    - YYYY-MM-DD-포스팅-제목.md

---

2. 마크다운 파일 생성

_post 디렉토리 생성에 성공했다면, 이제 블로그 포스트를 작성할 마크다운 파일을 생성합니다. 파일 이름은 `YYYY-MM-DD-포스팅 제목.md` 형식으로 마크다운 파일을 작성합니다.  마크다운 파일의 최상단에는 아래의 형식처럼 작성해야합니다. 

---
title: "Hello World!"
date: 2023-11-12 12:24:00 +0900
categories: [blog]
tags: [github Pages, githubBlog, blog, velog, github]
---

**"Github Blog First Commit Test"**

 

** title: 블로그 포스트의 제목입니다.

** date: 블로그 포스트의 날짜 및 시간입니다. 한국 표준시를 나타내는 +0900이 포함되어 있습니다.

** categories: 블로그 포스트가 속한 카테고리 입니다. 

** tags:  블로그 포스트와 관련된 키워드 또는 주제입니다. 

 

이제 마음껏 마크다운 언어를 사용하여 블로그 포스팅을 작성하면 됩니다. 마크다운은 가벼운 언어로, 쉽게 읽고 쓸 수 있습니다. 여러가지 포맷팅 기능을 활용하여 글을 더욱 돋보이게 작성할 수 있습니다. 

---

3. 서버를 실행 한 후, 작성한 포스팅 확인하기

포스팅을 작성한 후, 확인을 위해 터미널에 ` bundle exec jekyll serve`명령어를 입력하여 Jekyll 로컬 서버를 실행하고, 브라우저에서 `http://localhost:4000`으로 접속하여 작성한 포스팅을 확인합니다. 

// 서버 실행 
bundle exec jekyll serve

// 서버 홗인 
http://localhost:4000

---

---

????!!!!?!!??!?!??!?!?!?

작성한 게시물이 보이지가 않습니다. 이것은 고질적인 `Jekyll`의 이슈 때문인데 같이 해결하는 방법을 알려드리겠습니다.

---

# 메인페이지 문제 해결하기

대부분의 사용자들이 문제없이 다음 단계로 넘어가겠지만, 위와 같이 메인 페이지에 포스팅이 보이지 않는 문제가 발생했을 때, 지금 알려드리는 방법을 사용하시면 문제를 해결하실 수 있습니다. 

 

1. _Layout/home.html 파일 열기

---

2. `for post in posts` -> `for post in site.posts` 로 변경하기  

---

저장 후 로컬 서버를 다시 실행해보면 메인 페이지에 포스팅이 보이는 것을 확인 할 수 있습니다. 

---

# 빌드 및 배포하기

이제 마지막 단계로 GitHub에 파일을 업로드하고 자동으로 빌드 및 배포를 수행하여 블로그를 생성합니다. 

$ git add -A                          # 모든 수정 파일을 추가합니다.
$ git status                          # 파일 변경사항을 확인합니다.
$ git commit -m "원하는 커밋 제목"     # 커밋 메시지를 작성합니다.
$ git push                            # 레포지토리로 수정 사항을 업로드합니다.

 

위의 과정을 따라 `git push`를 하면 GitHub에서 자동으로 빌드를 진행합니다. GitHub 레포지토리로 들어가 Action 탭을 확인하면 빌드 과정을 확인할 수 있습니다. 빌드까지 시간은 다소 소요되며, 완료되면  체크 표시가 활성화됩니다.

---

---

# 고질적인 Jekyll 문제 해결 방법

GitHub블로그 배포 후 적용이 안되는 오류 발생

이 문구 외에 아무것도 적혀있지 않은 index.html 화면만 주구장창 뜰 때 사용하는 방법입니다.

// 오류 내용
---layout: home # Index page---

---

*** 오류료 인한 화면 페이지

---

** GitHub에서 action을 확인했을 때, 체크 활성화가 안됩니다.

---

✔해결 방안
git에서 작업하는 해당 Repository의 page setting을 변경해야합니다.
branch를 master가 아닌 gh-page로 바꿔서 적용시켜줘야합니다.

---

** Repository -> settings 이동 후 pages 클릭하기

---

** Source 선택 후 GitHub Actions (Beta)로 설정 바꾸기

---

이후 gh-page로 다시 배포하면 적용되어 있는 자신의 GitHubPage를 확인 할 수 있습니다. 

---

# GitHub Page 만들기를 마무리하며

블로그를 만들기 위해 더 많은 시간을 투자할 수 있었다면 지금의 내용보다 자세하고 풍부한 내용으로 기록하고 싶었는데, 그러지 못한 점이 아쉬웠습니다. 사전에 찍어둔 사진들도 모두 사용 기한이 만료돼 사용할 수 없었고, 결과적으로 제 기대와는 달리 글이 좀 더 부실하게 마무리되었습니다. 아쉬움이 매우 크게 남지만, 시간 관계상 포스팅을 마무리하고 궁금한 점은 댓글을 남겨주시면 GitHub 페이지 제작과 관련된 내 지식 범위에서 자세히 답변드리겠습니다. 지금까지 함께해주셔서 감사드리며 오늘 하루도 수고하셨습니다.