Loulou is a simple static site generator written in Python. It was primarily designed to build my personal website, blanchardjulien.com. But you are more than welcome to use it to create your own website.

Loulou relies on the following css and javascript libraries:

• Bulma
• Bulmaswatch
• Fontawesome
• Highlight.js
• Google's Space Mono font

You'll need to have the python language installed on your device (version 3.6 and above), as well as the mistune library.

Once this done, simply:

1. Modify the template_main.html file that you'll find in the templates directory
2. Add the following header to your markdown articles and place them into the posts directory:

-----
{
"title":"",
"date":"",
"summary":"",
"tags":["",""],
"featured":false,
"readTime":""
}
-----

Start writing your article here!

3. Name your markdown articles as follows: YYMMDD_name_of_the_article.md

Before you run the main.py file, you'll need two new directories at the root of your project:

• data
• build (this is where your website will magically appear!)

To do so, just type in mkdir build data in your command line tool.

• YouTube videos:

To embed a YouTube video into one of your posts, wrap the video's ID between the following tags: <yt></yt>. You must write these tags directly into your markdown file(s). Example:

<yt>O9upVbGSBFo</yt>

Because Loulou uses Bulmaswatch, you can very easily change the colour scheme of your website.

Pick any theme you like from the Bulmaswatch website, download the corresponding css file and place it in the css folder. Don't forget to modify your template_main.html file accordingly.

Examples:

• Solar (default theme)

• Slate

• Journal

• Nuclear