Github Pages

$Background header for Shoseki, a fractal that was pushed through Googles' Deep Dream$

Rules of building on github pages :

Create an entirely public repository on github.com named YOURACCOUNTNAME.github.io .
No server side component so pages must be regenerated each time.
Private files may be uploaded but they will need to be encrypted (e.g. using Ansible Vault)
This means API keys etc will need to be stored in Ansible Vault before being consumed by Ansible, they cannot be made public due to abuse potential.
No mysql or other database, so data will need to be stored in sqlite or equivalent, or json file to be queried client side.
As the build is automatic, the commit message has been set to the build id.
This entire project is public and cloneable, feel free to create a copy and create your own website using it!

Install git, ansible and npm on your local machine.
To test that everything is set up correctly, you should be able to run "ansible-playbook --version", "git --version" and "npm --version"
Fork the repository.
Clone a local copy of your repository by using the git clone command on the command line.
Change directory into the project by typing "cd project-name"
You can now create/edit/delete the data used to generate the pages in ansible/variables/site.yml and ansible/variables/page/pagename.yml. One caveat is that each page must have a unique "machine name" key at the top of the structure for the files to not clash when they automatically get stitched together to create content.
Once you have finished editing, to regenerate the site, from the root folder type "ansible-playbook ansible/commands/regenerate_site.yml".
Warning! This will git add everything in the folder, commit and push! Do not add anything private to this repo or else it will automatically be made public, and you will need to delete the repository and start again.