Moving a wiki to Miraheze



Welcome to Miraheze, we're glad to have you here!

Moving a wiki to Miraheze isn't a difficult chore. Whether the wiki is hosted by yourself, FANDOM, or any other MediaWiki host, moving a wiki to Miraheze is possible. As long as you have the database dump ('XML' file), the task is easy!

Exporting a wiki
The first step to the process is to generate an XML dump file of your wiki (also known as a database dump). This file will contain all pages on your wiki (including user pages and image descriptions but not the images themselves which are seperate). The method will vary on the wiki.

Moving from FANDOM


FANDOM (formerly known as Wikia) provides an XML dump of each wiki which can be accessed via on your wiki. Please note that this file is not generated every day and may be outdated. If it is outdated, wiki administrators can click the "Send request" button there to request a newer dump be generated. If your wiki has no active administrators, you'll have to ask [ https://fandom.zendesk.com/hc/en-us/requests/new FANDOM support] to generate one for you. Once that is done, skip to the "Importing a wiki" section.

FANDOM does not allow for wiki closures (except in certain circumstances such as small, niche wikis), mass deletions of pages or linking to external, non-FANDOM wikis on the Main Page. Their policy only allows for creating a public post regarding the move which may be linked to on the Main Page. After 2 weeks, the link to the new wiki must be removed from the post.

Images
If you wish, you may provide Miraheze with image dumps from your FANDOM for us to import. Note that under Fandom's Terms of Use, automated scraping of images is illegal and note too that images are not provided in XML dumps. Our understanding is that downloading them manually is still legal but Miraheze will not be able to assist you in that process. You may have additional rights under Article 20 of the GDPR in the EU in relation to images that you personally uploaded, due to any metadata linking it to your account.

Moving from WikiDot
Moving from WikiDot may pose a more unique challenge. WikiDot does not run MediaWiki, they use a proprietary software solution which is incompatible with MediaWiki.

Some scripts exist to convert WikiDot backups to MediaWiki-compatible XML files. One which has had reported success in the past is this script. Note that it requires an outdated version of Python (2.9) to run and that it is a shell script which may not be intuitive for less technically knowledgeable users.

Exporting via maintenance scripts
If you have server access and if you are moving an entire wiki, the easiest way to do so is using a maintenance script to export your entire wiki. For more information, checkout the documentation on dumpBackup.php on MediaWiki.org. Once you have a database dump, skip to "Importing a wiki."

Exporting images via maintenance scripts
If you have server access, you can use maintenance script dumpImages.php. Once you have an image dump, skip to "Importing a wiki."

Creating a dump via a script
If these methods don't work, you can use [ https://github.com/wikiteam/wikiteam WikiTeam's wiki archiving tool] to make a XML dump and download all available images at the same time. While it is a useful tool, do note that it does rely on an outdated version of Python in order to run. We can't guarantee it will work on all wikis, nor we will run it for you. You'll have to run it on your own and prepare the data yourself.

Exporting from Special:Export
You can export a wiki manually using Special:Export. That page is self-explanatory, just make sure to uncheck " " as most licenses (such as Creative Commons) require attribution to be rendered so failing to do that will cause legal headaches. While this is useful for smaller wikis or if you're exporting small amounts of pages, it can be tedious to use this interface if exporting an entire wiki.

Caveats

 * Apart from the WikiTeam tool method, none of the methods here export image files. Methods system administrators for processing (via a Phabricator ticket).
 * None of these tools will move user accounts.
 * As always, any data transferred must have the proper copyright, and you must a license or ownership that allows you to host the content at Miraheze (e.g. Creative Commons). If you need to change the license of the wiki as a whole from CC-SA to some other license, please note this in your upload request.

Importing a wiki
There are a few methods for importing a wiki. Generally, you should always have us do large imports as MediaWiki will display an error if the import is over a few kilobytes big. If your import is small enough however, you can do it yourself without needing us.

Do it yourself
If your dump is really small (less than few kilobytes), you can try Special:Import on your wiki (not this wiki, Miraheze Meta). Images cannot be restored imported using that page. If the import is small enough, your import should finish and you’ll be able to use your wiki.

If the import fails, please see below section.

If you choose to do it yourself, you’ll have to manually upload photos yourself. You can use the normal upload interface to do this or you can use the MsUpload extension to drag and drop and upload groups of photos through the wiki editor.

Have us do it
If your XML dump file is big enough that MediaWiki will likely fail to process it in an appropriate amount of time (files over a few kilobytes), you’ll have to request that a system administrator import it for you. To request that we import the file, please use this form (Phabricator account required). You can send us your XML file in a few different ways:
 * On the Phabricator task, paste a link to where it can be downloaded from (i.e. Google Drive, Dropbox)
 * Send it to sre-mediawiki@undefinedmiraheze.org
 * If it’s small enough, upload it directly to Phabricator

Image import should also follow this way, too.

In the meanwhile, while you wait for the import to be done, you should avoid creating new pages that share the same name as pages on your old wiki. That will cause a conflict and the imported version of the page will not override your newly created page. If this happens, you yourself will need to manually restore an older revision of the page through the history tab in order to get an older version of the page to display.

We will disable any editing (including account creation) on the wiki during the import process: Your wiki users will need to create an account on Meta (this wiki!) and use that username and password to log in on the wiki until the import is complete.