beemo

A Python-based static site generator. Bring your own content and templates and it’ll quickly generate you a deployable HTML website/blog. Also includes support for building a simple analytics site based on the known site structure by processing Apache logs.

Features

• Content as HTML, markdown or reStructuredText

• Pages

• Blog:

  • Posts

  • Tags

  • Archives (index, years and months)

• Atom feed

• Three modes:

  • Posts only

  • Pages only

  • Pages + posts

• XML sitemap

• Custom Chameleon templates

• Custom CSS, JS and other static files

• Apache log analytics (optional, via beemo[logs])

Install

Install the latest release with:

pip install beemo

For Apache log analytics, install the logs extra:

pip install beemo[logs]

Development

Create a virtual environment and run make develop to install the library and its dependencies.

Examples

Sites built with Beemo:

• bennuttall.com (repo)

• blog.piwheels.org (repo)

• pynw.org (repo)

• pyjok.es (repo)

If you wish to use this project for your own website, these examples will be a useful reference.

Links

• PyPI

• GitHub

Licence

• BSD-3-Clause

Table of Contents

• Overview
• Adding content
• Templates
• Configuration
• Output files
• Log analytics
• Beemo CLI
  • beemo build
  • beemo logs
  • beemo analytics
• Beemo Python API reference
  • SiteData
  • Config
  • Post Types
• Changelog
  • 0.6