Commit graph

4042 commits

Author SHA1 Message Date
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
5b6ecc816f - Add dblatex customization for Japanese 2013-07-21 14:50:28 +00:00
Gabor Kovesdan
4befd50e40 - Somehow hyphenation path handling is buggy but it works when set in the
base path
2013-07-21 14:49:22 +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
7d8720ec06 - Use the xetex backend since it works better for Unicode 2013-07-21 14:14:43 +00:00
Gabor Kovesdan
a751e1e60f - verbatim hyphenation requires higher recursion depth 2013-07-21 14:05:38 +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
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
480e4220cf - Add a FOP config file and use it 2013-07-11 19:27:42 +00:00
Gabor Kovesdan
b25caf6d4a - Disable hyphenation for now 2013-07-11 19:24:55 +00:00
Gabor Kovesdan
888db9ae19 - MFH 2013-07-11 17:27:09 +00:00
Gabor Kovesdan
b0b78fa4e9 - Indexterms should not be embedded directly into a question or answer
element but into a deeper paragraph, optimally right after the
  referenced word without spaces even [1] but somehow the schema allows
  badly nested indexterms.  Correct such entires in the whole documentation
  set.
- Add constraints to check for invalid indexterm entries.

See also: http://www.sagehill.net/docbookxsl/GenerateIndex.html#Indexterms [1]
2013-07-11 16:34:54 +00:00
John Marino
a62d658661 Add John Marino to developers list
Approved by:	bapt (mentor)
2013-07-10 21:40:29 +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
Murray Stokely
2c4a0195a9 Add link to YouTube playlist of BSDCan 2013 presentations. 2013-07-09 08:33:48 +00:00
Murray Stokely
128d5c6f7a Remove Upcoming links from our events pages. Upcoming was a Yahoo!
service for events that has since been turned down and was never used
much by this community in the first place so the links were not that
useful even when Upcoming was available and popular (it is now long
since completely turned down and the links all jus go to yahoo.com).

Meetup.com is the most popular service for upcoming technology meetups
in the bay area at least, and is used by the local BAFUG, but the
links are probably best added manually for events instead of optimistically
adding a link that tries to search on meetup.com for something
matching the event.
2013-07-09 08:32:42 +00:00
Rene Ladan
96f745fe66 Resolve whitespace-only changes against projects/entities (r40263)
Approved by:	gjb (mentor)
2013-07-07 22:15:36 +00:00
Gabor Kovesdan
d31228bd31 - MFH 2013-07-06 15:14:42 +00:00
Gabor Kovesdan
0dcb7a2f33 - Avoid footnotes in tables; it looks strange and is problematic for
some tools. (Either removed if the affected text has been removed
  from the English version or moved into parentheses.)
- Add constaints to avoid programlisting, screen and footnote in tables.
2013-07-06 14:05:02 +00:00
Gavin Atkinson
e09e953e37 Update with new UIDs and signatures. 2013-07-04 20:39:32 +00:00
Gabor Kovesdan
57cba96872 - MFH 2013-07-04 19:03:44 +00:00
Luiz Otavio O Souza
268142e918 - add my pgp key file
- update share/pgpkeys/pgpkeys.ent

- update share/pgpkeys/pgpkeys-developers.xml

Approved by:	adrian (mentor)
2013-07-04 01:46:01 +00:00
Luiz Otavio O Souza
34de6112e6 - add myself to share/xml/authors.ent and share/xml/developers.ent
- add myself to en_US.ISO8859-1/articles/contributors/contrib.committers.xml

- remove myself from en_US.ISO8859-1/articles/contributors/contrib.additional.xml

- add the news entry on share/xml/news.xml

Approved by:	adrian (mentor)
2013-07-04 01:40:16 +00:00
Gabor Kovesdan
e819151e45 - Fix the cases when the specified column number does not match the real one
- Add a constraint for this
2013-07-03 17:35:46 +00:00
Gabor Kovesdan
2de4169711 - Add experimental support for dblatex 2013-07-03 15:22:19 +00:00
Tony Finch
658ba1303d The last UK cvsup server is going away, so remove all its aliases. 2013-07-03 15:06:52 +00:00
Gabor Kovesdan
9eb4987236 - Manually merge manpage entities 2013-07-03 15:04:06 +00:00
Gabor Kovesdan
a4722b0475 - Add support for RELAX NG validation since it is the normative DB 5.0
schema.  The DTD validation still does a good job so there is no need
  to install Java; RNG validation is optional
2013-07-03 12:07:50 +00:00
Gabor Kovesdan
fc03eb5c00 - MFH 2013-07-03 10:43:17 +00:00
Gabor Kovesdan
e2e8ddc90e - Add constraint to check the required title element
- Add constraint to check colname and spanname attributes on table entries
2013-07-03 10:17:02 +00:00
Warren Block
b09fcf35cc Add a link to the documentation archive on the Documentation navigation
sidebar.

Reviewed by:	gjb
2013-07-02 13:55:18 +00:00
Gabor Pali
de949f16f9 - Add a news entry for the BSDCan 2013 developer summit special 2013-07-02 13:37:51 +00:00
Gabor Kovesdan
11421c72e2 - Add a constraint to check the validity of titles 2013-07-02 09:20:09 +00:00
Gabor Kovesdan
4db9d86d82 - Port stylesheets to namespaced processing 2013-06-30 09:58:03 +00:00
Gabor Kovesdan
b422bc43c3 - Drop DTD after parsing 2013-06-30 09:22:48 +00:00
Gabor Kovesdan
751080fed4 - FOP extensions do not seem to work properly 2013-06-30 09:21:55 +00:00