lhtml-site 1.0.0__tar.gz

lhtml_site-1.0.0/CHANGELOG.md

@@ -0,0 +1,104 @@
+# Changelog
+
+All notable changes to lhtml-site (`lhtml-site` on PyPI) are documented here.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [1.0.0] - 2026-10-19
+
+The first release on PyPI. The generator was named `static_website_lhtml`,
+and projects used it as a copy or a submodule; it is now a package with a
+command, `lhtml-site`, built on LHTML 3 (`lhtml-markup` on PyPI).
+
+### Added
+- `pipx install lhtml-site` (or `pip install lhtml-site` in a virtual
+  environment) installs the command `lhtml-site`; `lhtml-site --version`
+  says its version and the LHTML it runs.
+- `lhtml-site init [DIR] [--theme slides|slides-pdf|webpage-frame]` creates
+  a project: a `configure.yaml` and pages to start from in `src/` (four
+  slides, or two web pages). Over a directory that already has its pages in
+  `src/`, it writes only `configure.yaml`.
+- `lhtml-site doctor` says, for each optional feature (PDF export, layout
+  report, videos, SASS, figures, code snippets, tidy), what it finds and the
+  command that installs what is missing for the way lhtml-site is
+  installed (`pipx inject` after pipx).
+- `lhtml-site --serve --watch` builds, serves the site on localhost and
+  rebuilds it on save.
+- A page says what it is in its front matter (the YAML at its top), and may
+  be written in Markdown (`index.md.j2`) as well as in LHTML
+  (`index.html.j2`).
+- Projects of several decks, each built to several targets (the slides in
+  the browser, a PDF), the layout report (`--layout`), the lint of the
+  values written by hand (`--lint`).
+- The PDF export runs Chromium through Playwright for Python, with the extra
+  `lhtml-site[pdf]` (playwright, pypdf) and
+  `python -m playwright install --only-shell chromium`: no Node.js, poppler
+  nor ImageMagick. One browser for the deck, a few slides at a time, each
+  printed once ready (fonts, math, images, a frame of each video) instead of
+  after a fixed 4 s; the images are screenshots at 3840 px, the merge is
+  pypdf. The outputs keep their names and layout. `lhtml-site doctor`
+  reports it.
+- A progress bar while the PDF is made, on a terminal only (a log gets
+  nothing). Without Playwright, the build says what to install, the command
+  for the way lhtml-site is installed.
+- The layout report (`--layout`, `--render`) runs in the same Chromium,
+  through Playwright for Python (`lhtml_site/layout/measure.py`; what runs
+  inside the page is `lhtml_site/layout/page.js`). Its reports are those of
+  the Node version: same blocks, problems and usual values of the deck
+  measured in the same browser. The pages of an existing report are measured
+  again once (the measuring code changed). On a deck of 35 slides, the
+  report takes 7.9 s instead of 9.5 s.
+- A slide is printed once the promises a page or a demo (in an iframe too)
+  registered with `window.__lhtmlReady` are settled, as the layout report
+  already waited for them; the whole preparation of a slide is bounded (60
+  s), so a promise that never settles fails the slide instead of blocking
+  the export. After pipx, the commands to install are the same in the
+  README, in `lhtml-site doctor` and in the errors:
+  `pipx inject lhtml-site pypdf`, `pipx inject --include-apps lhtml-site
+  playwright`, then `playwright install --only-shell chromium`.
+
+### Changed
+- Requires LHTML 3 (`lhtml-markup>=3.0`), which reads no file: the
+  generator reads the sources, and `include::` is written with Jinja
+  (`{% include %}`). Coming from LHTML 2: the
+  [migration of LHTML](https://github.com/drohmer/lhtml/blob/main/docs/migration.md).
+- The README leads to a first talk in a few commands, opened from the disk
+  (`lhtml-site`, then `.site/index.html`; `--watch` to rebuild on save, and
+  `init` says the same); the reference moves to
+  [docs/reference.md](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md),
+  with the details of the PDF export.
+- The package holds the themes, plugins and starters but not the demo
+  course, and the themes ship their fonts as WOFF2 only: the wheel is about
+  8 MB.
+- The id of a heading is the one of the generator copied into projects
+  since April 2026 (` -,.:()` become `_`, then `__` becomes `_`), so links
+  into the sites it built keep working; a site built by an older copy
+  changes the id of its headings with these characters (`Part - One`:
+  `part___one` before, `part__one` now). A repeated heading gets distinct
+  ids (`_id2`, `_id3`...) and characters unsafe in a URL are removed.
+- The "Page content" column of the theme webpage-frame is read in the page
+  (its level-2 headings with an id), not fetched from a JSON file: it is
+  shown when the site is opened from disk (`file://`), where it was empty,
+  and lists the headings as the page shows them (`== One **bold**` is
+  "One bold", it was "One \*\*bold\*\*").
+- A heading whose text comes from Jinja gets its id from its text as
+  rendered, unique in its page: each occurrence of a page reused with
+  `params` has the id of its own title (`interpolation_de_key_l1`; it was
+  `_parties[current__1]_id2_l1`, the same source for all of them), and
+  each heading of a `{% for %}` loop has its own. The ids of the headings
+  written as text do not change: links into published sites keep working.
+
+### Removed
+- Node.js is no longer used: the Node PDF export of `static_website_lhtml`
+  (puppeteer, poppler, ImageMagick, `LHTML_PDF_ENGINE`), the Node scripts of
+  the layout report, `package.json`. `lhtml-site doctor` no longer looks for
+  Node, puppeteer or a Chrome of its own.
+- The site no longer holds `<page>.title_id.json`, `title_id.json` nor
+  `structure/title_id.json` (144 files, 592 KB on a deck of 78 slides).
+  The record of the headings that `--only` needs is build state, in
+  `.verification/headings.json`; the `structure/title_id.json` of a site
+  built by an older copy is read once in its place.
+
+### Fixed
+- The slides no longer write their menu in the console of the browser.
+
+[1.0.0]: https://github.com/drohmer/lhtml-site/releases/tag/v1.0.0

lhtml_site-1.0.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Damien Rohmer <damien.rohmer@polytechnique.edu>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lhtml_site-1.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+# The sdist: the package as pyproject.toml lists it, its tests and the changelog.
+# Never the demo course (its videos stay in a checkout), nor what a build or a
+# test run leaves behind - even when a stale *.egg-info/SOURCES.txt lists it.
+include CHANGELOG.md
+prune src/lhtml_site/example
+global-exclude *.py[cod] .DS_Store
+prune **/__pycache__

lhtml_site-1.0.0/PKG-INFO

@@ -0,0 +1,384 @@
+Metadata-Version: 2.4
+Name: lhtml-site
+Version: 1.0.0
+Summary: Static website and slide generator built on LHTML and Jinja2
+Author: Damien Rohmer
+License-Expression: MIT
+Project-URL: Repository, https://github.com/drohmer/lhtml-site
+Project-URL: Documentation, https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md
+Project-URL: Changelog, https://github.com/drohmer/lhtml-site/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/drohmer/lhtml-site/issues
+Project-URL: LHTML, https://github.com/drohmer/lhtml
+Keywords: static site generator,slides,presentation,lhtml,jinja2,teaching
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Multimedia :: Graphics :: Presentation
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: lhtml-markup>=3.0
+Requires-Dist: Jinja2
+Requires-Dist: markdown-it-py
+Requires-Dist: jinja-markdown
+Requires-Dist: pytidylib
+Requires-Dist: pyyaml
+Requires-Dist: rich
+Provides-Extra: pdf
+Requires-Dist: playwright>=1.49; extra == "pdf"
+Requires-Dist: pypdf>=4; extra == "pdf"
+Dynamic: license-file
+
+# lhtml-site
+
+Write your talks and course websites as short text files: lhtml-site turns
+them into slides shown in the browser, a PDF of the slides, or a website
+with a menu. It is made for teachers and researchers; no web development is
+needed.
+
+A slide is a text file in [LHTML](https://github.com/drohmer/lhtml), a light
+markup over HTML:
+
+```
+{% set layout = 'side' %}
+
+= A slide with an image
+
+The layout side puts the text on the left, and the figures of the media block
+on the right, fitted to the column.
+
+* Put the image next to the slide, in assets/
+* Name it in the media block below
+
+media::
+img::assets/diagram.svg
+credit:: An image of the slide (assets/diagram.svg) ::
+::
+```
+
+and lhtml-site shows it as:
+
+![The slide above, shown in the browser](https://raw.githubusercontent.com/drohmer/lhtml-site/main/docs/slide.png)
+
+Pages can also use Jinja2 templates and be written in Markdown. The output
+is a static site: open it from the disk, or copy it to any web host.
+
+## Getting started: your first slides
+
+**What you need**: Python 3.11 or newer ([python.org](https://www.python.org/downloads/)),
+and [pipx](https://pipx.pypa.io/stable/installation/), which installs
+commands written in Python: `brew install pipx` on macOS, `sudo apt install
+pipx` on Debian or Ubuntu, `py -m pip install --user pipx` on Windows; then
+`pipx ensurepath`, and open a new terminal. (Without pipx, see
+[Installation](#installation).)
+
+**1. Install lhtml-site and create a talk.** In a terminal:
+
+```bash
+pipx install lhtml-site
+lhtml-site init my-talk --theme slides
+cd my-talk
+lhtml-site
+```
+
+`init` creates a directory `my-talk/` with a configuration and four slides
+to start from; `lhtml-site` builds them:
+
+```
+my-talk/
+  configure.yaml                     the configuration
+  src/
+    01_title/index.html.j2           a title slide
+    02_text/index.html.j2            a slide of text: lists, math, a link
+    03_two_columns/index.html.j2     two columns
+    04_image/index.html.j2           text, and an image on the right
+```
+
+**2. Show it.** `lhtml-site` has built the slides into `.site/`: open
+`.site/index.html` in your browser, no server needed (in the terminal,
+`open .site/index.html` on macOS, `start .site\index.html` on Windows,
+`xdg-open .site/index.html` on Linux). Go from slide to slide with the
+arrow keys, or with the arrows at the bottom right; the icon next to them
+opens the list of the slides.
+
+After a change, run `lhtml-site` again and refresh the browser. To rebuild
+without retyping it, run `lhtml-site --watch` instead: it rebuilds the
+slides each time you save a file. **Keep that terminal open while you
+work**, refresh the browser to see the change, and press Ctrl+C in the
+terminal to stop. `lhtml-site --serve --watch` does the same and also shows
+the slides at <http://127.0.0.1:8000/>, which only a few features need, such
+as the [comments on the render](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#local-preview).
+
+**3. Add a slide.** A slide is a directory of `src/` with a file
+`index.html.j2` in it. Duplicate `src/02_text` (in your file explorer, or
+`cp -r src/02_text src/05_my_slide` in the terminal, from `my-talk/`) and
+name the copy `05_my_slide`. The slides follow the order of their
+directories, hence the numbers: `05_my_slide` comes last; name it
+`02b_my_slide` to put it after `02_text`.
+
+**4. Write it.** Open `src/05_my_slide/index.html.j2` in a text editor, and
+replace its content with:
+
+```
+= My first slide
+
+* A first idea
+* An **important** point
+* A conclusion
+```
+
+Save, rebuild (`lhtml-site`, unless `lhtml-site --watch` is running), and
+refresh the browser.
+
+- A line starting with `=` is the title of the slide, and its name in the
+  list of the slides.
+- A line starting with `*` is an item of a list; `**` at the start of a
+  line, a sub-item. The `slides` theme shows no bullet before them.
+- `**word**` is bold, `__word__` italic.
+
+**5. Put an image in it.** Copy your image (PNG, JPEG or SVG), say
+`photo.png`, into `src/04_image/assets/` (the directory is already there);
+then, in `src/04_image/index.html.j2`, replace `img::assets/diagram.svg`
+with `img::assets/photo.png`, and the caption on the line `credit::` with
+yours. Save and rebuild: the image is on the right of the slide, fitted to
+its column. An image belongs to the directory of its slide, in `assets/`.
+
+The four starter slides also show, each in a few lines: math
+(`\(e^{i\pi} + 1 = 0\)`), a link, a space (`gap::`) and small text in
+`02_text`, two columns (`cols::` and `col::`) in `03_two_columns`. All the
+macros and layouts of the slides are in
+[Design](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#design-tokens-macros-and-layouts),
+and the markup in [LHTML](https://github.com/drohmer/lhtml).
+
+**6. Come back to it later.** Open a terminal, go into the talk's
+directory, and rebuild (or let it rebuild as you save):
+
+```bash
+cd my-talk
+lhtml-site --watch
+```
+
+**7. Share it.** Your talk is `configure.yaml` and `src/`: keep them (a
+backup, or a git repository). The slides are built into `.site/`, which
+`lhtml-site` rebuilds from them at any time. To show the slides on another
+computer, copy `.site/` and open its `index.html`; to put them online, copy
+`.site/` to any web host (GitHub Pages, the server of your university).
+`.site/` is hidden, as any name starting with a dot: Cmd+Shift+. shows it in
+the macOS Finder, *View > Hidden items* in the Windows explorer. Next to it,
+`.structure/` and `.verification/` are working files of the build: leave
+them.
+
+To order the slides without renaming them, or to reuse a slide, list them in
+a [deck](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#deck-order-of-the-slides).
+
+## Your talk as a PDF
+
+Install the PDF export once (see [PDF export](#pdf-export)): when
+`lhtml-site doctor` says *ready* on its line *PDF export*,
+replace the line `theme: 'slides'` of the talk's `configure.yaml` with:
+
+```yaml
+theme: 'slides-pdf'
+```
+
+and build, in the talk's directory:
+
+```bash
+lhtml-site
+```
+
+It writes `slides.pdf`, and `images/` with an image of each slide, next to
+`configure.yaml` (a few seconds for a few slides). With this theme the HTML
+of the slides is only a step towards the PDF, and is not kept; put
+`theme: 'slides'` back to work on the slides in the browser. To get both at
+each build, the slides in the browser and the PDF, declare two targets:
+[Decks and targets](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#decks-and-targets).
+
+## Websites and themes
+
+- A website (documentation, a course) rather than slides:
+  `lhtml-site init my-site` (the `webpage-frame` theme, two pages to start
+  from).
+- *You already have your pages* in a directory `src/`: in the directory that
+  contains `src/`, run `lhtml-site init --theme slides`. It writes only
+  `configure.yaml` there; nothing else is created or changed.
+
+The theme is the `--theme` of `init`, or the key `theme:` of
+`configure.yaml`:
+
+| Theme | For | Needs |
+|---|---|---|
+| `webpage-frame` (default) | Web pages: documentation, a course website, with a navigation menu | nothing more |
+| `slides` | Slides shown in the browser, 1920x1080, one page per slide | nothing more |
+| `slides-pdf` | The same slides, exported to a PDF, with an image of each slide | Playwright and its Chromium: see [PDF export](#pdf-export) |
+
+Change the theme at any time by editing `theme:`; it also takes the
+directory of a theme of your own. To publish the same slides both in the
+browser and as a PDF, see
+[Decks and targets](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#decks-and-targets).
+
+## Installation
+
+```bash
+pipx install lhtml-site                  # the command lhtml-site, in an environment of its own
+pipx upgrade lhtml-site                  # later, to update it
+```
+
+Without pipx, in a virtual environment (Homebrew and recent system Pythons
+refuse a `pip install` outside one). On macOS and Linux:
+
+```bash
+python3 -m venv ~/.venvs/lhtml-site
+source ~/.venvs/lhtml-site/bin/activate     # fish: activate.fish
+python -m pip install lhtml-site
+```
+
+On Windows, in PowerShell:
+
+```powershell
+py -m venv $HOME\.venvs\lhtml-site
+& $HOME\.venvs\lhtml-site\Scripts\Activate.ps1
+python -m pip install lhtml-site
+```
+
+The command `lhtml-site` is then there while that environment is active
+(the `source` or `Activate.ps1` line again, in a new terminal).
+`lhtml-site --version` prints the installed version and the version of
+LHTML it runs. Development version:
+`pipx install git+https://github.com/drohmer/lhtml-site`.
+
+**Requirements**: Python 3.11 or newer, on Linux, macOS or Windows.
+Installed with it: `lhtml-markup` (LHTML 3), `Jinja2`, `jinja-markdown`,
+`markdown-it-py`, `pytidylib`, `pyyaml`, `rich`. That is all a site of HTML
+pages or slides needs: no Node, no browser, no other program.
+
+### Optional features
+
+Each optional feature needs its own tools. `lhtml-site doctor` says, for
+each feature, what it finds and the command that installs what is missing,
+for the way lhtml-site is installed:
+
+| Feature | Needs |
+|---|---|
+| PDF export (`slides-pdf`) | `playwright` and `pypdf` (Python, the extra `lhtml-site[pdf]`) and Playwright's Chromium: see [PDF export](#pdf-export) |
+| Layout report (`--layout`, `--render`) | the same `playwright` and Chromium |
+| Videos in several codecs (`cache_video_directory:`) | `ffmpeg`, and `ffpb` (Python) |
+| SASS (`.sass` files) | `libsass` (Python) |
+| Figures in code (`*.svg.py`, `*.svg.tex`) | the libraries their scripts import, such as `matplotlib`, `numpy` (Python); `latex` and `dvisvgm` (TeX Live) |
+| Code of other repositories (`code_include.py`) | `git` |
+| HTML cleaned by tidy (`use_tidy: true`) | the library `libtidy` |
+
+**Python packages after pipx.** pipx installs lhtml-site in an environment
+of its own: `pip install matplotlib` puts the package into another Python,
+where lhtml-site does not find it. Inject the packages into its environment
+instead:
+
+```bash
+pipx inject lhtml-site matplotlib numpy          # figures in code
+pipx inject lhtml-site libsass                   # SASS
+pipx inject --include-apps lhtml-site ffpb       # videos (a command: --include-apps)
+```
+
+In a virtual environment or a checkout, `pip install matplotlib numpy` (and
+`libsass`, `ffpb`) in the Python that runs lhtml-site does the same.
+
+### PDF export
+
+The PDF export, and the layout report, run Chromium through Playwright for
+Python: two Python packages and a browser, no Node.js. After
+`pipx install lhtml-site`:
+
+```bash
+pipx inject lhtml-site pypdf
+pipx inject --include-apps lhtml-site playwright
+playwright install --only-shell chromium         # Playwright's Chromium, about 200 MB, once
+lhtml-site doctor                                # PDF export (...): ready
+```
+
+`--include-apps` puts the `playwright` command of lhtml-site's environment
+on your PATH, so that the browser downloaded is the one its Playwright
+expects. If pipx warns that another `playwright` is already on your PATH,
+run the command that `lhtml-site doctor` gives instead. In a virtual
+environment or a checkout: `pip install "lhtml-site[pdf]"`, then
+`python -m playwright install --only-shell chromium`. On Linux, Playwright
+may also ask for the system libraries of Chromium:
+`playwright install-deps chromium`. The configuration key `chrome` names a
+Chromium or Chrome already installed, to use instead of the download.
+
+How the export waits for each slide is in the
+[reference](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#pdf-export).
+
+## From a checkout
+
+A clone, or a submodule of a project:
+
+```bash
+git clone https://github.com/drohmer/lhtml-site.git
+cd lhtml-site
+pip install -r requirements.txt
+python generate.py ...            # the same as lhtml-site ...
+```
+
+`generate.py` at the root of the repository runs the lhtml-site of the
+checkout (its code is in `src/lhtml_site/`), so the projects that include it
+as a submodule call `python <submodule>/generate.py`, and keep naming its
+files as `<submodule>/themes/slides/` or `<submodule>/plugins/pre_include.py`
+(they are found in `src/lhtml_site/`). `pip install -e .` in a checkout
+installs the command from it.
+
+The checkout also holds a complete demo, a course website with its videos,
+in `src/lhtml_site/example/` (not installed by pip: too heavy). To build it:
+
+```bash
+mkdir demo
+cp -r src/lhtml_site/example demo/src
+python generate.py init demo
+cd demo
+python ../generate.py --serve --watch
+```
+
+The tests, the locked dependencies and the layout of the repository are in
+[Development](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/development.md).
+
+## Documentation
+
+- [Reference](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md):
+  the [command line](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#cli-options),
+  the [preview server](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#local-preview)
+  and the comments on the render,
+  the [configuration](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#configuration),
+  [decks and targets](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#decks-and-targets),
+  [Markdown pages](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#markdown-pages),
+  [template variables](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#template-variables),
+  the [order of the slides](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#deck-order-of-the-slides),
+  [themes](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#theme-what-it-declares-about-the-build),
+  the [PDF export](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#pdf-export),
+  the [design](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#design-tokens-macros-and-layouts)
+  (tokens, macros, layouts), [credits and figures in code](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#credits-origin-of-the-slides-figures-in-code),
+  [plugins](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#plugins),
+  the [layout report](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#layout-report-llm-assisted-slide-layout),
+  [error reporting](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#error-reporting),
+  and [migrating from static_website_lhtml](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/reference.md#migrating-from-the-previous-layout).
+- [Writing slides with an AI agent](https://github.com/drohmer/lhtml-site/blob/main/src/lhtml_site/docs/agents.md):
+  the procedure an agent follows (each build copies it into `.structure/agents.md`).
+- [LHTML](https://github.com/drohmer/lhtml): the markup of the pages.
+
+## Help and changes
+
+- Questions and bugs: [GitHub issues](https://github.com/drohmer/lhtml-site/issues).
+- What changed in each version: [CHANGELOG](https://github.com/drohmer/lhtml-site/blob/main/CHANGELOG.md).
+
+## License
+
+MIT, see [LICENSE.md](https://github.com/drohmer/lhtml-site/blob/main/LICENSE.md).
+By Damien Rohmer.