Theme for GitHub Pages
Central helps you build websites on GitHub. You can write your content in Markdown, HTML and Liquid using any code editor you like. When you commit to your repository, GitHub Pages will build your website from the content of your repository files.
Begin with these files in your repository. Then, activate GitHub Pages to publish your website.
-
_config.yml
remote_theme: nikahmadz/central
-
index.md
{% include hero/1.html %}
-
404.md
{% include 404.md %}
- Go to GitHub Pages Settings of your repository:
//github.com/<user-name>/<repo-name>/settings/pages
- Scroll down to the Source section. Choose the source of your website files (where the
_config.yml
file is located) eg:main/(root)
- Hit Save.
- Your app will be accessible at
//<user-name>.github.io/<repo-name>
.
GitHub Pages uses Jekyyll to build your website from the content of your repository files. You can write your content in Markdown, HTML and Liquid using any code editor you like. Check out these articles to familiarize your self on the basics :
- GitHub Pages documentation
- Markdown syntax.
- Jekyll docs on front-matter, writing posts, and creating pages.
- Liquid syntax
example-page.md
---
title: "Page title"
description: "Short description on the article."
permalink: # (optional: permalink)
layout: # layout-name
theme: # theme-name
---
<style>/* define custom style using html syntax */</style>
# Header 1
## Header 2
### Header 3
Write paragraph using Markdown syntax.
Write in **Bold** and _Italic_ and `Code` text.
Apply custom styles using Liquid
{: .with-classes }
<div class="use-built-in-classes">With HTML syntax</div>
> Blockquote
- Bulleted
- List
1. Numbered
2. List
[Link](url)
[Footnote][^ref]
![Image](src)
{% include ready-made-blocks.html %}
{% assign variable = 'as you like' %}
add logics {% if variable %}to your site{% endif %}
More examples can be found in the docs folder.
Having trouble with GitHub Pages ?
Lets discuss about it,
or contact support to sort it out.
❤️ If you use this work and liked it, please consider supporting development.