Title formatting (was Re: RFC: Upgrading to DocBook 5.0)

Gabor Kovesdan gabor at FreeBSD.org
Mon Jul 15 08:43:23 UTC 2013


On 2013.07.14. 20:57, Warren Block wrote:
> On Sun, 14 Jul 2013, Gabor Kovesdan wrote:
>
>>> I find different fonts for filenames and commands to be useful, even 
>>> in titles.  The O'Reilly style guide doesn't mention anything about 
>>> title styles, and in a quick search I did not find anything else.
>> Ok, it doesn't specify it explicitly but can you show me a technical 
>> book that has such titles? A real, published book, please, not online 
>> docs.
>
> Mastering Regular Expressions (1998), by Jeffrey E. F. Friedl, shows 
> acronyms in titles in a smaller all-caps size.  There is a Perl 
> chapter with titles including "Modification with \Q and Friends: True 
> Lies", "The /e Modifier", and "Using /g with a Regex That can Match 
> Nothingness".  The "\Q", "/e", and "/g" in those titles are in a 
> monospace typewriter font.  This is an O'Reilly book, but most of the 
> other O'Reilly books I checked use the same font for all of the title.
>
> C Programming, A Modern Approach (2008), by K. N. King, has a Loops 
> chapter with section titles like "The while Loop" and "The do 
> Statement", where "while" and "do" are in a monospace typewriter font.
>
> Advanced Programming in the UNIX Environment (2001), by W. Richard 
> Stevens, has section titles like "stat, fstat, and lstat Functions", 
> "Streams and FILE Objects", and "pty_fork Function". The keywords are 
> in a monospace typewriter font.
>
> UNIX System Administration Handbook (2001), by Evi Nemeth, shows 
> keywords in the same font, but bold.  In "The /etc/ttys and 
> /etc/ttytab files", the filenames are bold. 
Ok, thank you for investigating this. If it is accepted then I don't 
object that much. But please let's keep these at a reasonable extent, 
e.g. monspace or italic but no colors.

Gabor


More information about the freebsd-doc mailing list