Documenter.jl: HTMLWriter: rendering HTML pages loops forever

General Usage
1

Hello everybody,
I am updating a package after a long time and the documentation does not build anymore.
Specifically, invoking the building process with makedocs, it gets to the final step, the REPL print

HTMLWriter: rendering HTML pages

and the process continues forever.
I have tried to remove all pages but the index one leaving only a minimal content,
still the problem persists. The documentation is here

3

I corrected some commas, now i can build the documentation locally, but the CI still fails after 15 minutes and that should be plenty of time to complete. Here is the error i get. Any ideas?

4

That is a bug in the most recent release, see Added anchor links to admonition blocks for direct referencing by Rahban1 · Pull Request #2676 · JuliaDocs/Documenter.jl · GitHub – a PR is already crafted at Use appropriate show method for PageLink by mortenpi · Pull Request #2714 · JuliaDocs/Documenter.jl · GitHub.

Either restrict to the last previous version (1.10.2) or wait a bit for that PR and the next version (1.11.1).

1 Like
5

Thanks Ronny, i will wait, i am not in a rush.

6

This should hopefully be fixed in 1.11.1, which was just tagged.

1 Like