🗺 Git Blog Link : https://kimyc1223.github.io
해당 블로그는 GitHub Pages와 Jekyll을 사용하여 퍼블리싱하였으며,
마크다운 문법을 사용하여 글을 작성합니다.
해당 문서에서는 Jekyll 기반의 블로그 운영을 위한 환경구성 방법부터
마크다운 작성을 통한 블로그 포스팅 방법 등을 설명합니다.
터미널에서 git clone git@github.com:KimYC1223/KimYC1223.github.io.git 명령어를 입력하여
프로젝트를 clone 받습니다.
만약 위 명령어를 입력했을 때 git을 찾을 수 없다는 오류가 발생한다면,
git 공식 사이트(Windows, macOS)에서 git을 설치한 뒤 터미널을 재실행하여 재시도해봅니다.
터미널에서 sudo gem install jekyll bundler 명령어를 입력하여 jekyll과 bundler를 설치합니다.
만약 잘 되지 않는다면 공식 사이트(Windows, macOS)에서 차근차근 따라하면 됩니다.
Jekyll on Windows 가이드 보고 기본적인 설치만 하는식으로 했는데,
가볍게 설치하거나 더 좋은 방법이 있다면 수정 부탁드립니다.
- 루비 공식 다운로드에서 WITH DEVKIT 2.4 버전 이상으로 다운로드 & 실행합니다.
- Agree - 다음 - 다음 - 설치 - 완료 후, Run 'ridk install 어쩌구' 체크박스 체크하여 Finish
- 자동으로 실행된 cmd 창에서
1입력하고ENTER→ base installer 설치 완료 후,ENTER입력하면 커맨드창 자동으로 꺼집니다. - 커맨드창 새로 실행하여
gem install jekyll bundler입력하여jekyll과bundler를 설치합니다. - 커맨드 창에서
jekyll -v입력시 아래와 같은 텍스트가 출력되면 정상적으로 설치 됐습니다!
jekyll 4.1.1 // jekyll 뒤의 버전은 다를 수 있습니다.터미널에서 프로젝트 경로로 이동한 뒤 하기 명령어들을 실행하여 로컬에 블로그를 띄워줍니다.
# 프로젝트 경로로 이동
$ cd KimYC1223.github.io
# 패키지 설치
$ bundle install
# 블로그 서버 실행
$ jekyll serve 안되면 $bundle exec jekyll serve위 과정에서 오류가 없었다면, 브라우저를 열어 http://127.0.0.1:4000/로 접속 시 로컬에서 블로그가 실행되는 것을 볼 수 있습니다.
앞으로는 jekyll serve 명령어를 실행하는 것만으로도 손쉽게 블로그를 실행할 수 있습니다.
마크다운 제너레이터 없이도 마크다운을 잘 작성한다면 설치하지 않아도 무관하나,
우리는 도구를 사용하는 영장류이기 때문에 툴을 사용하면 좋습니다.
Typora 공식 사이트에 접속하여 프로그램을 설치합니다.
- 작성하고자하는 폴더로 이동합니다. (테크노트:
tech/ 소소한 이야기:life) - 현재시간 기준으로
yyyymmddhhMM폴더를 생성합니다. (다른 폴더와 동명이지만 않으면 됩니다.) - 생성한 폴더 내에서
Typora나 메모장 등을 사용하여 마크다운 문서를 작성합니다. 포스트 내 이미지나 파일 첨부가 필요한 경우, 하위에img혹은file등의 폴더를 생성하여 넣어주는 편이 깔끔합니다. - 블로그 서버가 실행되어 있는 경우 브라우저에서 실시간으로 포스트 미리보기가 가능합니다.