[xwiki-users] Mindtouch to Xwiki
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.
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ô ([email protected](mailto:[email protected])) 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.
Hello, Thank you for your answer. Sorry to be late with this reply. This project was on hold until last week. We have now one xwiki ready on a production server (RHEL7) and we are ready to begin with it. I tried a lot of way to import data into xwiki from mindtouch but without success. The only way I see right now is with manually with html pages. I can create a new page and insert the content in html format. Converted or not in xwiki syntax, we can work with that. All the links in the pages are working (and have to be corrected in the future to point to xwiki instead of the old one) We have to review all the pages and recreate or move the content progressively. A new structure will be applied and some of the pages will be useless. The goal, right now, is to have all pages (660) available directly in xwiki. That + the search tool will be enough. Then you need to have some code that does the looping over the 600 pages you got. This is a part I’m interested in. A way to not have to click, copy and paste with all the html pages. My knowledge is limited but I have some people around me to help me achieve things i can’t do by myself. Thanks Daniel Le 9 décembre 2015 à 23:46:38, [email protected] ([email protected]) a écrit: 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ô ([email protected](mailto:[email protected])) 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.
Hi Daniel, I hope you're doing well. I was wondering whether you had had success with your Mindtouch to XWiki migration? Best, Guillaume On Wed, Mar 23, 2016 at 6:42 PM, Dan T <[email protected]> wrote:
Hello,
Thank you for your answer. Sorry to be late with this reply. This project was on hold until last week.
We have now one xwiki ready on a production server (RHEL7) and we are ready to begin with it.
I tried a lot of way to import data into xwiki from mindtouch but without success. The only way I see right now is with manually with html pages.
I can create a new page and insert the content in html format. Converted or not in xwiki syntax, we can work with that. All the links in the pages are working (and have to be corrected in the future to point to xwiki instead of the old one)
We have to review all the pages and recreate or move the content progressively. A new structure will be applied and some of the pages will be useless.
The goal, right now, is to have all pages (660) available directly in xwiki. That + the search tool will be enough.
Then you need to have some code that does the looping over the 600 pages you got.
This is a part I’m interested in. A way to not have to click, copy and paste with all the html pages.
My knowledge is limited but I have some people around me to help me achieve things i can’t do by myself.
Thanks
Daniel
Le 9 décembre 2015 à 23:46:38, [email protected] ([email protected]) a écrit:
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ô ([email protected](mailto: [email protected])) 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.
users mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/users
participants (4)
-
Dan T -
Daniel Tibô
-
Guillaume Lerouge -
vincent＠massol.net