Woodcut For Linux

Woodcut is an app for building static websites from Mako source files. It will walk your source directory, process any templates it finds, and produce a complete website in the build directory, ready to rsync to your webserver.

By making each page a Mako template, Woodcut gives you the hands-on simplicity of directly editing the HTML file as well as the full power of templates. You can use mako inheritance to factor out site layout and navigation in other, global templates. You can use inheritance chaining and callable blocks to build arbitrarily complex site structures.

Any file that ends in .mako is considered a template, and will be rendered as a corresponding file in the build directory (but will drop the .mako extension). The entire directory structure of the source directory is replicated in the build directory, and all non-template files appear in the build directory as symlinks to their source files (or optionally, full copies). Since each template lives within the directory structure in the same place that it's resulting page will go, relative paths work in the source files as they do in the built files.

Templates are most commonly used to generate HTML files, but they can just as easily be used to generate .htaccess, CSS, Javascript, or any other file types that may be part of your finished website.

- Fast to serve - Extremely basic server requirements - Simple and secure - Clone and prototype with ease - Access the site from local filesystem if you want (for development, archival, etc.)

- Define boilerplate code in one place - Programatically generate repetitive code - Embed python code to auto-generate site maps or indexes - Import other python modules such as Markdown or typogrify

- Leverage source control for your websites - Write content in your text editor, not a web interface - Be hands-on with your code — No CMS to get in your way

Installation

If you have pip available:

 pip install woodcut

Otherwise, download the latest tag, and run:

 python setup.py install

Usage

You can try it on the example source tree.

mbp:woodcut luke$ cd example/ mbp:example luke$ woodcut build src/ build/ Rendering htaccess.conf Rendering index.html Rendering foo.html

You will find the files rendered in the build directory.