最新消息:20210816 当前crifan.com域名已被污染,为防止失联,请关注(页面右下角的)公众号

【记录】尝试用docbook输出website网站格式

Docbook crifan 3025浏览 0评论

【背景】

之前就知道docbook可以输出website格式的。

一直没去研究。

最近看到docbook的website的示例:

http://docbook.sourceforge.net/release/website/current/example/index.html

感觉貌似效果不错。

所以打算去折腾试试。

【折腾过程】

1.打算参考之前html,pdf,webhelp等的做法,去写个自己的website的配置。

2.结果参考:

Chapter 31. Website

以及其提到的那个更高级的:

SilkPage: enhanced Website

去看看:

http://silkpage.markupware.com/

结果打不开了,该页面失效了。

3.继续参考原先的:

Chapter 31. Website

结果发现:

如果想要建立website,本身就要写个website。

(而不是我之前的book)

所以:

要么用示例代码中的website。

要么想办法,借用我之前已有的docbook_dev_note的源码,然后改为website,估计要用上此处的提到:

website-full.dtd

以便能够支持足够多的元素,而使得无需再一点点修改原先的docbook_dev_note的xml的源码了。

4.结果又仔细看了看介绍,发现即使是:

用上包含400多个元素的:website-full.dtd

但是还有其他很多内容,包括chapter等元素都不支持的。

所以:

如果借用docbook_dev_note,则必然还是要修改xml源码的。

5.又看了看,貌似还是有些复杂的。

最最主要的是:

目前,暂时没有真的要生成一个website的需求。

所以,其所给出的参考内容:

Creating a webpage XML file
Allowed DocBook elements
Structuring your webpages
Generating your webpages
Build with XSLT only
Build with make
Source files in multiple directories
Linking between pages
Olinks with XSLT build method
Olinks with Make method
Linking to other sites
Adding other content
Website with XML catalogs
Website formatting
Using CSS with Website
Website config attributes
Website stylesheet customization
SilkPage: enhanced Website

就暂时懒得去弄了。

 

【总结】

等真的有这类需求了:真的需要将某个docbook的website,去生成对应的website页面

然后再去继续折腾吧。

转载请注明:在路上 » 【记录】尝试用docbook输出website网站格式

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (3)

  1. 恍然间没看懂这个能干啥
    pang11年前 (2013-10-05)回复
    • 可以建立网站啊,建立一个静态页面的网站。 好处是: 网站的内容,用docbook的xml去管理,方便版本管理。
      crifan11年前 (2013-10-06)回复
      • 哦 小伙伴 求友链!
        pang11年前 (2013-10-06)回复
89 queries in 0.166 seconds, using 22.32MB memory