Revision: 3976 Author: wikipedian Date: 2007-08-06 17:50:16 +0000 (Mon, 06 Aug 2007)

Log Message: ----------- formatted docu

Modified Paths: -------------- trunk/pywikipedia/replace.py

Modified: trunk/pywikipedia/replace.py =================================================================== --- trunk/pywikipedia/replace.py 2007-08-06 16:38:41 UTC (rev 3975) +++ trunk/pywikipedia/replace.py 2007-08-06 17:50:16 UTC (rev 3976) @@ -11,6 +11,7 @@ -xml Retrieve information from a local XML dump (pages-articles or pages-meta-current, see http://download.wikimedia.org). Argument can also be given as "-xml:filename". + -page Only edit a specific page. Argument can also be given as "-page:pagetitle". You can give this parameter multiple times to edit multiple pages. @@ -19,29 +20,38 @@

-regex Make replacements using regular expressions. If this argument isn't given, the bot will make simple text replacements. + + -nocase Use case insensitive regular expressions. + -except:XYZ Ignore pages which contain XYZ. If the -regex argument is given, XYZ will be regarded as a regular expression. + -summary:XYZ Set the summary message text for the edit to XYZ, bypassing the predefined message texts with original and replacements inserted. + -fix:XYZ Perform one of the predefined replacements tasks, which are given in the dictionary 'fixes' defined inside the file fixes.py. - The -regex argument and given replacements will be ignored if - you use -fix. + The -regex and -nocase argument and given replacements will + be ignored if you use -fix. Currently available predefined fixes are: &fixes-help; + -namespace:n Number of namespace to process. The parameter can be used multiple times. It works in combination with all other parameters, except for the -start parameter. If you e.g. want to iterate over all categories starting at M, use -start:Category:M. + -always Don't prompt you for each replacement + -recursive Recurse replacement until possible. Be careful, this might lead to an infinite loop. - -nocase Use case insensitive regular expressions. + -allowoverlap When occurences of the pattern overlap, replace all of them. Be careful, this might lead to an infinite loop. + other: First argument is the old text, second argument is the new text. If the -regex argument is given, the first argument will be regarded as a regular expression, and the second argument might @@ -50,7 +60,7 @@ Examples:

If you want to change templates from the old syntax, e.g. {{msg:Stub}}, to the -new syntax, e.g. {{Stub}}, download an XML dump file (cur table) from +new syntax, e.g. {{Stub}}, download an XML dump file (pages-articles) from http://download.wikimedia.org, then use this command:

python replace.py -xml -regex "{{msg:(.*?)}}" "{{\1}}"