* Generate EPUB3
* Wrap programlistings if necessary
* Use grey background and smaller fonts for programlistings
* Justify main text
* Do not break after table caption
- Add support for a single variable that indicated whether we are building
for screen or for print. In the latter case, blue links are disabled
and the URI of links is included in a footnote.
some advanced features, like PDF bookmarks.
- Allow breaking lines of verbatim elements at spaces. Such a break is
denoted with a special arrow symbol. This technique is commonly used
in technical books to present long source lines.
- Use other monospace font, that has an appropriate arrow symbol for this.
- Add some padding to verbatim environments.
* B5 paper size
* chapters always start on recto
* the current chapter in indicated by the verso header and the current
section by the recto header
* render page numbers at the outer side of the foooter
* sections are automatically labelled
* bibliography entries are enumerated
* captions of figures and equations are rendered after
* captions of examples, tables and procedures are rendered before
* admonitions are highlighted with an icon and a border
* tables have a grey header with bold labels
* programlistings and screen elements are rendered with a grey background
* guibutton is also rendered with a grey background
* manpage references are real links and it is indicated with the blue color
The primary purposes are to clean up duplicated author definitions in
both share/xml/authors.ent and share/xml/developers.ent, and as a added
bonus simplify writing up author names/email addresses in web pages.
Apart from merging developers.ent into authors.ent, removing the former,
and updating the Committers Guide there should be little user-visible changes:
- a.portmgr renamed to a.portmgr.members
- a.doceng renamed to a.doceng.members
- team.re renamed to a.re.members.email and moved from
share/xml/freebsd.ent to share/xml/authors.ent
- a.core updated and moved from share/xml/mailing-lists.ent to
share/xml/teams.ent
- share/pgpkeys/{addkey.sh|README} updated
Translations are untouched except for build fixes.
Approved by: doceng (gjb)
Approved by: gjb (mentor)
images' long description is put into an external file but it seems
the non-chunked XHTML output does not support manifest yet so
disable external longdescs for now.
