From owner-freebsd-doc@FreeBSD.ORG Sun Jan 14 11:11:12 2007 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 224A916A412; Sun, 14 Jan 2007 11:11:12 +0000 (UTC) (envelope-from marc@blackend.org) Received: from postfix2-g20.free.fr (postfix2-g20.free.fr [212.27.60.43]) by mx1.freebsd.org (Postfix) with ESMTP id 9521D13C468; Sun, 14 Jan 2007 11:11:11 +0000 (UTC) (envelope-from marc@blackend.org) Received: from smtp2-g19.free.fr (smtp2-g19.free.fr [212.27.42.28]) by postfix2-g20.free.fr (Postfix) with ESMTP id 8D40B8F3326; Sun, 14 Jan 2007 10:40:49 +0100 (CET) Received: from abigail.blackend.org (bgn92-3-82-227-222-164.fbx.proxad.net [82.227.222.164]) by smtp2-g19.free.fr (Postfix) with ESMTP id 3EFCC7562; Sun, 14 Jan 2007 11:40:29 +0100 (CET) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id l0EAeSOt073960; Sun, 14 Jan 2007 11:40:28 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.13.4/8.13.3/Submit) id l0EAeMJr073959; Sun, 14 Jan 2007 11:40:22 +0100 (CET) (envelope-from marc) Date: Sun, 14 Jan 2007 11:40:22 +0100 From: Marc Fonvieille To: Giorgos Keramidas Message-ID: <20070114104022.GC65886@abigail.blackend.org> Mail-Followup-To: Giorgos Keramidas , murray@FreeBSD.org, Wes Peters , Robert Watson , developers@freebsd.org, freebsd-doc@FreeBSD.org, Mark Linimon References: <20061113225512.GD1634@kobe.laptop> <20061128232326.T95096@fledge.watson.org> <50FF9A98-DFE9-4CF7-8760-B0AF2FE1F339@opensail.org> <20070113132216.GA59518@abigail.blackend.org> <20061113153246.J38359@fledge.watson.org> <20061113225512.GD1634@kobe.laptop> <20061128232326.T95096@fledge.watson.org> <50FF9A98-DFE9-4CF7-8760-B0AF2FE1F339@opensail.org> <20070113125711.GB16664@soaustin.net> <20070114033349.GB2734@kobe.laptop> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20070114033349.GB2734@kobe.laptop> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.11-STABLE User-Agent: Mutt/1.5.9i Cc: developers@freebsd.org, freebsd-doc@freebsd.org, Robert Watson , Mark Linimon , Wes Peters Subject: Re: Slides, papers, etc. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 14 Jan 2007 11:11:12 -0000 On Sun, Jan 14, 2007 at 05:33:49AM +0200, Giorgos Keramidas wrote: > On 2007-01-13 06:57, Mark Linimon wrote: > > I know I'm too stupid to put a .pdf into the wiki. > > How about the projects/ repository? > > I was initially toying around with the idea of an "advocacy" collection > of presentations, and other material that developers and other > interested people can use to promote FreeBSD. > > Some times, presentation material contains large "blobs" of stuff which > is, essentially, not well suited for storing inside CVS though. For > example, it's nice to have a collection of compressed PDF documents, but > I'm not sure how well CVS can handle multiple copies, revisions and > updates to these documents, without bloating the repository too much. > > On 2007-01-13 14:22, Marc Fonvieille wrote: > > doc/en_US.ISO8859-1/slides already contains some presentations about > > FreeBSD, it's possible to add more (and up to date) presentations. > > These are written with DocBook/XML-slides though. I haven't worked a > lot with DocBook/slides, but the HTML output it generates is AFAICT very > "plain". > > It is, nevertheless, extremely nice that the slides are in a readable, > plain text format, which can be versioned, edited, reviewed, and > distributed easily with CVS. We can leverage the existing network of > CVSup servers to distribute copies of presentations stored in > `doc/en_US.ISO8859-1/slides/'. We can integrate their build to our web > site very easily. We can cross reference, index, and present these as > part of out advocacy web site section. All these advantages are, at > least for me, very important. > > Now, if we can find a nice way to attach a nicely designed, professional > looking CSS stylesheet to these slide collections, that would be great! > If we can also get someone who is experienced with DocBook/XML-slides to > write up a short "Internationalization Cookbook for FreeBSD slides" > tutorial, we would really have something going :) > Maybe Murray can help a bit on this (Cced). I'm not against the fact we also could use Beamer for some presentations with the advantage of a very nice rendering, easy to learn, text source files, pdf rendering and buildable with the current full docproj installation. On another hand I know OOo can export files to DocBook but I don't know if it can be directly useable in our DocBook/XML-slides environment. > IMHO, this is something that should be discussed on freebsd-doc, so I've > taken the liberty to set Mail-Followup-To. > Re-set cause I see a Cc to freebsd-doc@kobe-laptop which sound weird here :) -- Marc