Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Pelletron is yet another static site generator. Every modern programmer must reinvent this particular wheel.


Pelletron aims to minimize the effort of creating rich content, imposing as little overhead as possible to provide this power.

Pelletron is written in Python. Jinja2 is its templating language. Flask is the glue, providing utilities to build, serve (while debugging), and deploy the static pages. The FlatPages extension defines page content, using YAML to define the structure. It supports Markdown for text formatting and pygments for code syntax highlighting. The Frozen-Flask extension converts the templates to static pages.

Pelletron lets you preview your site using Flask's built-in development server, and includes Flask-DebugToolbar.

Rsync handles deployment to the target server.

Override the skeleton starter templates with widely used HTML5 frameworks such as Bootstrap, Foundation, and HTML5 Boilerplate. (See Beyond bare bones below for more information.)


For Linux and OS X:

  • Clone this repository:
    • $ git clone
  • Create a new python virtual environment:
    • $ mkvirtualenv my-site
  • Ensure you're using the new virtual environment:
    • $ workon my-site
  • Install the requirements:
    • $ pip install -r requirements.txt
  • Test the site build process:
    • $ python build
    • You may see some warnings; it's safe to ignore them
  • Test the server:
    • $ python server
    • Use your web browser to navigate to http://localhost:5050
    • You should see a page with the following text at the top appear:

      Pelletron is working

  • Deploy to localhost as the current user:
    • $ python deploy
    • Edit to change deployment options such as host, username, and path.


|-- built/               <-- Final static site output
|--            <-- Set configuration options
|--         <-- Framework name currently in use
|--              <-- Site management utility
`-- source/              <-- User defined content goes here
    |--    <-- MVC controllers (blank by default)
    |--         <-- MVC models (blank by default)
    |-- modules/         <-- Holds modules such as front-end frameworks
    |   |-- bootstrap/
    |   |-- custom/
    |   |-- foundation/
    |   `-- html5boilerplate/
    |-- pages/           <-- Holds 'page' content
    |   `--      <-- Sample 'page'
    |-- static/          <-- Static content goes here (favicon, css, javascript, etc.)
    |-- templates/       <-- Page layout
    `--          <-- MVC views (includes URL route mappings)

Beyond bare bones

Vanilla Pelletron is not opinionated beyond its basic technical structure, which is optimized for content not design, and provides none of the common HTML5 frameworks popular as jump-off points today. However, modules for the following frameworks are available for your use immediately:

These frameworks can give you a much stronger jumping off point if your site's design needs match up with their respective authors' choices.

Copyright and License

Copyright © 2015 Jeff Kayser. Released under the MIT license.


Simple static site generator







No releases published


No packages published