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:
 * replace.py : el mòdul principal
 * fixes.py : alguns arranjaments predefinits
 * user-fixes.py : un fitxer personalitzable. El fitxer es crea prèviament buit executant l'ordre generate_user_files.py

Fitxers que poden utilitzar-se per a llegir dades o registrar resultats:
 * filename.txt : un fitxer amb una llista d'articles quan s'afegeix el paràmetre "-file"
 * filename.xml : un dipòsit XML local quan s'especifica el paràmetre "-xml"
 * replacelog : 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:

<div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> 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:

<div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> 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:

<div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> 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: <div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> python replace.py -page:John_Doe -fix:HTML

Si no indique els arguments necessaris el programa vos anirà demanant els paràmetres: <div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> 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: <div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> 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 user-fixes.py</tt>, podent accedir a les dades d'este fitxer de la següent manera: <div style="background: #99B3FF; color: black; border: #668CFF solid 0.2em; padding: 0.85em; margin-left: 3em; margin-top: 0.5em; margin-right: 3em; margin-bottom: 0.5em;"> 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: <pre style="overflow:auto">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.