Backing up the wiki: Difference between revisions

Jump to navigation Jump to search
Content deleted Content added
No edit summary
No edit summary
 
Line 4: Line 4:
{{note|<nowiki>Windows: When using --images, because NTFS does not allow characters such as :*?"<>| in filenames, some files may not be downloaded, please check the errors.log file.</nowiki>}}
{{note|<nowiki>Windows: When using --images, because NTFS does not allow characters such as :*?"<>| in filenames, some files may not be downloaded, please check the errors.log file.</nowiki>}}


e.g. <code><nowiki>wikiteam3dumpgenerator https://WIKINAME.miraheze.org --xml --xmlrevisions --images --bypass-cdn-image-compression --force</nowiki></code>
e.g. <code><nowiki>wikiteam3dumpgenerator WIKI_URL --xml --xmlrevisions --images --bypass-cdn-image-compression --force</nowiki></code>


To dump a private wiki you will have to use a login that has at least read permission on the wiki.
To dump a private wiki you will have to use a login that has at least read permission on the wiki.


e.g. <code><nowiki>wikiteam3dumpgenerator https://WIKINAME.miraheze.org --xml --xmlrevisions --images --bypass-cdn-image-compression --force --user USER --pass PASSWORD</nowiki></code>
e.g. <code><nowiki>wikiteam3dumpgenerator WIKI_URL --xml --xmlrevisions --images --bypass-cdn-image-compression --force --user USER --pass PASSWORD</nowiki></code><br />
If that doesn't work. Login with a web browser, save the site cookies in Netscape format to cookies.txt, and add option <code><nowiki>--cookies cookies.txt</nowiki></code>


* --xml exports an XML dump, uses Special:Export by default when no other xmldump method is specified.
* --xml exports an XML dump, uses Special:Export by default when no other xmldump method is specified.
* --xmlrevisions uses API:Allrevisions xmldump method. Recommended as it's quicker and puts almost no pressure on the MediaWiki backend compared to Special:Export.
* --xmlrevisions uses API:Allrevisions xmldump method. Recommended as it's quicker and puts almost no pressure on the MediaWiki backend compared to Special:Export.
* --images generates an image dump
* --images generates an image dump
* --bypass-cdn-image-compression appends random parameters to URL when downloading image
* --bypass-cdn-image-compression needed with Miraheze
* --force generates a dump even if there is one already at Internet Archive
* --force generates a dump even if there is one already at Internet Archive