From kwade at redhat.com Thu Jun 4 22:12:09 2015 Content-Type: multipart/mixed; boundary="===============8763715404624880592==" MIME-Version: 1.0 From: Karsten Wade To: docs at lists.fedoraproject.org Subject: clean-up for DUG XML Date: Sun, 25 Feb 2007 09:48:44 -0800 Message-ID: <1172425725.4651.104.camel@erato.phig.org> --===============8763715404624880592== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable I just committed some changes to the desktop-user-guide XML, removing some cruft from the conversion. The diff should be sane when viewed through fedora-docs-commits because I did this: 1. ran xmlformat on the files 2. committed those formatted files 3. made changes 4. ran xmlformat again 5. committed those changes We may want to turn on the xmlformat for all files now, so we aren't having to think about this. IIRC, we have a hook to allow us to have xmlformat run on files as they are checked in, before the commit lands in CVS. I have a small list of other changes that need to be worked on. There are two sections -- changes that have to be made to make it build and work right, and changes that need to be made if we are doing a complete conversion. = With the release notes, we sometimes opt not to change the XML to the correct tags, because XML is an interim format. With a full conversion, we want to convert e.g. into one of the tags that is supposed to correspond to: http://fedoraproject.org/wiki/WikiEditing#Marking_Technical_Terms For example, if the Wiki usage was '''Firefox''', the output to XML becomes Firefox, and it needs to be changed manually to Firefox. In Emacs, I would put my cursor somewhere on the tag, then do 'C-c =3D'. In the status bar at the bottom appears "Change emphasis to"; type "app[tab]", it fills out "application", and pressing [Enter] changes the tag to . Here is the list of changes that I captured; there are surely more: n. Convert all
=3D> n. Give IDs to n. Clean up URIs =3D> n. Remove (redundant) - note that the ID is often present because it is linked to; use where needed in the nearest
etc., then search for the anchor text in the XML to find everywhere that links to this information, then fix those (ulink =3D> xref, etc.) n. Convert admonitions (search for , /wikidata/kindofblue/img/) = n. Remove and from s, including the bogus Docs/DesktopUserGuide/ n. Remove footer navigation hack (last table in a page) n. Remove CategoryDocumentation at the end n. Look for how is used; it gets a line break and sometimes around it that is not appropriate. n. that does not surround should be adjusted foo =3D> foo For full conversion to XML: Note: Once you have done this conversion, and bug fixes and updates to the Wiki and/or the XML need to be manually ported to the other format. In other words, once you distance your XML from its Wiki roots, you cannot easily insert new Wiki content or go backward. n. =3D> or n. =3D> , , etc. n. =3D> , , , , etc. n. Create (search for [) n. for FIG -- = Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project = Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ --===============8763715404624880592== Content-Type: application/pgp-signature MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="signature.asc" LS0tLS1CRUdJTiBQR1AgU0lHTkFUVVJFLS0tLS0KVmVyc2lvbjogR251UEcgdjEuNC42IChHTlUv TGludXgpCgppRDhEQlFCRjRjdjgyWklPQnEwT0RFRVJBdWhLQUpzRmZJMDAwSDlGWmhSekZkYkdz bGtIbTViWXpnQ2d5bnBMCnFSeWprelFMd2lBM1RrNUJZZzg2TmNrPQo9TWg1TAotLS0tLUVORCBQ R1AgU0lHTkFUVVJFLS0tLS0K --===============8763715404624880592==--