# Documenter.jl: HTMLWriter: rendering HTML pages loops forever

**URL:** <https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910>\
**Category:** General Usage\
**Tags:** documenter\
**Created:** [May 11, 2025, 4:57pm UTC](https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910 "2025-05-11T16:57:16Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Marco-Congedo](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/marco-congedo/32/7321_2.png) [@Marco-Congedo](https://discourse.julialang.org/u/Marco-Congedo)\
**Post date:** [May 11, 2025, 4:57pm UTC](https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910/1 "2025-05-11T16:57:16Z")

</div>

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](https://github.com/Marco-Congedo/FourierAnalysis.jl/tree/dev/docs)

---

<div class="post-metadata">

**Author:** ![Marco-Congedo](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/marco-congedo/32/7321_2.png) [@Marco-Congedo](https://discourse.julialang.org/u/Marco-Congedo)\
**Post date:** [May 11, 2025, 6:46pm UTC](https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910/3 "2025-05-11T18:46:39Z")

</div>

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](https://github.com/Marco-Congedo/FourierAnalysis.jl/actions/runs/14958569543/job/42017507548) is the error i get. Any ideas?

---

<div class="post-metadata">

**Author:** ![kellertuer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kellertuer/32/220707_2.png) [@kellertuer](https://discourse.julialang.org/u/kellertuer)\
**Post date:** [May 12, 2025, 4:47am UTC](https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910/4 "2025-05-12T04:47:34Z")

</div>

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](https://github.com/JuliaDocs/Documenter.jl/pull/2676#discussion_r2082477911) – a PR is already crafted at [Use appropriate show method for PageLink by mortenpi · Pull Request #2714 · JuliaDocs/Documenter.jl · GitHub](https://github.com/JuliaDocs/Documenter.jl/pull/2714).

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

---

<div class="post-metadata">

**Author:** ![Marco-Congedo](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/marco-congedo/32/7321_2.png) [@Marco-Congedo](https://discourse.julialang.org/u/Marco-Congedo)\
**Post date:** [May 12, 2025, 4:53am UTC](https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910/5 "2025-05-12T04:53:03Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![mortenpi](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mortenpi/32/158_2.png) [@mortenpi](https://discourse.julialang.org/u/mortenpi)\
**Post date:** [May 13, 2025, 2:39am UTC](https://discourse.julialang.org/t/documenter-jl-htmlwriter-rendering-html-pages-loops-forever/128910/6 "2025-05-13T02:39:26Z")

</div>

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

> <https://github.com/JuliaRegistries/General/pull/130821>
>
> \- Registering package: Documenter
> \- Repository: https://github.com/JuliaDocs/Doc…umenter.jl
> \- Created by: @mortenpi
> \- Version: v1.11.1
> \- Commit: 92adad9333a6a20665793e146aaf2acfe75eab07
> \- Git reference: HEAD
> \- Description: A documentation generator for Julia.
