Welcome
Coming soon!
More information coming soon. Stay tuned as we continue to build and enhance the site.
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
docs
folder. - Edit site settings in
_config.yml
file according to your project. !!!baseurl
should be your website’s relative URI like/my-proj
!!! - Replace
favicon-truck.ico
andassets/img/log-minetruck.png
with your own logo.
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
.
- Previous
- Next