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.
- 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:
(full list here: Manual: Pywikibot/Opções globais )
- -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
- Set the language of the wiki you want to work on to language code
xx
, overriding the configuration inuser-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
- 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
xyz
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.
Por exemplo, python scriptname.py -family:wiktionary executará o bot "scriptname" nos artigos de wiktionary, sobrescrevendo a configuração por defeito.
Permissão nos projetos de Wikimedia
Assegura-te de que teu bot está aprovado pela comunidade da wiki onde o vais usar: lê a política global de bots para mais informação. A rigidez muda muito entre diferentes projetos.
O uso normal de seu navegador, criar um nome de utente e a senha para o bot. O melhor é utilizar um nome que deixa claro que se trata de um robô, e preferivelmente também que está a operar a mesma. Um método comum é usar seu próprio nome de utente e acrescentar a palavra "bot" a ela, mas também existem outras formas.