Commit graph

67 commits

Author SHA1 Message Date
Gabor Kovesdan
988c5ce88c - MFH 2013-07-24 19:11:16 +00:00
Gabor Kovesdan
06c03968c8 - Use Droid Sans for title and sans text; it has Greek and Cyrillic
glyphs and looks good with the body text.
2013-07-23 17:26:10 +00:00
Gabor Kovesdan
444f838276 - Use Gentium fonts 2013-07-23 16:52:04 +00:00
Gabor Kovesdan
bb135e40e0 - Better sort entries 2013-07-22 10:39:06 +00:00
Gabor Kovesdan
01d03772d7 - Suppress list titles since they just break the continuity of the text.
The preceding paragraph always explains what the list is about so
  there is no need for these titles.
2013-07-22 07:31:58 +00:00
Gabor Kovesdan
04740982cc - Render blue links by default.
- 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.
2013-07-21 22:16:16 +00:00
Gabor Kovesdan
88d49943b0 - Highlight examples with a bolder and a title-like caption 2013-07-21 21:31:18 +00:00
Gabor Kovesdan
6d2158a428 - Stick captions where they belong 2013-07-21 17:13:29 +00:00
Gabor Kovesdan
0db1b886b0 - Readjust margins so that page numbers are more separated and thus are
more visible
2013-07-21 16:18:47 +00:00
Gabor Kovesdan
5e21cdac45 - textobjects do not work and we do not need them anyway 2013-07-21 14:36:42 +00:00
Gabor Kovesdan
37bf12cd76 - Add FO titlepage customization 2013-07-21 11:20:40 +00:00
Gabor Kovesdan
879f8d35d2 - Factor out parts that are reusable for FO output 2013-07-21 11:18:51 +00:00
Gabor Kovesdan
7e90dd62e8 - Rename the titlepage specs to reflect that they are used for XHTML 2013-07-21 09:33:05 +00:00
Gabor Kovesdan
2b831af117 - Variablelists look better as blocks
- Add some negative tracking to inline monospace text so that it fits
  better the body text
- Improve padding of verbatim blocks
- Adjust list spacing
2013-07-21 09:14:40 +00:00
Warren Block
1fc2982d3e Use the canonical addresses for -questions and -doc, simplify the
accompanying text.
2013-07-19 04:19:13 +00:00
Gabor Kovesdan
617b5b57d2 - Enable FOP extensions, which eliminate most of the warnings and turn on
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.
2013-07-15 15:23:13 +00:00
Gabor Kovesdan
d6eaaa9699 - Like in XHTML, do not generate outer links in TOC entries since
TOC entries themselves are cross-refereces, so move a customization to
  the common part.
2013-07-15 13:15:06 +00:00
Gabor Kovesdan
3b8d2e4e7f - Enable hyphenation 2013-07-14 08:24:02 +00:00
Gabor Kovesdan
44c2e15ea0 - Customize XSL FO stylesheets to render a more realistic handbook format:
* 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
2013-07-13 16:20:18 +00:00
Gabor Kovesdan
e94dad6215 - 400px width and a proportional height looks like a good default
for most images but some will need more exact parameters on
  an individual basis
2013-07-13 07:39:52 +00:00
Gabor Kovesdan
9ab14a1f7c - Make sure images and callouts are found 2013-07-13 07:02:57 +00:00
Gabor Kovesdan
b25caf6d4a - Disable hyphenation for now 2013-07-11 19:24:55 +00:00
Gabor Kovesdan
eeee1f2177 - userinput should also be bold so that it can be distinguished from the
rest of the screen content

