• <ins id="pjuwb"></ins>
    <blockquote id="pjuwb"><pre id="pjuwb"></pre></blockquote>

    <noscript id="pjuwb"></noscript>
          <sup id="pjuwb"><pre id="pjuwb"></pre></sup>

            <dd id="pjuwb"></dd>
            <abbr id="pjuwb"></abbr>
            

    
            

            




            







												


        


            


            牽著老婆滿街逛
            

            嚴(yán)以律己,寬以待人. 三思而后行.
            
GMail/GTalk: yanglinbo#google.com;
            
MSN/Email: tx7do#yahoo.com.cn;
            
QQ: 3 0 3 3 9 6 9 2 0 .
            

            




            
	
					
	
            
		
            
			Docbook寫(xiě)作指南 
		
            
		
		全文請(qǐng)看這個(gè)link：DocBook指南

            1. 概述

            DocBook提供了一個(gè)使用SGML/XML撰寫(xiě)結(jié)構(gòu)化文檔的系統(tǒng)。這個(gè)系統(tǒng)非常適合于計(jì)算機(jī)類的文章、書(shū)籍、論文等的出版，當(dāng)然并不僅僅限于計(jì)算機(jī)類。DocBook已經(jīng)被Linux、FreeBSD等眾多的項(xiàng)目制定作為文檔撰寫(xiě)格式，并且有越來(lái)越多的組織和個(gè)人開(kāi)始使用。

            本文只是一個(gè)簡(jiǎn)要指南。收集了一些DocBook的學(xué)習(xí)資料，和我自己的一些心得。

            如果想快速了解DocBook，可以看這里：DocBook的HelloWorld起步。
            2. DocBook語(yǔ)法

            學(xué)習(xí)DocBook，基本的語(yǔ)法是一定要掌握的，即便你使用所見(jiàn)即所得編輯器。下面是學(xué)習(xí)DocBook語(yǔ)法的一些資源：

            ? ? *

            ? ?? ?Writing Documentation Using DocBook

            ? ?? ?一個(gè)非常好的英文Docbook語(yǔ)法教程。也可以作為常備的速查手冊(cè)。

            ? ? *

            ? ?? ?DocBook 助你完成傳世之作

            ? ?? ?中文的教程。入門必看。有助于了解DocBook的全貌。
            ? ? *

            ? ?? ?DocBook學(xué)習(xí)

            ? ?? ?中文語(yǔ)法教程。也提到了DocBook格式轉(zhuǎn)換的內(nèi)容，特別是XSLT部分，是比較好的中文資料。

            3. DocBook編輯器

            DocBook可以用任何文本編輯器來(lái)編輯。但是為了提高生產(chǎn)力，我們可以使用一些更方便的工具。

            ? ? *

            ? ?? ?DocBookAuthoringTools

            ? ?? ?這是一個(gè)DocBook書(shū)寫(xiě)工具的列表。比較全面。

            但上述列表還并不能大全。至少還遺漏了Kate，Quanta Plus和OpenOffice（當(dāng)然還有其他一些形形色色的XML編輯器）。前面兩個(gè)都是KDE的項(xiàng)目，只能在KDE環(huán)境下運(yùn)行。OpenOffice編輯DocBook我還沒(méi)有用過(guò)。

            ? ? *

            ? ?? ?Kate編輯DocBook XML文檔

            ? ?? ?這是我2002年翻譯的一篇文章。
            ? ? *

            ? ?? ?Quanta as a Docbook Editor

            ? ?? ?Quanta Plus是一個(gè)不錯(cuò)的Html/XML編輯器，用來(lái)編輯DocBook也非常好。

            我推薦的編輯器：

            ? ? *

            ? ?? ?XMLMind XML Editor

            ? ?? ?這是我現(xiàn)在用的DocBook編輯器。所見(jiàn)即所得方式。基于Java，標(biāo)準(zhǔn)版免費(fèi)，可以跨平臺(tái)使用。不過(guò)我是在Linux環(huán)境用。

            ? ?? ?我用過(guò)不少的DocBook編輯器，這是我看見(jiàn)過(guò)最好用的。
            ? ? *

            ? ?? ?Quanta Plus

            ? ?? ?非所見(jiàn)即所得方式。基于KDE。

            4. 轉(zhuǎn)換DocBook

            DocBook格式的文件可以轉(zhuǎn)換成很多文件格式來(lái)發(fā)布。比如：Html,Rtf,Pdf,甚至Word。

            在 DocBook學(xué)習(xí) 和 DocBook助你完成傳世之作 兩篇文章中，介紹了 OpenJade和Saxon兩種轉(zhuǎn)換工具和它們的使用方法。

            按照我很早以前的印象，使用OpenJade將DocBook轉(zhuǎn)換成RTF和Html，中文是正常的。使用其他工具，基本上多少會(huì)遇到一點(diǎn)中文方面的麻煩。

            如果你使用XMLMind XML Editor標(biāo)準(zhǔn)版，那么在DocBook菜單下面已經(jīng)內(nèi)置了轉(zhuǎn)換成Html的工具（標(biāo)準(zhǔn)版不能將DocBook轉(zhuǎn)換成其他格式）。不過(guò)XMLMind轉(zhuǎn)換出來(lái)的html文件編碼都是iso-8859-1的。

            另外，你還可以關(guān)注一下在Windows下使用的Chinese DocBook Environment（CDBE） 。

            下面介紹我自己使用的轉(zhuǎn)換方法。環(huán)境是Ubuntu Linux。

            4.1. DocBook->Html

            4.1.1. 環(huán)境準(zhǔn)備

            ? ? *

            ? ?? ?安裝xsltproc

            ? ? *

            ? ?? ?安裝docbook-xsl

            ? ? *

            ? ?? ?建立合適的xsl

            ? ?? ?找到我們剛才安裝的docbook-xsl中的docbook.xsl，把它c(diǎn)opy成docbook_utf8.xsl(因?yàn)槲业南到y(tǒng)語(yǔ)言設(shè)定是utf。

            cp /path/html/docbook.xsl /path/html/docbook_utf8.xsl

            ? ?? ?編輯這個(gè)docbook_utf8.xsl，找到：

            <xsl: output method="html"
            ? ?? ?? ?? ?encoding="ISO-8859-1"
            ? ?? ?? ?? ?indent="no"/>

            ? ?? ?替換為：

            <xsl: output method="html"
            ? ?? ?? ?? ?encoding="utf8"
            ? ?? ?? ?? ?indent="yes"/>

            ? ?? ?在這段話之后，我們添加：

            <xsl: param name="html.stylesheet" select="'style.css'"></xsl:param>
            <xsl: param name="table.borders.with.css" select="1"></xsl:param>
            <xsl: param name="l10n.gentext.language" select="'zh_cn'"></xsl:param>
            <xsl: param name="admon.graphics" select="1"></xsl:param>
            <xsl: param name="section.autolabel" select="1"></xsl:param>
            <xsl: param name="section.label.includes.component.label" select="1"></xsl:param>
            <xsl: param name="ulink.target" select="'_blank'"></xsl:param>

            ? ?? ?這些是樣式表參數(shù)，它的具體意義請(qǐng)參考HTML Parameter Reference，這是DocBook Xsl文檔的一部分。
            ? ? *

            ? ?? ?建立轉(zhuǎn)換腳本

            ? ?? ?創(chuàng)建新文件/usr/bin/docbook2html,內(nèi)容如下：

            #/bin/sh
            xsltproc /path/html/docbook_utf8.xsl $*

            ? ?? ?將其設(shè)置為可執(zhí)行文件。

            4.1.2. 轉(zhuǎn)換步驟

            docbook2html YourDocBook.xml>YourDocBook.html

            這樣，我們就得到了html結(jié)果。

            這個(gè)Html可以使用同級(jí)目錄下的style.css來(lái)美化輸出。

            你可以去網(wǎng)上找那些docbook轉(zhuǎn)化出來(lái)的html（根據(jù)docbook的風(fēng)格是很容易識(shí)別的），然后把它們使用的css下載下來(lái)使用就可以了。

            比如：

            ? ? *

            ? ?? ?http://www.sagehill.net/docbookxsl/
            ? ? *

            ? ?? ?http://worldhello.net/doc/docbook_howto/index.html
            ? ? *

            ? ?? ?http://pyrecord.freezope.org/docbook/index.html

            我使用的是XMLMind XML Editor轉(zhuǎn)換出來(lái)的html所帶的css。
            

		
            
			posted on 2006-07-14 10:58 楊粼波 閱讀(1646) 評(píng)論(0)  編輯 收藏 引用  所屬分類: 學(xué)習(xí)筆記 
		
            
	
            
	
	





            
	    
    




            






            

				

            



    
    







            
	   
	



