# 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 and Jinja2 templates
`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>`.

## Commands

Linters: `just check` -- always run before committing

Code formatter and automatic fixes: `just fix`

Build the project: `just build`