Skip to content

feat: export Lean to HTML#537

Merged
david-christiansen merged 6 commits intonightly-testingfrom
literacy
Sep 28, 2025
Merged

feat: export Lean to HTML#537
david-christiansen merged 6 commits intonightly-testingfrom
literacy

Conversation

@david-christiansen
Copy link
Copy Markdown
Collaborator

@david-christiansen david-christiansen commented Sep 27, 2025

This PR adds two executables:

  • verso-literate: this uses elaborated Verso moduledocs and docstrings to create a richer representation of a Lean module than the prior literate module support, and with less overhead from heuristic Markdown processing.

  • verso-html: this takes the results of verso-literate and produces an HTML rendering of source code. Perhaps ironically, this fails on Verso documents due to differences in the parser's output, but it can render the rest of Verso's source without issue.

It also adds the ability for the blog genre and the manual genre to include text using verso-literate, so they can load arbitrary Lean files with Verso moduledocs and treat them as content.

This PR adds two executables:

* verso-literate: this uses elaborated Verso moduledocs and
  docstrings to create a richer representation of a Lean module than
  the prior literate module support, and with less overhead from
  heuristic Markdown processing.

* verso-html: this takes the results of verso-literate and produces an
  HTML rendering of source code. Perhaps ironically, this fails on
  Verso documents due to differences in the parser's output, but it
  can render the rest of Verso's source without issue.
@david-christiansen david-christiansen marked this pull request as ready for review September 28, 2025 21:58
@david-christiansen david-christiansen merged commit 582f88b into nightly-testing Sep 28, 2025
3 checks passed
@david-christiansen david-christiansen deleted the literacy branch September 28, 2025 22:06
david-christiansen added a commit that referenced this pull request Oct 15, 2025
This PR adds two executables:

* verso-literate: this uses elaborated Verso moduledocs and docstrings to create a richer representation of a Lean module than the prior literate module support, and with less overhead from heuristic Markdown processing.

* verso-html: this takes the results of verso-literate and produces an HTML rendering of source code. Perhaps ironically, this fails on Verso documents due to differences in the parser's output, but it can render the rest of Verso's source without issue.

It also adds the ability for the blog genre and the manual genre to include text using verso-literate, so they can load arbitrary Lean files with Verso moduledocs and treat them as content.
david-christiansen added a commit that referenced this pull request Oct 21, 2025
This PR adds two executables:

* verso-literate: this uses elaborated Verso moduledocs and docstrings to create a richer representation of a Lean module than the prior literate module support, and with less overhead from heuristic Markdown processing.

* verso-html: this takes the results of verso-literate and produces an HTML rendering of source code. Perhaps ironically, this fails on Verso documents due to differences in the parser's output, but it can render the rest of Verso's source without issue.

It also adds the ability for the blog genre and the manual genre to include text using verso-literate, so they can load arbitrary Lean files with Verso moduledocs and treat them as content.
david-christiansen added a commit that referenced this pull request Oct 21, 2025
This PR adds two executables:

* verso-literate: this uses elaborated Verso moduledocs and docstrings to create a richer representation of a Lean module than the prior literate module support, and with less overhead from heuristic Markdown processing.

* verso-html: this takes the results of verso-literate and produces an HTML rendering of source code. Perhaps ironically, this fails on Verso documents due to differences in the parser's output, but it can render the rest of Verso's source without issue.

It also adds the ability for the blog genre and the manual genre to include text using verso-literate, so they can load arbitrary Lean files with Verso moduledocs and treat them as content.
kim-em pushed a commit that referenced this pull request Oct 21, 2025
This PR adds two executables:

* verso-literate: this uses elaborated Verso moduledocs and docstrings to create a richer representation of a Lean module than the prior literate module support, and with less overhead from heuristic Markdown processing.

* verso-html: this takes the results of verso-literate and produces an HTML rendering of source code. Perhaps ironically, this fails on Verso documents due to differences in the parser's output, but it can render the rest of Verso's source without issue.

It also adds the ability for the blog genre and the manual genre to include text using verso-literate, so they can load arbitrary Lean files with Verso moduledocs and treat them as content.
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.

1 participant