Lilac

Configuration

Overview

There are only a few items to configure. A minimal configuration is:

root_path = ""

[blog]
name = "Make Difference"
description = "Here goes your blog's description"
url = "http://your-blog.org"
theme = "classic"

[author]
name = "me"
email = "me@some.com"

[disqus]
shortname = "your-disqus-short-name"

Root Path

If you are deploying your blog right under the server’s root, you needn’t to set this item, leave it blank:

root_path = ""

Else, if you are deploying your blog to some sub_directory under the server, you need to configure this item. For instance, your blog are deployed here:

you should set root_path to “/myblog”:

root_path = "/myblog"

But note that: when in localhost(lilac serve), your site will run regardless of root_path, so you must run lilac build before deploying this site to remote server.

Blog & Author

It’s easy enough to configure these by yourself.

Notes should know:

  • the item url in section blog is only used in feed generation.
  • better to set author ‘s email to your Gravatar’s email.

Disqus

Lilac uses Disqus to manage blog’s comments.

Follow this link to register your blog to disqus.com , and then set item shortname in the section disqus:

[disqus]
shortname = "your-short-name-from-disqus.com"

Theme Vars

This section configure your theme. We configure theme’s variables in config.toml instead of your_theme/theme.toml so that we can use theme as a standalone repo(or submodule).

What to configure depends on your theme:

[theme.vars]
github = 'my-github-username'
***
Fork me on GitHub