SiteFab: state of the art static website generator for humans
Getting Started in 30 seconds
Here is how to install SiteFab, Create a new site and compile it in less than 30 seconds:
# install the main package
pip install sitefab
spacy download en_core_web_sm
pip install -U spacy-lookups-data
# clone the site template as base
git clone https://github.com/ebursztein/sitefab-template.git mysite/
# clone the plugins in your site directory
git clone https://github.com/ebursztein/sitefab-plugins.git mysite/plugins
# generate your shiny new site
sitefab -c mysite/config/sitefab.yaml generate
Et voila! you know have a fully fonctional site that can be statically compiled. As the next step you should add your content, customize the html templates and tweak the plugins configuration to your liking!
Key Features
Here are some of the key highlevel functionalities that makes SiteFab the static generator of choice for modern websites:
- State of the art images processing stack: The images stack generate out of the box all you need to use image in optimal fashion including: reactive images for the
<picture>element, webp versions for the browsers who support it, frozen thumbnail for the loading and cropped thumbnails for previews. - Bleeding edge natural language processing stack: Leveraging the latest advance in NLP Sitefab offers: An accurate list of related posts (LSI algorithm), a client side faceted search and a smart client-side autocompletion
- Fully customizable: Its flexible plugin system and templatized parser make it easy and fast to customize SiteFab to your needs.
Design principles
Beside its technical features what separates SiteFab from other site generators is its guiding principles:
-
Configuration over convention: Every behavior is explictly specified. There are no special files or directories. SiteFab only do what the site configuration say. Nothing more, nothing less.
-
Content Agnostic: There is only one type of content called post. SiteFab makes no assumption about the content stored in the .md files. Its job is to apply the configuration specified in the frontmatter to render the specificied files and ensure that the enabled plugins are properly executed.
-
Atomicity: Each piece of content is self contained by having its own configuration in its frontmatter including which template to use. This allows to accomodate both complex sites with per page configuration and very simple ones that reuse the same template again and again.
-
Orthogonality: Site configuration, plugins and plugins configuration are independent of the core engine so you can use as many configurations and tweaked plugins you want. Additionally you can check those alongside with your site content to have reproducible build, safe rollbacks and concurrent version of the build pipeline (e.g alpha versus stable).
Alternatives
Here are some popular alternatives if SiteFab is not what you are looking for:
1 maintainer
Metadata
1 maintainer
Release files for sitefab 1.1.1613622175
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sitefab-1.1.1613622175.tar.gz | 41.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sitefab-1.1.1613622175-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 96.9 kB
Release files / sitefab-1.1.1613622175.tar.gz
| Download URL | sitefab-1.1.1613622175.tar.gz |
|---|---|
| Size | 41.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7db765f85340b970d1a998d73f2ac774323db0b1c502b721d9019897c280b18e
|
|
BLAKE2b-256 checksum How to use checksums |
9dd1e1b39d551a2a5101fcbec1497f1c9a25339f1f1f5805017946797f3405fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.1
|
Release files / sitefab-1.1.1613622175-py3-none-any.whl
| Download URL | sitefab-1.1.1613622175-py3-none-any.whl |
|---|---|
| Size | 55.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d0b5dede72dcd68c66d7994007668b015b59b0f018ae2966bca3d43e3cb995d
|
|
BLAKE2b-256 checksum How to use checksums |
7b0cee597a78d3570c6da0c6517c1d8ebf561e1cefaf782605e5377b9c8731d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.1
|
