Comments on: 学习 DocBook http://linuxtoy.org/archives/learning-docbook.html LinuxTOY 是一个致力于提供 Linux 相关资讯的专题站点。如果您发现了好用好玩的 Linux 东东并愿意发扬自由、分享的精神，可以点击顶部导航 Contact 按钮进行投稿。 Thu, 24 May 2012 17:43:16 +0000 hourly 1 http://wordpress.org/?v=3.3.1 By: cooras http://linuxtoy.org/archives/learning-docbook.html#comment-120115 cooras Tue, 28 Jul 2009 06:03:29 +0000 http://linuxtoy.org/?p=2462#comment-120115 <p>@Xhacker 用CDATA，或者将用entity代替</p> @Xhacker 用CDATA，或者将用entity代替

]]> By: Toy http://linuxtoy.org/archives/learning-docbook.html#comment-114445 Toy Tue, 02 Jun 2009 02:42:04 +0000 http://linuxtoy.org/?p=2462#comment-114445 <p>@<a href="#comment-114441" rel="nofollow">avenger</a>: thx, 已更新。</p> @avenger: thx, 已更新。

]]> By: avenger http://linuxtoy.org/archives/learning-docbook.html#comment-114441 avenger Tue, 02 Jun 2009 01:37:54 +0000 http://linuxtoy.org/?p=2462#comment-114441 <p>@toy 学习docbook 的链接要更新了</p> @toy 学习docbook 的链接要更新了

]]> By: hantsy http://linuxtoy.org/archives/learning-docbook.html#comment-101721 hantsy Fri, 23 Jan 2009 15:34:20 +0000 http://linuxtoy.org/?p=2462#comment-101721 <p>FOP中文输出别人费解，以前0.20的时候用过，中文不是很理想，一直没有再用。直到0.95发布之后，中文字体配置依然需要额外的配置。这次不知道什么原因，输出的中文全部是框框。</p> FOP中文输出别人费解，以前0.20的时候用过，中文不是很理想，一直没有再用。直到0.95发布之后，中文字体配置依然需要额外的配置。这次不知道什么原因，输出的中文全部是框框。

]]> By: Xhacker http://linuxtoy.org/archives/learning-docbook.html#comment-95927 Xhacker Sun, 23 Nov 2008 08:52:04 +0000 http://linuxtoy.org/?p=2462#comment-95927 <p>请问，如何在programlisting插入HTML代码？如果直接插入，它显示得不太对。</p> 请问，如何在programlisting插入HTML代码？如果直接插入，它显示得不太对。

]]> By: netwjx http://linuxtoy.org/archives/learning-docbook.html#comment-94256 netwjx Sat, 08 Nov 2008 13:36:34 +0000 http://linuxtoy.org/?p=2462#comment-94256 <p>txt2tags比rest还要简单一些,是py的程序,有简单的GUI转换文档界面</p> txt2tags比rest还要简单一些,是py的程序,有简单的GUI转换文档界面

]]> By: Kardinal http://linuxtoy.org/archives/learning-docbook.html#comment-93687 Kardinal Wed, 22 Oct 2008 06:28:13 +0000 http://linuxtoy.org/?p=2462#comment-93687 <p>如果是写xhtml的话，真不如直接用Docbook得了，可以输出xhtml 记笔记用Org-mode，也可以输出为html什么的，不过我只用Org-mode整理一些想法，输出用不到，所以没试这个功能</p> <p>其实就写作工具链来说，写作和排版的工序已经很好的解决了；还有一环就是前期酝酿阶段，比如收集灵感什么的。你所说的记笔记应该属于这一阶段 Org-mode可以很好的整理混乱的思维，但却不能帮助产生灵感；往往你很随便的回个帖子却能文思泉涌……这好比有些人在宽敞明亮的书房可能什么也写不出来，在人声鼎沸的闹市、酒肆、咖啡馆却灵感如潮……可能灵感需要某种催化剂，得研究下这个问题^_^!!</p> 如果是写xhtml的话，真不如直接用Docbook得了，可以输出xhtml 记笔记用Org-mode，也可以输出为html什么的，不过我只用Org-mode整理一些想法，输出用不到，所以没试这个功能

