Re: [Firebird-docs] Example of new documentation

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

On 11-05-2020 14:30, Paul Vinkenoog wrote:
> Dmitry Yemanov wrote:
> 
>> 4) I don't like how titles of <note> / <important> blocks are rendered,
>> they're just italic of the default size. I'd prefer a bigger font (and
>> maybe a different colour) as it was in the old version.
> 
> I don't think it looks good if notes, warnings and the like have a bigger
> font than the main text - just as long as they stand out by indentation,
> a border, an icon, maybe italics (rather not bold), and/or cetera.

Dmitry is specifically talking about the title of an admonition (note, 
tip, warning). In the PDF the admonition title is in italics + slightly 
smaller font than body text which doesn't make it really stand out. In 
the HTML it is italic + darker than the body text of the admonition, but 
also a slightly smaller font.

> BTW, in the old version (if you mean the current docs by that), notes
> and other admonitions have a somewhat smaller font than the main
> text (I prefer that, actually).

The current rendering (in HTML) uses the same size for the admonition 
body as for the main text, but a slightly smaller font-size for the 
title, which is a bit weird.

I'll see if I can tweak it a bit.

Mark
-- 
Mark Rotteveel