Migrate Confluence wikis to GitHub

18245
Reporter: mblissett
Type: Task
Summary: Migrate Confluence wikis to GitHub
Priority: Unassessed
Status: Open
Created: 2016-02-19 13:29:59.671
Updated: 2016-02-19 13:34:11.19
Resolved: 2016-02-19 13:29:59.651
        
Description: I looked at what it would take to migrate the Confluence wiki to GitHub — probably half a day's work, or less if most pages are obsolete and can be migrated as HTML.

GitHub wikis can be edited using Git — clone projectname.wiki.git (for example, the IPT wiki is here: git@github.com:gbif/ipt.wiki.git ) and do what you want with the pages. HTML, Markdown etc are supported.

The Confluence wiki can be exported in a few formats.

1) HTML.  This would be fastest, and perhaps is suitable if most of a Wiki's content is obsolete.

2) XML.  This format is complicated, it holds the full page structure.

Both of these exports export the whole "space" at once.

3) Export individual pages in "Tools" → "View Storage Format". They can then be converted using this XSLT setup: https://github.com/highsource/confluence-to-markdown-converter and added to Github in Markdown format.  This looks fine.  It's annoying that pages can only be exported individually in this way, but we don't have so many — maybe a browser bookmarklet could make it pretty quick to save the whole lot.]]>