From owner-freebsd-doc@FreeBSD.ORG Sun Sep 5 19:53:42 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 558BF16A4CE; Sun, 5 Sep 2004 19:53:42 +0000 (GMT) Received: from mail.freebsdmall.com (ns1.freebsdmall.com [69.50.233.146]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4771D43D39; Sun, 5 Sep 2004 19:53:42 +0000 (GMT) (envelope-from murray@freebsdmall.com) Received: by mail.freebsdmall.com (Postfix, from userid 2074) id 882FD1CC2C; Sun, 5 Sep 2004 12:59:32 -0700 (PDT) Date: Sun, 5 Sep 2004 12:59:32 -0700 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040905195932.GG1107@freebsdmall.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.2.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doceng@freebsd.org Subject: More thoughts about slides X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 05 Sep 2004 19:53:42 -0000 I've written a stylesheet layer on top of Norm's default slides stylesheet to render DocBook slides documents in a similar style to my usual OpenOffice template (faded daemon on a white background, blue header, see www.freebsd.org/~murray). We could have multiple stylesheet layers in the tree with a make variable to specify how the user would like the slides rendered. For example, Robert Watson's template (red/orange) would also be easy to write in XSL-FO. I'm writing slides for a presentation that I will give later this week at LinuxExpo Shanghai. That means the slides will contain : * What is FreeBSD? * Who uses FreeBSD? * FreeBSD Development Model (implicit comparison to Linux) * Differences with Linux * FreeBSD Release / Branch Terminology * Recent FreeBSD Releases * FreeBSD 5.3 etc.. Of these, most will be reusable by other presentations in the future. However, I'll probably talk about Linux more than would be the case if it weren't a Linux conference, or maybe the order or depth of those topics would be different. What is the best way to organize and encourage the re-use of these slides? One possibility is just to commit the presentation into one directory and make future presentation authors cut and paste the slide they want to reuse into their new presentation. In that case, I would commit the presentation to : doc/en_US.ISO8859-1/slides/200400909-linuxexpo (or similar). Another option would be to still commit a document into that directory, that s the more shareable slides from a 'common' directory : doc/en_US.ISO8859-1/slides/200400909-linuxexpo doc/en_US.ISO8859-1/slides/common/whatisfreebsd.xml doc/en_US.ISO8859-1/slides/common/freebsdreleases.xml doc/en_US.ISO8859-1/slides/common/freebsdvslinux.xml The files in the 'common' directory would pass through an intermediate stage in the build, so that they can include the contents of various variables (current release, last release date, some features from the release notes, etc..) from other XML/XSL parts of our documentation set. As far as tools, I've recently added support for USE_FOP and USE_XEP since PassiveTeX does not support the background-image property that I wanted for my stylesheet layer. XEP seems to be the clear leader for generating PDF output, but it is a commercial product. Apache's free FOP tool (java) is quite good. Any thoughts or suggestions about this process? If you're in the habit of giving presentations about FreeBSD, what would you look for to consider a DocBook/XML based solution over other (WYSIWYG) tools? Other ideas about ontology and creating a directory hierarchy that encourages more sharing of data between the Handbook, release notes, web site, slides, and other areas of our doc set? Thanks! - Murray