哲思官方群认证群组  - 讨论区

标题:[zeuux-universe] [reST]图书写作环境推荐

2009年11月11日 星期三 17:41

Zoom.Quiet zoom.quiet在gmail.com
星期三 十一月 11 17:41:09 CST 2009

BiilXu 问及分布式团队的图书撰写经验,这个早就分享出来了:
openbookproject - 如何组织在线图书工程 经验组织.
    http://code.google.com/p/openbookproject/wiki/HowToBuildBookOnline
核心一点认识就是:
    - 图书也是工程
    - 作者应该关注内容而不是排版/编辑

所以,各种在写文档管理/写作平台,其实对于复杂的技术图书的撰写都不合适;
俺推荐 图书团队使用纯文本进行本地撰写,通过 code.google 等项目管理环境进行协同
为什么呢,因为:
文可文,非常文。本可文,非常本。文本,数据之始,字符,万思之母...
    http://wiki.woodpecker.org.cn/moin/AllAboutText

包括Office 文档在内,当前日常接触的多是 标签文本(XML/HTML 通过和内容完全无关的标签字串来解析内容的输出)
"所见即所得"的编辑方式其实效率最低,俺推崇"所想即所得":
http://wiki.woodpecker.org.cn/moin/WyTiWyG

这其中,基于 reST 的Sphinx 工具套件非常好用!!
Python v2.6.4 documentation 已经全面使用了:
    http://docs.python.org/index.html
Sphinx v0.6.3 documentation
    http://sphinx.pocoo.org/index.html

这是一个向 reST 追加了一些内置宏操作后,形成的一整套方便的图书生产工具 ;-)

一些体验::
SphinxprojectHowto - pymotwcn - Project Hosting on Google Code
    http://code.google.com/p/pymotwcn/wiki/SphinxprojectHowto
关于本书的编写 — 用Python做科学计算 v1 documentation
    http://hyry.dip.jp/pydoc/pydoc_write_tools.html

资料::
reStructuredText
    http://docutils.sourceforge.net/rst.html
PyCon Trac Presentation - matt-good.net
    http://matt-good.net/2007/02/28/pycon-trac-presentation/
    有 reST到S5 网页幻灯的转换工具!


-- 
http://zoomquiet.org 人生苦短? Pythonic!
usage 7-zip to replace WinRAR/WinZip; You can get the truely Freedom 4 software.

[导入自Mailman归档:http://www.zeuux.org/pipermail/zeuux-universe]

2009年11月11日 星期三 18:00

Zhang Weiwu zhangweiwu在realss.com
星期三 十一月 11 18:00:17 CST 2009

Zoom.Quiet wrote:
> "所见即所得"的编辑方式其实效率最低,俺推崇"所想即所得":
>
>   
这句评价指的是系统而有影响的思想,如《瓦尔登湖》,还是指容易沟通从而在大量
信息中有竞争力的有效期短的信息,如《09年合作Linux实施,可行性快速一览》,
还是指易于通过视觉传递和引起共鸣的信息,如《回顾九十年代》?

我因为同时处理上述三种,知其对工具的需求不同,对“效率”的定义也不同。一适
于所想即所得,二适于所见即所得,三适于出版行业的专业软件。

[导入自Mailman归档:http://www.zeuux.org/pipermail/zeuux-universe]

如下红色区域有误,请重新填写。

    你的回复:

    请 登录 后回复。还没有在Zeuux哲思注册吗?现在 注册 !

    Zeuux © 2024

    京ICP备05028076号