blog / README.md
README.md1.2 KB
blog
Markdown blog engine. Client-side rendering: marked, KaTeX, highlight.js, Mermaid, DOMPurify.
Structure
index.html,main.js,style.css— the engineposts/— articles (markdown) andindex.json, the list of published
files
libs/— vendored renderers (marked, KaTeX, highlight.js, Mermaid,
DOMPurify) and fonts
courbes/— images referenced by articles
Add an article
- Write
posts/<name>.en.md(.fr.mdfor French). Front matter:
---
title: Article Title
date: 2026-07-09
lang: en
tags: [tag1, tag2]
---notitle: true hides the H1 the engine generates from title.
- Add the filename to
posts/index.json. Order in that list is the
order on the front page.
- A sibling with the same base name (
<name>.fr.mdnext to
<name>.en.md) enables the FR/EN switch on the article.
Markdown supports LaTeX ($...$, $$...$$), fenced code with syntax highlighting, mermaid code blocks, and raw HTML (iframes allowed). Images go in a folder at the blog root (e.g. courbes/) and are referenced by relative path.
Deploy
The site is plain files: upload the site root contents to the host.
