all repos — py-vite @ master

the original vite, written in python

Fix readme
Anirudh Oppiliappan
Fri, 30 Oct 2020 20:51:03 +0530
Add note about go-vite
Anirudh Oppiliappan
Fri, 30 Oct 2020 20:21:11 +0530
Update with correct readme

Signed-off-by: Anirudh Oppiliappan <>
Anirudh Oppiliappan
Sat, 30 May 2020 13:49:46 +0530


A simple and mnml static site generator that Just Works™

NOTE: Ths project has been superseded by go-vite.


$ pip install git+

Note: the PyPI version is out of date, and likely won’t be updated. I can’t be bothered.


$ vite init path/to/project
$ vite new blog/   # `pages/` is implied

This creates pages/blog/

And then:

$ vite build   # in project directory

Rendered HTML will be in the build directory.

Finally, run:

$ vite serve  # also in the project directory


Not very sophisticated, but basic configuration can be acheived using found in the project directory. Example config:

title = ''
author = ''
header = ''
footer = '' 
template = 'index.html'  # default is templates/index.html
pre_build = []           # list of commands to run pre-build
post_build = []          # list of commands to run post-build


Vite uses Jinja2 templating, so template files must be placed in a separate templates/ directory.
A basic example would be:

<link rel="stylesheet" href="/static/sakura-earthy.css">

<title> {{ title }} </title>

{{ body }}

{{ footer }}

Specifying per-page templates

Vite allows for specifying a unique template, per page. This is acheived by including YAML frontmatter at the top of the Markdown file, like so:

template: foo.html
title: Some fancy buzzwords here
subtitle: Cool catch phrase here
url: my-post
date: 2019-08-09

## markdown here

Notes on templating

Directory tree

├── build
├── pages
│   └──
├── static
└── templates
    └── index.html


git clone