FDP-primer has many examples of AsciiDoc code , that are placed into files in AsciiDoc format. It is always tricky to correctly represent AsciiDoc using AsciiDoc.
Known problems:
- some of commands (like include::, ifdef::) executed instead of rendering to text, creating wrong output in the original version of the document
- additionally some commands (like include::, ifdef::, all lines started from - and = interpreted as headers) break the work of po4a, that consider the remaining part of code block as usual text, and PO file for translation contain data, that cannot be processed on later steps and require manual correction (in fdp-primer - examples, asciidoc-primer).
Solution:
I propose simple solution: all lines in the code blocks containing AsciiDoc code as example must be prepended by space char. It is not visible, samples of code are rendered fine.
The same technique already used in developers-handbool/kerneldebug chapter - all debugger commands have prepended space char, it works good in original output and in Weblate.
This problem affects mainly these 4 files in FDP-primer. All other documentation has only 2 cases, when example code included line '---' as divider of the code, that is interpreted as AsciiDoc directive.