pyblue 3.0.1

PyBlue

A simple static site generator.

Why another one? There are many static site generators already. I found to be way too complicated, they have too many rules, put this here or there, call thing this or that.

PyBlue is different. Everything is optional, only use what you need. Stays out of the way.

From the simplest tasks:

• No configuration required.

• Works with any existing site.

• Easy to include markdown.

• Easy linking to other pages.

• Tiny codebase, pyblue is around 500 lines in a single file!

To more complicated:

• PyBlue generates the correct links even if you move pages around.

• Use Django Templates and all the features that it offers.

• Easily add data into each page (title, link name, or any arbitrary content).

Or go all the way out:

• Load python modules into each page.

• Exposed data: database queries, results of online requests etc.

• Run python code, access and modify data from inside of each page.

• Extend the Django templates. Add your own templatetags.

Install

pip install pyblue --upgrade

Or download it from the PyBlue at PyPI.

Usage

Launch pyblue to serve a directory

pyblue -r docs

View your site by visiting http:://localhost:8080

Edit your pages and make changes. Reload the page to see your edits live. Generate static output with:

pyblue -r docs -o html

That’s all. Told you it was simple. To see extra help on options run:

pyblue -h

Documentation

• The PyBlue Documentation was generated with PyBlue itself.

You can also browse the help in source format for examples.

Licensing

• PyBlue is being developed by Istvan Albert see https://github.com/ialbert

• PyBlue has been inspired by PyGreen created by Nicolas Vanhoren see https://github.com/nicolas-van

• PyBlue uses the MIT license.