GitHub - ourtreering/ourtreering.github.io

💚 CJ올리브영 기술 블로그

안녕하세요. 건강한 아름다움을 제안하는 No.1 H&B 스토어, 올리브영의 개발팀이 운영하는 기술 블로그입니다.

우리 블로그는 GitHub Pages와 Jekyll을 사용하여 퍼블리싱하였으며, 마크다운 문법을 사용하여 글을 작성합니다. 해당 문서에서는 Jekyll 기반의 블로그 운영을 위한 환경구성 방법부터 마크다운 작성을 통한 블로그 포스팅 방법 등을 설명합니다.

터미널에서 git clone https://github.com/oy-alldev/oy-alldev.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 oy-alldev.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 등의 폴더를 생성하여 넣어주는 편이 깔끔합니다.
블로그 서버가 실행되어 있는 경우 브라우저에서 실시간으로 포스트 미리보기가 가능합니다.

터미널에서 프로젝트 경로로 이동합니다.
git add . 명령어를 통해 추가/수정 된 전체 파일을 changes list에 추가해줍니다. (일부 파일만 추가하고싶은 경우 git add [파일명] 명령어를 통해 일일이 추가할 수 있습니다.)
git commit -m "[커밋 메시지]" 명령어를 통해 커밋 메시지를 입력해줍니다. 커밋 메시지는 팀 내 컨벤션에 맞게 작성합니다.
git checkout -b feature/[브랜치명] 명령어를 통해 신규 branch를 생성해줍니다. 브랜치명은 폴더명 등 구분 가능한 이름으로 팀 내 컨벤션에 맞게 작성합니다.
git push -u origin master 명령어를 통해 코드를 푸시합니다.

문화를 만듭니다. CJ ❤️💛💙