精品久久久久久国产免费了|
亚洲欧美国产日韩综合久久|
精品久久久久久国产|
香蕉久久一区二区不卡无毒影院|
久久成人小视频|
中文国产成人精品久久亚洲精品AⅤ无码精品
|
好属妞这里只有精品久久|
久久精品国产亚洲AV蜜臀色欲|
亚洲?V乱码久久精品蜜桃|
久久精品国产亚洲7777|
99久久99久久精品国产|
亚洲午夜久久久精品影院|
久久免费精品一区二区|
欧美亚洲国产精品久久蜜芽|
久久亚洲国产中v天仙www|
嫩草影院久久国产精品|
久久国产精品波多野结衣AV|
久久精品国产亚洲Aⅴ蜜臀色欲|
内射无码专区久久亚洲|
一本色道久久88综合日韩精品|
人妻少妇精品久久|
亚洲精品无码久久久久去q|
亚洲精品乱码久久久久久自慰
|
日韩AV无码久久一区二区|
国产亚洲精品美女久久久|
99久久中文字幕|
精品久久人人妻人人做精品
|
亚洲国产成人久久综合一区77|
青青草原综合久久大伊人导航|
思思久久好好热精品国产|
久久亚洲精品成人AV|
99久久精品国产高清一区二区
|
办公室久久精品|
婷婷久久综合九色综合绿巨人
|
国内精品久久久久|
久久无码人妻精品一区二区三区|
久久中文字幕视频、最近更新|
性欧美丰满熟妇XXXX性久久久
|
久久久久久久久无码精品亚洲日韩
|
久久香蕉国产线看观看猫咪?v|
久久香综合精品久久伊人|