Manual:Pywikibot/Installation/zh

  这个页面将帮助你开始使用Pywikibot. 您可以在您的个人计算机、Toolforge或PAWS: A Web Shell上使用Pywikibot.

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

 在您的个人计算机上使用 以下说明书将帮助您在您的个人计算机上安装并运行Pywikibot. 以下是四个主要步骤：  在Toolforge上 Toolforge拥有稳定的维基百科云托管基础设施，你将可以在这里持续或定期地运行机器人.
 * 安装Python
 * 安装Pywikibot
 * 配置Pywikibot
 * 运行脚本

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

如果您已经安装了Python，请检查您的Python版本是否符合Pywikibot的要求. 在命令提示符（windows）运行 即可获取版本号. 如果您已安装Python $py2或更高版本，或Python $py3或更高版本，那么您的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或更高版本，那么它已安装. 运行以下命令以安装该程序包：

For Python 2.7 additional packages are mandatory:

安装Pywikibot
下载当前版本Pywikibot stable：.tar.gz、.zip.

Python 2.7 users should download the stable python2 branch: .tar.gz, .zip instead.

解压下载的文件，解压到 或.

又或者，您可以使用git或svn客户端从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）：




 * Windows：



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

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

根据提示来配置Pywikibot.

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

在第三方wiki上使用
Pywikibot在很多维基网站上已预配置好了，但也许不是你想要工作的那一个. 查看来知晓如何为你自己的维基网站配置Pywikibot.

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

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

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

所有可用脚本的列表可以在查看.

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

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

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