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 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或更高版本，那么它已安装. 运行以下命令以安装该程序包：

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

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

又或者，您可以使用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”并运行以下命令即可：

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