Reported by:	wblock
2013-07-11 17:56:20 +00:00
Gabor Kovesdan
888db9ae19 - MFH 2013-07-11 17:27:09 +00:00
Gabor Kovesdan
0b76ab9d14 - Use UTF-8 in the LaTeX file so that we render all of the languages
- Render all links in blue
2013-07-10 11:57:13 +00:00
Gabor Kovesdan
8893e5621d - Workaround for dblatex escaping in <filename> 2013-07-10 10:38:06 +00:00
Rene Ladan
1d9bea10ed Merge the projects/entities branch into head/
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)
2013-07-09 21:15:47 +00:00
Gabor Kovesdan
fc03eb5c00 - MFH 2013-07-03 10:43:17 +00:00
Gabor Kovesdan
4db9d86d82 - Port stylesheets to namespaced processing 2013-06-30 09:58:03 +00:00
Gabor Kovesdan
751080fed4 - FOP extensions do not seem to work properly 2013-06-30 09:21:55 +00:00
Simon L. B. Nielsen
2f73cffa4b Point people at our prebuilt docs over HTTP instead of FTP.
FTP is just a painful protocol especially when there is a firewall
around, and all mirrors making up ftp.freebsd.org support HTTP.
2013-06-25 22:21:57 +00:00
Gabor Kovesdan
6fcc0e985e - Add customization for buildtarget
- Remove old bits
2013-06-23 10:14:48 +00:00
Gabor Kovesdan
3330d26644 - Do not generate meta description from the abstract since it is not generated
correctly

Reported by:	wblock
2013-06-02 10:52:01 +00:00
Gabor Kovesdan
a7b70eb4e8 - Use namespace-aware stylesheets
- Drop more legacy stuff
2013-05-29 19:29:43 +00:00
Gabor Kovesdan
f2976a4c6d - Port PGP keyring generation to XSLT 2013-05-23 06:12:40 +00:00
Gabor Kovesdan
31fec0dd2f - Manifest should be generated for the whole XHTML file as well since
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.
2013-05-17 20:55:02 +00:00
Gabor Kovesdan
4c135ee021 - Do not render commands in bold
- Merge two patterns
2013-05-13 16:52:32 +00:00
Gabor Kovesdan
d8e60c9b38 - Add a doc format navigation at the end of the titlepage as we used to have 2013-05-12 17:37:57 +00:00
Gabor Kovesdan
0438408178 - Do not render userinput with bold 2013-05-12 17:37:10 +00:00
Gabor Kovesdan
4f41586556 - Add a missing space. 2013-05-08 12:10:29 +00:00
Gabor Kovesdan
fdac88b190 - Fix rendering of the last modified text.
- We have our own complete CSS file so do not generate one with XSLT
2013-05-08 09:27:58 +00:00
Gabor Kovesdan
1c039cc17e - Fix rendering of titles in the toc, which contain a man page reference 2013-04-11 09:29:52 +00:00
Gabor Kovesdan
581bb4d850 - Create cleaner XHTML and exclusively use CSS for formatting 2013-04-11 06:35:51 +00:00
Gabor Kovesdan
c6fd9b9e1c - Make bridgehead actually render as specified in the renderas attribute 2013-04-06 16:40:32 +00:00
Gabor Kovesdan
61d924c5e2 - Better support I18N 2013-04-05 20:14:52 +00:00
Gabor Kovesdan
d518220b58 - Use more human-friendly pubdate and releaseinfo renderings
- Merge copyright years into intervals
- Try to produce cleaner XHTML
2013-04-05 13:11:11 +00:00
Gabor Kovesdan
843e63283c - sectX author rendering needs the same customization as used for chapter
authors
2013-04-04 11:39:28 +00:00
Gabor Kovesdan
d5c6e245d4 - Remove some further unused leftovers
- Make sure printed docs generated with DSSSL always use .eps images
- And XSLT-based output always uses .png
- Fix image conversion
2013-04-01 08:16:09 +00:00
Gabor Kovesdan
9334bf876f - Add titlepage customization so that chapter authors can be rendered as
they used to be
2013-03-23 21:21:23 +00:00
Gabor Kovesdan
a1f0eaf271 - Place the footer below the navigation as it used to be 2013-03-15 08:06:33 +00:00