From owner-freebsd-doc@FreeBSD.ORG Sun Jan 14 15:45:04 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 488DA16A407 for ; Sun, 14 Jan 2007 15:45:04 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (vlsi00.si.noda.tus.ac.jp [133.31.130.32]) by mx1.freebsd.org (Postfix) with ESMTP id 5646713C459 for ; Sun, 14 Jan 2007 15:45:02 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p3089-ipbf506funabasi.chiba.ocn.ne.jp [124.100.58.89]) (authenticated bits=128) by mail.allbsd.org (8.13.1/8.13.4) with ESMTP id l0EFAZk1034185; Mon, 15 Jan 2007 00:10:48 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (alph.allbsd.org [192.168.0.10]) (authenticated bits=0) by delta.allbsd.org (8.13.4/8.13.4) with ESMTP id l0EF9J9w007605; Mon, 15 Jan 2007 00:09:22 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Mon, 15 Jan 2007 00:09:07 +0900 (JST) Message-Id: <20070115.000907.32439009.hrs@allbsd.org> To: blackend@FreeBSD.org From: Hiroki Sato In-Reply-To: <20070114104022.GC65886@abigail.blackend.org> References: <20070113125711.GB16664@soaustin.net> <20070114033349.GB2734@kobe.laptop> <20070114104022.GC65886@abigail.blackend.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 5.1 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Mon_Jan_15_00_09_08_2007_157)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: ClamAV version 0.88.7, clamav-milter version 0.88.7 on gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH authentication, not delayed by milter-greylist-2.0.2 (mail.allbsd.org [133.31.130.32]); Mon, 15 Jan 2007 00:10:50 +0900 (JST) Cc: linimon@lonesome.com, freebsd-doc@FreeBSD.org, rwatson@FreeBSD.org, keramida@FreeBSD.org, wes@opensail.org 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 15:45:04 -0000 ----Security_Multipart(Mon_Jan_15_00_09_08_2007_157)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Marc Fonvieille wrote in <20070114104022.GC65886@abigail.blackend.org>: bl> On Sun, Jan 14, 2007 at 05:33:49AM +0200, Giorgos Keramidas wrote: bl> > On 2007-01-13 06:57, Mark Linimon wrote: bl> > > I know I'm too stupid to put a .pdf into the wiki. bl> > > How about the projects/ repository? bl> > bl> > I was initially toying around with the idea of an "advocacy" collection bl> > of presentations, and other material that developers and other bl> > interested people can use to promote FreeBSD. bl> > bl> > Some times, presentation material contains large "blobs" of stuff which bl> > is, essentially, not well suited for storing inside CVS though. For bl> > example, it's nice to have a collection of compressed PDF documents, but bl> > I'm not sure how well CVS can handle multiple copies, revisions and bl> > updates to these documents, without bloating the repository too much. bl> > bl> > On 2007-01-13 14:22, Marc Fonvieille wrote: bl> > > doc/en_US.ISO8859-1/slides already contains some presentations about bl> > > FreeBSD, it's possible to add more (and up to date) presentations. bl> > bl> > These are written with DocBook/XML-slides though. I haven't worked a bl> > lot with DocBook/slides, but the HTML output it generates is AFAICT very bl> > "plain". bl> > bl> > It is, nevertheless, extremely nice that the slides are in a readable, bl> > plain text format, which can be versioned, edited, reviewed, and bl> > distributed easily with CVS. We can leverage the existing network of bl> > CVSup servers to distribute copies of presentations stored in bl> > `doc/en_US.ISO8859-1/slides/'. We can integrate their build to our web bl> > site very easily. We can cross reference, index, and present these as bl> > part of out advocacy web site section. All these advantages are, at bl> > least for me, very important. bl> > bl> > Now, if we can find a nice way to attach a nicely designed, professional bl> > looking CSS stylesheet to these slide collections, that would be great! bl> > If we can also get someone who is experienced with DocBook/XML-slides to bl> > write up a short "Internationalization Cookbook for FreeBSD slides" bl> > tutorial, we would really have something going :) bl> > bl> bl> Maybe Murray can help a bit on this (Cced). I'm not against the fact we bl> also could use Beamer for some presentations with the advantage of a bl> very nice rendering, easy to learn, text source files, pdf rendering and bl> buildable with the current full docproj installation. On another hand I bl> know OOo can export files to DocBook but I don't know if it can be bl> directly useable in our DocBook/XML-slides environment. Well, what do you think about simply importing FreeBSD-related presentation materials into the doc tree for the moment like OpenBSD project does? I often think we should have such a collection of presentations in our web site if possible, too, but often forget the URLs or get "404 not found" if I find them. I think we can store them into doc/en_US.ISO8859-1/slides in the original format and create the "collection of presentations" page. Converting them to another format is generally difficult and it is not a good idea to force the authors to use DocBook-slides or so. -- | Hiroki SATO ----Security_Multipart(Mon_Jan_15_00_09_08_2007_157)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (FreeBSD) iD8DBQBFqkeUTyzT2CeTzy0RAoQYAKDeLxGVcE8W6fjU1+f2uvjyN/tssgCfUqMo cqy8SUEnkqR/k36/UuF7hOw= =DFwo -----END PGP SIGNATURE----- ----Security_Multipart(Mon_Jan_15_00_09_08_2007_157)----