sklearn库作为目前机器学习非常流行的python库,一个易读的文档更有助于工具库的理解和使用,虽然做机器学习方面的学生和工程师阅读英文并没有很大压力,但是在阅读速度上还是会有些影响。 寻找已久没找到相关的中文文档,而且翻译的过程也是对知识熟悉的过程,您可以在学习某一个章节的过程顺便翻译一下就可以贡献自己的力量。
欢迎大家踊跃加入!如果有更好的翻译组织形式也欢迎提出!
*中文文档地址:sklearn.lzjqsdd.com
图标 | 状态 |
---|---|
翻译中 | |
翻译结束 | |
暂未开始 |
相关算法示例程序的翻译,位于modules下,具体列表如下:
首先fork该项目到个人github,clone到本地,修改README中要申领的翻译内容的状态,提交pull request,接受之后即可开始翻译工作。 翻译结束后确保可正常编译成html,然后只提交rst文件的修改,不要添加sphinx生成的文件。 所有翻译后的文档以同名的方式添加到translate/同目录文件夹下,例如:
svm.rst的翻译文档 提交到项目translate/modules/svm.rst下,翻译完成之后覆盖doc/modules/svm.rst。
官方框架翻译
本项目采用travis-ci持续集成来实现自动编译部署,翻译的文档提交pull request到master,合并后会自动把html部署到gh-pages分支上,网站托管在sklearn.lzjqsdd.com
安装必要的环境:
sudo pip install numpy
sudo pip install scipy
sudo pip install sphinx
#上述为依赖的包
sudo pip install -U scikit-learn
生成html(和官网web页一样)
make html
生成文件会在在_build/html目录下:
如果要生成PDF手册的话:
make latexpdf
部署gh-pages:
由于Sphinx生成的html有自己的静态资源,需要在gh-pages分支加入.nojekyll文件。
配置中其他的问题: Issue