Fix empty lines being generated in LaTeX output for hidden @repl entries (#2056)

Co-authored-by: Morten Piibeleht <[email protected]>
Co-authored-by: Max Horn <[email protected]>

Author: 3 people

CHANGELOG.md

@@ -12,7 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Fixed
 
 * Don't require custom themes to set a color for the 'todo' admonition. ([#2576])
-
+* Entries in `@repl` blocks that were hidden with `# hide` no longer produce erroneous empty lines ([#1521], [#2054], [#2399])
 
 ## Version [v1.9.0] - 2025-03-17
 
@@ -1678,6 +1678,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#1518]: https://github.com/JuliaDocs/Documenter.jl/issues/1518
 [#1519]: https://github.com/JuliaDocs/Documenter.jl/issues/1519
 [#1520]: https://github.com/JuliaDocs/Documenter.jl/issues/1520
+[#1521]: https://github.com/JuliaDocs/Documenter.jl/issues/1521
 [#1526]: https://github.com/JuliaDocs/Documenter.jl/issues/1526
 [#1527]: https://github.com/JuliaDocs/Documenter.jl/issues/1527
 [#1529]: https://github.com/JuliaDocs/Documenter.jl/issues/1529
@@ -1849,6 +1850,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#2019]: https://github.com/JuliaDocs/Documenter.jl/issues/2019
 [#2027]: https://github.com/JuliaDocs/Documenter.jl/issues/2027
 [#2051]: https://github.com/JuliaDocs/Documenter.jl/issues/2051
+[#2054]: https://github.com/JuliaDocs/Documenter.jl/issues/2054
 [#2058]: https://github.com/JuliaDocs/Documenter.jl/issues/2058
 [#2066]: https://github.com/JuliaDocs/Documenter.jl/issues/2066
 [#2067]: https://github.com/JuliaDocs/Documenter.jl/issues/2067
@@ -1933,6 +1935,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#2375]: https://github.com/JuliaDocs/Documenter.jl/issues/2375
 [#2378]: https://github.com/JuliaDocs/Documenter.jl/issues/2378
 [#2394]: https://github.com/JuliaDocs/Documenter.jl/issues/2394
+[#2399]: https://github.com/JuliaDocs/Documenter.jl/issues/2399
 [#2406]: https://github.com/JuliaDocs/Documenter.jl/issues/2406
 [#2408]: https://github.com/JuliaDocs/Documenter.jl/issues/2408
 [#2410]: https://github.com/JuliaDocs/Documenter.jl/issues/2410

src/expander_pipeline.jl

@@ -926,8 +926,8 @@ function Selectors.runner(::Type{Expanders.REPLBlocks}, node, page, doc)
 
         outstr = String(take!(out))
         # Replace references to gensym'd module with Main
-        outstr = remove_sandbox_from_output(outstr, mod)
-        push!(multicodeblock, MarkdownAST.CodeBlock("documenter-ansi", rstrip(outstr)))
+        outstr = rstrip(remove_sandbox_from_output(outstr, mod))
+        !isempty(outstr) && push!(multicodeblock, MarkdownAST.CodeBlock("documenter-ansi", outstr))
     end
     node.element = Documenter.MultiCodeBlock(x, "julia-repl", [])
     for element in multicodeblock

test/examples/references/latex_simple.tex

@@ -2,7 +2,7 @@
 \newcommand{\DocMainTitle}{Documenter LaTeX Simple Non-Docker}
 \newcommand{\DocVersion}{1.2.3}
 \newcommand{\DocAuthors}{}
-\newcommand{\JuliaVersion}{1.11.1}
+\newcommand{\JuliaVersion}{1.11.4}
 
 % ---- Insert preamble
 \input{preamble.tex}
@@ -254,4 +254,26 @@ \section{Issue 2300}
 
 
 
+\section{PR 2056}
+
+
+
+\label{1659457410429464311}{}
+
+
+Issues: \texttt{\#1521}, \texttt{\#2054}, \texttt{\#2399}
+
+
+
+
+\begin{minted}{jlcon}
+julia> println(x)
+2
+
+julia> x
+2
+\end{minted}
+
+
+
 \end{document}

test/examples/src.latex_simple/index.md

@@ -131,3 +131,14 @@ lines**.
 ## Issue 2300
 
 You Shall Not Break! You Shall Not Break! You Shall Not Break!
+
+## PR 2056
+
+Issues: `#1521`, `#2054`, `#2399`
+
+```@repl
+x = 1 # hide
+x = 2 # hide
+println(x)
+x
+```