The moin->docbook conversion

Karsten Wade kwade at redhat.com
Tue Jul 4 20:13:34 UTC 2006


On Tue, 2006-07-04 at 08:15 +0300, Mikko Virkkilä wrote:
> I'm a Google Summer of Code 2006 student working on improving the way moin 
> can handle docbook.
> 
> I'm wrapping up the first stage which was about going from a wikipage to docbook.
> 
> The test wiki is at http://docbook.wikiwikiweb.de

We'll test it out a little later with the content from
fp.org/wiki/Docs/Beats.

Just have to decide if we should do the changes (below) on the canonical
or in the copy on wikiwikiweb.de.  I _think_ it makes sense to use the
new syntax all over, since we are using your new changes to output to
XML for the release notes..  There is not enough time to get the release
notes beat writers to use the new syntax for the FC6 test2 release, but
we can get it changed over for the test3 release.  

There, answered my own question -- we're switching to the new syntax and
macro needs, even if they don't work on the fp.org Wiki.

Note to others -- Mikko and I discussed the formatting (indenting) of
the XML; since we already use xmlformat to clean it up, we're going to
include that as part of the toolchain/process for outputting XML from
the Wiki.  He is using xmllint to verify, so it should be clean XML and
cause no problems going through xmlformat.

cheers - Karsten

> Feel free to try it out.
> 
> Some stuff in the 
> http://fedoraproject.org/wiki/DocsProject/WritingUsingTheWiki don't apply 
> to this wiki:
>   * WikiNames get converted in to complete urls
>   * FootNote macro works
>   * Include macro works, but a new similar macro called Insert is 
> preferred.
>   * TableOfContents-macro gets automatically ignored
>   * Admonition-macro for generating admonitions.
> 
> 
> I have still some minor code cleaning to do, but this part should be 
> feature complete. Please don't hesitate to report bugs directly to me.
> 
> Next I'll start working on converting a docbook to the moin-syntax.
> 
> Cheers,
> Mikko
> 
-- 
Karsten Wade, RHCE, 108 Editor    ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
   quaid.108.redhat.com           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20060704/45899e2c/attachment.sig>


More information about the fedora-docs-list mailing list