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!

A dumb static site generator.

Project Description

notes-py is a dumb static site generator. I use it to compile notes (duh) that I take about setting up packages or servers or w/e, to HTML so that I can serve them with apache and view them from any machine with internet access.

Fundamentally it uses to compile html from markdown files (like basically every other static site generator).


Since notes-py is self contained (within notes-py/, you can just download and install this file somewhere in your path to use it. It is also available on PyPI, so you should be able to install it with pip install notes-py as well.

If installed with pip, it will also install an entry point at compile_notes, which behaves effectively as a link to notes_py.notes.


notes-py offers both a command line and programmatic interface.

Command line

To keep the command line options simple, the only thing you need to specify is the location of a configuration file:

usage: compile_notes [-c path_to_config] [options]

    -h, --help    : Print this help text
    -c, --config  : Specipy the path to a configuration file
    -V, --version : Print version and licence info


The full functionalitly (it isn’t much) is available through the function at notes_py.notes.compile(content_path, compile_path, stylesheet, html_template). If you are using notes-py programmatically then you should just read through the function to understand whatit does.


You can reach me at

Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
notes-py-0.1.3.tar.gz (15.5 kB) Copy SHA256 Checksum SHA256 Source May 10, 2016

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting