Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Quick Site Generator - Static site generation in a single file

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 README
Octocat-spinner-32 ez_setup.py
Octocat-spinner-32 qsgen
Octocat-spinner-32 setup.py
README
qsgen
=====

qsgen is a Python static site generator. It uses a set of
Mako input templates and outputs a static site. qsgen also has builtin
support for code documentation and commenting with highlight generation
using Pygments

== Installing ==

 python setup.py install

All dependencies should be dealt with automatically.

== Features ==

 * Mako templating - by default all .html files are transformed by
  Mako

 * Pygments syntax highlighting builtin via ${pygment("print
  'Hi'")} or file references via pygment_file

 * Copies non-transformed files into the destination directory
  directly.

 * No configuration files to write, no rigid structure to follow.


== Usage ==

qsgen accepts only two command line parameters - the desination
directory, and optionally the source directory.


 qsgen /var/www /home/user/sitesource


qsgen will attempt to copy all files which are not .html files. It
will also by default NOT copy files beginning with an underscore
(_base.html for instance), which it considers to be private templating
files. This closely mimics Python's approach to 'private' class
methods.
Something went wrong with that request. Please try again.