Write non-breaking space as "~" in LaTeXWriter

CHANGELOG.md

@@ -3,6 +3,13 @@
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## Unreleased
+
+### Fixed
+
+* Non-breaking spaces are now properly converted as "~" in the `LaTeXWriter`.
+
+
 ## Version [v1.1.1] - 2023-10-12
 
 ### Fixed

Project.toml

@@ -1,6 +1,6 @@
 name = "Documenter"
 uuid = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
-version = "1.1.1"
+version = "1.1.2-dev"
 
 [deps]
 ANSIColoredPrinters = "a4c015fc-c6ff-483c-b24f-f7ea428134e9"

src/latex/LaTeXWriter.jl

@@ -804,6 +804,7 @@ latex(io::Context, node::Node, ::MarkdownAST.LineBreak) = _println(io, "\\\\")
 
 const _latexescape_chars = Dict{Char, AbstractString}(
     '~' => "{\\textasciitilde}",
+    '\u00A0' => "~",  # nonbreaking space
     '^' => "{\\textasciicircum}",
     '\\' => "{\\textbackslash}",
     '\'' => "{\\textquotesingle}",

test/latexwriter.jl

@@ -1,6 +1,7 @@
 module LaTeXWriterTests
 
 using Test
+import Documenter
 import Documenter.LaTeXWriter
 
 @testset "file ordering" begin
@@ -32,4 +33,39 @@ import Documenter.LaTeXWriter
     ]
 end
 
+
+function _dummy_lctx()
+    doc = Documenter.Document()
+    buffer = IOBuffer()
+    return LaTeXWriter.Context(buffer, doc)
+end
+
+function _latexesc(str)
+    lctx = _dummy_lctx()
+    LaTeXWriter.latexesc(lctx, str)
+    return String(take!(lctx.io))
+end
+
+function _md_to_latex(mdstr)
+    lctx = _dummy_lctx()
+    ast = Documenter.mdparse(mdstr; mode=:single)[1]
+    LaTeXWriter.latex(lctx, ast.children)  # should use latexesc internally
+    return String(take!(lctx.io))
+end
+
+
+@testset "latex escapes" begin
+
+    md = "~ Ref.\u00A0[1], O'Reilly, \"Book #1\""
+    tex = "{\\textasciitilde} Ref.~[1], O{\\textquotesingle}Reilly, {\\textquotedbl}Book \\#1{\\textquotedbl}"
+    @test _latexesc(md) == tex
+    @test _md_to_latex(md) == tex
+
+    md = "[DocumenterCitations.jl](https://github.com/JuliaDocs/DocumenterCitations.jl#readme)"
+    tex = "\\href{https://github.com/JuliaDocs/DocumenterCitations.jl\\#readme}{DocumenterCitations.jl}"
+    @test _md_to_latex(md) == tex
+
+end
+
+
 end