김영찬의 개발 블로그

🗺 Git Blog Link : https://kimyc1223.github.io

해당 블로그는 GitHub Pages와 Jekyll을 사용하여 퍼블리싱하였으며,

마크다운 문법을 사용하여 글을 작성합니다.

해당 문서에서는 Jekyll 기반의 블로그 운영을 위한 환경구성 방법부터

마크다운 작성을 통한 블로그 포스팅 방법 등을 설명합니다.

---

📖 목차

• 환경구성

  1. 프로젝트 clone
  2. Jekyll 설치
  3. 로컬에 블로그 실행

• 블로그 포스팅

  1. Typora 설치 (옵션)
  2. 글-작성

---

⚙️ 환경구성

프로젝트 clone

터미널에서 git clone git@github.com:KimYC1223/KimYC1223.github.io.git 명령어를 입력하여

프로젝트를 clone 받습니다.

만약 위 명령어를 입력했을 때 git을 찾을 수 없다는 오류가 발생한다면,

git 공식 사이트(Windows, macOS)에서 git을 설치한 뒤 터미널을 재실행하여 재시도해봅니다.

Jekyll 설치

터미널에서 sudo gem install jekyll bundler 명령어를 입력하여 jekyll과 bundler를 설치합니다.

만약 잘 되지 않는다면 공식 사이트(Windows, macOS)에서 차근차근 따라하면 됩니다.

Windows Jekll 설치

Jekyll on Windows 가이드 보고 기본적인 설치만 하는식으로 했는데,

가볍게 설치하거나 더 좋은 방법이 있다면 수정 부탁드립니다.

1. 루비 공식 다운로드에서 WITH DEVKIT 2.4 버전 이상으로 다운로드 & 실행합니다.
2. Agree - 다음 - 다음 - 설치 - 완료 후, Run 'ridk install 어쩌구' 체크박스 체크하여 Finish
3. 자동으로 실행된 cmd 창에서 1 입력하고 ENTER → base installer 설치 완료 후, ENTER 입력하면 커맨드창 자동으로 꺼집니다.
4. 커맨드창 새로 실행하여 gem install jekyll bundler 입력하여 jekyll과 bundler를 설치합니다.
5. 커맨드 창에서 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 설치 (옵션)

마크다운 제너레이터 없이도 마크다운을 잘 작성한다면 설치하지 않아도 무관하나,

우리는 도구를 사용하는 영장류이기 때문에 툴을 사용하면 좋습니다.

Typora 공식 사이트에 접속하여 프로그램을 설치합니다.

글 작성

1. 작성하고자하는 폴더로 이동합니다. (테크노트: tech / 소소한 이야기: life)
2. 현재시간 기준으로 yyyymmddhhMM 폴더를 생성합니다. (다른 폴더와 동명이지만 않으면 됩니다.)
3. 생성한 폴더 내에서 Typora나 메모장 등을 사용하여 마크다운 문서를 작성합니다. 포스트 내 이미지나 파일 첨부가 필요한 경우, 하위에 img 혹은 file 등의 폴더를 생성하여 넣어주는 편이 깔끔합니다.
4. 블로그 서버가 실행되어 있는 경우 브라우저에서 실시간으로 포스트 미리보기가 가능합니다.

---