On 25-04-2020 12:53, Mark Rotteveel wrote:
While trying out things for conversion to asciidoc, I found several
issues with our current XML which makes some of it invalid docbook (does
not conform to the schema docbook 4.5 schema).
With some testing, I found out that fixing these issue, makes the
quality of the conversion to asciidoc better (requiring less manual fixes).
However, making these changes will touch a lot of the XML sources. I
will send a message when I have merged those changes. When this is done,
please make sure to update the sources from master because the resulting
merge conflicts would be painful to resolve (as in: a lot of work).
I won't touch the Firebird 4 release notes for now to avoid possible
merge conflicts there. If there are other documents that are better left
alone for now because there is work-in-progress, let me know.
While working on this, I noticed that some documents apply weird tricks
to offset source listings. For example sometimes <programlisting> or
<screen> is wrapped in a <blockquote> so the code-block is offset from
the page margin, or they have a wide whitespace prefix so the code has
an offset inside the code-block. These seem to be tricks that might have
better been solved through styling.
When converting to asciidoc, such tricks result in markup that is less
than optimal (and the default styles will render it as a quote, which
this isn't).
Are there objections if I 'normalize' this as well (no <blockquote>, and
no extra whitespace inside the <programlisting>)?
Mark
--
Mark Rotteveel
_______________________________________________
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
