wastemobile · June 30, 2014 06:33
diff --git a/gistfile1.txt b/gistfile1.txt
 使用 Asciidoc，測試整合 Hipchat

 === HTMLBook

 HTMLBook 是一個開放專案，使用 XHTML5 為基礎，目的是用來撰寫與生產書籍，包含紙本與電子書。它根據下面的前提而開發：

 * 書本質上沒有時間性（不包含流通與能見度）。書的基本架構，數百年來均穩定不變，也將持續下去，不管以紙本或數位格式呈現。 
 * 在可見的未來，HTML 都會是世界通用的標記語言格式。
 * 在可見的未來，單一文件來源的生產流程，價值日益提高。

 整體來看，HTMLBook的特性如下：

 * HTMLBook 是 XHTML5 的一個子集。所有的 HTMLBook 都是 XHTML5，但並非所有的 XHTML5 都是 HTMLBook。
 * HTMLBook 所有的元件與屬性，都在 XHTML5 標準規範之內。
 * HTMLBook 以語義化的標準打造一本書的架構，包含使用於資訊科技類與參考教材這類書籍的複雜內容。
 * HTMLBook 能以 XML schema 定義並驗證。
 * HTMLBook 樣式表以 CSS 撰寫。

 === 起手式

 在這裏你可以看到 HTMLBook 的完整規範定義：

 https://github.com/oreillymedia/HTMLBook/blob/master/specification.asciidoc

 在這裡則能取得 HTMLBook schema：

 https://github.com/oreillymedia/HTMLBook/tree/master/schema

 主要的 HTMLBook Schema 檔案是 +htmlbook.xsd+，它同時匯入了 MathML 與 SVG 驗證準則。

 你可以使用終端機指令 +xmllint+，經由參照 +htmlbook.xsd+ 這個檔案來驗證你的 HTMLBook：

 ----
 $ xmllint --noout --schema htmlbook.xsd <your_html_filename>.html
 ----

 若想使用類似 oXygen 這類視覺化工具進行驗證，需要將 +xsi:schemaLocation+ 宣告加入 +<html>+ 根元素，像下面這樣：

 ----
 <html xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.w3.org/1999/xhtml ../schema/htmlbook.xsd"
 xmlns="http://www.w3.org/1999/xhtml">
 ----

 === 注意事項

 * HTMLBook 是由 O'Reilly Media 開發，若有任何建議，可前往 https://github.com/oreillymedia/HTMLBook 新增議題討論，包含臭蟲提報與功能建議。

 * HTMLBook 的規格還在工作草稿階段，持續進行修改中。

 * 未來幾個月，將會增加一些額外的工具，便利編輯與製作 HTMLBook 的流程，包含：CSS 樣式表，轉製 EPUB/Mobi 流通格式的程序等等。
	使用 Asciidoc，測試整合 Hipchat

	=== HTMLBook

	HTMLBook 是一個開放專案，使用 XHTML5 為基礎，目的是用來撰寫與生產書籍，包含紙本與電子書。它根據下面的前提而開發：

	* 書本質上沒有時間性（不包含流通與能見度）。書的基本架構，數百年來均穩定不變，也將持續下去，不管以紙本或數位格式呈現。
	* 在可見的未來，HTML 都會是世界通用的標記語言格式。
	* 在可見的未來，單一文件來源的生產流程，價值日益提高。

	整體來看，HTMLBook的特性如下：

	* HTMLBook 是 XHTML5 的一個子集。所有的 HTMLBook 都是 XHTML5，但並非所有的 XHTML5 都是 HTMLBook。
	* HTMLBook 所有的元件與屬性，都在 XHTML5 標準規範之內。
	* HTMLBook 以語義化的標準打造一本書的架構，包含使用於資訊科技類與參考教材這類書籍的複雜內容。
	* HTMLBook 能以 XML schema 定義並驗證。
	* HTMLBook 樣式表以 CSS 撰寫。

	=== 起手式

	在這裏你可以看到 HTMLBook 的完整規範定義：

	https://github.com/oreillymedia/HTMLBook/blob/master/specification.asciidoc

	在這裡則能取得 HTMLBook schema：

	https://github.com/oreillymedia/HTMLBook/tree/master/schema

	主要的 HTMLBook Schema 檔案是 +htmlbook.xsd+，它同時匯入了 MathML 與 SVG 驗證準則。

	你可以使用終端機指令 +xmllint+，經由參照 +htmlbook.xsd+ 這個檔案來驗證你的 HTMLBook：

	----
	$ xmllint --noout --schema htmlbook.xsd <your_html_filename>.html
	----

	若想使用類似 oXygen 這類視覺化工具進行驗證，需要將 +xsi:schemaLocation+ 宣告加入 +<html>+ 根元素，像下面這樣：

	----
	<html xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.w3.org/1999/xhtml ../schema/htmlbook.xsd"
	xmlns="http://www.w3.org/1999/xhtml">
	----

	=== 注意事項

	* HTMLBook 是由 O'Reilly Media 開發，若有任何建議，可前往 https://github.com/oreillymedia/HTMLBook 新增議題討論，包含臭蟲提報與功能建議。

	* HTMLBook 的規格還在工作草稿階段，持續進行修改中。

	* 未來幾個月，將會增加一些額外的工具，便利編輯與製作 HTMLBook 的流程，包含：CSS 樣式表，轉製 EPUB/Mobi 流通格式的程序等等。