Re: [Firebird-docs] Example of new documentation

[Mark R. <ma...@la...>]

On 10-05-2020 15:18, Paul Vinkenoog wrote:
> Mark Rotteveel wrote:
> 
>> 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/pdf/en/experiment/fblangref25.pdf
> 
> First reaction to the PDF:
> 
> - Overall, OK!
> 
> - Document title and author listing: really don't like the right-alignment here,
> I'd rather see it left-aligned or centered.
> 
> - Navigation pane: only has a depth of 2 (chapter and top-level paragraph).
> This means that lots of 2nd- and 3rd-level paragraphs are now missing from
> the nav pane. It would be very useful having them back.
> 
> - Some of the fonts are not very pleasant to the eye (at least my eye); they
> look horizontally compressed.
> 
> - Some other fonts are too big (e.g. in Examples sections), but I guess you
> already know that; this is simple a matter of adjustment, nothing complicated.

I made some minor tweaks: 
https://www.lawinegevaar.nl/fbdocs/pdf/en/experiment/fblangref25/fblangref25.pdf

Specifically I changed:
- admonition captions/titles are now bold instead of italic
- text on title page is now centered

With regard to the code font, I didn't want to spend too much time 
experimenting with that now. As to the size of fonts being too big in 
examples sections, that is due to the use of blockquotes, so it should 
disappear once I have removed them, and otherwise we can tweak the size 
further later.

Mark
-- 
Mark Rotteveel