TWiki
>
TWiki Web
>
MediaWikiToTWikiAddOn
(2012-02-09,
TWikiContributor
)
(raw view)
E
dit
A
ttach
P
DF
---+!! !MediaWikiToTWikiAddOn <!-- Contributions to this add-on are appreciated. Please update the add-on page at http://twiki.org/cgi-bin/view/Plugins/MediaWikiToTWikiAddOn or provide feedback at http://twiki.org/cgi-bin/view/Plugins/MediaWikiToTWikiAddOnDev. If you are a TWiki contributor please update the add-on in the SVN repository. * Set SHORTDESCRIPTION = <nop>MediaWiki to TWiki conversion tool --> <sticky><div style="float:right; background-color:#EBEEF0; margin:0 0 20px 20px; padding: 0 10px 0 10px;"> %TOC{title="Page contents"}% </div></sticky> %SHORTDESCRIPTION% ---++ Introduction This is a commandline tool to import <nop>MediaWiki pages and images to TWiki. It processes a <nop>MediaWiki XML dump to extract the pages and thus does not need a database access once the dump was created. The conversion tool takes care of almost all peculiarities of <nop>MediaWiki and TWiki. It does _not_ map <nop>MediaWiki's category system onto TWiki as long as TWiki lacks a standard category system. There are however many ways to implement categories in TWiki, one of which is the upcoming <nop>ClassificationPlugin which implements true hierarchies and semantic predicates to query categories and topics within. The mediawiki2twiki tool allows to map the <nop>MediaWiki categories onto any TWiki category system like the mentioned one using a plugin interface that comes with the conversion tool. One notion of caution: in general the conversion tool is able to convert the wiki markup dialects. However, the <nop>MediaWiki's template mechanism, comparable to TWiki's parametrized =INCLUDE= statement does *not* match. The reason is buried in the different parsing priorities within both parsers: while <nop>MediaWiki parses left-to-right, TWiki does also parser inside-out, which means parameters to =INCLUDE= are evaluate _before_ making the inclusion. The opposite is the case in <nop>MediaWiki. In a way <nop>MediaWiki's tempaltes are called "by reference" (passing the unparsed parameters) while TWiki evaluates =INCLUDE= passing parameters "by value". This means, that <nop>WikiApplications written for <nop>MediaWiki won't be translatable to <nop>TWikiApplications easily by this tool. ---++ Documentation The conversion tool is in =<path-to-your-twiki>/tools/mediawiki2twiki=. ---+++ Synopsis <verbatim> mediawiki2twiki --file <dumpfile> [--<debug>] [--<defaultweb> <webname>] [--<dry>] [--<exclude> <regex>] [--<help>] [--<images> <path>] [--<include> <regex>] [--<language> <language code>] [--<match> <regex>] [--<max> <number>] [--<namespace> <name>] [--<plugin> <perlfile>] [--<topicmap> <fromTopic1=toTopic1,fromTopic2=toTopic2,...>] [--<web> <target web>] [--<webmap> <fromWeb1=toWeb1,fromWeb2=toWeb2,...> </verbatim> ---+++ Example call <verbatim> mediawiki2twiki --file dump.xml --web MediaWiki --language de --topicmap 'Hauptseite=WebHome,Spezial.Allpages=WebTopicList' --images /var/www/mediawiki/images --defaultweb _mediawiki_default --plugin MyConversionPlugin --exclude '^(MediaWiki|Bild|Kategorie):' </verbatim> This reads the file =dump.xml=, and creats a TWiki web called <nop>MediaWiki in our current TWiki installation (see Setup). In this example, the source content is German. The pages "Hauptseite" will be stored in the the =WebHome= topic. The =Special.Allpages= page will be stored in =WebTopicList"=. Images are taken from the images subdirectory of our <nop>MediaWiki installation at =/var/www/mediawiki=. We prepared a template web called =_mediawiki_defaul= that will be used when creating TWiki webs. We have some perl code in =MyConversionPlugin.pm= that defines some custom conversions only of relevance for our own content. Source pages that match the regular expression =MediaWiki|Bild|Kategorie= will be excluded from the translation process. ---+++ Options The only mandatory option is the name of the <nop>MediaWiki dump file from which content is extracted. Before you start extracting large amount of data you should test the conversion result by using the -debug, -dry and -max. %RED%more docu please%ENDCOLOR% ---++ Installation Instructions * Download the ZIP file from the Plugin web (see below) * Unzip ==%TOPIC%.zip== in your twiki installation directory. Content: | *File:* | *Description:* | | ==data/TWiki/MediaWikiToTWikiAddOn.txt== | | | ==lib/CPAN/lib/Parse/MediaWikiDump.pm== | | | ==lib/TWiki/Contrib/MediaWikiToTWikiAddOn/Converter.pm== | | | ==lib/TWiki/Contrib/MediaWikiToTWikiAddOn/EmptyPlugin.pm== | | | ==lib/TWiki/Contrib/MediaWikiToTWikiAddOn/build.pl== | | | ==lib/TWiki/Contrib/MediaWikiToTWikiAddOn.pm== | | | ==pub/TWiki/MediaWikiToTWikiAddOn/schenck_logo.gif== | | | ==tools/EmptyMediaWiki2TWikiPlugin.pm== | | | ==tools/mediawiki2twiki== | | * Verify that the tool works fine by going to the =tools= subdirectory of your TWiki installation and type =./mediawiki2twiki --help= ---++ <nop>AddOn Info Sponsored by <a href="http://www.schenck-rotec.net"><img src="%ATTACHURLPATH%/schenck_logo.gif" border="0" title="Schenck-RoTec"/></a> | <nop>AddOn Author: | TWiki:Main.MichaelDaum | | Copyright: | © 2006-2007 Michael Daum http://wikiring.de <br /> © 2006-2012 TWiki:TWiki/TWikiContributor | | License: | GPL ([[http://www.gnu.org/copyleft/gpl.html][GNU General Public License]]) | | <nop>AddOn Version: | v1.1 | | Change History: | <!-- versions below in reverse order --> | | 2012-02-09: | TWikibug:Item6837: Doc improvements (typo fix) -- TWiki:Main.BobBagwill | | 2011-07-06: | TWikibug:Item6764: Doc improvements | | 2010-04-30: | TWikibug:Item6433: Doc improvements | | 20 Jul 2007 | initial release | | Dependencies: | None | | <nop>AddOn Home: | http://twiki.org/cgi-bin/view/Plugins/MediaWikiToTWikiAddOn | | Feedback: | http://twiki.org/cgi-bin/view/Plugins/MediaWikiToTWikiAddOnDev | | Appraisal: | http://twiki.org/cgi-bin/view/Plugins/MediaWikiToTWikiAddOnAppraisal | __Related Topics:__ %SYSTEMWEB%.DeveloperDocumentationCategory, %SYSTEMWEB%.AdminDocumentationCategory
E
dit
|
A
ttach
|
Watch
|
P
rint version
|
H
istory
:
|
B
acklinks
|
V
iew topic
|
WYSIWYG
|
M
ore topic actions
Topic revision: r0 - 2012-02-09
-
TWikiContributor
Log In
TWiki
TWiki Web
Index
Search
User Search
Changes
Notifications
RSS Feed
Statistics
Preferences
User Reference
ATasteOfTWiki
TextFormattingRules
TWikiVariables
FormattedSearch
QuerySearch
TWikiDocGraphics
TWikiSkinBrowser
InstalledPlugins
Admin Maintenance
Reference Manual
AdminToolsCategory
InterWikis
ManagingWebs
TWikiSiteTools
TWikiPreferences
WebPreferences
Categories
Admin Documentation
Admin Tools
Developer Doc
User Documentation
User Tools
Cern Search
TWiki Search
Google Search
TWiki
All webs
Copyright &© 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use
Discourse
or
Send feedback
Note:
Please contribute updates to this topic on TWiki.org at TWiki:TWiki.MediaWikiToTWikiAddOn