Manual:Pywikibot/replace.py/ca

Replace.py és un mòdul que forma part del marc de treball del Pywiki bot.

Aquest bot substitueix text. Recupera informació en aquelles pàgines que necessiten canvis per mig d'un dipòsit XML o un fitxer de text, o sols modifica una pàgina. Per obtenir més informació utilitzeu  python replace.py -help

Fitxers
El bot empra tres fitxers adicionals de l'entorn de treball:
 * : el mòdul principal
 * : alguns arranjaments predefinits
 * : un fitxer personalitzable. El fitxer es crea prèviament buit executant l'ordre

Fitxers que poden utilitzar-se per a llegir dades o registrar resultats:
 * : un fitxer amb una llista d'articles quan s'afegeix el paràmetre "-file"
 * : un dipòsit XML local quan s'especifica el paràmetre "-xml"
 * : un registre amb un nom quan s'especifica el paràmetre "-log"

locals
Podeu executar replace.py amb els següents paràmetres (per exemple, ).

Exemples
Si desitgeu modificar plantilles amb la sintaxi antiga, v.g., per la nova sintaxi, e.g.  , descarregueu el fitxer dipòsit XML des de https://dumps.wikimedia.org, i aleshores empreu esta ordre:

 python replace.py -xml -regex "" ""

Es poden trobar patrons en més d'una línia:

 python replace.py -regex -start:! "Primer a línia\nSegona línia" ""

El replace.py es pot emprar per a inserir o afegir text en una pàgina:

 python replace.py -regex '(?ms)^(.*)$' "\1"

Si teniu un fitxer dipòsit anomenat diposit.xml i voleu esmenar errors mecanogràfics, v.g. Errror -> Error, empreu esta línia d'ordres:

 python replace.py -xml:foobar.xml "Errror" "Error"

Si sabeu d'una pàgina anomenada "Betxí" amb etiquetes HTML i les voleu convertir a sintaxi viqui, feu la següent ordre:  python replace.py -page:John_Doe -fix:HTML

Si no indique els arguments necessaris el programa vos anirà demanant els paràmetres:  python replace.py -file:articles.txt

L'script demana a l'usuari abans de modificar un article els paràmetres de reemplaçament, el resum d'edició, etc. Es remomana fer una doble comprovació per assegurar-se que el bot no insereix errors (especialment tractant-se de correccions ortogràfiques). És possible especificar un conjunt d'articles amb un fitxer extern que continga les pàgines a revisar a mode d'enllaços viqui. Per exemple si desitgeu revisar les pàgines ”avió”, ”vehicle”, ”tren”, i ”cotxe”, haurieu de crear un fitxer de text anomenat articles.txt amb el següent contingut:

avió vehicle tren cotxe

Aleshores posarieu la següent ordre:  python replace.py [paràmetres-globals] -file:articles.txt "possar" "posar"

Més que indicar les expressions regulars a la línia d'ordres és preferible afegir-les al fitxer Python, podent accedir a les dades d'este fitxer de la següent manera:  python replace.py -file:articles.txt -fix:exemple1

El vostre fitxer user-fixes.py hauria de contenir almenys la següent variable:

Example: Replacing multiple paragraphs
The original text of the page Sandbox is: This page is for any tests.

Welcome to the sandbox!

If you want to switch the statement (the second one goes before the first one), you type the following syntax: replace.py -page:Meta:Sandbox -regex "This page is for any tests.\r\n\r\nWelcome to the sandbox!" "Welcome to the sandbox!\n\nThis page is for any tests."

To add a new line we use.