Skip to main content

Super Simple python system for building and deploying static websites

Project description

Copyright (C) 2013-2014 Samuel Colvin

License: The MIT License (MIT)

Donkey Simple is an extremely simple CMS that allows you to build a static website either from a web interface or the command line.

It uses clever tools like Ace Code Editor, Markdown and Jinja2 to make writing the site as painless as possible.

The pages, templates, static files and config files which make up the site are stored in a git repository so you can easily manage the version history of your site.

Once you’ve written your site, it is generated ONCE and then saved as static files, meaning the site is FAST, REALLY FAST in a way dynamic sites build from templates using lots of database calls and slow interpretted languages so rarely are.

DonkeySimple was built to work with Apache (it comes with .htaccess files) but it should be extremely simple to use it with other server. Similarly it has only been tested on Linux and Mac OS, however there’s nothing fundamental to stop it running on windows.

View the code and download it at Donkey Simple is available through PyPi here.


(These docs assume you’re setting up Donkey Simple to work with Apache on Ubuntu, but they should give you the gist of the process on other linux variants and Mac OS, even Windows and other web servers (like nginx and lighttpd) shouldn’t be that different.)

To Install run:

sudo pip install DonkeySimple

You should then be able to use the command line utility donkeysimple.

To build a new site run

donkeysimple build my_new_site

which will create a new site template at working/directory/my_new_site. Eg. you might think of running this command from /var/www/home/ to create /var/www/my_new_site.

(More details on what the donkeysimple utility can do can be found by running donkeysimpl --help.)

At this stage you might think about changing the password for the default user, you can do this by going into my_new_site and running.

donkeysimple edituser

The only remaining step is to setup apache to work with this directory. I won’t go into details of setting up an apache site, the only “special” thing you need to do is enable .htaccess files, there are details here but basically just need something like

<Directory /var/www/home/my_new_site>
    AllowOverride All

You should then be able to go to the site at to see the default site and to login and start building your site.

Building (You can Probably ignore this)

If you download the source (eg. from github as opposed to installing with pip) you should run python prior to installing. All this does is download the static files for the web interface and generate the docs.txt file for PyPi’s long_description, for this you will require pandoc and pyandoc.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


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
DonkeySimple-0.18.tar.gz (1.2 MB) Copy SHA256 hash SHA256 Source None Mar 21, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page