주의: GitHub Pages와 Jekyll에 대해서 충분히 숙지할 것. 주의: Collaborating on projects using issues and pull requests을 정독.
https://github.com/kakao/kakao.github.io 에 push 권한이 있다면:
- git fetch or pull or clone
- Jekyll 설치
$ git clone [email protected]:kakao/kakao.github.io.git
$ cd kakao.github.io
$ bundle install
https://github.com/kakao/kakao.github.io 에 push 권한이 없다면:
- https://github.com/kakao/kakao.github.io 에서
Fork
버튼 클릭하고, - 포크 저장소 계정(maybe 개인 계정) 선택
- git fetch or pull or clone
- 포크 설정 Configuring a remote for a fork
- 포크 동기화 Syncing a fork
- Jekyll 설치
$ git clone [email protected]:YOUR_GITHUB_ACCOUNT/kakao.github.io.git
$ cd kakao.github.io
$ git remote add upstream [email protected]:kakao/kakao.github.io.git
$ git fetch upstream
$ git checkout master
$ git merge upstream/master
$ bundle install
$ bundle exec jekyll serve
$ open http://localhost:4000
https://github.com/kakao/kakao.github.io 에 push 권한이 있다면:
$ git commit -m '...'
$ git push origin master
https://github.com/kakao/kakao.github.io 에 push 권한이 없다면:
- Fork 동기화 Syncing a fork
- Pull Request 보내기 Creating a pull request
_drafts
디렉토리에적당한이름.md
이름으로 파일을 만들고- 포스트를 마크다운으로 작성
- 확인
$ bundle exec jekyll serve --drafts
_posts
디렉토리에yyyy-mm-dd-slug.md
파일로 복사(or 이동).
- slug: 해당 포스트의 고유 키로 url의 일부로 사용. 왠만하면 특수문자없이 영문자,숫자,-(하이픈),.(점)...만 사용.
- yyyy,mm,dd: 발행 년,월,일.
- 참고: 최종적으로 포스트의 url(permalink)는 http://tech.kakao.com/yyyy/mm/dd/slug/
- 파일 상단에 front matter 작성
- layout: post # 레이아웃(필수).
page
레이아웃을 사용하면 목록에 보이지 않는 글을 쓸 수 있음. - title: '제목' # 제목(필수)
- author:
lastname.firstname
# 필자(필수). 왠만하면 회사 아이디(예: iolo.fitzowen) 사용 - tags:
[tag1,tag2,tag3,...]
# 태그 목록(선택). 왠만하면 특수문자없이 영소문자,숫자,-(하이픈),.(점)...만 사용. - image: http://... # 커버이미지 url(선택)
- date:
YYYY-MM-DD HH:MM:SS
# 발행일(필수)
- 처음 글을 쓰는 필자이라면 글쓴이 등록(필수)
- 유력한(?) 태그가 새로 등장했다면 태그 등록(선택)
_authors
디렉토리에lastname.firstname.md
이름으로 필자 정보 파일 추가
- 참고: 최종적으로 사용자 포스트 목록 페이지의 url은 http://tech.kakao.com/authors/lastname.firstname/
- 파일 상단에 front matter 작성
- layout: author # 레이아웃(필수)
- name:
lastname.firstname
# post의 author와 매칭(필수). 왠만하면 회사 아이디(예: iolo.fitzowen) 사용. 왠만하면 특수문자없이 영소문자,숫자,-(하이픈),.(점)...만 사용. - title: ... # 왠만하면 한글이름 사용( 필수)
- image: http://... # 프로필 이미지(필수)
- cover: http://... # 작성자 커버 이미지(선택)
- 내용은 필요없음
_tags
디렉토리에tag-name.md
이름으로 필자 정보 파일 추가
- 참고: 최종적으로 사용자 포스트 목록 페이지의 url은 http://tech.kakao.com/tags/tag-name/
- 파일 상단에 front matter 작성
- layout: tag # 레이아웃(필수)
- name:
tag-name
# post의 tags 배열의 항목과 매칭(필수). 왠만하면 특수문자없이 영소문자,숫자,-(하이픈),.(점)...만 사용. - title: ... # 좀 더 길고 구체적인 설명(필수)
- image: http://... # 태그 이미지(선택)
- 내용은 필요없음
May the SOURCE be with you...
This software is licensed under the Apache 2 license, quoted below.
Copyright 2017 Kakao Corp. http://www.kakaocorp.com
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Kakao fonts(/assets/fonts/) are fonts for Kakao brands and are not available for other uses.
카카오 폰트(/assets/fonts/)는 카카오 브랜드용 서체로 다른 용도로는 이용할 수 없습니다.