本章節顯示如何獲取關於如何書寫你自己的 LDP 文檔的信息。獲取並安裝工具，與 LDP 聯系，從那裡向所有 Linux 用戶發布你所掌握的知識。
如果你剛剛了解 LDP 並且想要選擇一個沒人維護的 HOWTO 或者想寫一個新的 HOWTO 或者 mini-HOWTO 文檔，請聯系 linux-howto@metalab.unc.edu 。
這將讓 HOWTO 協調人掌握誰在維護哪篇文檔。同時要注意所有的 HOWTO 都使用 SGML 格式(當前使用 LinuxDoc DTD)。mini-HOWTO 使用 SGML 或者 HTML 格式，但只有 SGML 格式將被包含進 HOWTO 的打印版本中。
有一些郵件列表可以訂閱以讓你了解 LDP 目前工作情況。首先是 ldp-discuss@lists.linuxdoc.org，這是 LDP 的主要討論組。如果要訂閱，發送主題為 "subscribe" 的郵件到 ldp-discuss-request@lists.linuxdoc.org。退訂則發送主題為 "unsubscribe" 的郵件到 ldp-discuss-request@lists.linuxdoc.org。
從 http://www.sgmltools.org/下載 sgmltools 包，或者直接從你的 Linux 發行版本中取得。從 sgmltools.org 取得的軟件是源碼格式，因此你必須在你的機器上編譯這些源碼。從你的 Linux 發行版本中取得的預建立好的包更容易些，你可以不用編譯而直接開始編輯工作。(特別是如果你不是一個程序員)
RedHat 中包含 sgmltools。 如果沒有，你可以從 ftp.redhat.com 或者其它鏡像站點下載。
如果你使用 Debian，在標準發行版本中也包含 sgmltools 。如果你沒有已安裝的包，你可以使用 apt-get 命令下載並安裝：
# apt-get install sgml-tools
要了解更多關於 Debian 包的信息，你可以查閱 http://www.debian.org/Packages/stable/text/sgml-tools.html
如果從源碼編譯，所有你需要做的是：
# tar -zxvf sgmltools-x.x.x.tar.gz # cd sgmltools-x.x.x # ./configure # make # make install
替換 sgmltools-x.x.x 成你當前 sgmltools 的版本號。支持 LinuxDoc 的當前版本號是 1.0.9。支持 DocBook 的當前版本號是 2.0.2。兩者在以上所述站點中都可以找到。
一旦工具安裝好後，你就可以使用很多命令了。
sgmlcheck file.sgml- 檢查給定文檔的句法。
sgml2html file.sgml- 轉換 SGML 文件成 HTML。 創建一個名為 file.html 的文件包含內容表，然後創建一系列名為 file-x.html 的文件，這裡 x 是章節號。
sgml2rtf file.sgml- 轉換 SGML 文件成 Rich Text Format (RTF)。創建兩個文件，第一個是 file.rtf 包含 TOC，以及 file-0.rtf 包含所有的章節。
sgml2txt file.sgml- 轉換 SGML 文件成 ASCII 文本。所有內容放在 file.txt中。
sgml2info file.sgml- Blah SGML blah INFO, 能被 info 命令使用。所有的輸出傳送到 file.info。
sgml2latex file.sgml- Blah SGML blah TeX.
sgml2lyx file.sgml- SGML yadda LyX graphical editor. This is great if you
have pre-generated SGML files and want to convert them for use in LyX.
非常象 HTML，你可以手工書寫 SGML , 只要你掌握了所有需要使用的標記代碼本章節將講述盡可能多的這些代碼，並為每一個提供例子。開始的最好的地方就是本文的源碼，可以從這裡看看： Introduction. 因為 SGML 的處理方式依賴於文件格式的不同而不同，我將盡可能說明在文件寫作中應該知道的事情。
現在開始寫作了，首先用你喜愛的編輯器創建一個新文件，文件的開頭如下：
<!doctype linuxdoc system>
這將定義 SGML 處理輸出文件時使用的文檔類型(我們這個例子使用 LinuxDoc)。這個標記本身不產生任何輸出。
接下來你需要把你其余的內容包含在標記 <article> 和 </article> 之中。這意味著內容的開始。如果你熟悉 HTML 的話，這類似於將所有內容包含在標記 <html> 和 </html> 之間。
內容的第一部分應該包含內容其余部分的概括信息。這類似於一本書的頭幾頁，那裡有標題頁(書本的標題、作者、出版日期、內容目錄等等)。
內容的標題包含在標記 <title> 和 </title> 之間。作者包含在標記 <author> 和 </author> 之間。日期則使用標記 <date> 和 </date> 。
有兩個保留的章節是： <abstract> 和 </abstract> 標記描述內容摘要；<toc> 標記指出內容目錄的位置。內容目錄(TOC)是由 SGML 自動生成的。我們後面將引入章節。
現在我們所做的一切看起來是什麼樣子呢？把剛才說過的 SGML 代碼組合起來，就象：
<!doctype linuxdoc system> <!-- LinuxDoc file was created by LyX 1.0 (C) 1995-1999 by <markk> Fri Aug 27 09:42:28 1999 --> <article> <title>HOWTO HOWTO </title> <author>Mark F. Komarinski </author> <date>Aug 27, 1999 </date> <abstract>Getting a new LDP author up and running with tools, ideas, and conventions used by the LDP </abstract> <toc>
當你使用 RTF 或 HTML 格式看這段創建主頁面的內容時，所有的信息都在一頁中。
為了建立內容目錄，你必須做一些標記。 在 SGML 中的章節(Sections)類似於傳統出版中的章的概念。你可以有多個章節，每個章節可以有子章節，子章節下還可以有子章節。
在你的文檔中使用章節，有助於你建立主題大綱。你可以將主題分隔成多個小章節。我在寫本文時就是這樣做的。
章節是 SGML 中少數幾個不需要成對出現的標記。也就是說，沒有 </sect> 標記。 你不用關於章節的編號，SGML 在輸出成其它格式時會自動處理的。
章節是使用 <sect> 標記作為開始的。每一個新章節開始於一個 <sect> 標記。 第一個章節被編號為 1。
創建子章節 (比如 1.1) 可以使用 <sect1> 標記。它也從 1 開始編號。
子章節 (1.1.1) 使用 <sect2> 標記，並且它也從 1 開始編號。
當 SGML 處理器處理到 <toc> 標記時，它開始掃描文檔的其余部分，利用其中的章節標記編號創建文檔目錄。章節被編號排列在內容目錄(TOC)中，然後被文檔的其余部分使用。子章節 (1.1.1) 並不出現在 TOC 中，但如果可能的話會被置成強調文本格式。
寫內容段落就象 HTML一樣。使用一個 <p> 標記指明一個新行的開始。SGML 會忽略 TAB、空格、空行。當 SGML 檢查到 <p> 標記時，它開始一個新行。放置 </p> 標記結束該段落。
你偶而會需要讓一些文本明顯不同於其它文本。可能是重要代碼或者命令列表。強調文本可以使用 <em> 和 </em> 標記。斜體字可以使用 <tt> 和 </tt> 標記。
在 SGML 中有兩種形式的列表。第一種是列舉列表，從1開始為每一個列表項編號。
以上的代碼如下：
<enum> <item>This is the first entry in the enumerated list. <item>This is the second. <item>Third. </enum>
<enum> 標記指出緊隨其後的列表項要開始編號。
另一種形式是逐項列表，每一個列表項前面只放一個星或圓圈或點或其它東西。
以上的代碼如下：
<itemize> <item>This is the first entry in the itemized list <item>This is the second. <item>Third. </itemize>
就象你所看到的，<item> 標記在兩種形式列表中都一樣。
第三種形式是描述列表，包括被描述的術語以及描述該術語的短語。
The Linux Documentation Project
Standard Generalized Markup Language
以上的代碼如下：
<descrip> <tag>LDP</tag>The Linux Documentation Project <tag>SGML</tag>Standard Generalized Markup Language </descrip>
這種形式不同於前面兩種，整個列表包含在標記 <descrip> 和 </descrip> 中，每一行中的每一項，也就是定義的短語，被包含在 <tag> 和 </tag> 中。行的剩余部分是對短語的定義。
有時你需要完全顯示你所寫的內容，你可以使用 <verb> 和 </verb> 標記來包含段落。在</verb> 標記之前的空格、回車以及其它文本(包括特別字符)都將被保留。
以下就是逐字文本
SGML 也允許統一資源定位(URL)。注意這在輸出成 HTML 格式時才有用，其它格式可能也有一些用，比如說 RTF 格式。
一個 URL 沒有結束標記，所有信息都放在 <url> 標記裡面。這是一個指向 LDP 主頁的 URL：
http://www.linuxdoc.org/ 。以下是代碼：
<url url="http://www.linuxdoc.org/" name="http://www.linuxdoc.org/">
url="http://www.linuxdoc.org/" 告訴瀏覽器目標地址，而 name="http://www.linuxdoc.org/" 則告訴瀏覽器如何顯示。在本例中兩者是一樣的，但我可以創建一個如下的 URL 標記：
<url url="http://www.linuxdoc.org/" name="LDP">
在頁面上的顯示就象這樣： LDP.
URL 適合於鏈接到 LDP 文檔之外的內容，但不適合於鏈接到文檔內容自身。為實現這一功能，可以使用 <label> 和 <ref> 標記。<label> 標記創建一個將來能跳轉回來的記號，非常象一個書簽。 創建 <label> 很簡單。找到以後需要跳轉回來的位置，然後插入以下：
<label id="Introduction">
你現在已經在文檔內容中創建了一個可以跳轉回來的記號 "Introduction"。這個標簽確實出現在文檔的開頭。當你以後需要跳轉回來時，插入以下：
<ref id="Introduction" name="here">
SGML 就能明白放入一個叫 "here" 的鏈接可以跳轉至 Introduction 章節的位置。
參考的另一部分是索引 (indexing)。由於 LDP 文檔經常是大量文檔，必須在書的後面建立基於單詞和主題的索引。
非常象 HTML，你必須避免許多非文字字符以防止 SGML 將其解釋成 SGML 代碼。這裡有一個 SGML 代碼的列表。更多的可以查閱 sgmltools 用戶指南： http://www.sgmltools.org/guide/guide.html。
我一直十分喜愛 LyX，因此我偏愛這個軟件。它提供常規字處理器易於使用的方式書寫 SGML。它不是一個所見即所得程序，而是所得即所想應用。
要用 LyX 創建一個 LinuxDoc 文檔，下載並安裝應用程序。確保你已安裝 TeX 和 sgmltools (參見
安裝工具 )。然後啟動 LyX 並且選擇 "file->new from template..."。選擇 "Templates" 然後點擊 linuxdoctemplate.lyx ，這樣你將得到一個帶 LDP 文檔頭信息的文檔模板。更改合適你的數據(也就是，填寫標題、作者、日期、摘要等等)，然後開始寫作。左上角的下拉菜單可以用來選擇內容的類型(標準、列表、章節)。感嘆號用來強調文本。你既可以點擊它進入強調模式，也可以用鼠標高亮選擇文本再點擊它，將選擇的文本置為強調文本。許多其它的 SGML 特性可以在 Insert 菜單條中找到。 你可以插入 URL、交叉參考、索引以及其它類型的數據。當完成你的文檔後，你可以保存成 LyX 格式，然後輸出到 LinuxDoc 得到 .sgml 後綴的文件。這個文件可以被 sgmlcheck 檢查和輸出成你想要的格式。
我不使用 Emacs，但我並不排斥它。有 Emacs 使用經驗的人會覺得它非常有用。
如果有除此之外的其它 SGML 工具，或者即使是商業版本，只要是能被 LinuxDoc DTD 用來創建 LDP 文檔，請告訴我。
到現在為止，LDP 還沒有一個共享倉庫可供你在線保存你的文檔內容。非常希望改變這種狀況。有很多需要使用 CVS 的原因：
在你將文檔發布給成千上萬的潛在讀者之前，我必須做一些事情。
首先，對你的文檔做拼寫檢查。沒有什麼比拼寫錯誤更快讓人覺得是在互聯網世界中說“嘿，我是傻瓜”。許多你可以用來寫 SGML 的應用程序(emacs、LyX...)都內置有拼寫檢查功能。如果沒有，就在所有的linux發行版本中都安裝了一個 ispell 程序。同樣要使用 sgmltools 中的 sgmlcheck 命令檢查 SGML 標記。
其次，找一些人評價你的文檔。由 LDP 發布的文檔應盡可能保証真實、正確，因為有成千上萬的Linux用戶可能會讀它。如果你參加了一個相關主題的較大規模的郵件列表，可以請求列表中的其他人幫助你。
第三，建立一個發布你的文檔的網站。這並不是必須的，但有助於人們找到你的文檔的原始出處。
In order for an LDP document to be accepted by the LDP, it must be licensed to allow for free (as in beer) distribution and publishing. As an author, you may retain the copyright and add other restrictions (for example, you must approve any translations or derivative works). A sample license is available at http://www.linuxdoc.org/COPYRIGHT.html. If you choose to use the boilerplate copyright, simply copy it into your source code under a section called "Copyright and Licenses" or similar. Also include a copyright statement of your own (since you still own it). If you are a new maintainer for an already-existing HOWTO, you must include the previous copyright statements of the previous author(s) and the dates they maintained that document.
一旦你的文檔被一部分人看過並且你已吸收了他們的意見，你就可以將文檔送往 LDP。發送郵件到 ldp-submit@lists.linuxdoc.org 。24小時之內你就可以知道它是否已被接受並送往主要的 LDP 站點。