GitHub 블로그 만들기

0. 소개

GitHub을 이용해서 Jupyter Noteboook을 이용해 작업한 것들을 그대로 업로드할 수 있는 블로그를 만들어본다. Jupyter Notebook에서 작업한 것들을 다시 Velog에 작성하는 것은 결과와 내용들을 재입력해야 한다는 불편함과 마음에 들만큼 깔끔하지 않다는 점에서 시도해 볼만한 가치가 있다고 생각한다.

1. GitHub Pages의 장점

기존의 블로그를 이용하면 편리하지만 정형화된 틀을 이용해야 한다는 단점, 블로그를 직접 만들면 배워야 할 것들이 많고 서버 호스팅 비용이 든다는 단점들이 있다.

GitHub Pages를 이용해 블로그를 만들면 원하는 대로 만들 수 있고 호스팅 비용이 들지 않으며 Jupyter Notebook을 쉽게 업로드 할 수 있다는 장점이 있다.

2. GitHub Pages 만들기

준비물은 GitHub 계정만 있으면 된다. GitHub 계정이 있다고 가정하고 시작해보자.

Step1. 테마 선택하기

웹사이트 접속 : https://github.com/topics/jekyll-theme

마음에 드는 테마를 선택

Step2. 블로그 설정하기

우측 상단에 Fork 버튼을 클릭

Repository name = user ID(자신의 아이디).github.io 로 설정

_config.yml 클릭

• _config.yml은 블로그 화면의 구성에 대한 정보가 담겨있다.

우측 상단 Edit this file 클릭

url : "https://user_ID.github.io 로 바꾸기"

우측 상단 Commit changes... 클릭

변경 내용 등 기입하고 싶은 내용을 적은 후 Commit changes 클릭

Step4. 블로그 확인하기

결과, 다음과 같이 블로그가 생성된 것을 확인할 수 있다.

2. 포스트 작성하기

GitHub 페이지로 돌아와서 우측 상단 Add file -> create new file 클릭

좌측 상단에 _posts/년-월-일-제목.md 입력

https://jekyllrb.com/docs/posts/
위의 사이트에 있는 예시를 참고하자.

다음과 같이 글을 남기고 Commit changes 클릭

추가 설명이 있다면 추가하고 Commit changes 클릭

문제

작성한 글이 올라가지 않아서 댓글을 확인해보니 다음과 같은 댓글이 있었다.

_config.yml로 가서 따라해보았다.

결과 다음과 같이 추가된 것을 확인할 수 있다.

3. 소스 코드 올리기

이번에는 Jupyter Notebook에서 작업한 파일을 바로 업로드해보자.

올리고 싶은 소스코드를 다운로드

년-월-일-제목.md 형태를 유지하되 가능한 영어로 작성하는 것이 좋다.

포스트 업로드 했던 파일로 돌아와서 Add file -> Upload files 클릭

파일 끌어온 후 Commit changes 클릭

다음과 같이 파일이 올라간 것을 확인할 수 있다.

제목 바꾸기

저장한 마크다운(.md)파일 제목이 아닌 다른 제목으로 바꾸려면 어떻게 해야할까?

_posts 폴더 -> 바꾸고 싶은 글 -> Edit this file 클릭

다음과 같이 제목을 설정하고 Commit chaanges 클릭

추가 설명 기재 후 Commit changes 클릭

다음과 같이 제목이 변한 것을 볼 수 있다.

총평 및 한계점

글을 올리거나 수정하는 것은 Latex과 유사한 느낌이 들었지만, 다음과 같이 latex 문법이나 사진 첨부는 바로 적용되지 않는다는 한계점이 존재한다. 이 부분에 대해서는 다음번에 포스트하도록하고 마친다.

출처

깃헙(GitHub) 블로그 10분안에 완성하기 - 테디노트 TeddyNote