View source for Pywikipediabot使用手冊

''In other languages:''
[[:de:b:Python-Programmierung:_Pywikipediabot|de]] -
[[Using the python wikipediabot|en]] -
[[:fr:Aide:Pywikipedia|fr]] - 
[[:hu:Wikipédia:Pywikipedia|hu]] -
[[Come_usare_il_wikipediabot_in_linguaggio_python|it]] -
[[:ja:Help:Pywikipediabot|ja]] -
[[Pywikipediabot 사용하기|ko]] - 
[[:nl:Help:Gebruik van bots|nl]] - 
[[Jak używać botów|pl]] - 
[[:pt:Ajuda:Como usar bots|pt]] -
[[:ru:Википедия:Pywikipedia-боты|ru]] - 
[[Hur man använder en python wikipediabot|sv]] - 
[[Pywikipediabot使用手冊|zh-hant]]
----
{{Bothelp}} 
Python Wikipediabot Framework (pywikipedia)是一組針對維基百科或維基媒體計劃等以MediaWiki架設的網站的自動執行更新工具。本頁將提供如何使用本軟體的一般資訊。

== 初始設定 ==
PyWikipediaBot是使用[[:zh:Python|Python]]撰寫而成的程式，您需要安裝最新版的Python程式到您的電腦中才可以執行Pywikipediabot。部份程式雖可以在Python 2.3版執行，但目前沒有計劃相容舊版本的Python。

ActivePython

ActivePython可以於任何的平臺上運作(Unix, Linux, Mac, Windows)，它也可以執行Pywikipediabot的程式碼。

