Welcome
Getting started
GitHub Pages can automatically generate and serve the website for you.
Let’s say you have a username/organisation my-org and project my-proj; if you locate Jekyll source under docs folder of master branch in your repo github.com/my-org/my-proj, the website will be served on my-org.github.io/my-proj.
The good thing about coupling your documentation with the source repo is, whenever you merge features with regarding content to master branch, it will also be published on the webpage instantly.
- Just download the source into your repo under
docsfolder. - Edit site settings in
_config.ymlfile according to your project. !!!baseurlshould be your website’s relative URI like/my-proj!!! - Replace
favicon.icoandassets/img/logonav.pngwith your own logo.
GitHub Pages는 자동으로 웹사이트를 생성하여 제공할 수 있습니다. 사용자 이름/조직이 my-org 이고 프로젝트가 my-proj 라고 가정할 때, master 브랜치의 문서 폴더 아래에 있는 지킬 소스를 리포지토리 github.com/my-org/my-proj에서 찾으면 웹사이트가 my-org.github.io/my-proj에 서비스됩니다. 문서를 소스 리포지토리에 연결하면 좋은 점은 마스터 브랜치에 관련 콘텐츠를 병합할 때마다 웹페이지에도 즉시 게시된다는 것입니다.
docs폴더 아래의 리포지토리에 소스를 다운로드 하기만 하면 됩니다.- 프로젝트에 따라
_config.yml파일에서 사이트 설정을 편집합니다. !!!baseurl은/my-proj와 같은 웹사이트의 상대 URI여야 합니다 !!! favicon.ico및assets/img/logonav.png를 고유 로고로 바꿉니다.
Writing content
Docs
Docs are collections of pages stored under _docs folder. To create a new page:
1. Create a new Markdown as _docs/my-page.md and write front matter & content such as:
---
title: My Page
permalink: /docs/my-page/
---
Hello World!
2. Add the pagename to _data/docs.yml file in order to list in docs navigation panel:
- title: My Group Title
docs:
- my-page
Blog posts
Add a new Markdown file such as 2017-05-09-my-post.md and write the content similar to other post examples.
Pages
The homepage is located under index.html file. You can change the content or design completely different welcome page for your taste. (You can use bootstrap components)
In order to add a new page, create a new .html or .md (markdown) file under root directory and link it in _includes/topnav.html.