Jump to: navigation, search

Difference between revisions of "DocumentationGuidelines/ConvertExistingContent"

(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...)
 
(Converting HTML)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{:DocumentationGuidelines/DraftHeader}}
 +
 
=Converting HTML=
 
=Converting HTML=
 +
Converting from HTML into mediawiki is actually very straight forward, as MediaWiki allows for the inclusion of HTML tags.  However, this can make editing of the pages much more difficult.  There are tools available to allow the conversion of HTML to particular wiki formats.
  
 
==Online Conversion==
 
==Online Conversion==
Line 23: Line 26:
  
 
=Converting DITA=
 
=Converting DITA=
 +
 +
[[Category:Documentation Guidelines]]

Latest revision as of 15:35, 26 August 2009

Warning2.png
Draft Content
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.


Converting HTML

Converting from HTML into mediawiki is actually very straight forward, as MediaWiki allows for the inclusion of HTML tags. However, this can make editing of the pages much more difficult. There are tools available to allow the conversion of HTML to particular wiki formats.

Online Conversion

Converting DocBook

This section will discuss ways in which existing DocBook source files can be converted into media wiki syntax.

Important.png
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.


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.
Note.png
Manual Clean
As with any conversion process, all of these will need some minor manual clean up.


Converting DITA