文档目前托管在readthedocs。请查看
http://scrapy-chs.readthedocs.org/zh_CN/latest/
本文档由marchtea初始进行翻译。网上也有相应的翻译, 但是大多仅仅翻译了其中的入门教程,并没有完整翻译。
于是这个坑就打开了。
目前已经翻译的有:
- intro下边四篇文章
- index.rst
- topics/commands.rst
- topics/items.rst
Scrapy的文档写得很详细,与之带来的就是文档量很大。 仅仅靠我需要很多的时间。希望您能加入这个计划,让翻译更快速。
除此之外,您也可以通过阅读相应的文章,提出翻译错误或者不满意的地方。
- 欢迎open issue
- 欢迎加入翻译组
在开始翻译前,请先open issue,说明自己要翻译的章节,大致完成的时间。 之后fork我的repo。
翻译完成前请先在自己的环境中运行
make html
大致浏览一下结果。然后提交pull request。
本文档提供了编译Scrapy文档的快速入门
以下Python库在编译文档时将会被使用:
- Sphinx
- docutils
- jinja
如果您已经安装好setuptools,执行下列命令将会安装全部所需的库 (Sphinx同时依赖了docutils和jinja):
easy_install Sphinx
在当前路径下运行下面的命令将编译文档(输出为HTML):
make html
(HTML格式的)文档将被生成在``build/html``路径下.
您可以执行下列命令来查看文档:
make htmlview
该命令将会启动您默认的浏览器,并且打开您之前生成的HTML文档的首页
执行下列命令来清除生成的文档:
make clean
注意,该命令不会对文档的源文件有任何影响