作者ilay (说唱猜做玩)
看板Python
标题[讨论] Django 官方文件翻译
时间Fri Aug 3 11:14:47 2012
关於这件事情相信版上不少人已经肖想了很久
今天在下斗胆来起个头,希望此事能有些进展,对社群发展应该也是一件贡献:)
======================================================================
基於先前的讨论串中,有讨论了一些可行的工具来进行这项计画
但不外乎就是得另外架个站。
刚好敝人最近有稍微研究一下 Django 官方的文件管理方式,有了以下心得,
所以产生新的想法:
1. 其实 Django 教学文件一直都跟 Django 本体打包放在一起,就在 doc 目录里。
又,因为官方用 github 来管理整个 project,所以在 github 上当然也能找到各版本
活生生的教学文件。
2. 官方采用 Sphinx 来处理文件的撰写与 HTML/PDF/ePub 版本生成,
这玩意儿本身就支援多国语系化,详见:
http://sphinx.pocoo.org/intl.html
3. 第一项说的 doc 目录其实就是一个 Sphinx Project 。
4. 官方的主要文件发布平台在这
http://readthedocs.org/projects/django/?fromdocs=django
这个站本身就依赖於 Sphinx 来作为文件生成,来源就是 django@github。
综合以上,在下的想法是:
1. 加入官方 django 专案,针对 Sphinx project 撰写 zh_TW 的翻译档,
这样就会 build 进官方在 readthedocs 的文件发布里?
2. 如果想法1太麻烦,那就自己 clone 一份 django project 来作?
--
※ 发信站: 批踢踢实业坊(ptt.cc)
◆ From: 163.29.98.120
1F:→ uranusjr:先 fork, 等差不多了再向官方发 merge request 好像较好 08/03 14:51
2F:→ ilay:好主意! 另外我转好po档放在transifex了 08/03 15:14
4F:→ ilay:这样要翻译比较方便 08/03 15:15
7F:→ ilay:这个是针对django的多国语系翻译 似乎没有包含doc? 08/03 15:39