Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
DocumentationGuidelines/ConvertExistingContent
< DocumentationGuidelines
Revision as of 16:01, 26 August 2009 by Unnamed Poltroon (Talk) (New page: =Converting HTML= ==Online Conversion== * [http://toolserver.org/~diberri/cgi-bin/html2wiki/ HTML2WIKI] =Converting DocBook= This section will discuss ways in which existing DocBook sou...)
Contents
Converting HTML
Online Conversion
Converting DocBook
This section will discuss ways in which existing DocBook source files can be converted into media wiki syntax.
Round Tripping
There is not a one to one mapping of tags to wiki markup, so some semantics may be lost in a round trip scenario.
There is not a one to one mapping of tags to wiki markup, so some semantics may be lost in a round trip scenario.
DocBook XSL Stylesheets
There is work underway to provide a contribution to the DocBook Project on sourceforge to allow the use of the existing DocBook Project's stylesheets to generate the wiki content. The advantage here is that most all of the docbook tags are covered, and the appropriate templates can be overriden to provide additional custom wiki support.
These stylesheets are still a work in progress. Other options include:
- DocBook to Wiki - a set of perl scripts that do a decent job of converting but only handle a limited subset of the DocBook elements.
Manual Clean
As with any conversion process, all of these will need some minor manual clean up.
As with any conversion process, all of these will need some minor manual clean up.