• <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>

            牽著老婆滿街逛

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

            Docbook寫作指南

            全文請看這個link:DocBook指南

            1. 概述

            DocBook提供了一個使用SGML/XML撰寫結構化文檔的系統。這個系統非常適合于計算機類的文章、書籍、論文等的出版,當然并不僅僅限于計算機類。DocBook已經被Linux、FreeBSD等眾多的項目制定作為文檔撰寫格式,并且有越來越多的組織和個人開始使用。

            本文只是一個簡要指南。收集了一些DocBook的學習資料,和我自己的一些心得。

            如果想快速了解DocBook,可以看這里:DocBook的HelloWorld起步。
            2. DocBook語法

            學習DocBook,基本的語法是一定要掌握的,即便你使用所見即所得編輯器。下面是學習DocBook語法的一些資源:

            ? ? *

            ? ?? ?Writing Documentation Using DocBook

            ? ?? ?一個非常好的英文Docbook語法教程。也可以作為常備的速查手冊。

            ? ? *

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

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

            ? ?? ?DocBook學習

            ? ?? ?中文語法教程。也提到了DocBook格式轉換的內容,特別是XSLT部分,是比較好的中文資料。

            3. DocBook編輯器

            DocBook可以用任何文本編輯器來編輯。但是為了提高生產力,我們可以使用一些更方便的工具。

            ? ? *

            ? ?? ?DocBookAuthoringTools

            ? ?? ?這是一個DocBook書寫工具的列表。比較全面。

            但上述列表還并不能大全。至少還遺漏了Kate,Quanta Plus和OpenOffice(當然還有其他一些形形色色的XML編輯器)。前面兩個都是KDE的項目,只能在KDE環境下運行。OpenOffice編輯DocBook我還沒有用過。

            ? ? *

            ? ?? ?Kate編輯DocBook XML文檔

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

            ? ?? ?Quanta as a Docbook Editor

            ? ?? ?Quanta Plus是一個不錯的Html/XML編輯器,用來編輯DocBook也非常好。

            我推薦的編輯器:

            ? ? *

            ? ?? ?XMLMind XML Editor

            ? ?? ?這是我現在用的DocBook編輯器。所見即所得方式。基于Java,標準版免費,可以跨平臺使用。不過我是在Linux環境用。

            ? ?? ?我用過不少的DocBook編輯器,這是我看見過最好用的。
            ? ? *

            ? ?? ?Quanta Plus

            ? ?? ?非所見即所得方式。基于KDE。

            4. 轉換DocBook

            DocBook格式的文件可以轉換成很多文件格式來發布。比如:Html,Rtf,Pdf,甚至Word。

            在 DocBook學習 和 DocBook助你完成傳世之作 兩篇文章中,介紹了 OpenJade和Saxon兩種轉換工具和它們的使用方法。

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

            如果你使用XMLMind XML Editor標準版,那么在DocBook菜單下面已經內置了轉換成Html的工具(標準版不能將DocBook轉換成其他格式)。不過XMLMind轉換出來的html文件編碼都是iso-8859-1的。

            另外,你還可以關注一下在Windows下使用的Chinese DocBook Environment(CDBE) 。

            下面介紹我自己使用的轉換方法。環境是Ubuntu Linux。

            4.1. DocBook->Html

            4.1.1. 環境準備

            ? ? *

            ? ?? ?安裝xsltproc

            ? ? *

            ? ?? ?安裝docbook-xsl

            ? ? *

            ? ?? ?建立合適的xsl

            ? ?? ?找到我們剛才安裝的docbook-xsl中的docbook.xsl,把它copy成docbook_utf8.xsl(因為我的系統語言設定是utf

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

            ? ?? ?編輯這個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>

            ? ?? ?這些是樣式表參數,它的具體意義請參考HTML Parameter Reference,這是DocBook Xsl文檔的一部分。
            ? ? *

            ? ?? ?建立轉換腳本

            ? ?? ?創建新文件/usr/bin/docbook2html,內容如下:

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

            ? ?? ?將其設置為可執行文件。

            4.1.2. 轉換步驟

            docbook2html YourDocBook.xml>YourDocBook.html

            這樣,我們就得到了html結果。

            這個Html可以使用同級目錄下的style.css來美化輸出。

            你可以去網上找那些docbook轉化出來的html(根據docbook的風格是很容易識別的),然后把它們使用的css下載下來使用就可以了。

            比如:

            ? ? *

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

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

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

            我使用的是XMLMind XML Editor轉換出來的html所帶的css。

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

            久久久精品日本一区二区三区| 伊人色综合久久| 久久99精品久久久久久齐齐 | 国内精品久久久久久久亚洲| 久久电影网2021| 色播久久人人爽人人爽人人片aV | 久久婷婷五月综合成人D啪| 久久综合偷偷噜噜噜色| 久久精品天天中文字幕人妻 | 国内精品久久九九国产精品| 精品久久久久久国产牛牛app | 久久亚洲视频| 午夜精品久久久久久中宇| 嫩草影院久久99| 日日躁夜夜躁狠狠久久AV| 欧美久久久久久午夜精品| 久久99精品久久只有精品| 91久久九九无码成人网站| 久久人人爽人人爽人人片AV高清 | 一本色道久久99一综合| 国産精品久久久久久久| AV无码久久久久不卡蜜桃| 久久久久精品国产亚洲AV无码| 久久精品一区二区三区不卡| 久久午夜福利无码1000合集| 99久久综合狠狠综合久久| 囯产精品久久久久久久久蜜桃| 欧美午夜A∨大片久久 | 久久久久亚洲AV成人网人人软件| 亚洲精品无码久久久久去q| 99久久精品九九亚洲精品| 91精品国产色综合久久| 色综合久久久久无码专区| 欧美日韩精品久久久久| 国产精品久久久久蜜芽| 一级女性全黄久久生活片免费 | 久久精品国产99国产精品导航| 国产亚州精品女人久久久久久 | 久久九九免费高清视频| 91精品观看91久久久久久| 热re99久久精品国99热|