New/modified documentation

Author: ethantw

documentation/api/gelei_ziti_yu_zitiji.md

@@ -1,35 +1,79 @@
+<style scoped>
+table thead th:nth(n+2) {
+	width: 18.75%;
+}
+</style>
 
-各類字體與字體集 { #gelei_ziti_ji_zitiji }
+
+各類字體與字體集 { #gelei_ziti_yu_zitiji }
 ===
 
 
-「漢字標準格式」提供了針對各系統優化的「<span style="font-family: 'Han Heiti', sans-serif;">黑</span>、<span style="font-family: 'Han Songti', serif;">宋（明）</span>、<span style="font-family: 'Han Kaiti', cursive, serif;">楷</span>、<span style="font-family: 'Han Fangsong', cursive, serif;">仿宋</span>」共++四種_中_{ .pn }文字體集++及「國語注音符號楷體」、「標點符號」字體集等。藉由不同字體種類的搭配，你可以設計出各式精美的排版效果。
+「漢字標準格式」提供了針對各系統優化的「<span style="font-family: 'Han Heiti', sans-serif;">黑</span>、<span style="font-family: 'Han Songti', serif;">宋（明）</span>、<span style="font-family: 'Han Kaiti', cursive, serif;">楷</span>、<span style="font-family: 'Han Fangsong', cursive, serif;">仿宋</span>」[++四大_漢_{ .pn }字字體集++][the-4]及「[國語注音符號字體][zhuyin]」、「[西文_義大利_{.pn}體（斜體）][italic]」、「標點符號」字體等。藉由不同字體種類的搭配，設計師可以設計出各式精美的排版效果。
 
 <strong>註：</strong>多數行動裝置<em>僅支援</em>黑體。
 
+[the-4]: api/gelei_ziti_yu_zitiji#sida_zitiji
+[zhuyin]: api/gelei_ziti_yu_zitiji#zhuyin_fuhao
+[italic]: api/gelei_ziti_yu_zitiji#xiwen_yidaliti
+
+
 
-使用方式 { #shiyong_fangshi }
+四大字體集 { #sida_zitiji }
 ---
 
-<p class="poem-like" markdown="1">直接於<abbr lang="en-GB">CSS</abbr>字體宣告中引用字體集名稱。<br>
-黑：`'Han Heiti'`；<br>
-宋：`'Han Songti'`；<br>
-楷：`'Han Kaiti'`；<br>
-仿宋：`'Han Fangsong'`。<br>
-試讀以下範例代碼，</p>
+直接於<abbr lang="en-GB">CSS</abbr>字體宣告中引用字體集名稱，如下附表所示。
+
+
+
+地區字形標準 | <span style="font-family: 'Han Heiti', sans-serif; font-weight: normal;">黑體</span> | <span style="font-family: 'Han Songti', serif; font-weight: normal;">宋（明）體</span> | <span style="font-family: 'Han Kaiti', cursive, serif; font-weight: normal;">楷體</span> | <span style="font-family: 'Han Fangsong', cursive, serif; font-weight: normal;">仿宋</span>
+---- | ---- | ---- | ---- | ----
+預設 | `'Han Heiti'` | `'Han Sonti'` | `'Han Kaiti'` | `'Han Fangsong'`
+_台灣教育部_{.pn}標準字形 | | | `'Han Kaiti CNS'` | 
+_中國_{.pn}國家標準字形 | | | `'Han Kaiti GB'` | 
 
 
+試讀以下範例代碼，使用「宋（明）體」。
 
 	article:lang(zh) {
 		font-family: 'Biaodian Pro Serif', 'Han Songti', 'SC Songti', PMingLiU, SimSun, serif;
 	}
 
-國語注音符號（楷體）：`'Han Zhuyin'`
 
-	.mps {
-		font-family: 'Han Zhuyin', 'Han Kaiti', '標楷體', cursive, serif;
+### 注音符號 { #zhuyin_fuhao }
+
+使用字體「`'Han Zhuyin Cursive'`」（手寫楷體）或「`Han Zhuyin Sans`」（黑體），以顯示正確的「注音符號」。
+
+	span.mps {
+		font-family: 'Han Zhuyin Curisve', '標楷體', cursive, serif;
 	}
 
-雖然現時的瀏覽器皆支援「_漢_{ .pn }字標準格式」提供的字體集功能，我們仍然建議設計師使用適當的字體[[fallback]]{ :en-GB }（如上述代碼範例所示），確保在各種系統或瀏覽器上能有最大的支援度與一致性。
+**注意：**為了在各種瀏覽環境或系統顯示一致的注音符號字體，「_漢_{.pn}字標準格式」使用`@font-face`外連注音符號字體檔案。而此處所使用的注音符號字體係為_中華民國教育部_{.pn}所研發的「[教育部標準楷書][kai]」，並**採[創用CC「姓名標示–禁止改作–3.0_台灣_{.pn}版」][cc]授權**。
+
+[kai]: http://www.edu.tw/treasure/filedown.aspx?Node=1123&Index=2&WID=c5ad5187-55ef-4811-8219-e946fe04f725
+[cc]: http://creativecommons.org/licenses/by-nd/3.0/tw/
+
+
+
+西文義大利體 { #xiwen_yidaliti }
+---
+
+設計師可以任意調用使用於「[變音文字][alternative]」`<i>`元素的西文_義大利_{.pn}體（斜體），以符合排版需用。分為襯線「`'Latin Italic Serif'`」及非襯線「`'Latin Italic Sans'`」二種。
+
+[alternative]: hanzi_biaozhun_geshi/bianyin_wenzi
+
+
+	span.italic {
+		font-family: 'Biaodian Pro Serif', 'Latin Italic Serif', Georgia, 'Han Kaiti', STKaiti, '標楷體', DFKaiShu-SB-Estd-BF, cursive, serif;
+		font-style: normal;
+	}	
+
+
+
+---
+
+雖然現時標準的瀏覽器皆支援「_漢_{ .pn }字標準格式」提供的字體集功能，我們仍然建議設計師使用適當的字體[[fallback]]{ :en-GB }（如上述各範例代碼所示），確保在各種系統或瀏覽器上能有最大的支援度與一致性。
+
+另關於標點符號字體的設定，請參閱<cite class="piece">[標點符號樣式·啓用方式](./)</cite>。
+
 
-另關於標點符號字體的設定，請參閱<cite class="piece">[標點符號樣式·啓用方式](./)</cite>。

documentation/api/index.md

@@ -1,5 +1,5 @@
 
-三、開放接口及其他 { #api_ji_qita .manual }
+三、開放接口及其他 { #api .manual }
 ===
 
 _漢_ { .pn }字標準格式提供各式[[JavaScript]] { :en-GB }、[[CSS]] { :en-GB }的開放函式與小型功能，可經由設計師的調用來完善網頁排版，共包含下列3小節：

manual/documentation/api/javascript_jiekou-han.characterize.md renamed to documentation/api/javascript_jiekou-han.characterize.md

@@ -1,39 +1,109 @@
+<style scoped>
+article header:nth-of-type(1) ~ p:nth-of-type(1)::first-letter {
+	font-size: 3.5em;
+}
+</style>
+
 
 [[Modernizr]]{:en}補充集 { #modernizr_buchongji }
 ===
 
 
-<dfn>[[Modernizr]]{:en}補充集</dfn>係<abbr lang="en-GB">CSS</abbr>框架「[Modernizr]」概念的延伸（但不包含[[Modernizr]]{:en}提供的內容）。使用[[JavaScript]]{:en}偵測系統、瀏覽器版本之特殊功能的支援與否，並在標籤`<html>`上加入相應的類別，方便以|CSS|編寫相容於不同環境或支援條件的代碼。
+<dfn>[[Modernizr]]{:en}補充集</dfn>是以「|HTML|5／|CSS|3用戶端功能偵測庫——『[Modernizr]』」為概念設計的開放功能接口，提供了「Modernizr」未收錄、且與「_漢_{.pn}字標準格式」或_漢_{.pn}字相關的功能支援偵測。設計師能夠藉此偵測用戶端瀏覽器或作業系統對各功能的支援與否，並據各種支援程度提供不同的解決方案。
 
-[Modernizr]: http://www.modernizr.com/ { :en }
+[Modernizr]: http://modernizr.com/ { :en }
+**[HTML]: HyperText Markup Language { :en-GB }
+**[CSS]: Cascading Style Sheets { :en-GB }
 
-**[CSS]: Cascading Style Sheets { :en }
 
+「[[Modernizr]]{:en}補充集」區分有|CSS|端及JavaScript端二種用法，設計師可依使用需求選擇調用。
 
-「<u class="pn">漢</u>字標準格式」所用的<abbr lang="en-GB">CSS3</abbr>模組屬性 { #hanzibiaozhungeshi_suoyong_de_CSS3_mozu_shuxing }
----
 
-<dfn>「_漢_ { .pn }字標準格式」所用的|CSS|3模組屬性</dfn>包括著重號`text-emphasis`、引號`quotes`、文字方向`writing-mode`、欄位寛度`column-width`。以下為使用範例：
+#### JavaScript支援與否 { #zhiyuan_javascript_yufou }
+
+「[[Modernizr]]{:en}補充集」需要JavaScript方可運作，設計師可在|CSS|中調用類別「`.han-js`」確知JavaScript及`han.js`是否於用戶的瀏覽器上正常運作、載入。
 
-	.textemphasis [id^=lyrics-] .singing_loudlier {
-		text-emphasis:              dot;
-			-moz-text-emphasis:     dot;
-			-o-text-emphasis:       dot;
-			-webkit-text-emphasis:  dot;
+支援JavaScript的情況下，
+
+	.han-js div.js-support-msg:after {
+		content: '你的瀏覽器支援JavaScript並且正確載入了han.js。';
 	}
 
-	.no-textemphasis [id^=lyrics-] .singing_loudlier {
-		color: red;
+
+不支援的情況，
+
+	html:not(.han-js) div.js-support-msg:after {
+		content: '你的瀏覽器不支援JavaScript或未正確載入han.js。';
+	}
+
+
+
+## 功能支援偵測 { #gongneng_zhiyuan_zhence }
+
+「[[Modernizr]]{:en}補充集」提供了「[Modernizr]」未收錄、且與「_漢_{.pn}字標準格式」或_漢_{.pn}字相關的|HTML|5／|CSS|3功能支援偵測。下依各功能之_英_{.pn}語拉丁字母排序。
+
+功能名稱              | CSS類別名稱
+-------------------- | --------------------
+column-width         | `columnwidth`
+font-face            | `fontface`
+&lt;ruby&gt;         | `ruby`
+text-emphasis        | `textemphasis`
+quotes               | `quotes`
+writing-mode         | `writingmode`
+
+
+另有三種「字體集」的支援偵測，分別為，
+
+字體集名稱            | CSS類別名稱
+-------------------- | --------------------
+宋體（明朝體）         | `fontface-songti`
+楷體                  | `fontface-kaiti`
+仿宋體                | `fontface-fangsong`
+
+
+
+### 使用範例 { #shiyong_fanli }
+
+在|CSS|中，設計師可分別為「支援」與「不支援」（以`no-`為前綴）該功能的二種情況提供不同的樣式或解決方案。
+
+支援|CSS|3文字着重號屬性「`text-emphasis`」的瀏覽器將解讀下列代碼，
+
+	.textemphasis span.sarcasm {
+		text-emphasis: dot;
+			-moz-text-emphasis: dot;
+			-ms-text-emphasis: dot;
+			-webkit-text-emphasis: dot;
+	}
+
+不支援者則，
+
+	.no-textemphasis span.sarcasm {
+		border-bottom: 3px dotted;
 		font-weight: bolder;
 	}
 
 
+---
+
+
+[[JavaScript]] { :en-GB }端的物件 { #javascript_duan_de_wujian }
+---
+
+在JavaScript中，使用全域變數集「`han.support.功能類別名稱`」即可獲得一布林值，`true`表該功能在用戶端可使用，反之，`false`表示不支援。
+。
+
+
+### 特定字體／字體集支援函式
+
+在網頁*載入*後，呼叫「_漢_{.pn}字標準格式」字體支援偵測函式「`han.support.font('字體／字體集名稱')`」即可獲知一布林值，表示該字體／字體集在用戶端是否安裝或得以使用。
+
+
+#### 參見 { #canjian }
+
+詳閱下列說明文件，瞭解更詳盡的使用方式。
 
-	.quotes.stands_out {  quotes: "~~" "~~" "*" "*";  }
-	.quotes .stands_out:before {  content: open-quote;  }
-	.quotes .stands_out:after {  content: close-quote;  }
+1. <cite class="piece">[JavaScript接口·`han.support.[feature]`](api/javascript_jiekou-han.support.feature)</cite>
+2. <cite class="piece">[JavaScript接口·`han.support.font()`](api/javascript_jiekou-han.support.font)</cite>
 
-	.no-quotes .stands_out:before {  content: "~~";  }
-	.no-quotes .stands_out:after {  content: "~~";  }