Manual:Pywikibot/Compat/Basic use/pt

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 , 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 " ".


 * Muda o diretório de trabalho a C: escrevendo
 * 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 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 escrevendo "python pwb.py login". Se não tens configurado user-config.py ainda, este comando criá-la-á interativamente.


 * 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 

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
 * Inicia sessão como o utente 'xyz' em vez de com o nome utente por defeito.


 * -log
 * Ativa o log. Os logs alojar-se-ão no subdiretório de logs.


 * -log:xyz
 * Ativa o log, usando  como nome de arquivo.


 * -nolog
 * Desabilitar o log (se está habilitado por defeito).


 * -putthrottle:nn
 * Estabelece o tempo mínimo (em segundos) que o bot esperará entre guardar páginas. O valor por defeito é 10.

For example,  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.