Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
A tool to generate static HTML pages using templates and markup sources http://derdon.github.com/swsg/index.html
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
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 (http://bitbucket.org/tiax/sr/overview). 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 and sass 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 (PIDA: http://pida.co.uk/) - web interface - possibly a GTK+ or Qt application, but I think using the PIDA-Plugin is more comfortable Requirements - Python: http://python.org/download - either version 2.7 or version 2.6 with the python package argparse (http://pypi.python.org/pypi/argparse) installed - texttable: http://pypi.python.org/pypi/texttable/ - py: http://pypi.python.org/pypi/py - logbook: http://packages.python.org/Logbook - at least one of the following markup languages, installed as a python package: - ReST (the corresponding python package is called "docutils"): http://pypi.python.org/pypi/docutils - markdown: http://pypi.python.org/pypi/Markdown - creole: http://pypi.python.org/pypi/creole - textile: http://pypi.python.org/pypi/textile - optional: one or more of the following template engines, also installed as python packages: - Jinja2: http://pypi.python.org/pypi/Jinja2/ - Mako: http://pypi.python.org/pypi/Mako - Genshi: http://pypi.python.org/pypi/Genshi Installation Enter the command "python setup.py install" (the file setup.py is the file which can be found in the same directory as this README file). That's it! Continue with the next section "Usage" to learn how to use SWSG. Usage See http://packages.python.org/swsg for a detailed documentation. License WTFPL, see COPYING in this folder for details. Bugs If you find a bug, please search for an existing issue that matches your problem before opening a new issue to avoid duplicates. Bug reports can be written at http://github.com/derdon/swsg/issues/ Contact github account: http://github.com/derdon email: firstname.lastname@example.org Jabber: email@example.com IRC Channel on FreeNode (irc.freenode.net): #swsg