LaTeX Export: PlantUML not rendering and document names with spacec cause problems

[opt12]

Problem

• PlantUML diagrams don't render in generated PDFs due to outdated Inkscape
  syntax.
• When using PlantUML diagrams, a local version of PlantUML needs to be installed.

When the documents in a project contain spaces in the name attribute, the LaTeX compile fails.

Steps to reproduce

• When trying to LaTeX export the requirements bundled with the doorstop sources, the LaTeX run fails in the TUT.tex document.

Use a windows machine with a recent inkscape version (Inkscape 1.4.2 (f4327f4, 2025-05-13)).
Publish the doorstop requirements

cd /c/sources/doorstop
doorstop publish --latex all ./latex
cd latex
./compile.sh

This either renders an error when no local PlantUML is installed or when the SVG file generated is to be converted to PDF for inclusion in the LaTeX output.

• Try to add a document with spaces in the name attribute in the .doorstop.yml file.

This renders an error as LaTeX cannot \input files containing spaces. (Called from \zexternaldocument and \externaldocument)

Impact

Severity: Critical - PDF export unusable for production documentation

Affected users: Anyone generating LaTeX/PDF exports with:

• PlantUML diagrams
• Document names with spaces

Proposed Solution

• change calling syntax for PDF Generation from PlantUML to current Inkscape syntax
• Add a documentation page explaining how to install Inkscape and local PlantUML
• Replace spaces in filenames derived from document name with dashes -.

[opt12]

@jacebrowning There are some more issues with the LaTeX export I experience with our production requirement set. However, I'll tackle this in smaller chunks.

(I thought I generated a all-in-one solution, however I found out that I was trapped in the AI rabbit hole which resulted in an overly complex solution which still doesn't handle all corner cases correctly. So let's go in smaller steps.)