前阵子忙着为The Art Of Programming By July编写生成html的工具,最后写出了个半成品,还有些功能欠缺,但是至少生成的结果不错了。各位有兴趣可以赏眼一看:
mdtogh
在完成了生成工具,并且有所效果了以后,这个小项目也算是告一段落。虽然还有不完善的地方,就只能过一阵子再去维护了。 相应地生成效果可以查看。
最近在了解python爬虫的时候,偶然得知了scrapy这个很成熟的python爬虫库。在阅读文档时发现其文档之全,着实惊讶。通过阅读文档,真的可以说是从“入门到精通”了。文档的语言写得也很简洁,英语基础较好的朋友阅读起来问题也不是很大。
不过再怎么说,阅读英文文档的速度实在是和中文文档没法比。在阅读了一阵,突然想到:
为什么不把这个文档翻译成中文呢?
于是上网搜索一番,还真的发现没有人来翻译。有些朋友仅仅翻译了入门的一两篇文章就没有下文了,着实可惜。于是,就下定决定,把这个坑开起来了。
项目主页
项目目前托管在github上。原本scrapy就是托管在github上的,并且和readthedocs做了很好地集成。因此,参考这个,我也把项目托管在github上了。
地址: scrapy_doc_chs
同时,我也让项目与readthedocs做了集成。在每次push到repo时,都会在readthedocs生成相应地结果。
文档阅读地址
您也可以在readthedocs阅读相应地文档。
地址: scrapy-chs
目前进度
文档主要由我进行翻译。通过之前的小小宣传,又有几位朋友加入到了翻译组内。同时,由于我的疏忽,没注意到还有三位朋友之前也在翻译o(╯□╰)o 。不过几位朋友都很nice,目前他们翻译的成果正在合并到我的repo中。
目前翻译的列表:
intro下边四篇文章index.rstfaq.rst topics/commands.rsttopics/items.rsttopics/spiders.rsttopics/selectors.rsttopics/shell.rsttopics/images.rsttopics/logging.rsttopics/feed-exporters.rsttopics/stats.rsttopics/email.rsttopics/telnetconsole.rsttopics/webservice.rst加入我们
一个人的力量永远是不够的。一是文档确实很全,导致的结果就是要翻译的内容很多,一时也翻译不完全。二是我的水平毕竟有限,难免会有翻译不好甚至是翻译错误的地方,所以需要您的支持。
您可以:
阅读翻译完的章节,对翻译结果进行审阅对翻译不准确的地方提交issue对翻译错误的地方地方issue加入翻译组fork项目认领某个章节,进行翻译给我们一点鼓励star这个项目最后但不是真的最后
欢迎大家能关注加入到这个项目来。
有力的出力,没时间的点个赞也行哈。您的鼓励就是我们翻译下去的动力。