[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Kudos and question
"Greg Ferguson" <email@example.com> wrote:
> On Mar 23, 8:08am, Pal Domokos wrote:
> > Subject: Kudos and question
> > I have a few questions about the current state of the DocBook-ization
> > of linuxdoc. Perhaps it would be beneficial to all authors if somebody
> > clarified these issues.
> > So: all existing HOWTOs had been converted to DocBook, as we all know.
> > Furthermore, HOWTOs are now accepted in DocBook format also.
> > My question is: what if I decide to migrate to DocBook and send all
> > future updates of my HOWTO in this format? How will the LinuxDoc
> > version of the HOWTO get updated? Or is the DocBook format the
> > "official" source now and are all other, non-SGML variants
> > produced from this source? In this case, we probably don't need
> > the files in LinuxDoc format any more.
> I can speak to this in some detail. In the processing environment
> currently established on our host machine [metalab], which has
> (hopefully!) improved turn-around time of publishing updates, we
> can transparently handle DocBook and/or linuxdoc SGML documents.
> Part of the processing done on a linuxdoc-encoded document is
> to convert to DocBook, using ld2db (I'm going to put the links
> to the packages used on metalab at the end of this msg; I've
> been meaning to do that).
> All native or derived DocBook instances can be accessed
> from (full HOWTOs) :
> and for mini-HOWTOs:
> If a document is given to us in linuxdoc, that is considered to
> be the "official" format. The DocBook SGML derived from the
> linuxdoc instance is usable, but can certainly benefit from
> an editing pass by the author. For that reason, it is not
> considered to be the official version UNTIL the author dictates
> that to us. An author can certainly use that derived version as a
> starting point for their move to DocBook, if they so choose.
> Once an author submits to us a DocBook instance of their document,
> and indicates that the DocBook instance is considered to be the
> official instance, we will either remove (or archive) the linuxdoc
> version from the LDP host machine (metalab).
> Does that sound like a reasonable approach?
It certainly does.
> We have a few DocBook-only HOWTOs currently in place, most
> of which were pulled from the OSWG CVS archive (with the author's
> permission): Cable-Modem, RPM, DHCP; to name a few.
> > Miscellaneous: about a month ago somebody sent a guide, called RUTE,
> > to this list, as a donation to linuxdoc. Has anybody answered the
> > post?
> I'll take care of that. It looks to be available only in PostScript,
> tex, and PDF.
> In case anyone is interested, here are the tools being used for
> processing on metalab:
> For support of linuxdoc:
> sgml-tools 1.0.9 -
> htmldoc (1.8.4) -
> fltk 1.0.7 (required by htmldoc for their GUI; I built it anyway) -
> ld2db -
> For support of DocBook:
> Jade (1.2.1) -
> DSSSL (1.52) -
let me note that the documentation for DSSSL is here:
> DocBook DTD (3.1) -
The DocBook HOWTOs on linuxdoc are of the type
<!DOCTYPE Article PUBLIC "-//Davenport//DTD DocBook V3.0//EN">,
while the DocBook DTD is 3.1, with the following line in the
PUBLIC "-//OASIS//DTD DocBook V3.1//EN" "docbook.dtd".
Is this OK?
> Entities -
What are these? What are they needed for? They don't seem to be
entities to me.
> best regards,
> Greg Ferguson - s/w engr / mtlhd | firstname.lastname@example.org
> SGI Tech Pubs - http://techpubs.sgi.com |
> Linux Doc Project - http://www.linuxdoc.org |
Gregory Leblanc <GLeblanc@cu-portland.edu> wrote:
> As soon as an author feels ready, and writes their own HOWTO in DocBook,
> LinuxDoc version will be removed, the the DocBook version becomes the
> official source, and all other outputs are generated from that. I just
> to make a couple of points for people who are moving to DocBook. First,
> while we've run the LinuxDoc HOWTOs through a script to convert them to
> DocBook, DocBook has FAR more features for technical writers than LinuxDoc
> did. The DocBook "output" of your HOWTO may be a good starting point, or
> you may wish to start from scratch. I believe that to take advantage of
> some of the features of DocBook, you'll probably need MORE markup in your
> document, but it will allow things like much better searching, and better
> integration into online help tools, like the new GNOME Help browser (which
> is still a few months off). I'm eager for DocBook 5.0 (towards the end of
> this year), and Mozilla, because they will allow the use of XML. This will
> allow people to use the native DocBook version of HOWTOs, with all of their
> special markup for key words, and for index terms, etc. to make the HOWTOs
> much easier to glean information out of. I think I've rambled enough,
> please let me know if you have more questions.
Thank both of you for the information. I'll try to use the tools now.
Get free email and a permanent address at http://www.netaddress.com/?N=1
To UNSUBSCRIBE, email to email@example.com
with a subject of "unsubscribe". Trouble? Contact firstname.lastname@example.org