文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
除了openoffice套件以外还有没有其他更方便的工具呢？


-- 
许鹏飞(Xu Pengfei)
My Web:http://xupf.blogspot.com/
NByteam,Beijing,China
-------------- 下一部分 --------------
一个HTML附件被移除...
URL: <http://www.zeuux.org/pipermail/zeuux-universe/attachments/20100819/5f951464/attachment.html>

2010/8/19 Xu Pengfei <kyohouhi在gmail.com>:
> 文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
> 除了openoffice套件以外还有没有其他更方便的工具呢？
>

rST 来写，Sphinx 组织，自动化生成各种格式...

>
> --
> 许鹏飞(Xu Pengfei)
> My Web:http://xupf.blogspot.com/
> NByteam,Beijing,China
>
> _______________________________________________
> zeuux-universe mailing list
> zeuux-universe在zeuux.org
> http://www.zeuux.org/mailman/listinfo/zeuux-universe
>
> ZEUUX Project - Free Software, Free Society!
> http://www.zeuux.org
>



-- 
http://zoomquiet.org 人生苦短? Pythonic!

在 2010年8月19日 上午9:35，Xu Pengfei <kyohouhi在gmail.com> 写道：
> 文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
> 除了openoffice套件以外还有没有其他更方便的工具呢？

DocBook.

-- 
Best regards,
Atommann

2010/8/19 Atommann <atommann在gmail.com>:
> 在 2010年8月19日 上午9:35，Xu Pengfei <kyohouhi在gmail.com> 写道：
>> 文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
>> 除了openoffice套件以外还有没有其他更方便的工具呢？
>
> DocBook.
这是基于XML 的很不友好,
rST 是结构化文本,书写时很直爽,,,,

>
> --
> Best regards,
> Atommann
> _______________________________________________
> zeuux-universe mailing list
> zeuux-universe在zeuux.org
> http://www.zeuux.org/mailman/listinfo/zeuux-universe
>
> ZEUUX Project - Free Software, Free Society!
> http://www.zeuux.org



-- 
http://zoomquiet.org 人生苦短? Pythonic!

在 2010年8月19日 上午9:35，Xu Pengfei <kyohouhi在gmail.com>写道：

> 文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
> 除了openoffice套件以外还有没有其他更方便的工具呢？
>

OOo可以拿来写通知，不能拿来写与代码相关的文档，嘿嘿。

API的文档，可以去找相关的自动化工具。

需要全手写的话，Sphinx咯。

如果你是写数学论文那种， LaTeX =_=


-- 
进出自由才是游戏者的生存之道。

http://zys-free.com
@zouyesheng
-------------- 下一部分 --------------
一个HTML附件被移除...
URL: <http://www.zeuux.org/pipermail/zeuux-universe/attachments/20100819/cdf11c4a/attachment.html>

我是需要写一些项目文档，例如代码解析的，需求的，系统设计、详细设计、测试文档
这些的文档可能会需要有一个特定的模板，然后可以方便的插入表格、流程图、时序图、
模块图之类的东西
不知道Sphinx能否满足要求

在 2010年8月19日 上午9:47，Yesheng Zou <yeshengzou在gmail.com>写道：

>
> 在 2010年8月19日 上午9:35，Xu Pengfei <kyohouhi在gmail.com>写道：
>
>> 文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
>> 除了openoffice套件以外还有没有其他更方便的工具呢？
>>
>
> OOo可以拿来写通知，不能拿来写与代码相关的文档，嘿嘿。
>
> API的文档，可以去找相关的自动化工具。
>
> 需要全手写的话，Sphinx咯。
>
> 如果你是写数学论文那种， LaTeX =_=
>
>
> --
> 进出自由才是游戏者的生存之道。
>
> http://zys-free.com
> @zouyesheng
>
>


-- 
许鹏飞(Xu Pengfei)
My Web:http://xupf.blogspot.com/
NByteam,Beijing,China
-------------- 下一部分 --------------
一个HTML附件被移除...
URL: <http://www.zeuux.org/pipermail/zeuux-universe/attachments/20100819/6700e7bd/attachment.html>

程序文档，一般用自动生成的，具体要看什么语言。
java就用javadoc
python就用python自带的
c/c++就用doxygen
lua有 luadoc

uml 设计，有专门的工具生成相关文档。

写论文，毫无疑问是 LaTeX。（但是个人觉得它也只适合写论文）

对于一般的文档，重要的是可以插入图片对象，OOO其实是可以对付的。主要是有OOdraw。


2010/8/19 Xu Pengfei <kyohouhi在gmail.com>:
> 文档是很重要的，不知道大家在linux下使用什么工具写文档呢？
> 除了openoffice套件以外还有没有其他更方便的工具呢？
>
>
> --
> 许鹏飞(Xu Pengfei)
> My Web:http://xupf.blogspot.com/
> NByteam,Beijing,China
>
> _______________________________________________
> zeuux-universe mailing list
> zeuux-universe在zeuux.org
> http://www.zeuux.org/mailman/listinfo/zeuux-universe
>
> ZEUUX Project - Free Software, Free Society!
> http://www.zeuux.org
>

在 2010年8月19日 上午10:12，Xu Pengfei <kyohouhi在gmail.com>写道：

> 我是需要写一些项目文档，例如代码解析的，需求的，系统设计、详细设计、测试文档
> 这些的文档可能会需要有一个特定的模板，然后可以方便的插入表格、流程图、时序图、
> 模块图之类的东西
> 不知道Sphinx能否满足要求
>

没问题的。另外说一点，如果你的一些文档（比如需求，系统设计）等，是要拿给客户看的，或者去推荐产品的，那么这些文档建议使用 LaTeX 或 OOo
单独地做，做得精致一点。

Sphinx主要是以HTML为主，生成CHM问题不大。但是生成PDF是通过LaTeX转的，它只生成LaTeX代码。对于中文，在LaTeX中要做比较多的额外处理，在方面你可以看看写《用Python做科学计算》的hyry的相关分享：
http://hyry.dip.jp/pydoc/index.html ，他在这方面做了比较多的工作。

各种设计图都可以通过其它工具画好，直接插入到Sphinx的源文件中。表格可以直接画的。反正HTML支持的东西都没有问题。

模板不用担心，只是一堆CSS而已。不过要弄PDF，修改页面样式，可能需要改一些LaTeX的代码了。

-- 
进出自由才是游戏者的生存之道。

http://zys-free.com
@zouyesheng
-------------- 下一部分 --------------
一个HTML附件被移除...
URL: <http://www.zeuux.org/pipermail/zeuux-universe/attachments/20100819/3ac02aca/attachment-0001.html>