From owner-freebsd-doc@FreeBSD.ORG Thu Jun 20 17:03:40 2013 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id C1587426; Thu, 20 Jun 2013 17:03:40 +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 66B631725; Thu, 20 Jun 2013 17:03:40 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r5KH3Y7s063184; Thu, 20 Jun 2013 11:03:34 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r5KH3YMN063181; Thu, 20 Jun 2013 11:03:34 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Thu, 20 Jun 2013 11:03:34 -0600 (MDT) From: Warren Block To: Hiroki Sato Subject: Re: RFC: Profiling and merging for the print edition In-Reply-To: <20130621.005500.1354772635358785822.hrs@allbsd.org> Message-ID: References: <20130621.005500.1354772635358785822.hrs@allbsd.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.4.3 (wonkity.com [127.0.0.1]); Thu, 20 Jun 2013 11:03:34 -0600 (MDT) 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: Thu, 20 Jun 2013 17:03:40 -0000 On Fri, 21 Jun 2013, Hiroki Sato wrote: > Warren Block wrote > in : > > wb> My proposal for merging the ISBN branch and getting out of our > wb> two-branch problem. > wb> > wb> First, profiling works. A demo file of the Porter's Handbook is here: > wb> http://wonkity.com/~wblock/profiledemo/ > wb> > wb> After applying the patch, build either the online or print version of > wb> the book with: > wb> > wb> make EDITION=online clean book.html > wb> make EDITION=print clean book.html > wb> > wb> The "online" version includes all sections with edition="online" or an > wb> edition not set. > > Please do not add a separate make variable for that. We already have > FORMATS, and setting profiling variables (profile.attribute and > profile.value in XSLT) based on it should work. You mean a new format should be added, like "pdf-withoutonline"? That sounds like a better option. > Also, we should consider/discuss what kind of difference we need > actually and should allow between the two first. Basically I am > against marking up everything with "online" or "print" because it > just makes the source files complicated. I think it is useful only > for separating lengthy preface, edition history, and pgpkey list from > the body in book.xml. Agreed. The experiment showed that only sections which should not be included in the printed book could be marked with edition="online". All other sections would be left with edition unset. There is a complication. Links to sections which have been eliminated by profiling will break, so those would also need profiling. I don't know how big an issue that will be, but suspect it will not be very much. Hopefully, the profiling will be unobtrusive enough so that it can be done in head. That will make turnaround time for the next printed version of the Handbook much shorter.