Skip to content

feat: lightweight HTTP server for Verso projects#876

Open
david-christiansen wants to merge 17 commits into
mainfrom
serve
Open

feat: lightweight HTTP server for Verso projects#876
david-christiansen wants to merge 17 commits into
mainfrom
serve

Conversation

@david-christiansen

@david-christiansen david-christiansen commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

Adds a lightweight HTTP server for previewing generated Verso HTML locally, run with lake exe serve. The server binds only 127.0.0.1, reducing the temptation to deploy it to production.

This replaces Python or Node local servers, with defaults that are better-suited to hosting Verso correctly. It also doesn't rely on users having any other programming language ecosystem available.

It can be configured from the command line, or for slightly more complex setups, via serve.toml.

Along the way, this branch encountered a bug in the TeX code generation that needed fixing in order to render the docs for the feature.

ahmedtadde pushed a commit to metroncorp/lean4-verso that referenced this pull request Jul 16, 2026
…r#900)

In writing leanprover#876, @david-christiansen noted "this branch encountered a
bug in the TeX code generation that needed fixing" — but I think the
issue was slightly misdiagnosed, it wasn't a fragility issue, a `]`
anywhere in an item description (including outside of verbatim) caused a
rendering issue because it was read as the description closer.

This fix fixes the bug from leanprover#876, also fixes bugs for `]` in literal
text, and adds a test for the behavior.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants