A static site generator for cmpalgorithms project
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cagen-0.1.0a1.dev8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5ef3722975b8257d8cfd6460a2e31d5ad2953a828a7e2e712ae90cecd2d9da48 |
|
MD5 | 6a0be31c2672d34732654570dac56328 |
|
BLAKE2b-256 | 9a42dd37d1c36fe888be4c1955f79c2869863541b5eac504e24cfd37ee20abd4 |