On Mon, 2005-08-22 at 08:36 -0400, Paul W. Frields wrote:
> On Mon, 2005-08-22 at 01:58 -0700, Karsten Wade wrote:
> > On Mon, 2005-08-22 at 01:39 +0100, Stuart Ellis wrote:
> >
> > > Posting a link to HTML is best, as it is the most convenient format for
> > > people to access. The DocBook tools produce HTML, so once you switch
> > > over it's easy to do the same.
> >
> > In addition, when you have the HTML at a stage when you are ready to
> > convert it to XML, we will help. There are a couple of useful html2db
> > tools out there that can help start the conversion.
> >
> > I think HTML links are the best. It helps make it clear it is not a
> > formal Fedora document yet. As it progresses, we'll convert it to XML,
> > add a draft notice/caveat, create a component in bugzilla for tracking,
> > get it into CVS, etc.
>
> Peter and all,
>
> If you're using Fedora Core 4, and you have the
> openoffice.org-javafilter package installed, you will find that you can
> write the body of your document with
OpenOffice.org Writer, and do a
> conversion after you're finished. Since almost everyone on this list is
> running
OpenOffice.org, that should make early collaboration very easy,
> just by emailing drafts back and forth. Once you're happy with a draft
> and it's ready for CVS, you can use the OO.o DocBook XML filters to save
> the document. (I wouldn't convert it until you're really ready; the
> filters for *importing* XML to OO.o's OpenDocument format are really not
> that good yet.)
>
> First, make sure you have the openoffice.org-javafilter package
> installed:
>
> # yum install openoffice.org-javafilter
>
> Now, write/import/edit your document in OO.o. BIG TIP: Use the Stylist
> to select styles for your headings. When you select Heading 1, you open
> a first-level section. After you type the heading title, just hit
> Enter, and the style changes automatically to make the following
> paragraphs part of that DocBook section (<sect1>). If you select
> Heading 2, and type a title, the following paragraphs are part of that
> DocBook second-level section (<sect2>). Although FDP uses <section>
and
> not <sectN>, that's very easy to fix later.
>
> The main point of doing this is that it makes writing easier for you,
> and should make the DocBook conversion relatively easy for other
> contributors when it's time to add the doc to CVS.
>
> When you're finished, select File -> Save As... and choose the "File
> Type" option. Select DocBook from the list, and give a name to your
> file. If you have "Automatic file extension" selected, OO.o adds the
> ".xml" extension to the file name.
Permission to Wiki this very useful information for potential
contributors ?
Heck yeah!
--
Paul W. Frields, RHCE
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Documentation Project: