Manual:Pywikibot/Installation/zh

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

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

如果您已经安装了Python，请检查您的Python版本是否符合Pywikibot的要求. 在命令提示符（windows）运行 即可获取版本号. 如果您的Python版本是2.7.2+或3.3+，那么就可以运行Pywikibot.

Install dependencies
An additional package named requests is required to run Pywikibot. Use pip, which is already installed if you have Python 2.7.9 or higher, or Python 3.4 or higher. Run the following command to install this package:

下载Pywikibot
下载Pywikibot master branch：.tar.gz、.zip.

解压此文件至合适的位置，例如 或.

又或者，如果您希望从gerrit检索最新版本，可参见$1.

或者使用这个链接.

更新
稳定版本每三个月发布一次，使用上面的链接即可下载.

安装之前，请备份你的配置文件和脚本（user-config.py、自定义脚本和一些Wiki的XML文件）

解压新版本，令其覆盖所有旧版本的文件.

调试Pywikibot
打开终端并“更改路径”（cd）至pywikibot的解压位置.


 * 类Unix（Linux/BSD/Solaris）：打开“Terminal”（一般位于菜单中“系统工具”下），运行：


 * Windows：启动命令提示符（运行“cmd”）并运行：

将目标位置替换为您解压pywikibot的路径.

Continue with the following command to generate user configuration file:

根据提示来配置Pywikibot.

在这之后在其他地方创建一个包含如下内容的文件： ，打开Pywikibot文件夹中的user-config.py并将先前文件的路径应用到 这一行.

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

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

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

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

其他要求
大多数脚本不需要额外的模块，但也有一些例外. requirements.txt中列出了这些脚本.

使用$pip来安装这些模块（pip应与较新版本的Python一同被安装在计算机中）. 运行下面的命令即可安装模块：

或使用下面的命令来安装所有推荐安装的模块：