Commit graph

76 commits

Author SHA1 Message Date
Glen Barber
0aa859afda Update the 12.0R release documentation following the recent move
from the base repository with changes provided by hrs@, and further
tweaks from myself.

Of note:
- Consolidate duplicated logic throughout the Makefiles and shared
  logic, and move files to more sane locations where they may be
  shared by other parts of the build tools.
- Update location of several entity files.
- In the top-level Makefile, only include the hardware page if the
  MAN4PAGES knob is set.  This is done to prevent build failures on
  the website until the webupdate script and wrapper are updated,
  which will require some more thought. [1]

This fixes the 'reldoc' target in release/Makefile in head, found
to be broken a few days ago.

[1] Changes from myself.

Patch provided by:	hrs
Sponsored by:	The FreeBSD Foundation
2017-12-07 19:58:47 +00:00
Wolfram Schneider
c305c981c3 show filename in error message 2017-09-13 09:02:06 +00:00
Warren Block
7db5f9e9e3 Add an entry so <errorname> is displayed in monospace italic text.
Approved by:	doceng (implicit)
2016-02-26 04:59:09 +00:00
Mathieu Arnold
fa89649662 Fix indentation in docbook.css.
Approved by:	wblock
Sponsored by:	Absolight
2015-09-04 14:25:59 +00:00
Mathieu Arnold
55a52a50bb Fix display of the note/tip/important/warning/caution when there are
more than one paragraph.

Approved by:	wblock
Sponsored by:	Absolight
2015-09-04 14:25:50 +00:00
Warren Block
cb57077ee3 Separate paragraphs in admonitions. Thanks for diagnosis to Allan Jude. 2015-09-02 00:34:19 +00:00
Warren Block
12b6d61396 Even out the padding for admonitions. 2015-08-16 22:40:01 +00:00
Warren Block
3728fea8d2 Remove extra comma located by the w3.org CSS validator.
PR:		202242
Submitted by:	mexas@bris.ac.uk
Reviewed by:	allanjude
Differential Revision:	https://reviews.freebsd.org/rD42009
2015-08-11 20:28:50 +00:00
Warren Block
138bb9156e A few miscellaneous changes to docbook.css to improve the appearance of
elements that should be displayed in monospace fonts.

Reviewed by:	allanjude
Differential Revision:	https://reviews.freebsd.org/D3313
2015-08-10 22:41:06 +00:00
Warren Block
0102e1ea5e Fix a typo that gave an invalid unit. 2014-09-08 23:41:04 +00:00
Gavin Atkinson
697b7b2748 e a serif font when printing.
Discussed on:	-doc (about 18 months ago)
2014-08-08 17:53:25 +00:00
Warren Block
fd948b0af1 Remove a line-height: 1.0 from the body pre section. It caused <screen>
and <programlisting> elements to be vertically compressed and difficult
to read.  Discussed in IRC.
2014-07-29 20:59:40 +00:00
Warren Block
a840440b00 Remove bold highlighting for <application> elements. Discussed on
freebsd-doc mailing list:
http://lists.freebsd.org/pipermail/freebsd-doc/2014-June/023883.html
2014-06-30 03:28:42 +00:00
Glen Barber
77e993c3f6 Add a few elements to the db.common.attributes definition:
- vendorurl
 - sponsor
 - sponsorurl
 - contrib

This will allow attribution for sponsored or contributed
work on FreeBSD in the release notes.

This is a prerequisite to additional upcoming changes.

While here, modify docbook.css to recognize a new 'contrib'
<span> class.

Also, set FreeBSD=%H on docbook50.dtd to allow the commit
to go through.

Sponsored by:	The FreeBSD Foundation
2014-05-07 18:57:40 +00:00
Warren Block
4f7690f0f7 Restore a missing border-radius, reduce border radius to keep small
boxes from looking oval.
2014-04-05 02:09:17 +00:00
Gabor Kovesdan
8858f6979c - Revert verbatim line numbering changes since they broke callouts and
other inline markup

PR:		docs/187773
Submitted by:	Allan Jude <freebsd@allanjude.com>
2014-03-25 07:04:45 +00:00
Warren Block
ff3975af95 Improve Handbook ToC readability. Adjust link colors based on
http://en.wikipedia.org/wiki/Help:Link_color.  This makes links less
garish and less distracting when near plain text.

PR:		docs/186857
Submitted by:	Allan Jude <freebsd@allanjude.com>
2014-03-22 19:06:49 +00:00
Warren Block
aeeae9aa4e Fix the display of line numbers in screen and programlisting elements.
Later version of the patch supplied by Allan Jude
<freebsd@allanjude.com>.

PR:		docs/187733
Submitted by:	Dru Lavigne <dru@freebsd.org>
2014-03-20 04:13:05 +00:00
Warren Block
6d5231d53e Remove line-height settings for lines in screen and programlisting
elements which were hiding underlines in text.

Submitted by:	James Riggs <equipages@gmail.com>
2014-03-05 02:28:59 +00:00
Gabor Kovesdan
38b32d78ce - Add line number indicators to programlisting and screen in the HTML
version. This makes linewrap indicators unnecessary since the
  line numbers suggest where the line is wrapped.

No objection from:	doc
2014-03-03 16:16:57 +00:00
Warren Block
4c60b949d6 Improve XHTML table of contents readability by reducing vertical spacing
and using slightly larger fonts for headings.

PR:		docs/186858
Submitted by:	Allan Jude <freebsd@allanjude.com>
2014-02-24 20:06:13 +00:00
Warren Block
5cd65a46d8 Improve the spacing of callout lists. Thanks to Allan Jude for his help. 2014-02-05 17:31:48 +00:00
Gabor Kovesdan
9205a7ee5a - Revert the change of the size of admonition boxes since it did not render
fine when embedded to procedures (should that be allowed at all?)

Reported by:	wblock
2014-02-04 14:47:02 +00:00
Gabor Kovesdan
75d5254c5a - Reduce bottom padding in admonition boxes
Reported by:	wblock
2014-01-22 11:16:07 +00:00
Gabor Kovesdan
26483d1c82 - Make the admonition boxes consistent
Reported by:	wblock
2014-01-22 11:08:48 +00:00
Gabor Kovesdan
a71d7bf3e6 - Render terms as bold and add some top margin to avoid sticking it to
tables in the previous definition

PR:		docs/181121
Submitted by:	Ken Reed <kreed002@gmail.com>
2014-01-22 10:27:50 +00:00
Gabor Kovesdan
8dedf73a24 - Render port and package names as links to their package description as they
used to be rendered

Reported by:	wblock
2014-01-10 18:18:51 +00:00
Warren Block
0cacc5cb47 Show port names in monospace italic. 2014-01-09 02:28:38 +00:00
Warren Block
eeee0b20e6 Add "overflow: auto;" to CSS. With Firefox and other browsers, this
puts a scrollbar on programlisting and screen elements that have lines
too long to fit on the screen.  The previous version just wrapped these
long lines with no indication.  Proposed on the -doc mailing list in
August, no public objections, discussed with gabor@ who may have an
alternate method.  In the meantime, this is better than what we had.
2013-12-17 23:20:30 +00:00
Gabor Kovesdan
d8198c0872 - Restore colored background for screen
- Render userinput as bold

Reported by:	wblock
2013-11-12 10:11:03 +00:00
Gabor Kovesdan
91b1380f4e - Explicitly list some font directories, it seems FOP does not find somee font
otherwise

Reported by:	many
2013-11-12 09:59:59 +00:00
Gabor Kovesdan
e755cbb739 - Restore grey background for programlisting
Submitted by:	pluknet
2013-11-11 16:09:14 +00:00
Gabor Kovesdan
86a8d2d471 MFH 2013-11-05 15:52:37 +00:00
Warren Block
6cedb661a6 Make userinput bold, add box and light background color to screen elements.
Asked on -doc on 2013-07-23, no objections.
2013-08-13 17:27:38 +00:00
Gabor Kovesdan
988c5ce88c - MFH 2013-07-24 19:11:16 +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
Warren Block
8ec1643f75 Enhancements of the CSS. Reduce indents, add spacing between table
columns, make admonishments a bit wider.  Thanks to Allan Jude and db@
for help with this.

Reviewed by:	gabor
2013-07-21 14:42:14 +00:00
Gabor Kovesdan
480e4220cf - Add a FOP config file and use it 2013-07-11 19:27:42 +00:00
Gabor Kovesdan
ecd76805e8 - Example has a title not just a label so the content can start in the
second line.  This fixes some rendering issues in the fdp-primer. [1]

Reported by:	wblock [1]
2013-06-23 20:28:38 +00:00
Isabell Long
f3a760eabf Change the documentation from a serif font to a sans-serif font, in order
to improve readability.

Discussed on: freebsd-doc@
2013-05-31 14:46:48 +00:00
Gabor Kovesdan
f4f6d84a74 - Add a boxed formatting for procedure descriptions 2013-05-13 16:51:51 +00:00
Gabor Kovesdan
478de03cac - Readjust styling for some recent changes 2013-05-12 17:36:00 +00:00
Gabor Kovesdan
581bb4d850 - Create cleaner XHTML and exclusively use CSS for formatting 2013-04-11 06:35:51 +00:00
Gabor Kovesdan
e1acf87ead - Render corpauthor in the same way as author
- Use more consistent styling for Table of Contents, and List of Foobar
  headers
2013-04-06 16:41:29 +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
be2bbeeff4 - Add support for the svnref element 2013-03-14 20:36:44 +00:00
Gabor Kovesdan
6dc14c39e4 - Fix formatting of warning, tip, etc. 2013-03-08 09:33:05 +00:00
Gabor Kovesdan
6186404cc9 - Readjust CSS styling to work with the new XHTML structure 2013-03-03 21:08:24 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
31698a11f5 - Add a Subversion config fragment that sets the SVN properties when adding
files
2012-10-20 12:26:26 +00:00