📚 一起写Python文章,一起看Python文章 - 利用readthedocs的Python技术文章的收集和翻译。
Makefile
Latest commit e01a830 Mar 27, 2017 @MrKiven committed on GitHub Create LICENSE
Permalink
Failed to load latest commit information.
docs Update the-python-yield-keyword-explained.rst Oct 18, 2016
.gitignore the place of requirements Apr 15, 2013
.gitmodules use new theme `rux` Dec 3, 2013
LICENSE Create LICENSE Mar 27, 2017
Makefile Fix build error Jun 7, 2016
Readme.rst Fix build error Jun 7, 2016
requirements.pip Remove feed Jun 7, 2016
todo.txt update todo Sep 2, 2013

Readme.rst

关于

利用readthedocs的Python技术文章的翻译和收集。

订阅

RSS: https://pyzh.readthedocs.org/en/latest/rss.xml

Online: https://pyzh.readthedocs.org/en/latest/

约定

  • 文件名必须是英文。一个文章的多个文件如下命名:

    xxxx-Part1.rst, xxxx-Part2.rst ..
    
  • 文第一行注明日期:

    :Date: 2013-04-15 22:00:00
    
  • 翻译的文章,需要注明原文链接

请Fork一起编写!

  1. 初始化环境:

    git clone https://github.com/hit9/PyZh
    cd PyZh
    git submodule init & git submodule update
    virtualenv venv
    source <env-path>/bin/activate
    pip install -r requirements.pip
    
  2. 编写文章:

    vim docs/xxxxx.rst
    
  3. 编译预览:

    make doc
    cd _build/html
    python -m SimpleHTTPServer
    

    打开 http://localhost:8000 预览

  4. 更新Readthedocs文档:

    push上去到Github, 然后到https://readthedocs.org/projects/pyzh build下即可

RST

RST文档的语法: https://github.com/ralsina/rst-cheatsheet/blob/master/rst-cheatsheet.rst

Example可以看项目中其它文章的源码