A refreshingly simple static site generator, for those who like to work in HTML.
Project description
A refreshingly simple static site generator, for those who like to work in HTML.
Documentation
The full documentation is at http://complexity.rtfd.org.
Quickstart
Try it out:
$ pip install complexity $ git clone git@github.com:audreyr/complexity-example.git my_proj $ cd my_proj $ complexity project/ www/
Once you’ve done that, 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, and on PyPy.
Takes simple HTML templates as input.
Data from .json files turns into template context data.
Template inheritance, filters, etc. (Brought to you by Jinja2.)
Auto-expands .html file URLs into cleaner URLs (e.g. about.html gets expanded to /about/)
Can optionally be used as a library instead of from the command line. See Using Complexity as a Library for details.
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
Stuck? Don’t know where to begin? File an issue and we’ll help you.
We love contributions. Read about how to contribute.
History
0.5 (2013-07-25)
Improved static site generation API - better parameters are used.
Files in the root of assets/ (or the asset directory) now get copied over to the output.
Much more documentation.
0.4.2 (2013-07-21)
Make reading of JSON files from json/ optional.
0.4.1 (2013-07-19)
Fix reading of JSON files from json/.
0.4 (2013-07-19)
Project layout is now:
my_repo/ ├── project/ <--------- input │ ├── assets/ │ │ ├── css/ │ │ ├── js/ │ │ └── img/ │ ├── json/ │ │ └── stuff.json │ └── 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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file complexity-0.5.tar.gz.
File metadata
- Download URL: complexity-0.5.tar.gz
- Upload date:
- Size: 10.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 778416ad6397faa2d128a17115eca7c0d1083ccf7a57652b0e7c0d479de1b7a1 |
|
| MD5 | d5a62560d44782262f8d622654cb8f3b |
|
| BLAKE2b-256 | 686f9d80c362adacf65c5413234154c9adb65a3804661099282159bbdcbab24a |
