手册: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 95% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎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以上的版本。

On Windows please don't forget to modify PATH environment variable to make Python and pip work properly.

安装依赖包

需要额外程序包“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.