cagen 0.1.0a1.dev9

A static site generator for cmpalgorithms project

cagen

About

cagen is a static site generator intented for cmpalgorithms project. So it's very rare you are interested in that.

License

The software is distributed under GPL2-only license.

How it runs

It assumes your documents are in markdown syntax. It is capable of convert those documents in any other format, using pandoc (specifically pypandoc wrapper) and Mako Templating System.

The reason to use "external" templating sytem instead of built-in pandoc templat system is because pandoc templates are not capable to make conditions with values (something like $if(author=='me') Print full name here $endif$).

The program just convert markdown files to HTML ones by default in the same directory. There is no predefined structure by default unlike many other static site generators do: no assets directory nope site directory. By default, all generated files are in the same directory than the source files. Obviously, you can modify it if you want.

We provide:

• a library
• a command line program for convert documents
• a script called cagen-make to generate a Makefile to convert automatically all markdown files to HTML ones.

The software is implemented in python because it's easy to program (I'm very language-neutral). If you want some really fast static site generator, be free to fork the project and program with any compiled language.

Installation

You can install via pip:

pip install cagen

Issue tracker

You can see the issue tracker and contribute if you want suggesting new features or reporting a bug.