summaryrefslogtreecommitdiff
path: root/AGENTS.md
blob: 382bf144be9bda7cecf38cc1428494afad1d87f9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# redman.xyz — 2026 modernization

redman.xyz is my personal website and a technical blog. Currently it runs on DokuWiki. I've downloaded all text to `old_pages/` and embedded images to `old_media/`.

The goal of this project is switching over to Typst using their experimental HTML output mode. `blog-torture/` contains a reference document that renders correctly, including equations.

## Repo structure

`blog-torture/`, `old_pages/`, `old_media/` – temp files to be removed after migration

`site/` — source .typ files
`static/` — CSS, images, etc.
`public/` — ready-to-publish site goes here

## Migration

Keep text verbatim. If there are any typos or other errors, point them out in the chat and keep them.

`=` corresponds to `<h2>`. It's a level below the title, so use it for sections.

For internal links, use `#link-self(page)[...])` from `common.typ`. The argument is a path relative to `site/content/` without the file extension.

`static(path)` returns the URL to a file in `static/`. Path is relative to that directory.

Replace links to scientific articles with references to the bibliography (`refs.bib`).

Use `img(url)` from `common.typ` for `<img>`.

## Building

```
uv run build.py
```