On Mon, 2005-08-22 at 13:58 +0100, Stuart Ellis wrote: > 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 http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list@xxxxxxxxxx To unsubscribe: http://www.redhat.com/mailman/listinfo/fedora-docs-list
