Handling entities

[kkaempf]

DocBook entities (like &version;) need to

• be converted to asciidoc {version}
• be defined at one place

https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#attributes-and-substitutions shows how to define entities at the top of the file. Top-of-file definitions are hard to implement with a streaming converter like docbookrx. Therefore, the entity definitions should go to a separate file to be included at every asciidoc header.

Actions

• create suse_entities.adoc
• include this file for every document
• report undefined entities, these must be added to suse_entities.adoc

[kkaempf]

This one is hard. xmllint does it right (replacing known entities, leaving unknowns in place), but Nokogiri either complains about "unknown entity" (strict parsing) or replaces unknowns with "" :disappointed:

[kkaempf]

visit_entity_ref does the trick!

[jcayouette]

We can close this right?

[kkaempf]

No, we can't. Still doesn't work :disappointed: