Commit graph

64 commits

Author SHA1 Message Date
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
e755cbb739 - Restore grey background for programlisting
Submitted by:	pluknet
2013-11-11 16:09:14 +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
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
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
Eitan Adler
89b7f2ff85 According to QuirksMode border-radius is supported on:
IE9+, FF10+, Safari 5.1+, Chrome 17+, and Opera 11+.

In other words these compatability hacks are no longer needed.

Approved by:	gabor
No objections:	www@
2012-10-12 12:10:41 +00:00
Gabor Kovesdan
f139bc3486 - Class names and elements are now generated lower case. Adjust the CSS
file accordingly.

Approved by:	doceng (implicit)
2012-08-21 09:32:29 +00:00
Warren Block
c3ebf18dee Be more specific about which table headers to force left-justified so
header and footer elements aren't unjustifiably justified.

Submitted by:	Jason Massey
PR:		www/164454
Reviewed by:	gjb (mentor)
2012-01-25 22:16:36 +00:00
Warren Block
e42b39db05 Fix rendering of calloutlist entries so they appear on the same line as
the definition.

Approved by:	gjb (mentor)
2012-01-07 00:46:26 +00:00
Warren Block
c26ee529de Remove trailing whitespace.
Approved by:	gjb (mentor)
2012-01-06 15:11:37 +00:00
Warren Block
018e7cfc14 Clarity changes:
Left-align table headers so they line up with columns.

  Set line-height: 1.1 in programlistings so descenders have a little
  clearance from the line below.

Appearance changes:
  Remove padding entries from various blockquotes.

  Reduce "body blockquote" line-spacing: from 1.5 to 1.3 so lines don't
  look double-spaced.

  Fix uneven margin spacing on notes and other blockquotes.

  Add rounded border corners.

Reviewed by:	(original version) Niclas Zeising, Remko Lodder, Eitan
		Adler, doc@ (no objections)
Approved by:	gjb (mentor)
2012-01-06 14:20:52 +00:00
Dmitry Morozovsky
4a50f95240 Implement <SVNref> tag element, which generates link to SVNweb to the given
revision.

Mark last two __FreeBSD_version bumps with it, and format long lines.

Prodded by:			glebius
With great DSL help from:	pluknet
2011-12-18 12:51:56 +00:00
Glen Barber
481d1e39b8 Colorize 'caution' blocks.
Feedback from:	manolis, Chad Perrin, Warren Block,
		Steve Craver, Isabell Long, Jason Helfman,
		eadler
Approved by:	jkois (mentor)
2011-03-06 13:18:58 +00:00
Hiroki Sato
49d43a9402 Add more spacing for cells in CALSTABLE. 2010-03-20 04:15:01 +00:00