Skip to content
Static site generator


Static site generator.


  • a configuration file
  • markdown files
  • jinja2 templates
  • any other file that should be published as-is


  • a site with the same structure as the input


apt install python3-tz python3-unidecode python3-markdown python3-toml \
            python3-yaml python3-jinja2 python3-dateutil python3-livereload

python-slugify is currently not in Debian, please package it. At the moment a copy of it is found in staticsite/slugify/.

Quick start

Example steps to create a new post, seeing it in the live preview, and build the site ready to be published:

  1. Start a preview of the site: ssite serve example
  2. Open http://localhost:8000 in the browser.
  3. Create a new post: ssite new example
  4. Save the new post, it automatically appears in the home page in the browser.
  5. Finally, build the site: ssite build example
  6. The built site will be in example/web ready to be served by a web server.

Useful tips:

  • keep your browser open on ssite serve for an automatic live preview of everything you do
  • you can use python3 -m http.server 8000 --bind to serve the result of ssite build and test your website before publishing
  • a quick rsync command for publishing the site: rsync -avz example/web/ server:/path/to/webspace

Index of the documentation


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see


Enrico Zini

Something went wrong with that request. Please try again.