*'''windows'''系統：連結到[http://www.activestate.com/Products/activepython/features.plex 這裡]下載並安裝ActivePython
*'''Unix'''系統：一般來說，Python會預設安裝在大部份的Unix版本，因此不需要下載(除非您系統的Python版本太舊才需要)
*在'''Macintosh'''，Python已包含在Mac OS X中

=== 下載 ===
使用[http://tools.wikimedia.de/~valhallasw/pywiki 這個網站]可以很輕易的下載到最近的Pywikipediabot版本。過去的舊版本可以在[http://sourceforge.net/projects/pywikipediabot/ Sourceforge]找到。下載並解壓縮這些檔案即可，不需要再做其他安裝手續。

'''Macintosh'''電腦請參閱[http://www.rubyrobot.org/tutorial/subversion-with-mac-os-x 此教學]。Pywikipediabot的檔案可以在[http://svn.wikimedia.org/svnroot/pywikipedia/trunk/pywikipedia/ 這裡]找到。<ref name="check">"Check out"是將這些檔案從儲存庫上複製一份並取去的意思。</ref> 

====透過SVN下載====
您可以使 用 [[:zh:Subversion|SVN]] ([http://subversion.tigris.org/] subversion.tigris.org)取得即時更新的Pywikipediabot資料。如果您使用Windows系統，我們建議您使用[http://tortoisesvn.net/downloads TortoiseSVN]。Macintosh電腦可以參閱[http://www.rubyrobot.org/tutorial/subversion-with-mac-os-x 這個網頁]

<div class="plainlinks">透過SVN取得原始碼的指令如下：

<tt><nowiki>$ svn checkout http://svn.wikimedia.org/svnroot/pywikipedia/trunk/pywikipedia/ pywikipedia</nowiki></tt>

如果不想取得拼音檢查的檔案，請輸入以下指令：
 $ svn checkout --ignore-externals http://svn.wikimedia.org/svnroot/pywikipedia/trunk/pywikipedia/ pywikipedia
</div>
這樣將會在您目前的目錄下建立一個名為“pywikipedia”的目錄。

使用非命令列工具的使用者，請使用您的工具輸入這個位置：http://svn.wikimedia.org/svnroot/pywikipedia/trunk/pywikipedia/

=== 設定 ===
您不需要去''安裝''就可以使用。在解壓縮或是從SVN下載之後就可以執行。

在使用之前，您需要在您的<tt>pywikipedia</tt>目錄中建立一個名為<tt>user-config.py</tt>您可以自行建立並按照以下說明輸入設定，也可以執行<tt>generate_user_files.py</tt>並依照指示操作，它會幫助您完成這些程序。

要注意的是PyWikipediaBot只能使用預設的Monobook外觀。為維持Pywikipediabot的運作順暢，請不要在帳號的參數設置中更改這個設定。

====設定(以下以Wikipedia為例)====
開啟文字編輯器(Windows下的Notepad或是unix下的ee)，將<code>user-config.py</code>存在<tt>pywikipedia</tt>的目錄下。

請在user-config.py增加以下兩行資料：

{| cellpadding=5
|'''程式碼'''
|'''解釋'''
|-
|valign=top width=400px| 
<source lang="python">mylang = 'xx'</source>
|valign=top| 
xx是您準備執行的計劃的語言，例如en指的是英語，ja是日語，zh是漢語。<ref name="lan">如果您打算在一個以上的語言執行bot，請選擇最常用的那個語言，未來在執行時您可以使用<tt>-lang</tt>參數來切換執行語言。</ref> 
|-
|valign=top|
<source lang="python">usernames['wikipedia']['en'] = u'ExampleBot'</source><ref name="uni">用戶名稱前頭的'u'指的是讓字串轉成Unicode編碼。如果您的用戶名稱並非英數字母，這個'u'就非常重要。</ref>
|valign=top|
您的<code>user-config.py</code>檔案需要設定您的機器人用戶名稱。

在這個例子中，用戶是在英語維基百科上執行工作，且已建立一個名為"ExampleBot"的用戶。
|-
|valign=top|
''(選項)''

 usernames['wikipedia']['de'] = u'BeispielBot'
 usernames['wikipedia']['en'] = u'ExampleBot'
 usernames['wiktionary']['de'] = u'BeispielBot'
|valign=top|
''(選項)'' 
如果您要在一個以上的維基百科上執行，您需要增加數個用戶名稱。
|}
輸入完成後請儲存<code>user-config.py</code>。

====其他MediaWiki網站設定====
請增加以下'''三行'''程式碼到<code>user-config.py</code>：

{| cellpadding=5
|'''程式碼'''
|'''解釋'''
|-
|valign=top width=400px| 
 <source lang="python">mylang = 'xx'</source>
|valign=top| 
xx是您準備執行的計劃的語言，例如en指的是英語，ja是日語，zh是漢語。<ref name="lan"/>
|-
|valign=top|
<source lang="python"> family = 'sitename' </source>
|valign=top|
"Sitename"是您要工作的網站名稱。

目前，這個選項可以在維基辭典、維基新聞、維基教科書、維基語錄等非[[Wikipedia維基百科]]的計劃，像Wikitravel。(所有清單可在pywikipedia/families目錄下找到)

|-
|valign=top|
<source lang="python"> usernames['memoryalpha']['en'] = u'ExampleBot'</source>
|valign=top|

您的<code>user-config.py</code>檔案需要設定您的機器人用戶名稱。

在這個例子中，用戶是在英語Memory Alpha上執行工作，且已建立一個名為"ExampleBot"的用戶。
|-
|valign=top|
''(以下只限維基共享資源)''

 mylang='commons'
 family='commons'
 usernames['commons']['commons']='UserBot'

|valign=top|
''(以下只限維基共享資源)''

如果您要在維基共享資源或是元維基類的網站執行機器人，請mylang跟family都指定相同的family名稱
|-
|valign=top|

|valign=top|
|}

輸入完成後請儲存<code>user-config.py</code>。

如果您的網站沒有在families目錄中，您需要自行建立您的fmailies.py，請參閱[[Pywikipedia bot on non-Wikimedia projects]].

====非維基媒體計劃的設定====
請參閱[[Pywikipedia bot on non-wikimedia projects]]。

==權限==
請確定您的機器人已經被該維基站的社群認可，每個計劃都有極大的不同。<!--Strictness of this differs greatly between various projects;
at some you need to announce it in advance and get approval before you start, at others you can do whatever you want.-->

請先使用你的瀏覽器，建立一個帳號密碼給這個機器人使用，名稱最好能讓人了解這是一個機器人帳號，以及是哪個用戶在操作它。通常的做法是拿您自己的用戶名稱後面加上"bot"這個字，但也可以有好幾種的組合存在。

On the English Wikipedia, bots are only allowed to be used if they are approved at [[:en:Wikipedia:Bots/Requests for approval]].

===Request a bot flag===
If you heavily use a bot, it will clutter recent changes. To avoid that, you can get your bot registered as such. In that case it will not be shown on Recent changes unless a user specifically asks to get bots included.

This can be done by a [[Bureaucrat]]. You can put a request to get your or someone else's bot registered at [[Requests for bot status]]. You will probably be asked for some kind of evidence that your local community agrees with your bot.  On the English language Wikipedia, requests should be made at [[en:Wikipedia:Bots/Requests for approvals|Requests for approvals]].  It is probably good to get your bot registered whenever it will edit many pages in a single run.

==Use==
===Select and run a bot script===
Now we are ready to really start using the bot. You need to get to a textual interface to your Operating System. 

On '''Windows''' this is done by opening the start menu, and clicking on 'Run'. You are asked to give the name of a program, type "cmd.exe". 
* Change the root to C: by typing chdir C:\
* Type chdir \"name of the folder where pywikipedia bot has been downloaded" ''(For example: chdir \"pywikipedia" if the file is in the C: folder.)''

On '''Mac''', find Terminal.app in /Applications/Utilities.

On '''Linux''' or any other '''Unix''', use any terminal application such as gnome-terminal, konsole, xterm, or simply the text-mode console.

Run the script [[login.py]] by typing "python login.py". 

Python will then return:

:<code>Checked for running processes. 1 processes currently running, including the current process.</code>
:<code>Password for user your_bot on your_site:en:</code>

Use the password you used for the bot's login name. The bot can't work anonymously. Unless you change your password, you normally need to run this program only once, the bot usually does not get logged off.

The bots are in the main pywikipedia folder when downloaded. But it necessary, use the command cd to go to the directory where the bot files are saved. 

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

===程式碼===
Here is a list of the existing bots with links to their descriptions:
{| cellspacing="0" cellpadding="0" border="0" width="100%"
|- align="left" valign="middle"
| style="width:1ex" | &nbsp;
!主要的機器人程式
| style="width:4ex" | &nbsp;
!其他的機器人程式
| style="width:2ex" | &nbsp;
|-
| ||
----
| ||
----
| ||
----
|- align="left" valign="top"
| ||
* [[category.py]] Script which manages categories
* [[imagetransfer.py]] Copy images to another wiki
* [[interwiki.py]] Creates Interlanguage links between a project
* [[redirect.py]] Fixes double redirects, and  deletes broken redirects
* [[replace.py]]  Replaces text
* [[solve_disambiguation.py]]
* [[table2wiki.py]] Converts HTML-tables to MediaWiki's language
* [[template.py]] Replaces a template with another
* [[upload.py]] Upload images to wiki
* [[weblinkchecker.py]] finds broken external links
* [[wikipedia.py]]
'''輔助程式'''
* [[login.py]] Essential python program
| ||
* [[catall.py]] Adds or changes categories
* [[copyright.py]] Checks copyright text in search engines 
* [[delete.py]] deletes pages en masse
* [[delinker.py]] Bot delinks and replaces images
* [[imageharvest.py]] Copies multiple images to a wiki
* [[movepages.py]] Moves page to another title
* [[pagefromfile.py]] Create pages from a textfile
* [[protect.py]]
* [[standardize_interwiki.py]] Moves the interwiki links
* [[standardize_notes.py]] Improves references and citations
* [[test.py]] Outputs logged-in account and wikifamily.
* <s>[[touch.py]]</s>
* <s>[[touchall.py]]</s>
* [[warnfile.py]]
* [[welcome.py]] Used to welcome new users 
* [[version.py]] Outputs about Pywikipedia's revision number and so on
|}

===Command-line arguments===
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:

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

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

===Bot mailing list===
It can be useful to subscribe to the bot mailing list (see  http://lists.wikimedia.org/mailman/listinfo/Pywikipedia-l). Every time a file of the bot software is changed, a mail is sent to the list, so you know when you need to update to the new version.

==Update==
For further updates chdir into 'pywikipedia' and type

<tt>$ svn update</tt>

On a Mac, you can write the following:

<tt>svn update pywikipedia</tt>

==How to report a bug==
When you report a bug please try to include:

* PyWikipediaBot version in use. It's recommended to test if the bug is still present in latest SVN revision available.
* Python version (python -V) and operating system you use (e.g. Windows, Linux, MacOS...)
** For above purpose, [[version.py]] will be useful.
* A nice summary
* Full description of the problem/report
* How to reproduce bug full information (script, command line, family, and language used)
* Output data

To submit a new bug visit the [http://sourceforge.net/tracker/?group_id=93107 bug tracker] provided by SourceForge.

==Development==
If you have a function you want to have a bot for that is not yet provided by one of the bots, you can ask one of the programmers to write it for you. Or even better, you can try to work on the bots yourself. Python is a nice language, and not hard to learn. We will welcome you.

===Tips===
Here and in [[wikipedia.py]], there are some very basic tips for getting started writing your own bot:
*be sure you've set up your user-config.py file (see [[#Configuring for Wikipedia|above]])
*To gain access to the pywikipedia framework, use: 
<source lang="python">
import wikipedia
</source>
*to retrieve a page, use the following, where pageName is, e.g., "Wikipedia:Bots" or "India":
<source lang="python">
site = wikipedia.getSite()
page = wikipedia.Page(site, u"pageName")
text = page.get(get_redirect = True)
</source>
*to update a page, use:
<source lang="python">
page.put(u"newText", u"Edit comment")
</source>
*look at some of the pywikipedia files for other ideas -- basic.py is relatively easy to read even if you're new to pywikipedia.
*you can find all available Page methods in the wikipedia.py file.
*basic.py gives you a setup that can be used for many different bots, all you have to do is define the string editing on the page text.
*To [[:w:iteration|iterate]] over a set of pages, see pagegenerators.py for some objects that return a set of pages. An example use of the CategoryPageGenerator that does something for each page in the [[:w:Category:Living people|Category:Living people]] category:
<source lang="python">
import catlib
import pagegenerators
site = wikipedia.getSite()
cat = catlib.Category(site,'Category:Living people')
gen = pagegenerators.CategorizedPageGenerator(cat)
for page in gen:
  #Do something with the page object, for example:
  text = page.get()
</source>

====Create a quick shortcut to run commands (Windows users) ====
How to make a quick shortcut to run commands (Windows users).

If you're installing Pywikipediabot in a folder such as "My Documents" it may be troublesome to use the "cd" command to go into the folder all the time to run the bots (For those who don't get what that means, this will help you a lot).

On Windows you can create a shortcut which will open the command box you can use to run bots easily. Just follow these simple steps to create one:
# Open up the folder pywikipedia is installed in, in a window.
# Under File > New select Shortcut.
# Type in "cmd.exe" and hit next.
# You can give a name to the shortcut here, just "Pywikipediabot" is good.
# In the address bar (The text bar above where your files are which tells you where you are) copy the path there.
# Right click on the new shortcut and hit properties and paste that path you copied into the "Start in" text field.
# Hit ok, and now you have a shortcut to open the command line to run bots from.

===Contributing changes===
If you changed the bot and want to send a patch to the maintainer, 
# Update to the current version (it will merge your changes with the improvements already committed to the SVN Repository), 
# Resolve any conflicts caused by the update (grep for "=====" ;-) and
# Type:
:<pre>$ svn diff > svn.diff</pre>

Review the diff to ensure it only includes the changes you want to contribute.  The lines at the beginning starting with "?" should be removed.

If you are in direct contact with a Pywikipediabot developer, you can send the file svn.diff to him, but preferably attach the patch to a ticket in the [http://sourceforge.net/tracker/?atid=603138&group_id=93107&func=browse Pywikipedia bug tracking system].

===Multiple accounts===
It is a common need to run python wikipedia bot under different accounts (main and/or multiple bot accounts). It can be done in two ways.

====Separate pywikipedia distributions====
One can install completely separate instances of pywikipedia in different directories (1 for each account) and have diferent <code>user-config.py</code> files in each of them. However, when updating the installation ''via'' SVN, one needs to run <code>svn update</code> on each folder separately. Also, every installation takes some disk space, which might be a problem on accounts with limited quota.

====One pywikipedia distribution with symbolic links====

Let's assume user <code>foo</code> has a current SVN working copy of pywikipedia in <code>/home/foo/pywikipedia</code>. For each of the accounts, he creates a separate directory:

 foo@bar:~$ '''mkdir foobot'''
 foo@bar:~$ '''cd foobot'''

Pywikipedia needs then some symlinks to the main code tree created in the working directory:

 foo@bar:~/foobot$ '''ln -s ~/pywikipedia/families'''
 foo@bar:~/foobot$ '''ln -s ~/pywikipedia/userinterfaces'''
<!-- THAT'S ALL IT NEEDED IN MY CASE - ADD MORE IF NECESSARY -->

Then, <code>user-config.py</code> for this account must be created as described in [[#Configuration|Configuration section]] above.

Finally, the bot must be logged in the usual way:

 foo@bar:~/foobot$ '''python ~/pywikipedia/login.py'''

The working directory is ready. The scripts will however require a slight modification to run (the path to the pywikipedia tree must be added to Python's path).

 import sys, os
 sys.path.append(os.environ['HOME'] + '/pywikipedia')
 import wikipedia

That's all. Updating to the newest version of pywikipedia on ''all account at once'' is now a matter of running <code>svn update</code> only in the <code>~/pywikipedia</code> directory.

==Bot & Proxy==
There is probably (not tested!) draft workaround described 
[http://nl.wikipedia.org/w/index.php?title=Overleg_gebruiker:Andre_Engels&oldid=10418345#pywikipedia_proxy here].
==Notes==
<references/>

==See also==
*[[Pywikipediabot general parameters]]
*[[Pywikipedia bot on non-Wikimedia projects]]
*[[botwiki:|Botwiki]]
*[[botwiki:Manual:Speed guide for pywikipediabot| Another guide]]
*[[w:Wikipedia:Creating a bot|Wikipedia:Creating a bot]]
*[[Using the python wikipediabot/Mac]], a Mac-specific guide.
*[[v:en:Pywikipediabot|Pywikipediabot course]] at [[Wikiversity]]

==External links==
*[http://pywikipediabot.sourceforge.net/ Project's webpage]
*[http://lists.wikimedia.org/mailman/listinfo/Pywikipedia-l PyWikipedia mailing-list]
*[irc://irc.freenode.net/pywikipediabot #pywikipediabot IRC channel] 

<!--[[Category:MediaWiki tools]] 
[[Category:Multilingualism]]
[[Category:Pywikipedia|!]]
-->