DevOps/Github

[Github] 깃허브에 블로그 만들기

IT수정 2024. 10. 14. 16:46

Jekyll Theme

깃허브 페이지에서 블로그나 사이트를 만들 때 사용하는 디자인과 스타일 모음을 의미한다.

대부분의 지킬 테마는 깃허브 저장소에 올라와 있으며, 데모 사이트를 함께 제공하므로 사이트를 참고하여 원하는 테마를 선택할 수 있다.

 

검색 사이트에서 Jekyll Theme으로 검색하면 찾을 수 있다.

지킬 테마 관련 참고 사이트
https://github.com/topics/jekyll-theme
http://jekyllthemes.org/
https://jekyllthemes.io/
https://jekyll-themes.com/
https://jamstackthemes.dev/ssg/jekyll/

 

난 https://github.com/cotes2020/jekyll-theme-chirpy 의 테마를 사용하여 블로그를 만들어 볼 것이다.

 

블로그 만들고 기본 환경 설정하기

지킬 테마를 선택 했다면 해당 리포지토리의 [Fork]를 클릭한다.

 

자신의 블로그로 사용하기 위해서 리포지토리 이름을 본인의 아이디.github.io로 지정해주고 [Create fork]를 클릭한다.

※ 나와 같은 테마를 포크한 사람들 중 지역 저장소에 연동하려는 사람들은 https://chirpy.cotes.page/posts/getting-started/ 링크의 환경설정을 진행하고 다음 단계로 넘어간다.

 

복제된 리포지토리가 생성된 것을 확인했으면, 테마 환경 설정을 위해 _config.yml 파일을 클릭한다.

 

파일 수정을 위해 연필 아이콘을 클릭하고, 주석을 참고해서 내용을 수정한다.

자신의 개인 URL을 이용해 들어가려는 사람들은 URL 주소를 https://username.github.io 로 설정해주어야 한다.

수정이 끝났다면 [Commit changes...]를 클릭한다.

 

이 후 [Settings]의 [Pages]로 들어가서 브랜치를 다음과 같이 설정해준다.

 

[Actions]에서 workflows가 제대로 연동되는지 확인해주고, 연결이 되지 않는다면 [Pages]의 Source를 Github Actions로 설정해 수동으로 flow 해준다.

 

웹 브라우저 창에서 블로그 주소를 확인해준다. 이때 시간이 좀 걸릴 수 있다.

 

블로그에 포스트 작성하기

블로그 포스트는 _posts 디렉터리에 저장된다.

파일 이름은 '20xx-xx-xx-파일이름.md' 형식으로 마크다운 문법을 사용한다.

 

_posts 디렉터리에 있는 예제 파일을 눌러 연필 아이콘을 클릭해 해당 테마의 포스트 작성 기본 문법을 복사한다.

---
title: Writing a New Post
author: cotes
date: 2019-08-08 14:10:00 +0800
categories: [Blogging, Tutorial]
tags: [writing]
render_with_liquid: false
---

 

_posts 디렉터리 선택 후 [Add file] - [Create new file]을 선택한다.

본문에 복사한 내용을 붙여 넣고, 제목과 내용을 입력한다.

Preview를 통해 미리 작성된 모습을 확인할 수 있다.

작성을 완료 했으면 [Commit changes...]를 클릭해준다.

 

_posts 디렉터리에 파일이 추가된 것을 확인하고 웹 브라우저를 확인해보면 새 글이 생성된 것을 볼 수 있다.