At 23:55 15/08/02 -0700, Greg Morgan wrote:
>I've been exploring docbook myself.  It is a bit daunting to come up to
>speed at first--I am still not there.

The best bit of advice I got was not to try and learn all of XML.  It's OK 
to think of Docbook as a markup language in itself without worrying about 
the fact that it's also XML.  Once I'd got that idea straight it didn't 
seem much more complicated than HTML.

Have you had a look at the Norman Walsh / Larry Muellner O'Reilly Wood Duck 
Docbook book?  It's online at http://www.docbook.org and is more up to date 
than the printed version I got from Amazon.  I find the online reference 
section particularly handy.

>It seems like new development is
>best served by just typing text in an editor of your choice to get the
>idea out.  Then in another step paste the text into a skeletal docbook
>file.

Suitable skeletal files are available at the linux documentation project 
http://www.tldp.org/authors/index.html#resources - there's a lot of other 
useful stuff here (Thanks Mike Noyes for alerting me to this area of tldp).

>Perhaps then the question is how can documents be checked in via cvs,
>then deployed on the leaf site?  I don't know all that you can do with
>SF, but is this possible?

Does anyone know what SourceForge can do along these lines?  Whatever 
happens, it's not that hard for authors and editors (or other volunteers) 
to run the xml through the relevant tools themselves.

>Later Linux distributions have all the docbook tools already.
><snip>
>There are tools for just about every OS out there.

Cool isn't it!  I'm doing this work on Mac OS X and generally I haven't had 
much trouble downloading and compiling the tools I need from their source 
code tarballs.  Isn't Unix supposed to be really difficult? : )

cheers

Julian

-- 
[EMAIL PROTECTED]
www.ljchurch.co.uk



-------------------------------------------------------
This sf.net email is sponsored by: OSDN - Tired of that same old
cell phone?  Get a new here for FREE!
https://www.inphonic.com/r.asp?r=sourceforge1&refcode1=vs3390

_______________________________________________
Leaf-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/leaf-devel

Reply via email to