9 Dec
2015
9 Dec
'15
11:46 p.m.
Hi Daniel,
Let me start by saying that ideally XWiki should offer some tool to help convert HTML
content into wiki pages. That would be awesome and it’s doable but we don’t have this
yet.
However XWiki internally supports parsing HTML.
First thing you can try is to enable HTML 4.01 syntax in your XWiki instance. Then create
a new page, select HTML 4.01 as the page syntax and copy paste the HTML you got. Save.
Then edit again and switch to XWiki Syntax 2.1 for example. This should convert the HTML
to wiki markup.
Now you’ll get some issues with this. Links are probably going to be off for example.
So what you really need is to create an HTML importer to transform the HTML you got into
an Annotated HTML format that XWiki supports. The Annotated HTML format is an internal
format used by XWiki when you edit a page using the WYSIWYG editor and it’s a lossless
format, meaning you can convert it to XWiki Syntax without loosing any meaning/data.
This requires some knowledge of that format and some massaging of your HTML to transform
it into this format.
Then you need to have some code that does the looping over the 600 pages you got.
This is quite technical. You’d need first to tell us your level of technical knowledge so
that we could try to help you.
Another option (the simplest for sure, especially if you’re not that technical or don’t
have the time to delve deeply into the technical details) would be to contact one of the
companies offering professional support for XWiki and asking them if they’d be interested
in making a quote for doing this job for you. There are some listed
at http://www.xwiki.org/xwiki/bin/view/Main/Support#HProfessionalSupport
Hope it helps,
-Vincent
On 9 Dec 2015 at 12:01:15, Daniel Tibô
(daniel.tibo@gmail.com(mailto:daniel.tibo@gmail.com)) wrote:
Hello,
In our department, the actuel wiki is based on Mindtouch/dekiwiki and we
want to go to for a global wiki for the company with Xwiki.
To do that, we need to transfer our data from the actual wiki and I
managed to extract all the pages in HTML format (600+ files).
I have found in the mailing list history a reply from Vincent in August
2013 to a similar request :
------
Hi Jason,
I don't know of any existing Mindtouch converter to XWiki. However there
are several handmade converter tools on http://extensions.xwiki.org that
could serve as examples.
What is the markup syntax used by Mindtouch? I have the feeling they
only provide HTML which would be fine since XWiki's Rendering can
convert HTML into wiki markup for example (or keep it as HTML too).
So converting a page would be:
* Read the export format from Mindtouch (what is it? XML?)
* Use the XWiki API to create a wiki page, convert the HTML content to
wiki markup (easy to do), add attachments
Also note that Thomas Mortagne (one of the XWiki committer) is currently
working on a wiki stream API that is an ideal scaffolding for
importing/exporting wikis:
https://github.com/xwiki-contrib/wiki-stream . But there's non trivial
dev work to be done to make it work.
Another idea is to contact one of the companies providing professional
services around XWiki and ask them how much it would cost for a
conversion:
http://www.xwiki.org/xwiki/bin/view/Main/Support#HProfessionalSupport
Hope it helps,
-Vincent
------
Could you please point me to the right direction to convert my 600+ HTML
pages to xwiki markup ?
If you have any information to help me for the integration, that would
be very kind of you
Thank you for your help.
Daniel.