<div>Hi Jorge,</div> <div> </div> <div> I'm currently writing a detailed procedure on the start to finish process of creating pdf, and html docs using docbook and xmlmind. I'll send it to you this afternoon when I've completed it. </div> <div> </div> <div>Thanks!</div> <div> </div> <div>Maili Page</div> <div>Umass Graduate research assistant<BR><BR></div> <BLOCKQUOTE class=replbq style="PADDING-LEFT: 5px; MARGIN-LEFT: 5px; BORDER-LEFT: #1010ff 2px solid"><BR>Message: 1<BR>Date: Fri, 25 Jan 2008 19:21:39 +0100<BR>From: "Jorge Gaspar Sanz Salinas" <XURXOSANZ@GMAIL.COM><BR>Subject: Re: [OSGeo-Edu] Comments and Questions on Docbook<BR>To: "Landon Blake" <LBLAKE@KSNINC.COM><BR>Cc: OSGeo-edu <EDU_DISCUSS@LISTS.OSGEO.ORG><BR>Message-ID:<BR><AF820FD70801251021P16D82241L9447C9615BEDBFBF@MAIL.GMAIL.COM><BR>Content-Type: text/plain; charset=ISO-8859-1<BR><BR>Hi Landon<BR><BR>2008/1/22, Landon Blake <LBLAKE@KSNINC.COM>:<BR>><BR>> I took some
time to look over Docbook last night. This included skimming a<BR>> Docbook crash course and messing around with XMLMind.<BR>><BR>><BR>><BR>> XMLMind definitely seems to be the most fully featured Docbook editor, and<BR>> would be a good choice for authors not familiar with XML.<BR>><BR><BR>After trying some XML authoring tools, even XMLMind and oXygen 9, I<BR>have to admit that new XML editor of Eclipse 3.3 (europa) is the<BR>nicest editor I've found as it does everything I need (included spell<BR>checking...).<BR><BR>oXygen is really good (Jeroen told me to try it). The "Author" mode<BR>would be really really comfortable to use if it wouldn't be SO slow.<BR><BR>><BR>><BR>> I personally found it a bit awkward, and figured I would be more comfortable<BR>> working in a text editor. I'd probably still write the content in OpenOffice<BR>> and would then cut and paste to a XML template file. My comfort with the raw<BR>> text editor may be
a result of my programming background.<BR>><BR>><BR>><BR>> I think Docbook would be a workable solution, but I think some templates<BR>> would be key. (For example, we could set up a template for Free GIS Book<BR>> chapters or for OSGeo Journal Articles.)<BR>><BR><BR>In the Spanish Free GIS Book group we decided LaTeX as editing tool<BR>for many reasons, and I think for that kind of content is the best. I<BR>see Docbook better for more technical content like user and developer<BR>docs. As you know, there is no better tool for writing equations than<BR>LaTeX at this moment.<BR><BR>Not sure how to deal with Docbook and MathML.....<BR><BR>><BR>><BR>> I'd like to check out the PDF format generated from Docbook. Can anyone get<BR>> me started with that conversion as quickly as possible? What conversion tool<BR>> would you recommend?<BR><BR>I'm using Apache FOP, but it's difficult to customize the results but<BR>not impossible. You will have
to deal with XSLT....<BR><BR>Docbook XSL complete guide is a good place to start to play with XSL<BR>customization layer:<BR><BR>http://www.sagehill.net/docbookxsl/index.html<BR><BR>Cheers<BR>-- <BR>Jorge Gaspar Sanz Salinas<BR>Ingeniero en Geodesia y Cartografía<BR>http://www.geomaticblog.net<BR>http://www.prodevelop.es<BR><BR><BR>------------------------------<BR><BR>Message: 2<BR>Date: Fri, 25 Jan 2008 19:30:28 +0100<BR>From: "Jorge Gaspar Sanz Salinas" <JSANZ@GEOMATICBLOG.NET><BR>Subject: Re: FW: [OSGeo-Edu] Subversion strategy questions<BR>To: "Landon Blake" <LBLAKE@KSNINC.COM><BR>Cc: OSGeo-edu <EDU_DISCUSS@LISTS.OSGEO.ORG><BR>Message-ID:<BR><AF820FD70801251030T15075308S2BF4209EF0A50BE8@MAIL.GMAIL.COM><BR>Content-Type: text/plain; charset=ISO-8859-1<BR><BR>2008/1/23, Landon Blake <LBLAKE@KSNINC.COM>:<BR>> At a minimum it looks like I would need to complete the following steps<BR>> to perform a conversion:<BR>><BR>> Install and learn how to use an XSLT
Stylesheet Processor.<BR>> Import the Docbook DTD into the processor.<BR>> Import the conversion stylesheet into the processor.<BR>> Run the conversion in the processor.<BR>><BR>> This isn't exactly a one-click task, but perhaps it could be made into<BR>> one.<BR>><BR>> I wonder how one would control things like margin width and font style<BR>> when generating PDF documentation from Docbook. Is anyone familiar with<BR>> how this works in the conversion process?<BR>><BR><BR>Hi Landon again ;)<BR><BR>It's mainly in Spanish, but maybe you find useful the article I'm<BR>writing for the Girona Meeting about OSGeo Spanish LC. It's in the<BR>OSGeo SVN.<BR><BR>https://svn.osgeo.org/osgeo/community/presentations/20080303-Girona/OSGeo_Spanish/<BR><BR><BR>You'll find an ant build file for linux systems (I'm working on a<BR>Debian box) so you only need to install the proper packages (xalan,<BR>fop, jai, docbook-xml, docbook-xsl) and run ant to generate
the HTML<BR>or the PDF.<BR><BR>Sorry, the README is also in Spanish :S<BR><BR>Of course you can always use the old DSSL stylesheets and OpenJade....<BR><BR>Cheers<BR>-- <BR>Jorge Gaspar Sanz Salinas<BR>Ingeniero en Geodesia y Cartografía<BR>http://www.geomaticblog.net<BR>http://www.prodevelop.es<BR><BR><BR>------------------------------<BR><BR>Message: 3<BR>Date: Fri, 25 Jan 2008 19:31:36 +0100<BR>From: "Jorge Gaspar Sanz Salinas" <XURXOSANZ@GMAIL.COM><BR>Subject: Re: FW: [OSGeo-Edu] Subversion strategy questions<BR>To: OSGeo-edu <EDU_DISCUSS@LISTS.OSGEO.ORG><BR>Message-ID:<BR><AF820FD70801251031M387A966CH8BF9F177E060668E@MAIL.GMAIL.COM><BR>Content-Type: text/plain; charset=ISO-8859-1<BR><BR>2008/1/23, Landon Blake <LBLAKE@KSNINC.COM>:<BR>><BR>><BR>> -----Original Message-----<BR>> From: Landon Blake<BR>> Sent: Wednesday, January 23, 2008 9:22 AM<BR>> To: 'Frank Warmerdam'<BR>> Subject: RE: [OSGeo-Edu] Subversion strategy questions<BR>><BR>>
Frank Wammerdam wrote:<BR>><BR>> "On the whole DocBook issue - we tried using DocBook for a while for<BR>> MapServer docs and ended up abandoning it because installing and getting<BR>> to understand DocBook tools was too hard for many potential<BR>> contributors."<BR>><BR>> I also identified this as the major challenge when I looked at Docbook.<BR>> I was all full of steam for the format until I started reading about<BR>> what was necessary to convert the format in to PDF. It didn't look like<BR>> a process for the faint of heart.<BR>><BR>> At a minimum it looks like I would need to complete the following steps<BR>> to perform a conversion:<BR>><BR>> Install and learn how to use an XSLT Stylesheet Processor.<BR>> Import the Docbook DTD into the processor.<BR>> Import the conversion stylesheet into the processor.<BR>> Run the conversion in the processor.<BR>><BR>> This isn't exactly a one-click task, but perhaps it
could be made into<BR>> one.<BR>><BR>> I wonder how one would control things like margin width and font style<BR>> when generating PDF documentation from Docbook. Is anyone familiar with<BR>> how this works in the conversion process?<BR><BR><BR>Hi Landon again ;)<BR><BR>It's mainly in Spanish, but maybe you find useful the article I'm<BR>writing for the Girona Meeting about OSGeo Spanish LC. It's in the<BR>OSGeo SVN.<BR><BR>https://svn.osgeo.org/osgeo/community/presentations/20080303-Girona/OSGeo_Spanish/<BR><BR><BR>You'll find an ant build file for linux systems (I'm working on a<BR>Debian box) so you only need to install the proper packages (xalan,<BR>fop, jai, docbook-xml, docbook-xsl) and run ant to generate the HTML<BR>or the PDF.<BR><BR>Sorry, the README is also in Spanish :S<BR><BR>Of course you can always use the old DSSL stylesheets and OpenJade....<BR><BR>Cheers<BR><BR>-- <BR>Jorge Gaspar Sanz Salinas<BR>Ingeniero en Geodesia y
Cartografía<BR>http://www.geomaticblog.net<BR>http://www.prodevelop.es<BR><BR><BR>------------------------------<BR><BR>Message: 4<BR>Date: Fri, 25 Jan 2008 21:29:49 +0100<BR>From: Tim Michelsen <TIMMICHELSEN@GMX-TOPMAIL.DE><BR>Subject: Re: [OSGeo-Edu] Comments and Questions on Docbook<BR>Cc: OSGeo-edu <EDU_DISCUSS@LISTS.OSGEO.ORG><BR>Message-ID: <479A46BD.2010203@gmx-topmail.de><BR>Content-Type: text/plain; charset=ISO-8859-1; format=flowed<BR><BR>> In the Spanish Free GIS Book group we decided LaTeX as editing tool<BR>> for many reasons, and I think for that kind of content is the best. I<BR>> see Docbook better for more technical content like user and developer<BR>> docs. As you know, there is no better tool for writing equations than<BR>> LaTeX at this moment.<BR>Again another reason for using LyX, the friendly frontend to LaTeX.<BR><BR>It makes life with LaTeX a lot easier and could also speed it's adoption <BR>in the OSGEO-Edu
community.<BR><BR>Kind regards,<BR>Timmie<BR><BR><BR>------------------------------<BR><BR>Message: 5<BR>Date: Sat, 26 Jan 2008 17:56:10 +0100<BR>From: Lorenzo Becchi <LORENZO@OMINIVERDI.COM><BR>Subject: Re: [OSGeo-Edu] Why not use the wiki? My reasons... let me<BR>know if I am off in my thinking<BR>To: Charlie Schweik <CSCHWEIK@PUBPOL.UMASS.EDU><BR>Cc: OSGeo-edu <EDU_DISCUSS@LISTS.OSGEO.ORG><BR>Message-ID: <479B662A.6040602@ominiverdi.com><BR>Content-Type: text/plain; charset=ISO-8859-1; format=flowed<BR><BR><BR><BR>Charlie Schweik wrote:<BR>><BR>> 1) How easy it is to find modules of interest to you... e.g., <BR>><BR>> I think we need a database driven search system. I'm not convinced the<BR>> wiki is right for this, especially if there are other pages that are not<BR>> educational content that might be returned on a search.<BR>> <BR><BR>we can make a dedicated one easily.<BR><BR>><BR>> 2) How easy it is to derive new works and keep track
of author<BR>> contributions<BR>><BR>> The wiki system of course keeps a history. But you wouldn't want the<BR>> "production" education module being edited. I suppose the way we'd have<BR>> to do this is have two copies on the wiki, one that is a locked down<BR>> current version and the second being an open edit "next release"<BR>> version. <BR>> <BR><BR>you can lock pages without creating two different Wikis, it would be a <BR>mess (IMO).<BR>><BR>> 3) Updating wiki pages sometimes can be a little painful.<BR>> <BR><BR>that's true.<BR>even merging contents from different formats is a pain. More over if <BR>you're not using a concurrency system (as wiki is).<BR><BR><BR>ciao<BR>Lorenzo<BR><BR><BR>------------------------------<BR><BR>_______________________________________________<BR>Edu_discuss mailing list<BR>Edu_discuss@lists.osgeo.org<BR>http://lists.osgeo.org/mailman/listinfo/edu_discuss<BR><BR><BR>End of Edu_discuss Digest, Vol 13,
Issue 15<BR>*******************************************<BR></BLOCKQUOTE><BR><p> 
<hr size=1>Looking for last minute shopping deals? <a href="http://us.rd.yahoo.com/evt=51734/*http://tools.search.yahoo.com/newsearch/category.php?category=shopping">
Find them fast with Yahoo! Search.</a>