手册:Pywikibot/安装

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Installation and the translation is 100% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Lëtzebuergesch • ‎Nederlands • ‎asturianu • ‎català • ‎dansk • ‎español • ‎français • ‎italiano • ‎norsk nynorsk • ‎polski • ‎português do Brasil • ‎suomi • ‎čeština • ‎Ελληνικά • ‎български • ‎русский • ‎українська • ‎עברית • ‎العربية • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Gnome-system-software-installer.svg
这个页面将帮助你开始使用Pywikibot。您可以在您的个人计算机、Toolforge或PAWS: A Web Shell上使用Pywikibot。
PAWS
Unicorn paw logo.svg

PAWS: A Web Shell是最简单的学习使用Pywikibot的工具。 不需要任何安装,您只需使用网络界面即可提交命令。

在您的个人计算机上使用
Computer n screen.svg

以下说明书将帮助您在您的个人计算机上安装并运行Pywikibot。以下是四个主要步骤:

Toolforge
Toolforge logo.svg

Toolforge拥有稳定的维基百科云托管基础设施,你将可以在这里持续或定期地运行机器人。

安装

从https://www.python.org/downloads/下载并安装Python。

如果您已经安装了Python,请检查您的Python版本是否符合Pywikibot的要求。在命令提示符(windows)运行python --version即可获取版本号。 如果您已安装Python 2.7.4或更高版本,或Python 3.4或更高版本,那么您的Python版本就足够新了。 总而言之,Python3.5以前的版本在未来将被淘汰。 强烈推荐使用Python3.5以上的版本。

Modify the path

On Windows systems, even after installing python, the command line interface may not initially know where the python installation is located (although the installer has an option to make it know). In other words, if you enter the command

C:\Users\Joe>python

it may result in the following error:

'python' is not recognized as an internal or external command, operable program or batch file.

To fix this, you need to modify the environment variable named "path" and add the folder which contains "python.exe". On Windows 10, this is under Settings > System > About > System info > Advanced System Settings > Environment Variables. Closing and re-opening the command line, entering "python" should give some information about your current python installation. This same process can be repeated for pip. If you enter the command

C:\Users\Joe>pip

and it displays an error, also add the folder containing "pip.exe" to the path.

安装依赖包

需要额外程序包“requests”才能运行Pywikibot。使用pip,如果您已拥有Python 2.7.9或更高版本,或Python 3.4或更高版本,那么它已安装。运行以下命令以安装该程序包:

$ pip install requests

安装Pywikibot

下载当前版本Pywikibot stable branch:.tar.gz.zip

解压下载的文件,解压到~/pywikibotC:\Users\username\pywikibot

又或者,您可以使用git或svn客户端从Gerrit检索最新版本,可参见手册:Pywikibot/Gerrit 。推荐活跃机器人操作者及开发者使用这种方法操作Pywikibot。

其它版本可在https://tools.wmflabs.org/pywikibot/找到。

更新Pywikibot

保持您的机器人框架随时更新。新版本会连续发布,并在同一位置可用。

如果您在使用git或svn发行版本,您可以跳过此注释。否则请尤其注意,在安装新版本前,要备份您的配置文件盒脚本(“user-config.py”、任何家族文件或任何您可能创建或更改的自定义脚本,以及任何当前您为某一wiki使用的XML转储文件)。

解压新版本,令其覆盖所有旧版本的文件。

配置Pywikibot

在类Unix系统(Linux/BSD/Solaris)上打开“终端”,或在Windows上打开“命令提示符”(一般在“Windows”系统或“所有应用”中的“附件”文件夹,或是开始菜单中的“所有程序”菜单中),并更改您解压Pywikibot的目录。

类Unix(Linux/BSD/Solaris):
$ cd ~/pywikibot
Windows
$ c:
$ cd "\Users\username\pywikibot"

当然需要将路径替换为您解压Pywikibot的路径。

输入以下命令继续以生成用户配置文件:

$ python pwb.py generate_user_files

根据提示来配置Pywikibot。

最后运行以下命令以登录您的wiki:

$ python pwb.py login

在第三方wiki上使用

Pywikibot在很多维基网站上已预配置好了,但也许不是你想要工作的那一个。 查看Manual:Pywikibot/Use on third-party wikis 来知晓如何为你自己的维基网站配置Pywikibot。

更多配置选项

Pywikibot提供了许多选项来改变你的机器人行为。 你可以在user-config.py中修改这些选项。 参见config2.py以获取您可以使用的所有参数的列表。

Proxy configuration

Pywikibot relies on requests for communicating with the web. You can use HTTP_PROXY and HTTPS_PROXY environment variables to make requests use a proxy server. Refer to requests' documentation for more info.

运行脚本

Pywikibot在“scripts”目录下储存了大量的脚本。 您可以通过以下指令运行它们:

$ python pwb.py [name of the script]

所有可用脚本的列表可以在Manual:Pywikibot/Scripts 查看。

其他依赖性

多数脚本不需要额外的程序包,但也有一少部分没有程序包就无法工作。 在requirements.txt中列出了这些脚本及其依赖性。

要为一些脚本安装依赖性,使用“pip”并运行以下命令即可:

$ pip install [name of the package]

或者,运行下面的命令来为所有脚本一次安装所有依赖性:

$ pip install -r requirements.txt


If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel 连接 or pywikibot@ mailing list.