This is a Jekyll theme created for Aista Ltd, and more specifically Magic Cloud to document our project(s). If you want to use it for your own site, you're welcome to do so under the terms of Creative Commons Attribution-ShareAlike version 4, implying you'll have to keep the link to our web site. Below is a screenshot of the theme in use over at Magic Cloud's documentation site.
The theme works perfectly for your GitHub Page, and in fact it was explicitly created to document our own open source framework Magic Cloud, and the theme is created with a "content first" approach, implying content over functionality, which of course is important for a site intended to document an open source framework such as Magic.
To use the theme add something resembling the following to your YAML configuration file "_config.yml".
# The next line declares you want to use this theme
# The next line declares the URL structure of your blog items
# Title of your site
title: Title of your site
# Slogan of your site
slogan: Slogan of your site
# Description of your site
description: This is the description for your site
# Google Analytics tracking code
# Copyright displayed in the bottom right corner
copyright: © Foo, Ltd 2022
# Most Wanted Response, most important link on your site
mwr_text: Foo 1
# Background images for banner and the main body/content parts of your site
# Open Graph image for pages when shared on Facebook or Twitter, etc
# Your navigation section. Declares the drop down menu items for your hamburger menu.
- name: Section 1
- url: /section-1/foo
name: Foo 1
- url: /section-1/bar
name: Foo 2
- name: Section 2
- url: /section-2/
name: Another foo
remote_theme parts needs to be exactly as above, the rest is intended for configuring your site, and include
Google Analytics tracking codes, MWR ("Most Wanted Response", a link on your site being the most important navigation hyperlink),
and navigation sections, etc. The navigation sections becomes a navbar that you can toggle at the top of your page
using a hamburger button. If you don't provide an MWR, and/or a
nav_section, these elements will not be rendered.
The theme is blog aware, assuming you save your blog posts into your "_posts" folder. To list your blog items, create a Markdown page and store at your root folder and name it for instance "blog.md", and fill it with the following content.
Some descriptive spiehl here for your blog ...
To create a single blog item, create a file called for instance "2022-01-04-new-documentation-website.md" and store it into your "_posts" folder and fill it as follows.
author: john doe
Bananas are _cool_ because they can be eaten.
If you do the above, you can go to your site with the relative URL of
/blog/ to see a list of your blogs.
To create custom pages, you can create a markdown file such as the following and store under for instance a "misc" folder.
# About our amazingly cool website
This website is like the coolest website in the world, because it features Bananas!
The theme is freely available as open source under the terms of the Creative Commons Attribution-ShareAlike 4.0 license.