Central

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.

Demo

Base Prime Primer

Get started

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 %}
```

Activating GitHub Pages

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>.

Writing content

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.

Getting help

Having trouble with GitHub Pages ?
Lets discuss about it, or contact support to sort it out.

Sponsor

❤️ If you use this work and liked it, please consider supporting development.

License

MIT licensed - nikahmadz

nikahmadz / central