|
|
|
|
  开始编写DocBook教程 - limodou [ 2004-03-10 16:18 | 73 byte(s)]
Re: 开始编写DocBook教程 - snetkiller [ 2004-11-23 10:44 | 61 byte(s)]
Re: 开始编写DocBook教程 - searun [ 2004-10-28 14:06 | 434 byte(s)]
Re: 开始编写DocBook教程 - ipzh [ 2004-03-12 17:33 | 173 byte(s)]
Re: 开始编写DocBook教程 - zoomquiet [ 2004-03-12 14:30 | 1,355 byte(s)]
Re: 开始编写DocBook教程 - x11perf [ 2004-10-15 23:05 | 144 byte(s)]
Re: 开始编写DocBook教程 - 2.5代码片段中有问题。 - xuejm [ 2004-10-16 22:43 | 525 byte(s)]
Re: 开始编写DocBook教程 - 2.5代码片段中有问题。 - limodou [ 2004-10-17 09:35 | 42 byte(s)]
Re: 开始编写DocBook教程 - limodou [ 2004-03-12 17:03 | 995 byte(s)]
Re: 开始编写DocBook教程 - zoomquiet [ 2004-03-12 17:14 | 669 byte(s)]
Re: 开始编写DocBook教程 - nonametomz1 [ 2004-03-12 20:37 | 364 byte(s)]
Re: 开始编写DocBook教程 - limodou [ 2004-03-13 14:47 | 1,429 byte(s)]
Re: 开始编写DocBook教程 - nonametomz1 [ 2004-03-13 22:16 | 259 byte(s)]
Re: 开始编写DocBook教程 - limodou [ 2004-03-13 23:39 | 144 byte(s)]
restructuredtext到docbook - panjunyong [ 2004-03-15 12:56 | 1,059 byte(s)]
Re: restructuredtext到docbook - najia01 [ 2004-11-04 22:13 | 916 byte(s)]
Re: restructuredtext到docbook - dd001 [ 2005-07-28 17:28 | 23 byte(s)]
Re: restructuredtext到docbook - limodou [ 2004-11-05 09:33 | 936 byte(s)]
Re: restructuredtext到docbook - panjunyong [ 2004-11-04 22:17 | 127 byte(s)]
Re: restructuredtext到docbook - najia01 [ 2004-11-04 22:20 | 83 byte(s)]
Re: restructuredtext到docbook - limodou [ 2004-03-15 14:22 | 210 byte(s)]
Re: restructuredtext到docbook - panjunyong [ 2004-03-15 19:35 | 344 byte(s)]
Re: restructuredtext到docbook - limodou [ 2004-03-15 21:17 | 6 byte(s)]
Re: restructuredtext到docbook - zoomquiet [ 2004-03-16 10:01 | 2,446 byte(s)]
Re: restructuredtext到docbook - limodou [ 2004-03-16 10:50 | 831 byte(s)]
Re: restructuredtext到docbook - zoomquiet [ 2004-03-16 11:14 | 1,100 byte(s)]
Re: restructuredtext到docbook - limodou [ 2004-03-16 15:29 | 737 byte(s)]
Re: restructuredtext到docbook - zoomquiet [ 2004-03-16 17:21 | 1,715 byte(s)]
Re: restructuredtext到docbook - Eric.Hu [ 2004-10-20 15:09 | 50 byte(s)]
通用的TW模式 - zoomquiet [ 2004-10-20 15:38 | 577 byte(s)]
Re: 通用的TW模式 - Eric.Hu [ 2004-10-21 10:22 | 352 byte(s)]
|
|
|
|
[Original]
[Print]
[Top]
|
|
有兴趣的与我交流，主页在：http://pyrecord.freezope.org/docbook/index.html
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
嗯嗯!
一直在想办法升级公司的产品文档使用 Word 来编写的问题!
可是DocBook 使用过时的DTD来限定,
总算通过 http://www.docbook.org/wiki/moin.cgi/DocBookTools?action=highlight&value=ConvertOtherFormatsToDocBook
找到了比较适当的Aptconvert
http://www.xmlmind.com/aptconvert.html
却发现从MoinMoin,ZWiki还有Doxygen 的文本中不能简单的转换到
APT format (Almost Plain Text)
还是结构化文本比例可亲,
终于!发现了 txt2tags!
http://www.dohao.org/blog/000022.html#more
Python 完成的,支持各种使用方式!
只要以txt2tags 为中心,可以快速的形成
MoinMoin 起草,
HTML组合文档,
PDF发行的技术文档写作流程!
是也乎是也乎!
兄台以为?
简单的就是强大的!
不用学习DocBook的DTD,LeTeX 的宏,
只要学习一下子txt2tags的格式,就可以完成所有任务!
|
|
|
----
Time is unimportant, only life important!
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
我看了看，的确可以。不过它只是为了满足一般排版的需要。而DocBook已经是一种标准了，支持它的软件很多，而且是SGML/XML格式的，更可以进行更进一步地处理。写起来可能有点麻烦，但txt2tags不是也有许多的写法要学吗？如果你只想用docbook的简单排版功能，那么只要从一个样例中copy和paste，然后再modify就可以了，也不会太复杂。
其实这些东西：docbook, latex, structuredtext, restructuredtext, txt2tag之类的格式都大同小异，都可以由一种源生成多种源或目标，所不同的就是支持的内容与你所关注的焦点了。除了今天了解的txt2tags，其它几种我都学过或了解过，相比之下后三种应该算是最简单地了。而latex有些太复杂了 （不过功能的确强大，而且排版效果很好）。因此我现在比较关注docbook，因为它是sgml/xml的，而且更专注于文章的结构。同时对语法要求又很严格。用它作为一种源非常合适。而且因为sgml/xml格式的缘故，它的语言涵义更是一目了然，更清晰。其它的格式则不是那么清晰了。
不过等学会了docbook之后，我也想用一些工具自动生成docbook文档，如：docutilt项目(restructured的python处理包)。那可能是不久的事吧。
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
是也乎是也乎…………
按照王垠的介绍
TeX 是 "WYTIWYG(所想即所得)"
DocBook 也是类似的实现,不过是将命令使用XML 规范化了,
但是,形成的文档却是难以阅读的,间杂了太多的标记,实在是打断阅读哪!
可以认为 DocBook 是LaTeX对于文章排版的特殊关注的XML格式实现,
所以,以更加"轻"的格式标记约定来书写文档,同时最大可能的让程序可以有足够的有效信息来识别文章的结构,语义, 应该说是绝大多数技术文档编写人员更加愿意接受的工作环境?!
嗯嗯！不论DocBook 还是LaTeX,都有着不可替代的优点，
但是对于98% 的文档编写需求，各种结构化文本的功能已经足够了哪！
|
|
----
Time is unimportant, only life important!
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
关注中。
以前也学过一段时间的DocBook，觉得很有意思，可惜日常工作中少有使用的机会（工作中交换文件的格式是DOC）。
个人认为DocBook在技术方面是一种不错的选择。
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
嗯。我比较倾向于用结构化文本。
我说的结构化文本是wiki的结构化文本，不是zope的结构化文本。
目前比较苦恼的是结构化文本的种类太多了。我真希望大家都以usemodewiki为格式标准。
新的结构化文本比原来的好些，但搞出“章、节”来，好像结构化文本和latex的混合，四不象。
目前只能用txt2tags了。
|
|
----
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
的确对于一般的文档工作，使用结构化文本也就够了。但Docbook因为使用了SGML/XML，从而使用信息的自动化处理更加强大。现在使用Docbook写文档的项目有：
• Linux Documentation Project
• FreeBSD Documentation Project
• GNOME Documentation Project
• KDE Documentation Project
• Caldera Systems
• Mandrakesoft
• Red Hat
• SuSE
(这是从别人那里抄来的)。用得范围还是很广的。
使用结构化文本，转换成Docbook格式是我的下一个目标。
不过我还想的一个问题是，到底我们保留什么样的数据源呢？是转换后的东西，还是转换前的东西呢？我想应该是转换前的东西吧。因此，也许我会只写docbook的文档。diveintopython网站上，如果你们有兴趣的话，连主页都是用docbook生成的。不过他作了一些客户化的工作。转换器也是不使用saxon。我也是看了他的东西，才想把docbook学习完整的。以前也只是一个了解，现在是下定决心要学完它了。在中国好象研究docbook的的确不多，象tomz说过的worldhello.net，其实我以前就访问过。而且我还用openjade转换过，但因为别的事情就放下了。现在再看看，蒋鑫的工作没有作完。因此我想给大家写一个即简单又实用的docbook教程，不会面面俱到，但足够平时使用了。有兴趣的话大家可以继续研究。
其实关于docbook的内容也是不少，在学习它的过程中，我还学习了xml, xsl的一些基础知识，这些东西因为平时不用所以也不会。借这个机会学了一把，真要感谢docbook带给我这个机会呢。
|
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
docbook的好处是标准化的，并且功能较多，几乎具有了latex的大部分功能。
但对我来说结构化文本足够。当需要更正式的文本的时候再用docbook。
另外，我希望做一个自己的知识管理系统。具有更完整的知识整理和检索功能。一个智能化的系统。
|
|
----
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
|
呵呵。我是想先学习复杂的docbook，再学会其它格式化文本，然后转成docbook。反正也是要学的，况且国内可学习的东西几乎没有，全是老外的。我先开个头了。
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
|
谢谢潘兄提供的信息。我已经下载，但还没有使用。最近还在学习与写教程。现在比较头痛xsl-fo转换成pdf。如果成功的话，我会试用docunilt的docbook writer的。我是想先把docbook学会了，再学学将restructedtext转换成docbook。
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
python上进行pdf转换的包是reportlab.
我们现在使用restructuredtext完成了中文plonebook，也希望能够使用一个包把他转换为pdf。
暂时还没有仔细去研究对中文的支持的问题，我从前试验backtalk，发现是有问题的。
在www.zope.org.tw 或者 zope.slat.org上应该有reportlab中文支持的文章（可能是后者），建议你先去看看。
|
|
----
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
唉呀呀！
每次看DD们的回复，总会引发出无数的问题，无数的技术链接！
下载一大堆的文档，软件包…………
PythonprojectsDocutils 下面收集了一堆解决方案，
不过从简单化原则考虑，
还是 LaTeX 比较终极一些？
虽然 DocBook 比 TeX 文本比较容易读，
可是从出版，分发的角度考虑还是 TeX标准哪！
印刷厂可是只能接收 TeX 的，
而且排版方面， LaTeX 可是更加专业的！
至于原始文本， 是新的结构化文本还是 ZWiki 的restructuredtext又或是usemodewiki格式？
得看各人的习惯，想来应该说都可以互相转换的吧？？
如下的图景:
*********************
* reStructuredText *
* StructuredText *
*********************
** * **
** * **
** * **
** * **
* *
***************** * *****************
* usemodewiki * ** * *
* ******** * ********* * 新结构化文本 *
* MoinMoinWiki * ** * *
***************** * *****************
* * *
** * *
* * **
* * *
** ********* *
*** ***
* *
* DocBook *
* LaTeX *
* SGML *
* ... *
* 出版 *
*** ***
*********
|
|
|
----
Time is unimportant, only life important!
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
我在阅读Docbook:The Definitive Guide一书时，上面介绍为什么要学DocBook。其实以前出书，作者只是写稿，并不关心排版是个什么样子。可是自从出现了WYSYG以后，好象排版就变成作者的事情了，可是作者不一定是专业的排版人员。现在网络发达，出现了个人主页，个人发表已经比比皆是，排版也已经成了个人要掌握的技能了。那么Docbook其实就是想重新回到以前的样子，只注重内容，不用过分的关心排版。当然，这样的结果是，大家排出的东西基本上是一样的，可能没有什么新意。不过，通过一些参数设置，还是可以改变许多。如果自已重新编写xsl对docbook进行处理，那更是可以展现新的风格。学习docbook并不是说其它的东西不好，各有所长。我希望掌握国际上相对流行的东西。就象我说过，latex我也学过，有兴趣可以看我的主页。但xml风格的docbook我认为更有前途。
当前如何想完全个性化，对于排版来说可能tex更出色。但我关注的是内容，何况docbook排出的东西也可以接受。
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
So So!
同意！
XML 技术的可靠，以及前瞻性，几乎所有的开发商都在XML化！
嗬嗬嗬，但是XML 文本的冗余字串实在太多了！
David Mertz(gnosis.xml.objectify)
等等高手，就自行进行了XML 紧缩格式的应用开发，来加速XML的解析和应用；
而且，XML的展示技术 XSL-XSLT 一直没有真正W3C标准的引擎，使用比较广的还是IE 的M$解析器！！！！
LaTeX 完全就是SGML 的一个变形，其形式到思想与XML是不谋而和的是也乎！
而且因为使用时间长，拥有了完整的高级排版支持，
嗯嗯！短期内还是主流？
"好象排版就变成作者的事情了"
哈哈哈！正好相反吧！
因为排版的技术门槛降低，作者能够控制最终印刷品的一切！
这才使文档编写人员高兴的开始了排版技术的学习和使用，
而且，随着出版——概念的扩大！第三媒体的超速发展，
在线出版，已经成为每个人可以的出版方式，那未，统一HTML.PDF,CHM,Wiki,Doc，PPT...所有数字文档的出版，也就自然的成为文档创建时的关注！
幸好！我们发现了“结构化文本”！！
哈哈哈！！！
|
|
|
----
Time is unimportant, only life important!
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
|
排版的入门低到不见得，就拿大家常用的word来说，会用word的人不少，但能用word排好版的人有几个，word的全部功能又掌握了多少。如果你过多的关注排版，那么可能没有过多的精力去关心内容了。就象我现在写docbook教程，为了转换成html和pdf已经好几天没写一点东西了，每一都在试验各种各样的效果。原因就是我想排得好一些。这就是因为写作与排版都是作者的事的缘故。有时我发现老外的主页往往都很简陋，为什么，因为他们不太关注版面。就象zope,python主页并不好看，他们认为就是实用就可以了。而国内的网站内容不见得有多少，但页面都比较好看。也许这就是因为我们太注重排版，而忽略了内容的缘故吧。象latex这种专门可以排出漂亮版面的语言，国内又有多少人会呢？其实排版并不容易呀。所以我花了许多精力还在研究如何转换docbook。在这上面所花的时间已经远远超过了我学习和写教程的时间了。
|
|
----
Python在向你招手(http://writedown.126.com)
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
嘿嘿嘿！
严重同意！
当初想使用 Doxygen 实现公司产品的技术文档的，代码说明，API文档的自动生成！
形成代码，文档同一的维护方式，
结果，为了Doxygen 支持中文，与作者都讨论了半天，
调整CSS，准备图片等等，用了半个多月！才找到最方便的标签解析方式！
不过，后果是更加懒了！
一切帮助文档，不再编辑HTML，一个命令，就可以生成一大堆相同格式的标准HTML，再一个操作，就可以得到CHM 的伪软帮助文档！
哈哈哈！随意的发布文档！
这是是文档的快乐了！
喂喂！不是老外不太关注版面!
人家的基督教，提倡禁止偶像崇拜，而且经过巴洛克的艺术轰炸，
都有很好的艺术理解力，
别人的网站是简明但绝对不粗陋！
比如说:
http://www.mindview.net/
写了N本Think in ..书的 Bruce Eckel's 网站，颜色调配的非常好！
好象就是定制了 TalkBack ，然后自动转换为 HTML,LaTex,PDF 出版的！
咱们中国人呢？用的是象形文字，对于图形，空间，组合则更加敏感一些…………
所以！唉呀呀，自个儿找事儿呗！
弄的客户也时髦一样的比漂亮！好象文档美丽的公司，作的活也一样美丽！
其实！！！！！皮包公司的文档是全球最漂亮的！！
人说好的程序员都有一个共性：懒惰！
为了省一点儿，代码优化，执行，编译…………的时间，不惜创造一个软件工具来自动的为自个儿干活！
我们也是为了省一点儿使用Word 反复修正字体，格式，边条，样式…………的时间，拼命要学习DocBook,LaTeX,StructureTxt......
嗯嗯！我骄傲ing...!!!
|
|
|
----
Time is unimportant, only life important!
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
<programlisting><![CDATA[
#include <stdio.h>
int main()
{
printf("hello, world.
");
}
</programlisting>]]>
这段代码好像不合XML语句，应该改为：
<programlisting><![CDATA[
#include <stdio.h>
int main()
{
printf("hello, world.
");
}
]]></programlisting>
|
|
----
明月如霜，青箫独吟，小桥清溪枯柳。
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
嗯嗯?!?
好象没有什么真正通用的,
Doxygen,txt2tags,ePydoc.....
只要你有心,就会发现很多很好用的文档工具!
而且都各有特色,各有专精,不能简单化对待的,
不过,都有很好的文档,和示范,都是可以简单学会的,放心去品尝吧!
实在没有什么可以拿出手的方案,只能说:
Doxyhen 适用于API的文档生成,要求仅仅是语言支持块注释;
ePydoc 是针对 Python 的文档化开发,非常好用!
t2t和 reST 等等标签语言,则是与 Docbook 一样适用于文章的创立,维护...
|
|
----
[Time is unimportant, only life important!]
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
我正在为公司的技术文档管理发愁，我也知道有这样一些工具，只是没有时间逐一学习测试，所以很想听听像你这样的真正用户的应用体会和经验。还请不吝赐教。:-)
还有，让所有的需要写文档的人都学习这些工具，也是头痛的事情，大部分人还是习惯word的"所见即所得"，不习惯"所思即所得"，总是说，这个我用word也可以作啊，为什么还要学习新的工具呢？
|
|
----
Hello,world!
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
GOOD.
请问个问题：
我按照你的顺序执行，可是执行build.bat的时候却出现了
Exception in thread "main" java.lang.NoClassDefFoundError: com/icl/saxon/StyleSheet
的信息，请问是怎么回事啊？
btw: 在2.15.2中需要修改一下下面这句， 其中的 & 字符是不允许的吧。
<publishername>O'Reilly & Associates, Inc.</publishername>
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
各位大侠，小弟想请教如下问题：
我们公司，现在的文档都是用word文档写的，但是这样不好，因为doc文档实在是没办法纳入版本
控制范围。于是，我想到了xml，把所有的文档都xml化，但是这样的话，成本很高，不可能要求所有
的开发人员都能够写xml文档。后来我想到了wiki，因为wiki降低了文档写作的门槛，不用象html那样去
学习html那么复杂的标签语言。对开发人员来讲，最重要的是文档的内容，越容易编写越好，这样也容易
在开发人员中推广wiki，同时在由于wiki有版本控制的功能，所以也解决了文档版本控制的问题。
但是，我不知道哪种wiki写成的文档，可以很方便的转换成xml文档，pdf文档?或者说， 能不能将
wiki转化成xml文档和pdf文档？如果能够转换，那么，如何去转换呢？我知道wiki具有版本控制功能，但
是这仅是从wiki的简介看到的，自己并没亲身去实践。所以想问这个问题。
今晚，看到大家对Docbook讨论那么多，所以想向大家请教，还望不吝赐教！
谢谢！^_^
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
使用reStructuredText，reStructuredText内部保存的格式实际上就是xml。
你可以到www.czug.org上搜索一下相关的信息
|
|
----
|
|
[Original]
[Print]
[Top]
|
|
[Original]
[Print]
[Top]
|
使用文本化的格式来写文档有多种格式，象docbook是xml格式，reStruectured Text是reST格式，wiki有自已的格式，还有著名的tex格式。最简单的是wiki格式，但它是适用于生成html的。至于你想转为其它的格式，如html，这几种都可以，wiki的格式相对少些，学些起可能容易一些。至于想转成pdf，那么docbook, reST, tex也都可以，但docbook现在对中文支持不好。reST没试过。tex应该是最好的，因为它的最终文件就是pdf。但tex比较难学。当然如果你已经有一个模板，只是让大家根据模板填内容就容易了。docbook是xml格式的，如果有模板也简单，麻烦的就是转换还有汉字支持。
因此，如果想效果最好，请使用tex，
如果只关心内容，请使用docbook，
如果想简单，可以使用wiki，reStructured
至于版本管理，wiki的确方便，因为在编辑时就维护了，查阅，写作都容易。其它的如果想看，都多多少少要进行转换，版本可以使用cvs, subversion进行管理。也没有一个简单的自动管理平台，只能是把转好的东西放在web上发布，如果改动则要先改源文件，重新转换，再次发布。
|
|
----
|
|
[Original]
[Print]
[Top]
|
|
|
声明: 本页内容为中国Linux论坛的内容镜像，文章的版权以及其他所有的相关权利属于中国Linux论坛和相应文章的作者，如果转载，请注明文章来源及相关版权信息。