其实就写作工具链来说，写作和排版的工序已经很好的解决了；还有一环就是前期酝酿阶段，比如收集灵感什么的。你所说的记笔记应该属于这一阶段 Org-mode可以很好的整理混乱的思维，但却不能帮助产生灵感；往往你很随便的回个帖子却能文思泉涌……这好比有些人在宽敞明亮的书房可能什么也写不出来，在人声鼎沸的闹市、酒肆、咖啡馆却灵感如潮……可能灵感需要某种催化剂，得研究下这个问题^_^!!

]]> By: allbluedream http://linuxtoy.org/archives/learning-docbook.html#comment-93684 allbluedream Wed, 22 Oct 2008 03:15:16 +0000 http://linuxtoy.org/?p=2462#comment-93684 <p>＠Kardinal 你真是耐心！看来必须自己试过才知道了，记笔记的话先从ReST开始，希望不用痛苦地转到DocBook啊。其他一些东西现在是写xhtml的，也许用DocBook更省事。</p> ＠Kardinal 你真是耐心！看来必须自己试过才知道了，记笔记的话先从ReST开始，希望不用痛苦地转到DocBook啊。其他一些东西现在是写xhtml的，也许用DocBook更省事。

]]> By: Kardinal http://linuxtoy.org/archives/learning-docbook.html#comment-93679 Kardinal Wed, 22 Oct 2008 00:41:52 +0000 http://linuxtoy.org/?p=2462#comment-93679 <p>@allbluedream:哥们儿，这个页面我太眼熟了，以前我写过一个文档，这个页面我参考了很多…… http://forum.ubuntu.org.cn/viewtopic.php?f=68&t=20245</p> <p>footnote和calloutlist作用完成不一样的，举一个最明显的例子吧，假如我不是分页输出，而一个很长的单独的页面，页面顶部有几个地方需要注释，看解释却要到页面的底部，这样就很麻烦…… calloutlist 适合需要密集注释的地方，脚注一般用在稀疏注释的地方 calloutlist 每一部分包含的解释都重新编号，更容易的区分各个不同的概念。footnote是从头到尾编号的</p> <p>ReST的call-out其实和脚注差不多，只不过用的不是编号 而Calloutlist要求　标记和注释离的不能太远，以便于阅读</p> <p>…………这个得用了才知道，这样空口说很难说清楚的…… 文档里的很多的Calloutlist用ReST是不能够以这种清晰度解释出来的</p> <p>CalloutList很重要，但不是用DocBook的全部理由，还有其它很多的特点 比如语义清晰(ReST对于缩进有特殊要求，如果换用一个不同的编辑器，对缩进的处理可能就不同，就有可能产生混乱) 扩展能力强(ReST的行内元素就要少很多，它的语法特点决定了它弄不出更多的东西来表示标记，要是扩展成类似这种形式(假设)　..::userinput::，那它还不如Docbook方便了) ………… 还有一些特点，一下子真是说不出这么多，我会在Org-mode上弄一个条目，想起一条记一条^__^!!</p> @allbluedream:哥们儿，这个页面我太眼熟了，以前我写过一个文档，这个页面我参考了很多…… http://forum.ubuntu.org.cn/viewtopic.php?f=68&t=20245

footnote和calloutlist作用完成不一样的，举一个最明显的例子吧，假如我不是分页输出，而一个很长的单独的页面，页面顶部有几个地方需要注释，看解释却要到页面的底部，这样就很麻烦…… calloutlist 适合需要密集注释的地方，脚注一般用在稀疏注释的地方 calloutlist 每一部分包含的解释都重新编号，更容易的区分各个不同的概念。footnote是从头到尾编号的

ReST的call-out其实和脚注差不多，只不过用的不是编号 而Calloutlist要求　标记和注释离的不能太远，以便于阅读

…………这个得用了才知道，这样空口说很难说清楚的…… 文档里的很多的Calloutlist用ReST是不能够以这种清晰度解释出来的

CalloutList很重要，但不是用DocBook的全部理由，还有其它很多的特点 比如语义清晰(ReST对于缩进有特殊要求，如果换用一个不同的编辑器，对缩进的处理可能就不同，就有可能产生混乱) 扩展能力强(ReST的行内元素就要少很多，它的语法特点决定了它弄不出更多的东西来表示标记，要是扩展成类似这种形式(假设)　..::userinput::，那它还不如Docbook方便了) ………… 还有一些特点，一下子真是说不出这么多，我会在Org-mode上弄一个条目，想起一条记一条^__^!!

]]> By: allbluedream http://linuxtoy.org/archives/learning-docbook.html#comment-93621 allbluedream Tue, 21 Oct 2008 02:39:46 +0000 http://linuxtoy.org/?p=2462#comment-93621 <p>＠Kardinal: http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets</p> ＠Kardinal: http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets

]]>