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}}"