Manuale:Pywikibot/Compatto/Uso base

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Manual:Pywikibot/Compat/Basic use and the translation is 57% complete.

Other languages:
български • ‎Ελληνικά • ‎English • ‎español • ‎français • ‎italiano • ‎日本語 • ‎polski • ‎русский • ‎српски / srpski • ‎svenska

Uso[edit]

Guarda Creare un collegamento for Windows users

Seleziona e avvia il bot script[edit]

Ora che hai installato python e Pywikibot, devi avere un'interfaccia testuale al tuo sistema operativo.

Accedi a Pywikibot

Dopo aver creato il file, chiamato user-config.pyManual:Pywikibot/user-config.py, è possibile accedere a pywikibot.

Su "Windows" questo avviene aprendo il manu start e facendo clic su 'Esegui'. Viene richiesto di indicare il nome di un programma, e scrivere "cmd.exe".

  • Cambia il root in C: scrivendo chdir C:\
  • Scrivere chdir\"nome della cartella dove pswikibot è installato" (Per esempio: chdir\"pywikibot" se il file è nella cartella C:)

Potrebbe essere necessario fare le seguenti operazioni:

  • Sposta la cartella httplib2 che è nella sub-cartella externals di un livello su.
  • Tutti gli script che vuoi usare devono essere copiati dalla cartella "scripts" alla cartella principale. Incluso login.py.

Su "Mac", trova Terminal.app in /Applications/Utilities, vedi Mac Installation.

Su "Linux" o qualsiasi altra "Unix", utilizzare qualsiasi applicazione terminale come gnome-terminal, konsole, xterm o semplicemente la console di testo.

In compat, esegui lo script login.pyManual:Pywikibot/login.py scrivendo "python login.py". Se non hai ancora user-config.py, questo comando lo creerà.

In core, dalla cartella principale, esegui lo script login.pyManual:Pywikibot/login.py. Se non hai ancora user-config.py, questo comando lo creerà.

Nota Nota: pwb.py aggiunge la cartella principale alla variabile `PATH` affinchè Python veda la cartella di pywikibot. Ci sono altri modi per farlo, ad esempio aggiungendo la cartella principale (o ogni cartella contenente la cartella pywikibot) nella `PATH` o `PYTHONPATH`.

Inserimento password

Python in seguito restituirà:

Password for user your_bot on your_site:en:

Usa la password che hai usato per il login del bot. Tieni conto che quello che verrà scritto non sarà visibile per ragioni di sicurezza. Il bot non può lavorare anonimamente. Se non cambi la tua password, generalmente sarà necessario eseguire questo programma solo una volta.

Utilizzo di un bot

I bot stanno nella cartella principale di pywikibot quando scaricati.

Se necessario, usa il comando cd per andare nella cartella dove i file del bot sono stati salvati.

Now run any of the bots here by typing "python botname.py" (If you are using Windows, you can leave out "python").

Scripts[edit]

Main page: Manual:Pywikibot/ScriptsManual:Pywikibot/Scripts

Command-line arguments[edit]

Although many bot scripts have their own command line arguments, which should be documented on their respective pages (or in their source code), all bots unless specifically stated to the contrary recognize the following command line arguments:

(full list here: Manual:Pywikibot/Global OptionsManual:Pywikibot/Global Options)

-help
Print a list of global bot arguments (this list), followed by bot-specific help if available.
-lang:xx
Set the language of the wiki you want to work on to language code xx, overriding the configuration in user-config.py.
-family:xyz
Set the family of the wiki you want to work on, e.g., wikipedia, wiktionary, wikitravel, ... This will override the configuration in user-config.py.
-user:xyz
Log in as user 'xyz' instead of the default username.
-log
Enable the logfile. Logs will be stored in the logs subdirectory.
-log:xyz
Enable the logfile, using xyz as the filename.
-nolog
Disable the logfile (if it's enabled by default).
-putthrottle:nn
Set the minimum time (in seconds) the bot will wait between saving pages. The default value is 10.

For example, python scriptname.py -family:wiktionary will run the "scriptname" bot on wiktionary articles, overriding the default family setting in your user configuration.

Permission on Wikimedia projects[edit]

Make sure that your bot is approved by the wiki community where you are going to use it: see the global Bot policy for guidance. Strictness differs greatly between various projects.

Using your normal browser, create a login name and password for the bot. It is best to use a name that makes clear that it is a bot, and preferably also who is operating it. A common method is to use your own login name and add the word 'bot' to it, but several other forms also exist.