About
=====
swsg (static web site generator) is a tool to create static websites using
human-readable markup languages like ReST_. It was highly-inspired by SR_.
The advantage of SWSG against directly using (X)HTML files is that you have one
(or more) templates and do not have to rewrite every your main layout on ebery
single site. You can concentrate on the main content: the text; the content is
seperated from the templates.
Features
========
- supports many markup languages: Markdown_, Creole_, Textile_, ReST_
- supports many template engines: Jinja2_, Mako_, Genshi_, and also a very
simple template language for those who do not need control structures like
loops or if-conditions
- supports clevercss_ beside the usual CSS as a markup language for the
stylesheets
- provides multiple interfaces: until now, only a CLI is implemented, but
others are planned:
- PIDA_-Plugin
- web interface
- possibly a GTK+ or Qt application, but I think using the PIDA-Plugin is
more comfortable
Requirements
============
In order to be able to install swsg, you need `Python`_ (version 2.7 or
2.6 with the Python package `argparse`_ installed) and the
following Python packages:
- texttable_
- py_
- Logbook_
- CleverCSS_
- at least one of the following markup languages: ReST_, markdown_,
creole_, textile_
- optional: one or more of the following template engines: jinja2_, mako_, genshi_
.. _ReST: http://docutils.sourceforge.net/rst.html
.. _SR: http://bitbucket.org/tiax/sr/overview
.. _markdown: http://daringfireball.net/projects/markdown/
.. _creole: http://www.wikicreole.org/
.. _textile: http://textile.thresholdstate.com/
.. _jinja2: http://jinja.pocoo.org/2/
.. _mako: http://www.makotemplates.org/
.. _Genshi: http://genshi.edgewall.org/
.. _clevercss: http://sandbox.pocoo.org/clevercss/
.. _PIDA: http://pida.co.uk/
.. _argparse: http://code.google.com/p/argparse/
.. _texttable: http://pypi.python.org/pypi/texttable
.. _py: http://pypi.python.org/pypi/py
.. _Python: http://python.org
.. _Logbook: http://packages.python.org/Logbook