A simple static site generator.
Why another one? There are many static site generators already. I found most to be way too complicated, too many conventions and rules: put this here or there, call it this or that. It was too tiring to keep up.
PyBlue is different. Everything is optional, nothing is required, use only what you need. It basically stays out of the way.
Simple things are very easy:
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!
Complicated tasks are easy:
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).
And you can go all the way out if you really want to:
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.
Documentation
The PyBlue Documentation was generated with PyBlue itself.
You can also browse the help in source format for examples.
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
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.
1 maintainer
Release files for pyblue 2022.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyblue-2022.8.1.tar.gz | 4.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyblue-2022.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.1 MB
Release files / pyblue-2022.8.1.tar.gz
| Download URL | pyblue-2022.8.1.tar.gz |
|---|---|
| Size | 4.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d1a9b36fd7cc14e47aa652e4d4c552796844116ffdd8b7c8b839f17e636ef306
|
|
BLAKE2b-256 checksum How to use checksums |
1e82ff15fc7c95f5c1660518e2f8e002004355c18adf5c7ef345739b1ecd0253
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.15
|
Release files / pyblue-2022.8.1-py3-none-any.whl
| Download URL | pyblue-2022.8.1-py3-none-any.whl |
|---|---|
| Size | 36.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
abb00bf8ee2eedded168e2470d12a1ac486c1ae110a41491ebf92ac992d88e31
|
|
BLAKE2b-256 checksum How to use checksums |
4ce8bc978e8d991b7af0202ada6175b49a77dd796a15c16a4d06f0179ce844c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.15
|
