Mindtouch to Xwiki

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Mindtouch to Xwiki

Dan T
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
[hidden email]
http://lists.xwiki.org/mailman/listinfo/users
Reply | Threaded
Open this post in threaded view
|

Re: Mindtouch to Xwiki

vmassol
Administrator
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ô ([hidden email](mailto:[hidden email])) 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
[hidden email]
http://lists.xwiki.org/mailman/listinfo/users
Reply | Threaded
Open this post in threaded view
|

Re: Mindtouch to Xwiki

Dan T
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, [hidden email] ([hidden email]) 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ô ([hidden email](mailto:[hidden email])) 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
[hidden email]
http://lists.xwiki.org/mailman/listinfo/users
Reply | Threaded
Open this post in threaded view
|

Re: Mindtouch to Xwiki

Guillaume Lerouge
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 <[hidden email]> 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, [hidden email] ([hidden email]) 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ô ([hidden email](mailto:
> [hidden email])) 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
> [hidden email]
> http://lists.xwiki.org/mailman/listinfo/users
>
_______________________________________________
users mailing list
[hidden email]
http://lists.xwiki.org/mailman/listinfo/users