complexity 0.4

A refreshingly simple static site generator, for those who like to work in HTML.

A refreshingly simple static site generator, for those who like to work in HTML.

Of course, @pydanny (https://twitter.com/pydanny) came up with the name for this.

Documentation

The full documentation is at http://complexity.rtfd.org.

Quickstart

Try it out:

$ pip install complexity
$ git clone [e-mail]:audreyr/complexity-example.git my_proj
$ cd my_proj
$ complexity project/ www/

Open a web browser to http://127.0.0.1:9090 to see the newly generated Complexity static site.

Features

• Works on Python 2.6, 2.7, and 3.3.

• Takes simple HTML templates as input.

• Template inheritance, filters, etc. (Brought to you by Jinja2.)

• Data from .json files turns into template context data.

Best Used With

Complexity is designed to be used with these packages:

• Simplicity: Converts ReStructuredText into JSON, which Complexity can use as input.

• A Lot of Effort: Deploys a static website (e.g. the output of Complexity) to Amazon S3.

• Cookiecutter: Creates projects from project templates.

Sure, they could have all been built into Complexity, but decoupling them seemed like a nice thing to do.

Community

You can help make Complexity even better:

• Contribute issues or pull requests. Instructions: https://github.com/audreyr/complexity/blob/master/CONTRIBUTING.rst

History

0.4 (2013-07-19)

• Project layout is now:

  my_repo/
  ├── project/       <--------- input
  │   ├── assets/
  │   │   ├── css/
  │   │   ├── js/
  │   │   └── img/
  │   └── templates/
  │       ├── base.html
  │       ├── index.html
  │       └── about.html
  └── www/          <---------- output (generated)
      ├── index.html
      ├── about/
      │   └── index.html
      ├── css/
      ├── js/
      └── img/

• Assets are copied over to www/ during site generation.

• If the www/ directory was previously created, it prompts the user and then deletes it before site regeneration.

• Templates starting with base are not generated as individual pages. They are meant to be extended in other templates.

0.3 (2013-07-18)

• Graceful shutdown/restart of dev server.

• Required input and output dir arguments.

• Optional port argument.

• Improved server start/stop messages.

• Major internal refactor.

0.2.1 (2013-07-15)

• Fixes to setup.py.

0.2.0 (2013-07-15)

• Data from .json files now gets read as template context data.

• Tested (and passing!) on Python 2.6, 2.7, 3.3, PyPy.

0.1.1 (2013-07-10)

• First release on PyPI.