Manual:Pywikibot/Compat/Uso básico

This page is documentation for Pywikipedia Compat, which is no longer supported. This page is kept for historical interest. It may document scripts and features that are obsolete and/or no longer supported. Do not rely on the information here being up-to-date.

Uso

Veja Criar um atalho para os usuários de Windows.

Selecione e execute um script de bot

Agora que tens intalado python e Pywikibot, precisas conseguir uma interface baseada em texto para teu sistema operativo.

Acedendo a pywikibot

Após que tenhas criado o arquivo chamado user-config.py , terás acesso a pywikibot.

Em Windows isto se faz abrindo o menu de início, e fazendo clique em 'Executar'. Perguntar-te-ão o nome do programa, escreve "cmd.exe".

Muda o diretório de trabalho a C: escrevendo chdir C:\
Escreve chdir \"nome da pasta onde pywikibot tem sido descarregado" "(Por exemplo: chdir\"pywikibot" se o arquivo encontra-se na diretório C:.)"

É possível que tenha que realizar os seguintes passos:

Move a pasta httplib2, que está na subpasta externals, a um nível superior.
Todos os scipts que queiras usar, têm que ser copiados desde a subpasta "scripts" ao diretório principal. Isto inclui a login.py.

Em Mac, encontra Terminal.app em /Aplications/Utilities, veja-se Instalação em Mac.

Em Linux ou qualquer outro sistema opertivo Unix, usa qualquer terminal como gnome-terminal, konsole, xterm,ou simplesmente a consola baseada em texto.

Em compat, executa o script login.py escrevendo "python login.py". Se não tens configurado user-config.py ainda, este comando criá-lo-á interativamente.

Em core, desde o diretório principal, executa o script login.py escrevendo "python pwb.py login". Se não tens configurado user-config.py ainda, este comando criá-la-á interativamente.

pwb.py acrescenta o diretório principal à variável 'PATH' para que python veja o diretório de pywikibot. Há outras formas de arranjar isto, como acrescentando o diretório principal (ou qualquer outro diretório que contenha o diretório de pywikibot) a 'PATH' ou 'PYTHONPATH'.

Introduzindo senha

Python devolverá a seguinte:

Password for user your_bot on your_site:en:

Usa a senha que tens usado para o login do bot. Tenha em conta que o que introduzas não será visível por razões de segurança. O bot não pode trabalhar anonimamente. A não ser que mudes tua senha, geralmente só será necessário executar este programa uma vez.

Utilizando um bot

Os bots estão na pasta principal pywikibot quando se descarregam.

Se é necessário, usa o comando cd para ir ao diretório onde os arquivos do bot estão guardados.

Agora, executa qualquer dos bots aqui escrevendo "python botname.py" (se estás a usar Windows, não é necessário pôr "python").

Scripts

Página principal Manual:Pywikibot/Scripts

Interface de linha de comandos

Apesar de que muitos bots têm seus próprios argumentos de interface de linha de comandos, o qual deveria estar documentado em suas respectivas páginas (ou em seu código fonte), todos os bots, a não ser que especificamente se diga o contrário, reconhecem os seguintes argumentos de interface de linha de comandos:

(lista completa aqui: $1)

-help: Mostra uma lista de argumentos globais para o bot (esta lista), seguido de uma ajuda específica para o bot se está disponível.
-lang:xx: Estabelece o idioma da wiki na que queres trabalhar com o código do idioma $1 sobrescrevendo a configaração de $2.
-family:xyz: Estabelece a família da wiki na que queres trabalhar, por exemplo, wikipedia, wiktionary, wikitravel... Isto sobrescreverá a configuração de $1.
-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

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.