Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Tools for working with pure HTML static sites

Project Description

Experiment: going all in on a static site, where pure HTML is the only storage format using semantic HTML5 and microdata.

Currently developed and tested only on Python 3, although some effort has been made to keep backporting easy if necessary.

WARNING: changes highly likely until it hits 1.0…


  • Command-line tools used to manage a static site which will be uploaded to something supported by Apache libcloud — currently tested with Rackspace Cloud Files.
  • No template language is assumed, avoiding any impedance mismatches between modern HTML and the tooling or the need to have anything other than a browser to render pages. What you test is what you get.
  • HTML templates can be developed live in a browser; all content with the placeholder class will be removed by the apply-template command.
  • No attempt is made to provide change tracking – it’s highly recommended that you use Git, Mercurial, etc. on the site base directory instead.

Getting Started


  • pip install simple-cloud-site
  • Run simple-cloud-site --help to list commands


  1. Create index.html and post.html templates in _templates/

  2. Create .simple-cloud-site.cfg with site-specific configuration:

    name = YOUR_NAME
    email = YOUR_EMAIL
  3. Optionally, enable shell completion using the output of simple-cloud-site complete – for example, in a virtualenvwrapper postactivate script:

    eval "$( simple-cloud-site complete )"

Applying Templates

simple-cloud-site apply-template [--template=filename] path/to/post.html


simple-cloud-site devserver

Open the listed URL in your browser


simple-cloud-site publish

Open the public URL in your browser

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(15.3 kB) Copy SHA256 Hash SHA256
Source None Mar 18, 2014

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers