skip to navigation
skip to content

Not Logged In

lilac 0.3.9

Minimal static blog generator.


Lilac is a MIT Licensed static blog generator, written in Python. It's fast, simple enough and easy to use.

Latest version: v0.3.9

Documentation is already on readthedocs: [English Version](, [简体中文版本](

News about lilac is here:

Note: If you are looking for a small and fast one, check out [rux](



- TOML and GFM based.
- 100% in Python (any linux distribution comes with python)
- Built-in Tags & Feed & Theme & Code Highlighting support
- We use Jinja2 to render templates.
- No categories, only tags. (It's A GOOD FEATURE!)
- Minimal configuration.

Demo Sites

- [Lilac News](, repo:

- [Make Difference](, repo:

- [miles](


$ mkdir MyBlog
$ cd MyBlog
$ virtualenv venv
New python executable in venv/bin/python
Installing setuptools............done.
Installing pip...............done.
$ . venv/bin/activate
$ pip install lilac

Sample Post

A post is made up of two parts: header and body.

The header is in [TOML]( and body is in Github Flavored Markdown,
the two parts are separated with a '---' like separator.

title = "Hello World"
datetime = "2013-06-05 19:38"
tags = ["sample", "some-tag"]

# Here is markdown content


To deploy a new blog in new-created directory:

    $ lilac deploy

To build site from source to htmls:

    $ lilac build

To remove all htmls lilac built:

    $ lilac clean

To start a simple HTTP server:

    $ lilac serve

To watch source changes the same time when the cute web server running:

    $ lilac serve --watch

When you save your writings, lilac can detect the changes and start rebuilding.

To run lilac's server and rebuilder in the background:

    $ lilac start

We can write blog with at most one shell session.

**NOTE: ililac was removed in version 0.3.9, use `lilac start|stop instead`**


You really should manage your theme in a standalone git repository, and use it as a submodule of your blog's
submodule if your blog is under git versioning too.

For instance, add theme `less` a submodule of your blog's repo:

    $ git submodule add git:// less

If you want to modify a theme created by someone else, just fork his(or her) repo, and then modify it.

But it's 100% ok to use themes not in the submodule way.

Theme list:

- [classic]( -  by @hit9
- [less]( - a clean theme for lilac. by @hit9 (built-in theme)
- [pure]( - a clean theme for lilac by @kshiftlv

Have you made one? Please send a pull request on lila's repo, append yours to this list.


- English version:

- 简体中文版本:

Common Issues

- Installation troubles:

   cann't find Python.h. Solution: install `python-dev` package (on ubuntu: `sudo apt-get install python-dev`. There's no such issue on OSX)

- How to create a new post?

   There's no command to do it, just `touch src/post/`.

Help Us

Found a bug? Have a good idea for improving Lilac?
You can fork lilac's repo and then send a feature pull request, or you can open a new
[issue]( to report bugs, that will help all users. Welcome for your feedback.
File Type Py Version Uploaded on Size
lilac-0.3.9.tar.gz (md5) Source 2013-12-27 84KB
  • Downloads (All Versions):
  • 4 downloads in the last day
  • 82 downloads in the last week
  • 502 downloads in the last month