static site generator
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
ddftwiki.github.io @ 88c6916
resources/templates
src/cryogen
.gitignore
.gitmodules
How To Develop The Site.txt
LICENSE
LICENSE.code
LICENSE.content
Makefile
Puzzles Feature Documentation.txt
README.md
how to manually update the live site from a windows computer.txt
project.clj

README.md

ddft.wiki

Source code for ddft.wiki. We use a system called Cryogen to generate the site. A quick overview is here.

To build locally

lein run

To test locally

lein ring server

Deployment to ddft.wiki

CircleCI

When we push changes to the master branch of this repository, an automatic build is kicked off via CircleCI. This executes lein run and then pushes the resulting files to our ddftwiki/ddftwiki.github.io repo. This causes github pages (who hosts the site backing ddft.wiki) to publish a new version of our site.

Configuration

The config file is at resources/templates/config.edn1. This controls some misc SSG stuff. You shouldn't need to modify this.

Templates

You can find templates at resources/templates/themes/ddftwiki/. They use Selmer for a (a django/jinja/liquid/twig-style) templating system. Look at the examples and ask emidln if you have questions.

Markdown

For basic syntax and a test console, see: https://rawgit.com/yogthos/markdown-clj/master/demo/markdown.html

For our actual implementation, see: https://github.com/yogthos/markdown-clj.

Pages

You can find pages at resources/templates/md/pages/. They are written in Markdown.

Posts

You can find blog posts at resources/templates/md/posts/. They are written in Markdown.

License

Content

License: CC BY 4.0

The website content of this project is licensed under the Creative Commons Attribution 4.0 as found in the LICENSE.content file.

Code

License

The software source code of this project is licensed under the Eclipse Public License 1.0 as found in the LICENSE.code file.