page 0.2.1

Static website generator

Page, a static website generator

• creates a well organized website with clear navigation reflecting the folder structure of source text documents
• fast, well compressed, mobile friendly pages
• feed and sitemap files for your subscribers and search engines
• import from any CMS DB (inc. Wordpress), import HTML sites

Writers love distraction free conventional plain text formatting. Template designers love the easy to read, beautiful and powerful template language.

Installation and run

Page is a small command line program written in Python programming language. It requires python installed, which lets user install Page on any platform in a single command.

pip install page

By default, Page will collect all text files in current folder and create a HTML website in a static folder using default templates. Run the program

page

it will look for a config file ./page.yml with custom options.

source: /markdown/source/folder/
target: /target/folder/
tpl: /custom/template/folder/
ext: ''  # or '.htm'
ctx:
    site_name: 'My Site'
    site_url: https://example.org

Batteries included

Minimal default template.

Page has lots of tests including one importing an existing HTML site, converting it to source markdown files and then back into a static HTML site in full circle. This code can inspire users to convert existing static site or one powered by a slow Content Management System to simple markdown powered static site and maintain it with Page.

Programmers using Djagno Web Framework can make their sites faster and less demanding using static cache generation helpers provided, see static.py.

E-commerce features for static shops (cart, checkout, persistence) implemented as a shop template

Example websites using page with sources

• Normy Jedal/Dish standards in Slovak language [sources]
• Sip Sip — Herbal Medicine in Slovak language [sources]
• Blocl activist literature, blog, privacy policy [sources]

Note: public repositories for projects using page begin with word "revisions" to prevent them from being indexed in public search engines as per github.com/robots.txt

---

Designed in Slovakia by Francis Malina.