From owner-freebsd-doc@FreeBSD.ORG Wed Feb 27 01:24:34 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id BEB6B778; Wed, 27 Feb 2013 01:24:34 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 4CDB0F67; Wed, 27 Feb 2013 01:24:34 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.6/8.14.6) with ESMTP id r1R1OXYt049487; Tue, 26 Feb 2013 18:24:33 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.6/8.14.6/Submit) with ESMTP id r1R1OX03049484; Tue, 26 Feb 2013 18:24:33 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Tue, 26 Feb 2013 18:24:33 -0700 (MST) From: Warren Block To: Gabor Kovesdan Subject: Re: [CFR] Migrating the documentation to a real XML toolchain In-Reply-To: <512D2F9C.8080403@FreeBSD.org> Message-ID: References: <512D2F9C.8080403@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Tue, 26 Feb 2013 18:24:33 -0700 (MST) Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Feb 2013 01:24:34 -0000 On Tue, 26 Feb 2013, Gabor Kovesdan wrote: > I have some improvements for the doc infrastructures in the xml-tools branch. > I think that the changeset is now getting mature enough to be merged back so > I'd like to ask for review. It does not affect the web pages, only books and > articles. The rendered docs are available at: > http://people.freebsd.org/~gabor/db45/ > > For every article/book, you will find there the chunked XHTML docs or if you > manually enter the URL, you can access the single XHTML and PDF versions as > (article|book)\.(html|pdf). Thanks for all your work on this! Noticed when looking at the English version of the Handbook: Author info is a little off. Compare the authors at the start of the bsdinstall chapter: http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/bsdinstall.html http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall.html In the standard version, each section is rendered as a sentence, with multiple authors separated by commas. Acronyms don't have any highlights, they just look like normal text. Table rendering in the new version looks better than the old on the svn mirrors. Notes, tips, and warnings are not shown in color boxes. Examples are, though. Callout labels are missing, although the explanations below are present. See "2.4.1.3. Booting for SPARC64": http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/bsdinstall-start.html#bsdinstall-boot-loader-menu http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall-start.html#bsdinstall-boot-loader-menu Pictures (screenshots) are missing: http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/using-bsdinstall.html http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/using-bsdinstall.html Man page entities are not links, just text. are rendered in bold. Just a difference, not necessarily a problem: http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/GEOM-mirror.html http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html Thanks again!