I have published an PDF and HTML version of the Firebird 2.5 Language
Reference built from asciidoc. I have used some elements of style from
the old documentation, but a lot of it is based on the standard asciidoc
styles.
Could you look at the overall style of things to see if there are things
you really don't like.
https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25.html
https://www.lawinegevaar.nl/fbdocs/pdf/en/experiment/fblangref25.pdf
To be clear, the asciidoc sources of this document still contain various
problems that I haven't addressed yet, so rendering of some parts might
be weird or incorrect.
Examples of things that I know are weird:
- A lot of code blocks are rendered in italic and have a big double
quote in front due to usage of blockquote
- Some tables are broken (wrong number of columns), the conversion tool
doesn't handle multiple header rows with multiple spans, this needs to
be fixed manually, and I only want to do that once on final conversion
of a document
- Reserved words list is rendered incorrectly
I'm primarily interested in feedback on the overall style, but feel free
to point out oddities.
Mark
--
Mark Rotteveel
_______________________________________________
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
