HomeMAL' // MANUFACTORUM
datacrypt
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 engine
  • posts/ — articles (markdown) and index.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

  1. Write posts/<name>.en.md (.fr.md for 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.

  1. Add the filename to posts/index.json. Order in that list is the

order on the front page.

  1. A sibling with the same base name (<name>.fr.md next 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.