https://github.com/julien-blanchard/loulou
A simple static site generator written in Python
https://github.com/julien-blanchard/loulou
bulma bulma-css microsite personal-website python static-site-generator
Last synced: 3 months ago
JSON representation
A simple static site generator written in Python
- Host: GitHub
- URL: https://github.com/julien-blanchard/loulou
- Owner: julien-blanchard
- License: mit
- Created: 2024-12-07T16:23:06.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-18T21:05:00.000Z (11 months ago)
- Last Synced: 2025-08-18T23:22:33.050Z (11 months ago)
- Topics: bulma, bulma-css, microsite, personal-website, python, static-site-generator
- Language: CSS
- Homepage: https://blanchardjulien.com/
- Size: 723 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# :love_letter: **Loulou** :love_letter:
Loulou is a simple static site generator written in **Python**. It was primarily designed to build my personal website, [blanchardjulien.com](https://blanchardjulien.com/). But you are more than welcome to use it to create your own website.
# How does Loulou work?
Loulou relies on the following *css* and *javascript* libraries:
* [Bulma](https://bulma.io/)
* [Bulmaswatch](https://jenil.github.io/bulmaswatch/)
* [Fontawesome](https://fontawesome.com/)
* [Highlight.js](https://highlightjs.org/)
* [Google's Space Mono font](https://fonts.google.com/)
# How to run Loulou?
You'll need to have the *python* language installed on your device (*version 3.6 and above*), as well as the [mistune](https://mistune.lepture.com/en/latest/) 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.
# Special features
* **YouTube** videos:
To embed a **YouTube** video into one of your posts, wrap the video's ID between the following tags: ``. You must write these tags directly into your *markdown* file(s). Example:
`O9upVbGSBFo`
# Customising Loulou
Because Loulou uses [Bulmaswatch](https://jenil.github.io/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*
