cagen 0.1.0a1.dev11

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 GPL 2-only license.

How it runs

It assumes your documents are written with markdown syntax. It is capable of convert those documents to any other format, using pandoc (specifically pypandoc wrapper) and Mako templating system.

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

The program just converts markdown files to HTML ones by default in the same directory. Unlike many other static site generators, there is no predefined structure by default: no assets directory neither 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

Other resources

• You can see the issue tracker and contribute if you want suggesting new features or reporting a bug.
• The API documentation of libcagen i available.