Mike Noyes wrote quoting Julian Church:
> Date: 15 Aug 2002 07:47:13 -0700
> 
> On Fri, 2002-07-12 at 08:10, Julian Church wrote:
> > I've a few questions.
> 
<snip>
> > 2. The DocBook documents will need converting to other more usable formats
> > for distribution/posting on the site.  I know XML is supposed to be
> > directly supported by modern browsers, but I tried this and it didn't work

You really don't try to view the xml docbook file directly with a
browser.

> > very well, so I don't think it's a very good option really - I think
> > DocBook is a bit too complex for that kind of thing.  So what formats do we
> > want?  (X)HTML seems like the obvious choice to me.  Anything else though?
> 
> The normal formats are: html, pdf, plain text, and PostScript.

I've been exploring docbook myself.  It is a bit daunting to come up to
speed at first--I am still not there.  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.

I didn't understand this before a few weeks ago, but the idea of docbook
is that you really aren't rendering your document like you would in a
word processor.  You are putting your data in a format independent
model. Because docbook is sgml and soon to be xml, the format
independent model can be transformed to most any type of document you
want with docbook tools.  You run the tool once with your document and
you receive an html file.  Run it again and you receive a pdf file via
ghost script.  It is quite powerful.

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?

docbook > cvs repository > cron process > html, pdf, txt, rtf < user

Developer checks in docbook to LEAF cvs.
A cron or manual process is then used to execute the docbook
transformation tool once for each desired format in to the pub
directory.
A PHPWebSite page points at the target file for the users.
New documents would have to be hooked into the cron/manual process.

Later Linux distributions have all the docbook tools already. Rpms on
redhat 7.3 include
docbook-dtds-1.0-8
docbook-style-dsssl-1.76-1
docbook-style-xsl-1.49-1
docbook-utils-0.6.9-25
docbook-utils-pdf-0.6.9-25

The transformations are performed with these executables.
/usr/bin/db2dvi
/usr/bin/db2html
/usr/bin/db2ps
/usr/bin/db2rtf
/usr/bin/docbook2dvi
/usr/bin/docbook2html
/usr/bin/docbook2man
/usr/bin/docbook2ps
/usr/bin/docbook2rtf
/usr/bin/docbook2tex
/usr/bin/docbook2texi
/usr/bin/docbook2txt

There are tools for just about every OS out there.

I hope this helps,
Greg Morgan


-------------------------------------------------------
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