最关心的文档格式是什么？ [英] What would be the best documentation format taking into concern

问题描述

...担心它必须是：

- 可修改 - 小项目，但一些数字数据将从版本更改为版本，文档必须是版本可靠的，并且某种修订控制是比较好的（diff）

- 必须是可打印的 - 因为最终会打印出一些其他文档（否则我会选择某种wiki）

- 必须能够轻松地包含图形，图片（通常由程序扫描和生成的各种图像）

... taking into concern that it must be:
- revisable - small project but some numerical data will be changing from version to version, and documentation must be version dependable, and some kind of revision control is preferable (diff)
- must be printable - since, well, in the end it will be printed along with some other documents (otherwise I would just take opt for some sort of wiki)
- must be able to easily include graphs, pictures (images of all sorts in general, scanned and produced by programs)

选项：

.doc / .pdf - 不同于diff

维基 - 在正常事务中打印的问题

大html文件 - 一个选项，仍然考虑它

latex - 一个选项，但是在定位大量图像时，需要编辑
，并且不可能在不同的地方进行编辑，而不是预期的。

Options:
.doc / .pdf - different to diff
wiki - problem with printing in a "normal" matter
big html file - an option, still considering it
latex - an option, but a pain to edit when it comes to positioning lots of images, and impossible to edit when it comes to something different and not expected in view of layout

到目前为止，我最好的想法是使用.doc - > .pdf文件，只是处理与他们分歧的痛苦。更好的选择？

So far my best idea is to go with .doc -> .pdf files, and just handle the pain with diffing them. Better alternatives ?

推荐答案

DocBook的的？您可以使用DocBook编写747手册：它是技术写作的最终SGML（或XML;有两个版本）方言。

What about DocBook? You could write the manual for a 747 with DocBook: it's the ultimate SGML (or XML; there are two versions) dialect for technical writing.

这篇关于最关心的文档格式是什么？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！