{"id":28713854,"url":"https://github.com/julien-blanchard/loulou","last_synced_at":"2026-05-09T02:33:59.059Z","repository":{"id":267192149,"uuid":"900013805","full_name":"julien-blanchard/Loulou","owner":"julien-blanchard","description":"A simple static site generator written in Python","archived":false,"fork":false,"pushed_at":"2025-08-18T21:05:00.000Z","size":740,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-18T23:22:33.050Z","etag":null,"topics":["bulma","bulma-css","microsite","personal-website","python","static-site-generator"],"latest_commit_sha":null,"homepage":"https://blanchardjulien.com/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/julien-blanchard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-07T16:23:06.000Z","updated_at":"2025-08-18T21:05:03.000Z","dependencies_parsed_at":"2024-12-09T00:25:01.332Z","dependency_job_id":"b8bb5b55-8c68-47a7-9c7f-4c6dd742b5b7","html_url":"https://github.com/julien-blanchard/Loulou","commit_stats":null,"previous_names":["julien-blanchard/loulou"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/julien-blanchard/Loulou","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julien-blanchard%2FLoulou","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julien-blanchard%2FLoulou/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julien-blanchard%2FLoulou/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julien-blanchard%2FLoulou/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/julien-blanchard","download_url":"https://codeload.github.com/julien-blanchard/Loulou/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julien-blanchard%2FLoulou/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273392214,"owners_count":25097255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bulma","bulma-css","microsite","personal-website","python","static-site-generator"],"created_at":"2025-06-15T01:00:12.101Z","updated_at":"2026-05-09T02:33:59.054Z","avatar_url":"https://github.com/julien-blanchard.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Project status](https://img.shields.io/badge/version-1.0-green)\n![Python version](https://img.shields.io/badge/requires-python_3.6-blue)\n\n# :love_letter: **Loulou** :love_letter:\n\nLoulou 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.\n\n# How does Loulou work?\n\nLoulou relies on the following *css* and *javascript* libraries:\n\n*  [Bulma](https://bulma.io/)\n*  [Bulmaswatch](https://jenil.github.io/bulmaswatch/)\n*  [Fontawesome](https://fontawesome.com/)\n*  [Highlight.js](https://highlightjs.org/)\n*  [Google's Space Mono font](https://fonts.google.com/)\n\n# How to run Loulou?\n\nYou'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.\n\nOnce this done, simply:\n\n1.  Modify the `template_main.html` file that you'll find in the `templates` directory\n2.  Add the following header to your *markdown* articles and place them into the `posts` directory:\n\n```\n-----\n{\n\"title\":\"\",\n\"date\":\"\",\n\"summary\":\"\",\n\"tags\":[\"\",\"\"],\n\"featured\":false,\n\"readTime\":\"\"\n}\n-----\n\nStart writing your article here!\n```\n\n3.  Name your *markdown* articles as follows: `YYMMDD_name_of_the_article.md`\n\nBefore you run the `main.py` file, you'll need two new directories at the root of your project:\n\n*  `data`\n*  `build` (this is where your website will magically appear!)\n\nTo do so, just type in `mkdir build data` in your command line tool.\n\n# Special features\n\n* **YouTube** videos:\n\nTo embed a **YouTube** video into one of your posts, wrap the video's ID between the following tags: `\u003cyt\u003e\u003c/yt\u003e`. You must write these tags directly into your *markdown* file(s). Example:\n\n`\u003cyt\u003eO9upVbGSBFo\u003c/yt\u003e`\n\n# Customising Loulou\n\nBecause Loulou uses [Bulmaswatch](https://jenil.github.io/bulmaswatch/), you can very easily change the colour scheme of your website.\n\nPick 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.\n\nExamples:\n\n*  *Solar* (default theme)\n\n![alt text](https://github.com/julien-blanchard/Loulou/blob/main/showcase/solar_loulou.png \"Image\")\n\n*  *Slate*\n\n![alt text](https://github.com/julien-blanchard/Loulou/blob/main/showcase/slate_loulou.png \"Image\")\n\n*  *Journal*\n\n![alt text](https://github.com/julien-blanchard/Loulou/blob/main/showcase/journal_loulou.png \"Image\")\n\n*  *Nuclear*\n\n![alt text](https://github.com/julien-blanchard/Loulou/blob/main/showcase/nuclear_loulou.png \"Image\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjulien-blanchard%2Floulou","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjulien-blanchard%2Floulou","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjulien-blanchard%2Floulou/lists"}