From 0c73c707f63f4251c68b5a526633a776ae56b01e Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Thu, 18 Sep 2014 15:40:47 +0800
Subject: [PATCH 01/33] Add zh-TW folder

---
 manual/zh-TW/_old/README.md                   |  28 +
 manual/zh-TW/_old/basic-guidelines.md         |  33 ++
 manual/zh-TW/_old/comments.md                 | 106 ++++
 manual/zh-TW/_old/php.md                      | 477 ++++++++++++++++++
 manual/zh-TW/_old/preface.md                  |   8 +
 manual/zh-TW/appendices/analysis.md           |  37 ++
 manual/zh-TW/appendices/examples.md           |   1 +
 .../chapters/basic-guidelines.md              |  33 ++
 manual/zh-TW/coding-standards/chapters/css.md | 220 ++++++++
 .../coding-standards/chapters/docblocks.md    | 129 +++++
 .../zh-TW/coding-standards/chapters/html.md   | 342 +++++++++++++
 .../chapters/inline-comments.md               | 110 ++++
 .../coding-standards/chapters/javascript.md   | 475 +++++++++++++++++
 manual/zh-TW/coding-standards/chapters/php.md | 477 ++++++++++++++++++
 .../chapters/source-code-management.md        |  24 +
 manual/zh-TW/coding-standards/chapters/xml.md |  57 +++
 manual/zh-TW/coding-standards/introduction.md |  19 +
 manual/zh-TW/menu.md                          |  15 +
 manual/zh-TW/version.md                       |   1 +
 19 files changed, 2592 insertions(+)
 create mode 100644 manual/zh-TW/_old/README.md
 create mode 100644 manual/zh-TW/_old/basic-guidelines.md
 create mode 100644 manual/zh-TW/_old/comments.md
 create mode 100644 manual/zh-TW/_old/php.md
 create mode 100644 manual/zh-TW/_old/preface.md
 create mode 100644 manual/zh-TW/appendices/analysis.md
 create mode 100644 manual/zh-TW/appendices/examples.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/basic-guidelines.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/css.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/docblocks.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/html.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/inline-comments.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/javascript.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/php.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/source-code-management.md
 create mode 100644 manual/zh-TW/coding-standards/chapters/xml.md
 create mode 100644 manual/zh-TW/coding-standards/introduction.md
 create mode 100644 manual/zh-TW/menu.md
 create mode 100644 manual/zh-TW/version.md

diff --git a/manual/zh-TW/_old/README.md b/manual/zh-TW/_old/README.md
new file mode 100644
index 00000000..6154079b
--- /dev/null
+++ b/manual/zh-TW/_old/README.md
@@ -0,0 +1,28 @@
+Joomla 編碼標準中文版
+=============================
+
+The Joomla coding standard Chinese version.
+
+1. [前言 - Preface](preface.md) (完成)
+2. [基礎導覽 - Basic Guidelines](basic-guidelines.md) (完成)
+3. [註解 - Comments](comments.md) (未完成)
+4. [編碼標準 - PHP](php.md) (完成)
+
+-----
+
+讓一個軟體變得更好的因素，並不只在於其提供了多少優異的功能，而在於他的原始碼品質有多優良。為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。
+
+可讀性高的代碼也是易於維護的，且能夠指引我們實現依賴深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案的目標。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座能安全指引開發者編寫漂亮、乾淨代碼的燈塔，以避開懶惰所造成的陷阱。
+
+Joomla 的編碼標準大量的借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
+
+-----
+
+## 貢獻者
+
+* Asika - @asika32764
+* Michael - @michael520
+* Tim - @skylying
+* Leo - @gourrymk2
+* Lewis - @AEdesWeb
+* Benson - @bblurock 
diff --git a/manual/zh-TW/_old/basic-guidelines.md b/manual/zh-TW/_old/basic-guidelines.md
new file mode 100644
index 00000000..90852462
--- /dev/null
+++ b/manual/zh-TW/_old/basic-guidelines.md
@@ -0,0 +1,33 @@
+## 基礎大綱
+
+本章節旨在說明基礎的檔案規則
+
+## 檔案格式
+
+所有針對 Joomla 開發的檔案格式都必須存為 ASCII text、使用 UTF-8 編碼字型並且經過 Unix 格式化。以行為單位的程式碼必須使用換行字元(LF)作為結尾。換行字元的表示法為：10(序數)、012(八進位)、0A(十六進位)。不要使用純CR回車符(例如蘋果電腦)或是CRLF組合(例如windows電腦)。
+
+## 拼字
+
+所有使用在程式碼註解、類別、函式、變數、常數的命名原則都必須根據英式英文(en_GB)原則。但有些例外是可允許的，例如某些已內建在 PHP API 中常見的程式用語，或其他慣例用語如 "color" 這樣已制定的用法便可沿用美式英文
+
+## 縮排
+
+縮排一律使用 Tab 鈕(根據國際 PEAR 準則)。編碼時使用的 IDE 如 Eclipse 需設定 Tab 為4個空白字元長度。
+
+## 行寬
+
+原則上每行程式碼並沒有最大長度限制，但根據國際標準值，150字元能夠在不需要水平滾動的狀況下達到最好的可讀性。若遇到換行會影響輸出結果的情況(例如 PHP/HTML 混合的結構檔案)，更長的程式碼也是被允許的。
+
+## 優良範例
+
+以下提供一些外部資源，讓大家可以參考這些資源以及相關寫法：
+
+* [Joomla 開發者網路](http://developer.joomla.org/) - 所有開發相關資源都可由此尋找
+* [Joomla 開發教學文件](http://docs.joomla.org/Developers) - 官方完整的開發教學 Wiki
+* [PEAR 編碼標準](http://pear.php.net/manual/en/standards.php)
+* [Allman 縮排風格 (Wiki)](http://en.wikipedia.org/wiki/Indent_style#Allman_style)
+* [Joomla Coding Standards Github](https://github.com/joomla/coding-standards) - 儲存 PHP Codesniffer 設定檔等等
+* [Joomla CodeSniffer](http://docs.joomla.org/Joomla_CodeSniffer) - Joomla 開發過程與 IDE 的整合
+* [Secure coding guidelines](http://docs.joomla.org/Secure_coding_guidelines) - 安全性編碼導覽
+
+本清單將隨時補充~~~
diff --git a/manual/zh-TW/_old/comments.md b/manual/zh-TW/_old/comments.md
new file mode 100644
index 00000000..4482e7ef
--- /dev/null
+++ b/manual/zh-TW/_old/comments.md
@@ -0,0 +1,106 @@
+## 註解
+
+此章節將告訴您在程式碼中寫入詳細的文字註解。而在程式碼中的註解文字並不能加以插入文件區塊。為該程式碼下註解的目的就是解釋該段的程式碼的運作跟用途。
+
+註解能用可人為且易閱讀的方式去述敘該程式碼中複雜的運算，幫助瞭解程式碼之間的運作關係，下註解是值德鼓勵去實行的美德。
+
+註解盡可能的用一句話解釋完畢，應該是說，它們應該是有完整的思思並可以完全理解的，而不是只有太簡短而帶過。
+
+註解是不能代替詳細的文檔區塊。它是用來說明代碼本身的羅輯結構，而不是去使用程式碼。
+
+## 註解的格式
+
+註解一個區塊的程式碼或是超過兩行者應該使用(c)風格的'/**/'，並應與同一空間/標籤規則文檔塊的每一行使用'*'。 如果你需要一個大的引進考慮這個塊是否應被分為一個方法來降低複雜性並因此提供了一個完整的文檔塊。
+
+註解必需要處於一個優先的地位來解釋程式碼運作的方式。像是要做為一個參考或引用，註解的位置就應該不必跟程式碼置於同一行(與它們放在程式碼的後方做為一個引用)。它們必需跟自己同一行來放置。
+
+不要在每行的註解跟每行的程式碼之間插入空白行。(在註解的區塊中不要有空白行)
+
+應該是要用一個區塊的方式，也就是說程式碼一個區塊註解一個區塊，然後各個區塊間用一行空白行區隔。
+
+註解應該跟程式碼的縮排對齊以便優於參考，使用同縮排方式跟隨註解之後。
+
+註解應該要用(tab)來縮排。(跟程式碼一樣，而不是與文件區塊同排)。
+
+## 註解的內容表達
+
+註解的語系必需要是en-GB (請參考下方範例)。
+
+必需要在//與開頭之間有空隔。
+
+下一個新行的註解必需大寫以開頭，除非這個新行是延續上一個註解的句子。然而，程式碼是有分大小寫的。
+
+程式碼所含了特別的相容性去保證其它軟體的正常運作(例如一個特定的瀏覽器或特定的內容管理軟體或需要向下相容往後版本的理由)而必需要特別標明。如果有個不明確的未來或由理要移除這一段程式碼，則讓它處於一個不會去用到的舊程式碼或暫時的去做一個版本的發佈。
+
+在所有註解中檢查拼字跟語法。(請參考下方範例)。
+
+只使用一行來完整整個句子。
+
+而不是使用文件區塊，如果有適合下註解的方式可使用 See:、 Link: 和 Note: 這些標籤。
+
+除此之外有特別的關係去解釋該內容，則不要使用 HTML 於解註中。
+
+不要留下註解過的程式碼，除非有明確解釋這樣做的理由，在這樣的情況下，註解說明“程式碼需要被註解”則將不會意外移除。
+
+註釋可能包括一些程式碼可能在未來會有延展性來修改程式碼，表示了這個程式碼是不完整的或是要用來準備有前瞻性的陳述，也是不一個待辦事項。
+
+請記住幽默和諷剌是很難翻譯。
+
+## 縮寫字
+
+大寫首字母縮寫詞，如HTML，XML，SQL，GMT和UTC的所有字母。這些都是例外，一般使用EN-GB的規則。
+
+## 常見的拼寫和語法錯誤檢查。
+
+Joomla的貢獻者包括許多非母語的EN-GB，有時會有拼寫和語法錯誤，這使得它可以理解的。同時，有些人解讀評論也都是非母語，甚至可能使用自動翻譯理解的註釋。這使得它非常重要的意見應遵循正確的EN-GB的拼寫和語法規則。不幸的是，這可能會非常棘手。
+
+維基百科提供在en-US和en-GB之間很常見的差異做了一個很好的詮釋。http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences 請留意有某些情況下EN-GB的常見用法（而不是實際的規則）略高於EN-AU不相同，使用EN-AU被認為是可以接受的。
+
+### S 跟 Z 的對決
+
+EN-GB最常使用``ISE其中的en-US將使用`IZE`，比如`正常化，而不是'正常化'`。 （請注意，有一些例外情況和 en-GB 之間和 en-AU 共同使用一些差別。）
+
+使用單引號是英文的棘手的部分之一。
+
+### Lets 與 let’s
+
+Lets means permits or allows to:
+讓我們準許這樣做 :
+
+```php
+// This lets the user enter data
+// 這裡讓我們給使用者輸入一些資料
+```
+
+Let’s is a contraction for let us and means we are going to do this now:
+讓`我們的縮短為我們和這樣的意思來做:
+
+```php
+// Let's validate the field
+// 讓`我們檢查這個欄位
+```
+
+### Its versus it’s
+### 它是 和 它`是
+
+Its is the possessive form of it:
+它是它的所有格形式
+
+```php
+// Get its ID
+// 取得它的唉滴，俊郎....
+```
+
+It’s is a contraction of it is
+它`是它的一個縮寫
+
+```php
+// It's time to save
+// 它`是時候去解救了...俊郎郎郎
+```
+
+### 在 Joomla 下所拼寫一些常用的單詞。
+
+-   依賴的
+
+
diff --git a/manual/zh-TW/_old/php.md b/manual/zh-TW/_old/php.md
new file mode 100644
index 00000000..eae76d4a
--- /dev/null
+++ b/manual/zh-TW/_old/php.md
@@ -0,0 +1,477 @@
+## 語言結構
+
+### PHP 標籤
+
+永遠使用長標籤： `<?php ?>` 來包裹 PHP 程式碼，不使用短標籤 `<? ?>`。這可以確保您的程式碼可執行在大多數未經設定的主機環境。
+
+如果檔案中只包含PHP程式碼，則不應該包含結尾標籤 `?>`。這個標籤在 PHP 中不是必要的。這樣子可以避免在系統輸出前，不小心讓任何空白預先送出 header ，這會造成 Joomla 的 Session 功能錯誤 (參見 PHP 手冊的說明 [Instruction separation](http://php.net/basic-syntax.instruction-separation))。
+
+檔案結尾必須永遠由一個空行結束。
+
+### 引入程式
+
+當您想要無條件引入一個檔案時，應使用 `require_once`。當您要有條件的引入一個檔案（例如 factory 類別與其方法），則用 `include_once`。這兩者都可以確保檔案不被二次載入。兩種用法共享檔案清單，所以混用不會有任何問題。被 `require_once` 引入的檔案不會再被 `include_once` 引入一次。
+
+> **注意**
+>
+> `include_once` 與 `require_once` 是 PHP 關鍵字，不是函式，寫法應該如下:
+>
+>
+> `require_once JPATH_COMPONENT . ’/helpers/helper.php’;`
+
+您不應該把檔案路徑用括號包起來。
+
+### 兼容 E_STRICT 的 PHP 程式
+
+我們必須秉持並實踐 PHP 5.3 以上所支持的物件導向設計模式。Joomla! 一直致力於讓原始碼符合 E_STRICT 標準。
+
+## 全域變數
+
+盡量減少使用全域變數或超全域變數，用物件導向或工廠(Factory)模式替代之。
+
+## 控制結構
+
+所有的控制結構必須在關鍵字與起始括號之間放置一個空白字元，而開頭、結尾括號與邏輯判斷式之間無空格。這是為了區隔控制結構與函式以方便辨認，而括號內必須要包含邏輯。
+
+所有的控制結構關鍵字，如： `if`, `else`, `do`, `for`, `foreach`, `try`, `catch`, `switch` 與 `while` 皆採 [Allman](http://en.wikipedia.org/wiki/Indent_style#Allman_style) 風格，關鍵字本身必須在一個新行，而語言區塊（大括號）的開頭與結束也接需再一個新行中。
+
+### _if-else_ 範例
+
+```php
+if ($test)
+{
+	echo 'True';
+}
+
+// 註解可寫在此
+// 要注意的是 "elseif" 採用單一單字而非拆開成 "else if"
+
+elseif ($test === false)
+{
+	echo 'Really false';
+}
+else
+{
+	echo 'A white lie';
+}
+```
+
+如果控制結構的判斷式需要多行，則第二行開始需要一個 Tab 縮排，結尾括號需要再同一行上。
+
+```php
+if ($test1
+	&& $test2)
+{
+	echo 'True';
+}
+```
+
+### _do-while_ 範例
+
+
+```php
+do
+{
+	$i++;
+}
+while ($i < 10);
+```
+
+### _for_ 範例
+
+```php
+for ($i = 0; $i < $n; $i++)
+{
+	echo 'Increment = ' . $i;
+}
+```
+
+### _foreach_ 範例
+
+```php
+foreach ($rows as $index => $row)
+{
+	echo 'Index = ' . $id . ', Value = ' . $row;
+}
+```
+
+### _while_ 範例
+
+```php
+while (!$done)
+{
+	$done = true;
+}
+```
+
+### _switch_ 範例
+
+當使用 `switch` 時， `case` 關鍵字必須縮排一次，而 `break` 關鍵字必須獨立在新的一行，且相較於 `case` 再縮排一次。
+
+```php
+switch ($value)
+{
+	case 'a':
+		echo 'A';
+		break;
+
+	default:
+		echo 'I give up';
+		break;
+}
+```
+
+## 參照
+
+當使用變數參照時，參照符號應該距離等號一個空白字元，且跟後面的變數緊鄰，沒有空白。
+
+範例:
+
+```php
+$ref1 = &$this->sql;
+```
+
+> **注意**
+>
+> 在 PHP 5 ，物件不再需要參照符號，所有物件皆是參照。
+
+## 陣列
+
+陣列元素的指派可稍微排版，當多行時，可用 Tab 縮排。每行跟隨一個都逗號結尾，最後一行可包含逗號，這是 PHP 允許的寫法，對於程式碼 diff 比對時也有所幫助。
+
+範例:
+
+```php
+$options = array(
+	'foo'	=> 'foo',
+	'spam'	=> 'spam',
+);
+```
+
+## 註解
+
+行內註解可用 C 語言風格的 `/* ... */` 或 C++ 的單行註解 `// ...`。 C 風格的註解通常被用在文件開頭、類別、函式等等的文件標頭。而 C++ 風格單行註解則常用在程式解釋與提醒。註解對於幫助其他開發人員理解程式碼的目的有非常大的幫助，甚至包含您自己也能受惠。當程式碼開始進行複雜操作時，永遠記得要加上註解。至於 Perl 與 Shell 的井號 (`#`)註解則不建議使用，目前在 PHP 中也不再允許此類註解。
+
+您可以在某些情況下藉由註解掉整段程式碼或類別函式以用於調整程式功能，但應該在最終提交到核心前去除這些註解或不再需要的程式區塊。
+
+例如，不要在提交的程式碼中包含以下片段:
+
+```php
+// 這段程式碼未來需要修復
+//$code = broken($fixme);
+```
+
+### 文件區塊註解
+
+在 PHP、Javascript、檔案中的所有類別、成員屬性、方法與函式，皆需要區塊註解，並遵循 JavaDoc 或 phpDoc 的約定。
+
+這些 "區塊註解 (DocBlocks)" 從 PEAR 引用而來，但也為了 Joomla Framework 做了一點改變。
+
+雖然一般的縮排皆使用標準 Tab 來縮進，但區塊註解中，我們使用空格來排版，這提供了原始碼更優良的可讀性。任何文字元素，如標籤、變數的類型、變數名稱與標籤描述的最小距離必須是兩個空格。變數類型和標籤說明應分別按照最長的標籤和變數類型、變數描述對齊。
+
+如果使用了 `@package` 標籤，必須是 "Joomla.Platform"。
+
+除果使用了 `@subpackage` ，必須是 /joomla/ 資料夾下的頂層目錄名稱，例如: Application, Database, Html 等等。
+
+> 註: 在 Joomla Framework 中，不再使用 `@package` 與 `@subpackage`。
+
+貢獻給 Joomla 的程式碼，將成為專案的資產，不允許擁有 `@author` 標籤。你應該在 CREDITS.php 更新貢獻紀錄。Joomla 的理念是這樣的，所有的程式是一起發展編寫出來的，並沒有任何一個人擁有任何代碼中的一個部分。不過 `@author` 標籤允許使用在被包含進核心函式庫的第三方函式庫。
+
+從第三方函式庫引入的檔案，其區塊註解必須完好無損。Layout 的檔案使用跟其他 PHP 檔案一樣的區塊註解。
+
+### 檔案文件標頭註解
+
+文件標頭註解有以下內容且按照順序
+
+-   簡易說明 (選填, 除非超過兩個以上類別或方法) 結束空一行.
+-   完整說明 (選填) 結束空一行.
+-   `@category` (選填)
+-   `@package` (通常是選填, 但如果檔案只包含程序邏輯(無類別)則必填)
+-   `@subpackage` (選填)
+-   `@author` (選填, 但只允許在非的Joomla源文件，例如，包括第三方函式庫例如 Geshi)
+-   `@copyright` (必填)
+-   `@license` (必填且必須是相容於 Joomla 所使用的授權條款)
+-   `@deprecated` (選填)
+-   `@link` (選填)
+-   `@see` (選填)
+-   `@since` (通常是選填，但如果檔案只包含程序邏輯(無類別)則必填)
+
+```
+/**
+ * @package     Joomla.Platform
+ * @subpackage  Database
+ * @copyright   Copyright 2005 - 2010 Open Source Matters. All rights re-served.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+```
+
+## 函式呼叫
+
+呼叫函式時, 函式名稱跟參數括號中不能有空白, 而第一個帶入參數也不得有空白; 每個參數逗點後一個空白隔開 (如果有的話), 最後一個參數跟括號沒有空格. 參數帶值等號前後需有空白. 可以多行對齊.
+
+```php
+// 單函式呼叫
+$foo = bar($var1, $var2);
+
+// 多函式呼叫
+$short  = bar('short');
+$medium = bar('medium');
+$long   = bar('long');
+```
+
+## 函式定義
+
+函式定義需開始並獨立於一新行，開始與結束的括號也需分別被放置於一新行。在負責處理回傳值的程式碼前應插入一空行。
+
+函數定義必須包含註解說明，根據本文件中的註解章節所規範之規則予以撰寫。
+
+-   簡易說明 (必要，結束需空一行)
+-   完整說明 (選填，結束需空一行)
+-   `@param` (若函式有參數則此欄位為必要，並於最後一個`@param`標簽之後新增一空行)
+-   `@return` (必要，結束需空一行)
+-   其餘標簽依據字母順序排列，需注意 @since 標籤永遠為必要。
+
+```php
+/**
+ * An utility class.
+ *
+ * @package     Joomla.Platform
+ * @subpackage  XBase
+ *
+ * @param       string  $path  The library path in dot notation.
+ *
+ * @return      void
+ *
+ * @since       1.6
+ */
+function jimport($path)
+{
+	// Body of method.
+}
+```
+
+如果一個函數定義橫跨數行，第二行起的每一行皆需以一個 tab 作縮排，結束括號需與最後一個參數存在於同一行。
+
+```php
+function fooBar($param1, $param2,
+	$param3, $param4)
+{
+	// Body of method.
+}
+```
+
+## 類別定義
+
+類別定義需開始並獨立於一新行，開始與結束的括號也需被分別放置於一新行。類別方法(Class Methods)需根據函數定義標準來撰寫。類別的屬性及方法需根據物件導向(OOP)標準適當宣告(使用適合的 public, protected, private 和 static 等屬性)
+
+類別的定義、屬性及方法皆需撰寫對應的註解區塊(DocBlock)，根據接下來的準則規範。
+
+### 類別註解區塊標頭
+
+類別註解區塊包含以下必要及非必要欄位，並依照下列順序排列。
+
+-   簡易說明(必要，除非該檔案擁有兩個以上之類別或函數)
+-   完整說明(選填，結束需空一行)
+-   `@category` (選填，很少用到)
+-   `@package` (必要)
+-   `@subpackage` (選填)
+-   `@author` (選填，但只允許在非joomla的程式碼中，舉例來說，如：使用第三方函式庫如Geshi)
+-   `@copyright` (選填，除非與檔案文件註解表頭(file Docblock)不同)
+-   `@license` (選填，除非與檔案文件註解表頭(file Docblock)不同)
+-   `@deprecated` (選填)
+-   `@link` (選填)
+-   `@see` (選填)
+-   `@since` (必填, 根據類別第一次出現時的程式版本號)
+
+### 類別屬性註解區塊
+
+類別屬性註解區塊包含以下必要及非必要欄位，並依照下列順序排列。
+
+-   簡易說明(必要，除非該檔案擁有兩個以上之類別或函數)
+-   `@var` (必要，於該屬性後其後註明屬性種類(property type))
+-   `@deprecated` (選填)
+-   `@since` (必填)
+
+### 類別方法註解區塊
+
+類別方法註解區塊是依據PHP函式之規則做撰寫(如上述)。
+
+```php
+/**
+ * An utility class.
+ *
+ * @package     Joomla.Platform
+ * @subpackage  XBase
+ * @since       1.6
+ */
+class JClass extends JObject
+{
+	/**
+	 * Human readable name
+	 *
+	 * @var    string
+	 * @since  1.6
+	 */
+	public $name;
+
+	/**
+	 * Method to get the name of the class.
+	 *
+	 * @param   string  $case  Optionally return in upper/lower case.
+	 *
+	 * @return  boolean  True if successfully loaded, false otherwise.
+	 *
+	 * @since   1.6
+	 */
+	public function getName($case = null)
+	{
+		// Body of method.
+
+		return $this->name;
+	}
+}
+```
+
+## 命名慣例
+
+### 類別
+
+類別應給予描述性的名稱。在可能的情況下應避免縮寫。類別名稱總是以一個大寫字母開頭，且採用駝峰式 (CamelCase) 命名法則，即便名字中包含傳統上常用大寫的字彙(如 HTML, XML)。唯一例外是必須由 J 開頭的核心類別後面可接上一個大寫字母。
+
+範例:
+
+-   JHtmlHelper
+-   JXmlParser
+-   JModel
+
+### 函式與方法
+
+函式與方法採用 "studly caps" 風格 (也稱作 "bumpy case" 或 "camel caps")。 名稱起始的字母必須是小寫，而每個新單字的首個字母為大寫。而在 Joomla 框架中的函式必須由小寫字母 'j' 開頭。
+
+範例:
+
+-   connect();
+-   getData();
+-   buildSomeWidget();
+-   jImport();
+-   jDoSomething();
+
+類別的私有成員屬性 (就是說只被用在他所宣告出來的類別內部的成員屬性) ，開頭有一個底線。屬性名稱採用底線命名風格 (也就是說，單字被底線區  隔開來)，且應該全部小寫。
+
+範例:
+
+```php
+class JFooHelper
+{
+	protected $field_name = null;
+
+	private $_status = null;
+
+	protected function sort()
+	{
+	}
+}
+```
+
+### 常數
+
+常數應永遠為大寫，並用底線分隔單字。總是在常數前加上 `J` 且運用一些眾人常識和慣例來避免常數名稱太長。你 *應該* 使用類別或封包 (package) 中已經使用的名稱。例如在 'Joomla\Application\Web\Router' 中的常數，以 `JRoute_` 開頭。
+
+### 全域變數
+
+不要使用全域變數。採用靜態類別與屬性或常數替代。
+
+### 一般情況下的變數與類別屬性
+
+一般情況下的變數，遵循函式的慣例。
+
+類別的屬性應該設為 null 或其他適當的預設值。
+
+## 例外處理
+
+例外處理應當只用於錯誤處理上。
+
+下面的章節將指出如何照語意使用 [PHP 標準函式庫 (SPL) 的 Exceptions](http://php.net/manual/en/spl.exceptions.php)。
+
+### 邏輯例外 LogicException
+
+在 API 的使用方式上發生的明確問題會丟出 LogicException 的例外。例如：如果有個依賴參數失效時（你試圖操作一個未被載入的物件）。
+
+下方的子類別也可被用於適當的情境下：
+
+#### BadFunctionCallException
+
+如果一個 callback 參照到一個未定義的函式(function) 或是缺少了一些參數時可以丟出該例外。例如：如果 `is_callable()` 或其他類似的函式用在一個函式(function)上時得到失敗的結果。
+
+#### BadMethodCallException
+
+如果一個 callback 參照到一個未定義的方法(method) 或是缺少了一些參數時可以丟出該例外。例如：如果 `is_callable()` 或其他類似的函式用在一個方法(method)上時得到失敗的結果。 另一個例子可能是找不到某些使用魔術方法的參數。
+
+#### InvalidArgumentException
+
+當有不合規格的輸入發生時丟出該例外。
+
+#### DomainException
+
+該例外和 InvalidArgumentException 類似，但會在一數值未依附在一已定義的有效資料群集的情形下丟出該例外。例如：試圖載入一個"mongodb"的資料庫引擎，但該引擎尚未在 API 中實作。
+
+#### LengthException
+
+當作一參數的長度檢查失敗時丟出該例外。例如：一個檔案的雜湊值不是一個指定長度的字串。
+
+#### OutOfRangeException
+
+該例外較少被實際的應用，但可在存取一個非法的索引值時丟出該例外。
+
+### 執行期例外 RuntimeException
+
+當外部實體或環境造成你無法控制的問題因而產生錯誤時，便丟出 RuntimeException 的例外。當一個錯誤的產生不能明確地被判斷出來時，預設丟出該例外。例如：你試圖連到資料庫但資料庫卻無法使用 (伺服器掛掉之類的)。另一個例子可能為 SQL 查詢語句的錯誤。
+
+#### UnexpectedValueException
+
+當一個非預期的結果發生時應當丟出該種類的例外。例如：當一個函式預期是要回傳布林值卻回傳字串時。
+
+#### OutOfBoundsException
+
+該例外較少實際的應用，但也許當某個值不為合法的索引值時丟出該例外。
+
+#### OverflowException
+
+該例外較少實際的應用，但也許當你加入一個元素到已經滿載的容器物件時丟出該例外。
+
+#### RangeException
+
+該例外較少實際的應用，但也許在程式執行期間丟出該例外以指出一個範圍的錯誤。通常這是指除了運算虧位/溢位之外的錯誤。該例外為 DomainException 的 runtime 版本。
+
+#### UnderflowException
+
+該例外較少實際的應用，但也許當你從一個空的容器物件中移除一個元素時丟出該例外。
+
+### 例外處理的文件撰寫
+
+每個函式(function)或方法(method)必須要註解使用到的例外，用 @throws 的標籤和丟出例外的物件名稱作註解。每種例外只須備被註解一次。註解的說明非必須。
+
+## SQL 查詢語句
+
+SQL 的保留字要全用大寫，其他的文字符號 (當然被引號包起來的文字為例外) 為小寫。
+
+全部的 table 名稱必須要用 `#__` 的前綴字而不是用 `jos_` 去讀取 Joomla 的內容，並允許替換為使用者定義的資料庫前綴字。查詢語句也必須使用 JDatabaseQuery API。
+
+```php
+// Get the database connector.
+$db = JFactory::getDBO();
+
+// Get the query from the database connector.
+$query = $db->getQuery(true);
+
+// Build the query programatically (using chaining if desired).
+$query->select('u.*')
+	// Use the qn alias for the quoteName method to quote table names.
+	->from($db->qn('#__users').' AS u'));
+
+// Tell the database connector what query to run.
+$db->setQuery($query);
+
+// Invoke the query or data retrieval helper.
+$users = $db->loadObjectList();
+```
diff --git a/manual/zh-TW/_old/preface.md b/manual/zh-TW/_old/preface.md
new file mode 100644
index 00000000..16575742
--- /dev/null
+++ b/manual/zh-TW/_old/preface.md
@@ -0,0 +1,8 @@
+# Preface - 前言
+
+讓一個軟體變得更好的因素，並不只在於其提供了多少優異的功能，而在於他的原始碼品質有多優良。為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。
+
+可讀性高的代碼也是易於維護的，且能夠指引我們實現依賴深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案的目標。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座能安全指引開發者編寫漂亮、乾淨代碼的燈塔，以避開懶惰所造成的陷阱。
+
+Joomla 的編碼標準大量的借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
+
diff --git a/manual/zh-TW/appendices/analysis.md b/manual/zh-TW/appendices/analysis.md
new file mode 100644
index 00000000..a534f7da
--- /dev/null
+++ b/manual/zh-TW/appendices/analysis.md
@@ -0,0 +1,37 @@
+## Coding Standards Analysis
+
+For new contributions we are going to be enforcing coding standards to ensure that the coding style in the source code is consistent. Ensuring that your code meets these standards will make the process of code contribution smoother.
+
+## Configuring Code Analysis Tools
+
+In order to improve the consistency and readability of the source code, the Joomla project runs a coding style analysis tool, CodeSniffer, everytime changes are pushed to a Joomla project's repository. 
+
+### Running CodeSniffer
+
+The Joomla Coding Standards sniffer rules are written to be used with a tool called PHP CodeSniffer. Please see the [PHP CodeSniffer Pear
+Page](http://pear.php.net/package/PHP_CodeSniffer) for information on
+installing PHP CodeSniffer on your system.
+
+You can run the CodeSniffer by going to the CMS, Framework, or Issue Tracker's root directory and executing 
+
+```
+phpcs --report=checkstyle --report-file=build/logs/checkstyle.xml --standard=/path/to/<your root>/build/phpcs/Joomla /path/to/<your root>
+```
+
+Alternatively, if you have Ant installed on your system, you may run the CodeSniffer by going to the `<root directory>` of the Joomla project's code you want to test and executing
+
+```
+ant phpcs
+```
+
+#### Known Issues
+
+-   There is currently an issue with running the Code Sniffer on the
+    Simplepie library. Pointing the sniffs at the libraries/joomla
+    directory or below will avoid the issue.
+
+## Other Tools
+
+Here are some other tools available to developers who are planning to submit source code to the project.
+
+### PhpStorm Code Style Scheme
diff --git a/manual/zh-TW/appendices/examples.md b/manual/zh-TW/appendices/examples.md
new file mode 100644
index 00000000..7fda47f1
--- /dev/null
+++ b/manual/zh-TW/appendices/examples.md
@@ -0,0 +1 @@
+## Code Examples
\ No newline at end of file
diff --git a/manual/zh-TW/coding-standards/chapters/basic-guidelines.md b/manual/zh-TW/coding-standards/chapters/basic-guidelines.md
new file mode 100644
index 00000000..90852462
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/basic-guidelines.md
@@ -0,0 +1,33 @@
+## 基礎大綱
+
+本章節旨在說明基礎的檔案規則
+
+## 檔案格式
+
+所有針對 Joomla 開發的檔案格式都必須存為 ASCII text、使用 UTF-8 編碼字型並且經過 Unix 格式化。以行為單位的程式碼必須使用換行字元(LF)作為結尾。換行字元的表示法為：10(序數)、012(八進位)、0A(十六進位)。不要使用純CR回車符(例如蘋果電腦)或是CRLF組合(例如windows電腦)。
+
+## 拼字
+
+所有使用在程式碼註解、類別、函式、變數、常數的命名原則都必須根據英式英文(en_GB)原則。但有些例外是可允許的，例如某些已內建在 PHP API 中常見的程式用語，或其他慣例用語如 "color" 這樣已制定的用法便可沿用美式英文
+
+## 縮排
+
+縮排一律使用 Tab 鈕(根據國際 PEAR 準則)。編碼時使用的 IDE 如 Eclipse 需設定 Tab 為4個空白字元長度。
+
+## 行寬
+
+原則上每行程式碼並沒有最大長度限制，但根據國際標準值，150字元能夠在不需要水平滾動的狀況下達到最好的可讀性。若遇到換行會影響輸出結果的情況(例如 PHP/HTML 混合的結構檔案)，更長的程式碼也是被允許的。
+
+## 優良範例
+
+以下提供一些外部資源，讓大家可以參考這些資源以及相關寫法：
+
+* [Joomla 開發者網路](http://developer.joomla.org/) - 所有開發相關資源都可由此尋找
+* [Joomla 開發教學文件](http://docs.joomla.org/Developers) - 官方完整的開發教學 Wiki
+* [PEAR 編碼標準](http://pear.php.net/manual/en/standards.php)
+* [Allman 縮排風格 (Wiki)](http://en.wikipedia.org/wiki/Indent_style#Allman_style)
+* [Joomla Coding Standards Github](https://github.com/joomla/coding-standards) - 儲存 PHP Codesniffer 設定檔等等
+* [Joomla CodeSniffer](http://docs.joomla.org/Joomla_CodeSniffer) - Joomla 開發過程與 IDE 的整合
+* [Secure coding guidelines](http://docs.joomla.org/Secure_coding_guidelines) - 安全性編碼導覽
+
+本清單將隨時補充~~~
diff --git a/manual/zh-TW/coding-standards/chapters/css.md b/manual/zh-TW/coding-standards/chapters/css.md
new file mode 100644
index 00000000..91979236
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/css.md
@@ -0,0 +1,220 @@
+## CSS
+These guidelines have been assembled following an examination of emerging practices, ideas and existing styleguides, namely:
+
+1. [OOCSS Code Standards](https://github.com/stubbornella/oocss-code-standards)
+2. [Oneweb Style Guide](https://github.com/nternetinspired/OneWeb/blob/master/STYLEGUIDE.md)
+3. [Idiomatic CSS](https://github.com/necolas/idiomatic-css)
+
+
+## Commenting
+
+### Major sections
+Major code sections should be named in caps and within a full comment block, eg:
+```css
+/* ==========================================================================
+   PRIMARY NAVIGATION
+   ========================================================================== */
+```
+
+### Sub sections
+Subsections should be normally cased and within an open comment block.
+```css
+/* Mobile navigation
+   ========================================================================== */
+```
+
+### Verbose comments
+```css
+/**
+ * Short description using Doxygen-style comment format
+ *
+ * The first sentence of the long description starts here and continues on this
+ * line for a while finally concluding here at the end of this paragraph.
+ *
+ * The long description is ideal for more detailed explanations and
+ * documentation. It can include example HTML, URLs, or any other information
+ * that is deemed necessary or useful.
+ *
+ * @tag This is a tag named 'tag'
+ *
+ * TODO: This is a todo statement that describes an atomic task to be completed
+ *   at a later date. It wraps after 80 characters and following lines are
+ *   indented by 2 spaces.
+ */
+ ```
+
+### Basic comments
+```css
+/* Basic comment */
+```
+
+### Uncompiled LESS/Scss comments
+```css
+// These are stripped on compile.
+```
+
+## Class naming
+Use dashes to create compound class names:
+
+```css
+/* Good - use dashes */
+.compound-class-name {…}
+
+/* Bad - uses underscores */
+.compound_class_name {…}
+
+/* Bad - uses camelCase */
+.compoundClassName {…}
+
+/* Bad - does not use seperators */
+.compoundclassname {…}
+```
+
+### Indentation
+Rules should be indented one tab (equal to 4 spaces):
+
+```css
+/* Good */
+.example {
+	color: #000;
+	visibility: hidden;
+}
+
+/* Bad - all on one line */
+.example {color: #000; visibility: hidden;}
+```
+
+LESS/Scss should also be nested , with child selectors and rules indented again. Nested rules should also be spaced by one line:
+
+```css
+/* Good */
+.example {
+
+  > li {
+    float: none;
+
+	+ li {
+		margin-top: 2px;
+		margin-left: 0;
+	}
+
+  }
+
+}
+/* Bad - nested rules not indented */
+.example {
+
+	> li {
+	float: none;
+
+	+ li {
+	margin-top: 2px;
+	margin-left: 0;
+	}
+
+	}
+
+}
+/* Bad - nested rules not spaced */
+.example {
+  > li {
+    float: none;
+	+ li {
+		margin-top: 2px;
+		margin-left: 0;
+	}
+  }
+}
+```
+
+### Alignment
+The opening brace must be on the same line as the last selector and preceded by a space. The closing brace must be on its own line after the last property and be indented to the same level as the opening brace.
+
+```css
+/* Good */
+.example {
+    color: #fff;
+}
+
+/* Bad - closing brace is in the wrong place */
+.example {
+    color: #fff;
+    }
+
+/* Bad - opening brace missing space */
+.example{
+    color: #fff;
+}
+```
+
+### Property Format
+Each property must be on its own line and indented one level. There should be no space before the colon and one space after. All properties must end with a semicolon.
+
+```css
+/* Good */
+.example {
+    background: black;
+    color: #fff;
+}
+
+/* Bad - missing spaces after colons */
+.example {
+    background:black;
+    color:#fff;
+}
+
+/* Bad - missing last semicolon */
+.example {
+    background: black;
+    color: #fff
+}
+```
+
+### HEX values
+HEX values must be declared in lowercase and shorthand:
+```css
+/* Good */
+.example {
+    color: #eee;
+}
+
+/* Bad */
+.example {
+    color: #EEEEEE;
+}
+```
+
+### Attribute selectors
+Always use double quotes around attribute selectors.
+
+```css
+/* Good */
+input[type="button"] {
+    ...
+}
+
+/* Bad - missing quotes */
+input[type=button] {
+    ...
+}
+
+/* Bad - using single quote */
+input[type='button'] {
+    ...
+}
+```
+
+### Zero value units
+Zero values should not carry units.
+
+```css
+/* Good */
+.example {
+   padding: 0;
+}
+
+/* Bad - uses units */
+.example {
+   padding: 0px;
+}
+```
diff --git a/manual/zh-TW/coding-standards/chapters/docblocks.md b/manual/zh-TW/coding-standards/chapters/docblocks.md
new file mode 100644
index 00000000..74965f46
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/docblocks.md
@@ -0,0 +1,129 @@
+## DocBlocks
+
+Documentation headers for PHP code in: files, classes, class properties, methods and functions, called the docblocks, follow a convention similar to JavaDoc or phpDOC.
+
+These "DocBlocks" borrow from the PEAR standard but have some variations specific for Joomla and the Joomla projects.
+
+Whereas normal code indenting uses real tabs, all whitespace in a Docblock uses real spaces. This provides better readability in source code browsers. The minimum whitespace between any text elements, such as tags, variable types, variable names and tag descriptions, is two real spaces. Variable types and tag descriptions should be aligned according to the longest Docblock tag and type-plus-variable respectively.
+
+Code contributed to the Joomla project that will become the copyright of the project is not allowed to include @author tags. You should update the contribution log in CREDITS.php. Joomla's philosophy is that the code is written "all together" and there is no notion of any one person "owning" any section of code. The @author tags are permitted in third-party libraries that are included in the core libraries.
+
+Files included from third party sources must leave DocBlocks intact. Layout files use the same DocBlocks as other PHP files.
+
+### File DocBlock Headers
+The file header DocBlock consists of the following required and optional elements in the following order:
+Short description (optional unless the file contains more than two classes or functions), followed by a blank line). Long description (optional, followed by a blank line).
+
+* @category (optional and rarely used)
+* @package (generally optional but required when files contain only procedural code)
+* @subpackage (optional)
+* @author (optional but only permitted in non-Joomla source files, for example, included third-party libraries like Geshi)
+* @copyright (required)
+* @license (required and must be compatible with the Joomla license)
+* @deprecated (optional)
+* @link (optional)
+* @see (optional)
+* @since (generally optional but required when files contain only procedural code)
+
+Example of a DocBlock Header:
+
+```php
+/**
+ * @package     Joomla.Installation
+ * @subpackage  Controller
+ *
+ * @copyright   Copyright (C) 2005 - 2014 Open Source Matters, Inc. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+```
+
+### Class Definitions
+Class definitions start on a new line and the opening and closing braces are also placed on new lines. Class methods must follow the guidelines for Function Definitions. Properties and methods must follow OOP standards and be declared appropriately (using public, protected, private and static as applicable).
+Class definitions, properties and methods must each be provided with a DocBlock in accordance with the following sections.
+
+#### Class DocBlock Headers
+The class Docblock consists of the following required and optional elements in the fol-lowing order.
+Short description (required, unless the file contains more than two classes or functions), followed by a blank line). Long description (optional, followed by a blank line).
+* @category (optional and rarely used)
+* @package (required)
+* @subpackage (optional)
+* @author (optional but only permitted in non-Joomla source files, for example, included third-party libraries like Geshi)
+* @copyright (optional unless different from the file Docblock)
+* @license (optional unless different from the file Docblock)
+* @deprecated (optional)
+* @link (optional)
+* @see (optional)
+* @since (required, being the version of the software the class was introduced)
+
+Example of a Class file DocBlock header:
+```php
+/**
+ * Controller class to initialise the database for the Joomla Installer.
+ *
+ * @package     Joomla.Installation
+ * @subpackage  Controller
+ * @since       3.1
+ */
+```
+
+#### Class Property DocBlocks 
+The class property Docblock consists of the following required and optional elements in the following order.
+Short description (required, followed by a blank line)
+
+* @var (required, followed by the property type)
+* @deprecated (optional)
+* @since (required)
+
+Example of Class property DocBlock:
+
+```php
+	/**
+	 * The generated user ID
+	 *
+	 * @var    integer
+	 * @since  3.1
+	 */
+	protected static $userId = 0;
+```
+
+
+
+#### Class Method DocBlocks and Functions DocBlocks
+Function definitions start on a new line and the opening and closing braces are also placed on new lines. An empty line should precede lines specifying the return value.
+
+Function definitions must include a documentation comment in accordance with the Commenting section of this document.
+
+* Short description (required, followed by a blank line)
+* Long description (optional, followed by a blank line)
+* @param (required if there are method or function arguments, the last @param tag is followed by a blank line)
+* @return (required, followed by a blank line)
+* All other tags in alphabetical order, however @since is always required.
+
+Example of Method DocBlock:
+```php
+	/**
+	 * Set a controller class suffix for a given HTTP method.
+	 *
+	 * @package Joomla.Framework
+	 * @subpackage Router 
+	 *
+	 *
+	 * @param   string  $method  The HTTP method for which to set the class suffix.
+	 * @param   string  $suffix  The class suffix to use when fetching the controller name for a given request.
+	 *
+	 * @return  Router  Returns itself to support chaining.
+	 *
+	 * @since   1.0
+	 */
+	public function setHttpMethodSuffix($method, $suffix)
+```
+
+If a function definition goes over multiple lines, all lines must be indented with one tab and the closing brace must go on the same line as the last parameter.
+
+```php
+function fooBar($param1, $param2, 
+    $param3, $param4) 
+{ 
+    // Body of method. 
+}
+```
diff --git a/manual/zh-TW/coding-standards/chapters/html.md b/manual/zh-TW/coding-standards/chapters/html.md
new file mode 100644
index 00000000..9a7a641f
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/html.md
@@ -0,0 +1,342 @@
+## html
+
+These guidelines have been assembled following an examination of emerging practices, ideas and existing styleguides, and include items from:
+
+1. [Google's html styleguide](http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml)
+2. [JQuery's HTML Styleguide](http://contribute.jquery.org/style-guide/html/)
+3. [Nicolas Ghallager's "Principles of writing consistent, idiomatic HTML"](https://github.com/necolas/idiomatic-html)
+4. [Harry Robert's "My HTML/CSS coding style"](http://csswizardry.com/2012/04/my-html-css-coding-style/)
+4. [The BBC's Media Standards and Guidelines](http://www.bbc.co.uk/guidelines/futuremedia/technical/semantic_markup.shtml)
+
+
+### Doctype
+
+Always use the minimal, versionless doctype.
+
+```html
+<!doctype html>
+```
+
+### Language
+
+Always define which language the page is written in.
+
+```html
+<html lang="en">
+```
+
+### Encoding
+Always define the character encoding. The encoding should be defined as early as possible.
+Make sure your editor uses UTF-8 as character encoding, without a byte order mark (UTF-8, no BOM).
+Do not specify the encoding of style sheets as these assume UTF-8.
+
+```html
+<meta charset="utf-8">
+```
+
+[More on encodings and when and how to specify them can be found in Handling character encodings in HTML and CSS](http://www.w3.org/International/tutorials/tutorial-char-enc/)
+
+
+### Capitalisation
+All html should be lowercase; element names, attributes, attribute values (unless text/CDATA), CSS selectors, properties, and property values (with the exception of strings). Additionally, there is no need to use CDATA to escape inline JavaScript, formerly a requirement to meet XML strictness in XHTML.
+
+```html
+<!-- Good -->
+<img src="joomla.png" alt="Joomla">
+
+<!-- Bad -->
+<A HREF="/">Home</A>
+```
+
+```html
+<!-- Good -->
+a {
+    color: #a3a3a3;
+}
+
+<!-- Bad -->
+a {
+    color: #A3A3A3;
+}
+```
+
+### Protocol
+
+Omit the protocol portion (http:, https:) from URLs pointing to images and other media files, style sheets, and scripts unless they are not available over both protocols.
+
+This prevents mixed content issues and results in minor file size savings.
+
+```html
+<!-- Good -->
+<link rel="stylesheet" href="//joomla.org/css/main.css">
+
+<!-- Bad -->
+<link rel="stylesheet" href="http://joomla.org/css/main.css">
+```
+
+### Elements and Attributes
+
+Always include html, head, and body tags.
+
+### Type attributes
+Do not use type or attributes for style sheets (unless not using CSS) and scripts (unless not using JavaScript).
+```html
+<!-- Good -->
+<link rel="stylesheet" href="//joomla.org/css/main.css">
+
+<!-- Bad -->
+<link rel="stylesheet" href="//joomla.org/css/main.css" type="text/css">
+```
+
+### Language attributes
+Do not use language attributes on script tags.
+```html
+<!-- Good -->
+<script href="//code.jquery.com/jquery-latest.js">
+
+<!-- Bad -->
+<script href="//code.jquery.com/jquery-latest.js" language="javascript">
+```
+
+
+### Attributes
+
+Attribute values should be quoted using double ("") quotes. Optional attributes should be omitted.
+```html
+<!-- Good -->
+<script src="//code.jquery.com/jquery-latest.js"></script>
+<!-- Bad -->
+<script src='//code.jquery.com/jquery-latest.js'></script>
+```
+
+Use attribute/value pairs for boolean attributes
+```html
+<!-- Good -->
+<input type="checkbox" value="on" checked="checked">
+<!-- Bad -->
+<input type="checkbox" value="on" checked>
+```
+
+HTML attributes should be listed in an order that reflects the fact that class names are the primary interface through which CSS and JavaScript select elements.
+
+1. class
+2. id
+3. data-*
+4. Everything else
+```html
+<!-- Good -->
+<a class="[some-value]" id="[some-value]" data-name="[some-value]" href="[some-value]">Text</a>
+<!-- Bad -->
+<a href="[some-value]" class="[some-value]" id="[some-value]" data-name="[some-value]">Text</a>
+```
+
+Elements with multiple attributes can have attributes arranged across multiple lines in an effort to improve readability and produce more useful diffs:
+
+```html
+<a class="[some-value]"
+ data-action="[some-value]"
+ data-id="[some-value]"
+ href="[some-value]">
+    <span>Text</span>
+</a>
+```
+
+### Elements
+Optional closing tags may not be omitted.
+```html
+<!-- Good -->
+<p>The quick brown fox jumps over the lazy dog.</p>
+<!-- Bad -->
+<p>The quick brown fox jumps over the lazy dog.
+```
+
+Self-closing (void) elements should not be closed. Trailing forward slashes and spaces should be omitted.
+```html
+<!-- Good -->
+<img src="//images/logo.png" alt="">
+<!-- Bad -->
+<img src="//images/logo.png" alt="" />
+```
+
+
+### Formatting
+Use a new line for every block, list, or table element, and indent every such child element.
+
+```html
+<!-- Good -->
+<div>
+	<ul>
+	  <li>Home</li>
+	  <li>Blog</li>
+	</ul>
+</div>
+
+<!-- Bad -->
+<div><ul>
+  <li>Home</li>
+  <li>Blog</li>
+</ul></div>
+```
+
+We prefer readability over file-size savings when it comes to maintaining existing files. Plenty of whitespace is encouraged. Use whitespace to visually separate groups of related markup and to improve the readability and maintainability of your HTML. Use two empty lines between larger blocks, and use a single empty line between child blocks of larger blocks. Be consistent. (If you are worried about your document's size, spaces (as well as repeated use of the same strings - for instance class names) are excellent candidates for compression. Also, you may use a markup minifier to decrease your document's file size.)
+
+Keep line-length to a sensible maximum, e.g., 80 columns.
+
+Tip: configure your editor to "show invisibles". This will allow you to eliminate end of line whitespace, eliminate unintended blank line whitespace, and avoid polluting commits.
+
+```html
+<blockquote>
+    <p><em>Space</em>, the final frontier.</p>
+</blockquote>
+
+
+<ul>
+    <li>Moe</li>
+    <li>Larry</li>
+    <li>Curly</li>
+</ul>
+
+
+<table>
+    <thead>
+        <tr>
+            <th scope="col">Income</th>
+            <th scope="col">Taxes</th>
+        </tr>
+    <tbody>
+    <tr>
+        <td>$ 5.00</td>
+        <td>$ 4.50</td>
+    </tr>
+</table>
+```
+
+### Indentation
+Don't indent inside html, body, script, or style. Indent inside head and all other elements.
+Indent by four spaces at a time. Don’t use tabs or mix tabs and spaces for indentation.
+
+
+```html
+<!-- Good -->
+<!doctype html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Sample Page</title>
+ 
+    <link rel="stylesheet" href="/style.css">
+    <style>
+    body {
+        font-size: 100em;
+    }
+    </style>
+ 
+    <script src="/jquery.js"></script>
+    <script>
+    $(function() {
+        $( "p" ).text( $.fn.jquery );
+    });
+    </script>
+</head>
+<body>
+ 
+<p>Joomla! is awesome!<p>
+ 
+</body>
+</html>
+```
+
+### Trailing Whitespace
+Remove trailing white spaces. Trailing white spaces are unnecessary and can complicate diffs.
+
+```html
+<!-- Good -->
+<p>Yes please.</p>
+
+<!-- Bad -->
+<p>No, thank you. </p>
+```
+
+
+### Entity References
+Do not use entity references. There is no need to use entity references like &mdash;, &rdquo;, or &#x263a;, assuming the same encoding (UTF-8) is used for files and editors as well as among teams.
+
+The only exceptions apply to characters with special meaning in HTML (like < and &) as well as control or “invisible” characters (like no-break spaces).
+```html
+<!-- Good -->
+<p>The currency symbol for the Euro is “€”.</p>
+
+<!-- Bad -->
+<p>The currency symbol for the Euro is &ldquo;&eur;&rdquo;.</p>
+```
+
+### Inline CSS
+
+Inline CSS must be avoided. When altering states using JavaScript, use CSS to define your states, and only use onobtrusive JavaScript to alter class names whenever possible.
+```html
+<!-- Good -->
+<a class="is-link-disabled" href="//index.php">Home</a>
+
+<!-- Bad -->
+<a href="//index.php" style="text-decoration: line-through;">Home</a>
+```
+
+@todo more meaningful example.
+
+### Style Attributes
+You should not use border, align, valign, or clear attributes. Avoid use of style attributes, except where using syndicated content or internal syndicating systems.
+
+
+### Semantics
+Use HTML according to its purpose. For example, use heading elements for headings, p elements for paragraphs, a elements for anchors, etc.
+
+Using HTML according to its purpose is important for accessibility, reuse, and code efficiency reasons.
+```html
+<!-- Good -->
+<a href="subscriptions/">View subscriptions</a>
+
+<!-- Bad -->
+<div onclick="goToSubscriptions();">View subscriptions</div>
+```
+
+
+
+### Markup
+
+#### Image Tags
+Image elements (<img>) must have an alt attribute. Height and width attributes are optional and may be omitted.
+
+
+@todo add examples from here http://www.bbc.co.uk/guidelines/futuremedia/technical/semantic_markup.shtml
+
+### Comments
+@todo: comment styles in JS, CSS, HTML
+For more complex blocks of HTML, it may be useful to add a comment to the closing tag:
+```html
+<div class="parent">
+
+    <div class="child">
+    </div><!-- /child -->
+
+</div><!-- /parent -->
+```
+
+
+
+### Mark todos
+Highlight todos by using the keyword TODO, eg:
+
+```html
+<!-- TODO: add active item class -->
+<ul>
+  <li>Home</li>
+  <li>Blog</li>
+</ul>
+```
+
+
+
+### Markup validation tools
+@todo: list various testing tools:
+* http://validator.w3.org/nu/
+* http://csslint.net/
diff --git a/manual/zh-TW/coding-standards/chapters/inline-comments.md b/manual/zh-TW/coding-standards/chapters/inline-comments.md
new file mode 100644
index 00000000..9bbecfb8
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/inline-comments.md
@@ -0,0 +1,110 @@
+## Inline Code Comments
+
+This chapter covers inline code commenting in more detail. Inline comments are all comments not included in doc blocs. The goal of in line commenting is to explain code in context. Such explanation may take many different forms.
+
+Comments that are written in a readable and narrative style, especially when explaining a complex process, are encouraged. In general they should be placed close to the code explained rather than before the entire block of code.
+
+Comments should be as sentence like as possible, which is to say that they should be complete and readable, not in short hand.
+
+Comments are not a replacement for detailed doc blocks. Comments serve to explain the logic and structure of code itself rather than the use of code.
+
+### Formatting of Comments
+
+Comment blocks that introduce large sections of code and are more than 2 lines long should use `/* */` (C) style and should use `*` on each line with the same space/tab rules as doc blocks. If you need a large introduction consider whether this block should be separated into a method to reduce complexity and therefore providing a full docblock.
+
+Comments should precede the code they refer to. As a corollary, comments should not be on the same line as the code to which they refer (which puts them after the code they reference). They should be on their own lines.
+
+Don’t use a blank line between comments and the code they refer to (no space underneath a comment block).
+
+Always have a single blank line before a comment or block of comments unless the comment (or block) is at the beginning of a code structure. ( You should not have a blank line after a '{' line )
+
+For example in the following case there is no new line before the first comment (because it follows a '{' line) but we do want a new line before the second comment:
+
+```php
+  while (!$done)
+  {
+    // We don't want an infinite loop here.
+    $done = true;
+  }
+  
+  //Now let's do something interesting.
+  $result = somethingInteresting();
+```
+
+Comments should align with the code they refer to, using the same indenting as the line that follows the comment.
+
+Comments should be indented with tabs (like code, not like doc blocks).
+
+### Content of comments
+
+Comments should use en-GB (See below).
+
+Always have a space between // and the start of comment text.
+
+New lines should always start with an upper case letter unless The line is a continuation of a complete sentence The term is code and is case sensitive.
+
+Code that is included specifically to assure compatibility with other software (for example specific browsers or a specific version of the CMS or for backward compatibility reasons) should be clearly marked as such. If there is the intention to remove specific code at a future point, state that but do not use a deprecation tag or specify a release (this can be hard to predict).
+
+Check spelling and grammar on all comments (see below).
+
+Only end a line with a period if it is a full sentence.
+
+Rather than use docblock tags use See:, Link: and Note: for comments if appropriate.
+
+Do not use HTML in comments unless specifically related to the comment content.
+
+Do not leave commented code unless there is a clearly explained reason for doing so. In such a case, a comment saying "Code intentionally commented" will prevent accidental removal.
+
+Comments may include forward looking statements of how something will be extended or modified in the future, but not todos indicating that code is not complete or ready to use.
+
+Remember that humor and sarcasm are difficult to translate.
+
+### Acronyms
+
+Capitalise all letters of acronyms such as HTML, XML, SQL, GMT, and UTC. This is an exception to the general use of en-GB rules.
+
+### Common spelling and grammar errors for which to check.
+
+Joomla contributors include many non-native speakers of en-GB which makes it understandable that there are sometimes spelling and grammar errors. At the same time, some people reading comments also are non native speakers and may even use automated translation to understand comments. This makes it very important that comments should follow proper en-GB spelling and grammar rules. Unfortunately, these can be tricky.
+
+Wikipedia provides a good summary of [common differences between en-US and en-GB](http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences). Note that there are some instances where en-GB common usage (but not actual rules) varies slightly from en-AU and using en-AU is considered acceptable.
+
+#### S vs Z
+
+en-GB most commonly uses `ise` where en-US would use `ize`, such as `normalise` instead of `normalize`. (Note that there are some exceptions to this rule and some differences between en-GB and en-AU in common usage.)
+
+Use of apostrophes is one of the trickier parts of English.
+
+#### Lets versus let’s
+
+Lets means permits or allows to:
+
+```php
+// This lets the user enter data
+```
+
+Let’s is a contraction for let us and means we are going to do this now:
+
+```php
+// Let's validate the field
+```
+
+#### Its versus it’s
+
+Its is the possessive form of it:
+
+```php
+// Get its ID
+```
+
+It’s is a contraction of it is
+
+```php
+// It's time to save
+```
+
+#### The correct Joomla spelling of some commonly used words.
+
+-   dependant
+-	deprecated
+
diff --git a/manual/zh-TW/coding-standards/chapters/javascript.md b/manual/zh-TW/coding-standards/chapters/javascript.md
new file mode 100644
index 00000000..b27fde09
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/javascript.md
@@ -0,0 +1,475 @@
+## JavaScript
+
+### Contents
+
+1. [Naming Conventions](#naming-conventions)
+    - [Variables](#naming-conventions-variables)
+    - [Functions](#naming-conventions-functions)
+    - [Reserved Words](#naming-conventions-reserved)
+2. [Syntax Style](#syntax-style)
+    - [Indentation](#syntax-indentation)
+    - [Spacing](#syntax-spacing)
+    - [Commas](#syntax-commas)
+    - [Semicolons](#syntax-semicolons)
+    - [Quotes](#syntax-quotes)
+3. [Types](#types)
+4. [Functions](#functions)
+5. [Conditional Statements](#conditional-statements)
+6. [Blocks & Multi-line Statements](#blocks)
+7. [Comments](#comments)
+
+<a name="naming-conventions"></a>
+## Naming Conventions
+
+Use descriptive words or terse phrases for names.
+
+Variables and Functions should be camel case, starting with a lowercase letter: `likeThis`
+
+<a name="naming-conventions-variables"></a>
+### Variables
+
+**Use names that describe what the variable is:**
+
+`var element = document.getElementById('elementId');`
+
+**Iterators are the exception**
+
+Use i for index in a loop (and subsequent letters when necessary for nested iteration).
+
+<a name="naming-conventions-functions"></a>
+### Functions
+
+**Use names that describe what the function does:**
+
+```
+function getSomeData() {
+	// statements
+}
+```
+<a name="naming-conventions-reserved"></a>
+### Reserved Words
+
+Do not use reserved words for anything other than their intended use. The list of: [Reserved Words](http://es5.github.io/#x7.6.1)
+
+---
+
+<a name="syntax-style"></a>
+## Syntax Style
+
+<a name="syntax-indentation"></a>
+### Indentation
+- Don't mix tabs and spaces.
+- Tabs, 4 spaces
+
+<a name="syntax-spacing"></a>
+### Spacing
+- No whitespace at the end of line or on blank lines.
+- Unary special-character operators (e.g., !, ++) must not have space next to their operand.
+- Any , and ; must not have preceding space.
+- Any ; used as a statement terminator must be at the end of the line.
+- Any : after a property name in an object definition must not have preceding space.
+- The ? and : in a ternary conditional must have space on both sides.
+- No filler spaces in empty constructs (e.g., {}, [], fn())
+- New line at the end of each file.
+
+**Array:**
+
+```
+var array = [ 'foo', 'bar' ];
+```
+
+**Function call:**
+
+```
+foo( arg );
+```
+
+**Function call with multiple arguments:**
+
+```
+foo( 'string', object );
+```
+
+**Conditional Statements**
+
+```
+if ( condition ) {
+    // statements
+} else {
+    // statements
+}
+```
+
+```
+while ( condition ) {
+    // statements
+}
+```
+
+```
+for ( prop in object ) {
+    // statements
+}
+```
+
+
+#### Exceptions
+
+**First or only argument is an object, array or callback function.**
+
+**No space before the first argument:**
+
+```
+foo({
+    a: 'bar',
+    b: 'baz'
+});
+```
+
+```
+foo(function() {
+    // statements
+}, options ); // space after options argument
+```
+
+**Function with a callback, object, or array as the last argument:**
+
+No space after the last argument.
+
+```
+foo( data, function() {
+    // statements
+});
+```
+
+<a name="syntax-commas"></a>
+### Commas
+
+**Place commas after:**
+
+- variable declarations
+- key/value pairs
+
+#### Arrays
+
+Do not include a trailing comma, this will add 1 to your array's length.
+
+**No:**
+
+```
+array = [ 'foo', 'bar', ];
+```
+
+**Yes:**
+
+```
+array = [ 'foo', 'bar' ];
+```
+
+<a name="syntax-semicolons"></a>
+### Semicolons
+
+Use them where expected.
+
+Semicolons should be included at the end of function expressions, but not at the end of function declarations.
+
+**Function Expression:**
+
+```
+var foo = function() {
+    return true;
+};
+```
+
+**Function Declaration:**
+
+```
+function foo() {
+    return true;
+}
+```
+
+<a name="syntax-quotes"></a>
+### Quotes
+
+Use ' instead of "
+
+
+---
+
+<a name="variables"></a>
+## Variables
+
+### Avoid Global Variables
+
+**No:**
+
+```
+foo = 'bar';
+```
+
+**No: implied global**
+
+```
+function() {
+    foo = 'bar';
+}
+```
+
+**Yes:**
+
+```
+var foo = 'bar';
+```
+
+### Multiple Variable Declarations
+
+Use one `var` declaration and separate each variable on a newline ending with a comma.
+
+**No:**
+
+```
+var foo = 'bar';
+var bar = 'baz';
+var baz = 'qux';
+```
+
+**Yes:**
+
+```
+var foo = 'bar',
+	bar = 'baz',
+    baz = 'qux';
+```
+
+<a name="types"></a>
+## Types
+
+### String
+
+- Concatenate long strings.
+- Place space before closing quote at the end of each string.
+- Concatenation operator at the end of each subsequent string.
+
+```
+var longString = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' +
+    'Sed placerat, tellus eget egestas tincidunt, lectus dui ' +
+    'sagittis massa, id mollis est tortor a enim. In hac ' +
+    'habitasse platea dictumst. Duis erat justo, tincidunt ac ' +
+    'enim iaculis, malesuada condimentum mauris. Vestibulum vel ' +
+    'cursus mauris.';
+```
+
+### Number
+
+Use `parseInt()` or `parseFloat()` instead of unary plus, for readability.
+
+**No:**
+
+```
+var count = +document.getElementById('inputId').value;
+```
+
+**Yes:**
+
+```
+var count = parseInt(document.getElementById('inputId').value);
+```
+
+### Type Checks
+
+- String: `typeof object === 'string'`
+- Number: `typeof object === 'number'`
+- Boolean: `typeof object === 'boolean'`
+- Object: `typeof object === 'object'`
+- Plain Object: `jQuery.isPlainObject( object )`
+- Function: `jQuery.isFunction( object )`
+- Array: `jQuery.isArray( object )`
+- Element: `object.nodeType`
+- null: `object === null`
+- null or undefined: `object == null`
+
+**Undefined:**
+
+- Global Variables: `typeof variable === 'undefined'`
+- Local Variables: `variable === undefined`
+- Properties: `object.prop === undefined`
+
+### Objects
+
+Use the literal, not constructor, syntax.
+
+**No:**
+
+```
+var myObj = new Object();
+```
+**Yes:**
+
+```
+var myObj = {};
+```
+
+If an object contains more than one key/value pair or an array as a value, each key/value pair should be on its own line.
+
+```
+var myObj = {
+	foo: 'bar',
+	bar: 'baz',
+	baz: 'qux'
+};
+```
+
+### Arrays
+
+Use the literal, not constructor, syntax
+
+**No:**
+
+```
+var myArr = new Array();
+```
+**Yes:**
+
+```
+var myArr = [];
+```
+
+If you don't know array length use push method. This will replace the current array.
+
+```
+var myArr = [];
+myArr.push('foo');
+```
+
+<a name="functions"></a>
+## Functions
+
+### Chaining Method Calls
+
+```
+$('.someElement')
+	.hide()
+	.delay(1000)
+	.fadeIn();
+```
+
+<a name="conditional-statements"></a>
+## Conditional Statements
+
+Use ternary syntax if:
+
+- One condition
+- Result of either evaluation is one operation. 
+
+```
+joomlaRocks ? 'This is true' : 'else it is false';
+```
+
+Otherwise, use standard syntax:
+
+```
+if ( condition ) {
+	// statements
+} else {
+	// statements
+}
+```
+
+**Cache length in variable for performance:**
+
+```
+var i,
+    j = myArr.length;
+
+for ( i = 0; i < j; i++ ) {
+    // statements
+}
+```
+
+**With more than one condition:**
+
+```
+if ( condition &&
+	condition2 &&
+	condition3 ) {
+    // statements
+} else {
+    // statements
+}
+```
+
+### Equality
+
+Use strict equality operator === so that type is considered in comparison. Using == can produce false positives.
+
+
+```
+// evaluates true
+1 == "1"
+```
+
+```
+// evaluates false
+1 === "1"
+```
+
+<a name="blocks"></a>
+## Blocks & Multi-line Statements
+
+Use curly braces on blocks that have more than one statement.
+
+**Block with one statement:**
+
+```
+if ( test ) return false;
+```
+
+**Block with more than one statement:**
+
+```
+if ( test ) {
+    var foo = 'some string';
+    return foo;
+}
+```
+
+<a name="comments"></a>
+## Comments
+
+**Single Line**
+
+- Place above the code it refers to.
+- A space between double forward slashes and comment text.
+
+```
+// I am a single line comment.
+```
+
+
+**Multiline**
+
+- Place above the code it refers to.
+- Opening token placed on the line above first comment line, closing placed below last comment line.
+- Each comment line begins with two astericks followed by a space.
+
+```
+/*
+** I am a multiline comment.
+** Line two
+** Line three
+*/
+```
+
+---
+
+#### TODO
+
+- Switch Statements vs other methods like Objects
+- Add jQuery examples
+- Double check accuracy of all examples
+
+**With help from:**
+
+- [jQuery JS Style Guide](https://contribute.jquery.org/style-guide/js)
+- [Idiomatic JS](https://github.com/rwaldron/idiomatic.js)
diff --git a/manual/zh-TW/coding-standards/chapters/php.md b/manual/zh-TW/coding-standards/chapters/php.md
new file mode 100644
index 00000000..eae76d4a
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/php.md
@@ -0,0 +1,477 @@
+## 語言結構
+
+### PHP 標籤
+
+永遠使用長標籤： `<?php ?>` 來包裹 PHP 程式碼，不使用短標籤 `<? ?>`。這可以確保您的程式碼可執行在大多數未經設定的主機環境。
+
+如果檔案中只包含PHP程式碼，則不應該包含結尾標籤 `?>`。這個標籤在 PHP 中不是必要的。這樣子可以避免在系統輸出前，不小心讓任何空白預先送出 header ，這會造成 Joomla 的 Session 功能錯誤 (參見 PHP 手冊的說明 [Instruction separation](http://php.net/basic-syntax.instruction-separation))。
+
+檔案結尾必須永遠由一個空行結束。
+
+### 引入程式
+
+當您想要無條件引入一個檔案時，應使用 `require_once`。當您要有條件的引入一個檔案（例如 factory 類別與其方法），則用 `include_once`。這兩者都可以確保檔案不被二次載入。兩種用法共享檔案清單，所以混用不會有任何問題。被 `require_once` 引入的檔案不會再被 `include_once` 引入一次。
+
+> **注意**
+>
+> `include_once` 與 `require_once` 是 PHP 關鍵字，不是函式，寫法應該如下:
+>
+>
+> `require_once JPATH_COMPONENT . ’/helpers/helper.php’;`
+
+您不應該把檔案路徑用括號包起來。
+
+### 兼容 E_STRICT 的 PHP 程式
+
+我們必須秉持並實踐 PHP 5.3 以上所支持的物件導向設計模式。Joomla! 一直致力於讓原始碼符合 E_STRICT 標準。
+
+## 全域變數
+
+盡量減少使用全域變數或超全域變數，用物件導向或工廠(Factory)模式替代之。
+
+## 控制結構
+
+所有的控制結構必須在關鍵字與起始括號之間放置一個空白字元，而開頭、結尾括號與邏輯判斷式之間無空格。這是為了區隔控制結構與函式以方便辨認，而括號內必須要包含邏輯。
+
+所有的控制結構關鍵字，如： `if`, `else`, `do`, `for`, `foreach`, `try`, `catch`, `switch` 與 `while` 皆採 [Allman](http://en.wikipedia.org/wiki/Indent_style#Allman_style) 風格，關鍵字本身必須在一個新行，而語言區塊（大括號）的開頭與結束也接需再一個新行中。
+
+### _if-else_ 範例
+
+```php
+if ($test)
+{
+	echo 'True';
+}
+
+// 註解可寫在此
+// 要注意的是 "elseif" 採用單一單字而非拆開成 "else if"
+
+elseif ($test === false)
+{
+	echo 'Really false';
+}
+else
+{
+	echo 'A white lie';
+}
+```
+
+如果控制結構的判斷式需要多行，則第二行開始需要一個 Tab 縮排，結尾括號需要再同一行上。
+
+```php
+if ($test1
+	&& $test2)
+{
+	echo 'True';
+}
+```
+
+### _do-while_ 範例
+
+
+```php
+do
+{
+	$i++;
+}
+while ($i < 10);
+```
+
+### _for_ 範例
+
+```php
+for ($i = 0; $i < $n; $i++)
+{
+	echo 'Increment = ' . $i;
+}
+```
+
+### _foreach_ 範例
+
+```php
+foreach ($rows as $index => $row)
+{
+	echo 'Index = ' . $id . ', Value = ' . $row;
+}
+```
+
+### _while_ 範例
+
+```php
+while (!$done)
+{
+	$done = true;
+}
+```
+
+### _switch_ 範例
+
+當使用 `switch` 時， `case` 關鍵字必須縮排一次，而 `break` 關鍵字必須獨立在新的一行，且相較於 `case` 再縮排一次。
+
+```php
+switch ($value)
+{
+	case 'a':
+		echo 'A';
+		break;
+
+	default:
+		echo 'I give up';
+		break;
+}
+```
+
+## 參照
+
+當使用變數參照時，參照符號應該距離等號一個空白字元，且跟後面的變數緊鄰，沒有空白。
+
+範例:
+
+```php
+$ref1 = &$this->sql;
+```
+
+> **注意**
+>
+> 在 PHP 5 ，物件不再需要參照符號，所有物件皆是參照。
+
+## 陣列
+
+陣列元素的指派可稍微排版，當多行時，可用 Tab 縮排。每行跟隨一個都逗號結尾，最後一行可包含逗號，這是 PHP 允許的寫法，對於程式碼 diff 比對時也有所幫助。
+
+範例:
+
+```php
+$options = array(
+	'foo'	=> 'foo',
+	'spam'	=> 'spam',
+);
+```
+
+## 註解
+
+行內註解可用 C 語言風格的 `/* ... */` 或 C++ 的單行註解 `// ...`。 C 風格的註解通常被用在文件開頭、類別、函式等等的文件標頭。而 C++ 風格單行註解則常用在程式解釋與提醒。註解對於幫助其他開發人員理解程式碼的目的有非常大的幫助，甚至包含您自己也能受惠。當程式碼開始進行複雜操作時，永遠記得要加上註解。至於 Perl 與 Shell 的井號 (`#`)註解則不建議使用，目前在 PHP 中也不再允許此類註解。
+
+您可以在某些情況下藉由註解掉整段程式碼或類別函式以用於調整程式功能，但應該在最終提交到核心前去除這些註解或不再需要的程式區塊。
+
+例如，不要在提交的程式碼中包含以下片段:
+
+```php
+// 這段程式碼未來需要修復
+//$code = broken($fixme);
+```
+
+### 文件區塊註解
+
+在 PHP、Javascript、檔案中的所有類別、成員屬性、方法與函式，皆需要區塊註解，並遵循 JavaDoc 或 phpDoc 的約定。
+
+這些 "區塊註解 (DocBlocks)" 從 PEAR 引用而來，但也為了 Joomla Framework 做了一點改變。
+
+雖然一般的縮排皆使用標準 Tab 來縮進，但區塊註解中，我們使用空格來排版，這提供了原始碼更優良的可讀性。任何文字元素，如標籤、變數的類型、變數名稱與標籤描述的最小距離必須是兩個空格。變數類型和標籤說明應分別按照最長的標籤和變數類型、變數描述對齊。
+
+如果使用了 `@package` 標籤，必須是 "Joomla.Platform"。
+
+除果使用了 `@subpackage` ，必須是 /joomla/ 資料夾下的頂層目錄名稱，例如: Application, Database, Html 等等。
+
+> 註: 在 Joomla Framework 中，不再使用 `@package` 與 `@subpackage`。
+
+貢獻給 Joomla 的程式碼，將成為專案的資產，不允許擁有 `@author` 標籤。你應該在 CREDITS.php 更新貢獻紀錄。Joomla 的理念是這樣的，所有的程式是一起發展編寫出來的，並沒有任何一個人擁有任何代碼中的一個部分。不過 `@author` 標籤允許使用在被包含進核心函式庫的第三方函式庫。
+
+從第三方函式庫引入的檔案，其區塊註解必須完好無損。Layout 的檔案使用跟其他 PHP 檔案一樣的區塊註解。
+
+### 檔案文件標頭註解
+
+文件標頭註解有以下內容且按照順序
+
+-   簡易說明 (選填, 除非超過兩個以上類別或方法) 結束空一行.
+-   完整說明 (選填) 結束空一行.
+-   `@category` (選填)
+-   `@package` (通常是選填, 但如果檔案只包含程序邏輯(無類別)則必填)
+-   `@subpackage` (選填)
+-   `@author` (選填, 但只允許在非的Joomla源文件，例如，包括第三方函式庫例如 Geshi)
+-   `@copyright` (必填)
+-   `@license` (必填且必須是相容於 Joomla 所使用的授權條款)
+-   `@deprecated` (選填)
+-   `@link` (選填)
+-   `@see` (選填)
+-   `@since` (通常是選填，但如果檔案只包含程序邏輯(無類別)則必填)
+
+```
+/**
+ * @package     Joomla.Platform
+ * @subpackage  Database
+ * @copyright   Copyright 2005 - 2010 Open Source Matters. All rights re-served.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+```
+
+## 函式呼叫
+
+呼叫函式時, 函式名稱跟參數括號中不能有空白, 而第一個帶入參數也不得有空白; 每個參數逗點後一個空白隔開 (如果有的話), 最後一個參數跟括號沒有空格. 參數帶值等號前後需有空白. 可以多行對齊.
+
+```php
+// 單函式呼叫
+$foo = bar($var1, $var2);
+
+// 多函式呼叫
+$short  = bar('short');
+$medium = bar('medium');
+$long   = bar('long');
+```
+
+## 函式定義
+
+函式定義需開始並獨立於一新行，開始與結束的括號也需分別被放置於一新行。在負責處理回傳值的程式碼前應插入一空行。
+
+函數定義必須包含註解說明，根據本文件中的註解章節所規範之規則予以撰寫。
+
+-   簡易說明 (必要，結束需空一行)
+-   完整說明 (選填，結束需空一行)
+-   `@param` (若函式有參數則此欄位為必要，並於最後一個`@param`標簽之後新增一空行)
+-   `@return` (必要，結束需空一行)
+-   其餘標簽依據字母順序排列，需注意 @since 標籤永遠為必要。
+
+```php
+/**
+ * An utility class.
+ *
+ * @package     Joomla.Platform
+ * @subpackage  XBase
+ *
+ * @param       string  $path  The library path in dot notation.
+ *
+ * @return      void
+ *
+ * @since       1.6
+ */
+function jimport($path)
+{
+	// Body of method.
+}
+```
+
+如果一個函數定義橫跨數行，第二行起的每一行皆需以一個 tab 作縮排，結束括號需與最後一個參數存在於同一行。
+
+```php
+function fooBar($param1, $param2,
+	$param3, $param4)
+{
+	// Body of method.
+}
+```
+
+## 類別定義
+
+類別定義需開始並獨立於一新行，開始與結束的括號也需被分別放置於一新行。類別方法(Class Methods)需根據函數定義標準來撰寫。類別的屬性及方法需根據物件導向(OOP)標準適當宣告(使用適合的 public, protected, private 和 static 等屬性)
+
+類別的定義、屬性及方法皆需撰寫對應的註解區塊(DocBlock)，根據接下來的準則規範。
+
+### 類別註解區塊標頭
+
+類別註解區塊包含以下必要及非必要欄位，並依照下列順序排列。
+
+-   簡易說明(必要，除非該檔案擁有兩個以上之類別或函數)
+-   完整說明(選填，結束需空一行)
+-   `@category` (選填，很少用到)
+-   `@package` (必要)
+-   `@subpackage` (選填)
+-   `@author` (選填，但只允許在非joomla的程式碼中，舉例來說，如：使用第三方函式庫如Geshi)
+-   `@copyright` (選填，除非與檔案文件註解表頭(file Docblock)不同)
+-   `@license` (選填，除非與檔案文件註解表頭(file Docblock)不同)
+-   `@deprecated` (選填)
+-   `@link` (選填)
+-   `@see` (選填)
+-   `@since` (必填, 根據類別第一次出現時的程式版本號)
+
+### 類別屬性註解區塊
+
+類別屬性註解區塊包含以下必要及非必要欄位，並依照下列順序排列。
+
+-   簡易說明(必要，除非該檔案擁有兩個以上之類別或函數)
+-   `@var` (必要，於該屬性後其後註明屬性種類(property type))
+-   `@deprecated` (選填)
+-   `@since` (必填)
+
+### 類別方法註解區塊
+
+類別方法註解區塊是依據PHP函式之規則做撰寫(如上述)。
+
+```php
+/**
+ * An utility class.
+ *
+ * @package     Joomla.Platform
+ * @subpackage  XBase
+ * @since       1.6
+ */
+class JClass extends JObject
+{
+	/**
+	 * Human readable name
+	 *
+	 * @var    string
+	 * @since  1.6
+	 */
+	public $name;
+
+	/**
+	 * Method to get the name of the class.
+	 *
+	 * @param   string  $case  Optionally return in upper/lower case.
+	 *
+	 * @return  boolean  True if successfully loaded, false otherwise.
+	 *
+	 * @since   1.6
+	 */
+	public function getName($case = null)
+	{
+		// Body of method.
+
+		return $this->name;
+	}
+}
+```
+
+## 命名慣例
+
+### 類別
+
+類別應給予描述性的名稱。在可能的情況下應避免縮寫。類別名稱總是以一個大寫字母開頭，且採用駝峰式 (CamelCase) 命名法則，即便名字中包含傳統上常用大寫的字彙(如 HTML, XML)。唯一例外是必須由 J 開頭的核心類別後面可接上一個大寫字母。
+
+範例:
+
+-   JHtmlHelper
+-   JXmlParser
+-   JModel
+
+### 函式與方法
+
+函式與方法採用 "studly caps" 風格 (也稱作 "bumpy case" 或 "camel caps")。 名稱起始的字母必須是小寫，而每個新單字的首個字母為大寫。而在 Joomla 框架中的函式必須由小寫字母 'j' 開頭。
+
+範例:
+
+-   connect();
+-   getData();
+-   buildSomeWidget();
+-   jImport();
+-   jDoSomething();
+
+類別的私有成員屬性 (就是說只被用在他所宣告出來的類別內部的成員屬性) ，開頭有一個底線。屬性名稱採用底線命名風格 (也就是說，單字被底線區  隔開來)，且應該全部小寫。
+
+範例:
+
+```php
+class JFooHelper
+{
+	protected $field_name = null;
+
+	private $_status = null;
+
+	protected function sort()
+	{
+	}
+}
+```
+
+### 常數
+
+常數應永遠為大寫，並用底線分隔單字。總是在常數前加上 `J` 且運用一些眾人常識和慣例來避免常數名稱太長。你 *應該* 使用類別或封包 (package) 中已經使用的名稱。例如在 'Joomla\Application\Web\Router' 中的常數，以 `JRoute_` 開頭。
+
+### 全域變數
+
+不要使用全域變數。採用靜態類別與屬性或常數替代。
+
+### 一般情況下的變數與類別屬性
+
+一般情況下的變數，遵循函式的慣例。
+
+類別的屬性應該設為 null 或其他適當的預設值。
+
+## 例外處理
+
+例外處理應當只用於錯誤處理上。
+
+下面的章節將指出如何照語意使用 [PHP 標準函式庫 (SPL) 的 Exceptions](http://php.net/manual/en/spl.exceptions.php)。
+
+### 邏輯例外 LogicException
+
+在 API 的使用方式上發生的明確問題會丟出 LogicException 的例外。例如：如果有個依賴參數失效時（你試圖操作一個未被載入的物件）。
+
+下方的子類別也可被用於適當的情境下：
+
+#### BadFunctionCallException
+
+如果一個 callback 參照到一個未定義的函式(function) 或是缺少了一些參數時可以丟出該例外。例如：如果 `is_callable()` 或其他類似的函式用在一個函式(function)上時得到失敗的結果。
+
+#### BadMethodCallException
+
+如果一個 callback 參照到一個未定義的方法(method) 或是缺少了一些參數時可以丟出該例外。例如：如果 `is_callable()` 或其他類似的函式用在一個方法(method)上時得到失敗的結果。 另一個例子可能是找不到某些使用魔術方法的參數。
+
+#### InvalidArgumentException
+
+當有不合規格的輸入發生時丟出該例外。
+
+#### DomainException
+
+該例外和 InvalidArgumentException 類似，但會在一數值未依附在一已定義的有效資料群集的情形下丟出該例外。例如：試圖載入一個"mongodb"的資料庫引擎，但該引擎尚未在 API 中實作。
+
+#### LengthException
+
+當作一參數的長度檢查失敗時丟出該例外。例如：一個檔案的雜湊值不是一個指定長度的字串。
+
+#### OutOfRangeException
+
+該例外較少被實際的應用，但可在存取一個非法的索引值時丟出該例外。
+
+### 執行期例外 RuntimeException
+
+當外部實體或環境造成你無法控制的問題因而產生錯誤時，便丟出 RuntimeException 的例外。當一個錯誤的產生不能明確地被判斷出來時，預設丟出該例外。例如：你試圖連到資料庫但資料庫卻無法使用 (伺服器掛掉之類的)。另一個例子可能為 SQL 查詢語句的錯誤。
+
+#### UnexpectedValueException
+
+當一個非預期的結果發生時應當丟出該種類的例外。例如：當一個函式預期是要回傳布林值卻回傳字串時。
+
+#### OutOfBoundsException
+
+該例外較少實際的應用，但也許當某個值不為合法的索引值時丟出該例外。
+
+#### OverflowException
+
+該例外較少實際的應用，但也許當你加入一個元素到已經滿載的容器物件時丟出該例外。
+
+#### RangeException
+
+該例外較少實際的應用，但也許在程式執行期間丟出該例外以指出一個範圍的錯誤。通常這是指除了運算虧位/溢位之外的錯誤。該例外為 DomainException 的 runtime 版本。
+
+#### UnderflowException
+
+該例外較少實際的應用，但也許當你從一個空的容器物件中移除一個元素時丟出該例外。
+
+### 例外處理的文件撰寫
+
+每個函式(function)或方法(method)必須要註解使用到的例外，用 @throws 的標籤和丟出例外的物件名稱作註解。每種例外只須備被註解一次。註解的說明非必須。
+
+## SQL 查詢語句
+
+SQL 的保留字要全用大寫，其他的文字符號 (當然被引號包起來的文字為例外) 為小寫。
+
+全部的 table 名稱必須要用 `#__` 的前綴字而不是用 `jos_` 去讀取 Joomla 的內容，並允許替換為使用者定義的資料庫前綴字。查詢語句也必須使用 JDatabaseQuery API。
+
+```php
+// Get the database connector.
+$db = JFactory::getDBO();
+
+// Get the query from the database connector.
+$query = $db->getQuery(true);
+
+// Build the query programatically (using chaining if desired).
+$query->select('u.*')
+	// Use the qn alias for the quoteName method to quote table names.
+	->from($db->qn('#__users').' AS u'));
+
+// Tell the database connector what query to run.
+$db->setQuery($query);
+
+// Invoke the query or data retrieval helper.
+$users = $db->loadObjectList();
+```
diff --git a/manual/zh-TW/coding-standards/chapters/source-code-management.md b/manual/zh-TW/coding-standards/chapters/source-code-management.md
new file mode 100644
index 00000000..7ee0a55c
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/source-code-management.md
@@ -0,0 +1,24 @@
+## Source Code Management
+
+Before we start talking about what Joomla! code should look like, it is appropriate to look at how and where the source code is stored. All serious software projects, whether driven by an Open Source community or developed within a company for proprietary purposes will manage the source code is some sort of source or version management system. The Joomla project uses a Distributed Version Control System (DVCS) called Git hosted at [GitHub.com](http://github.com).
+
+### The Joomla Framework
+
+The [Joomla Framework](https://github.com/joomla/joomla-framework) is a PHP framework that is designed to serve as a foundation for not only web applications (like a CMS) but other types of software such as command line applications. The files that form the Joomla Framework are stored in a Distributed Version Control System (DVCS) called Git hosted at github.com
+
+You can learn about how to get the Joomla Framework source code from the Git repository, https://github.com/joomla/joomla-framework.
+
+Because Git treats the concepts of file revision numbers differently than Subversion, the repository revision number is not required in files (that is, the `@version` tag is not necessary).
+
+### The Joomla CMS
+The [Joomla! CMS](https://github.com/joomla/joomla-cms) is a Content Management System (CMS) which enables you to build Web sites and powerful online applications. It's a free and OpenSource software, distributed under the GNU General Public License version 2 or later. The files that form the Joomla CMS are stored in a Distributed Version Control System (DVCS) called Git hosted at github.com
+
+You can learn about how to get the Joomla CMS source code from the Git repository, https://github.com/joomla/joomla-cms.
+
+Because Git treats the concepts of file revision numbers differently than Subversion, the repository revision number is not required in files (that is, the `@version` tag is not necessary).
+
+## Compliance Tool
+
+The standards in this manual have been adopted across the Joomla project, including the [Joomla Framework](https://github.com/joomla/joomla-framework), the [Joomla! CMS](https://github.com/joomla/joomla-cms) and any other applications maintained by the project. These standards apply to source code, tests and (where applicable) documentation.
+
+A custom Joomla sniff standard for PHP files is maintained by the Joomla project and available from the code repository. The Sniff is based on the standard outlined in this document. For more information about how code standards are enforced see the analysis appendix of the manual. For information on using the Sniff see the documentation stored in its repository.
diff --git a/manual/zh-TW/coding-standards/chapters/xml.md b/manual/zh-TW/coding-standards/chapters/xml.md
new file mode 100644
index 00000000..3c90cb85
--- /dev/null
+++ b/manual/zh-TW/coding-standards/chapters/xml.md
@@ -0,0 +1,57 @@
+## XML Files
+
+### Attributes
+
+* Each attribute is on its own line.
+* The four attributes `name`, `type`, `label` and `description` should be written in this order and at the top of the element definition.
+
+### Closing Elements
+
+Elements should be closed with the closing tag on a new line.
+
+### Exception
+
+When the element only has few attributes, then the whole element can stay on the same line.
+A max line length of 100 characters is recommended for good reading.
+
+#### Examples
+
+Element is **empty**:
+```xml
+<field
+	name="abc"
+	type="text"
+	label="Empty Field"
+	description="Empty field without options"
+	/>
+```
+
+Element is **not empty**:
+```xml
+<field
+	name="abc"
+	type="radio"
+	label="Field"
+	description="Field with options"
+	>
+	<option value="1">JYES</option>
+	<option value="0">JNO</option>
+</field>
+
+<field
+	name="abc"
+	type="radio"
+	label="Field"
+	description="Field with options"
+	>
+	<option
+		value="1"
+		foo="bar"
+		>
+		SOMETHING_VERY_LONG
+	</option>
+	<option value="0">
+		SOMETHING_VERY_LONG
+	</option>
+</field>
+```
diff --git a/manual/zh-TW/coding-standards/introduction.md b/manual/zh-TW/coding-standards/introduction.md
new file mode 100644
index 00000000..7c11c059
--- /dev/null
+++ b/manual/zh-TW/coding-standards/introduction.md
@@ -0,0 +1,19 @@
+## Introduction
+
+Good coding standards are important in any software development project. These standards are even more important when a large, diverse and worldwide community of developers are contributing to a project. One of the things that sets good software apart from great software is not only the features or the actual function the software performs, but the quality of its source code. 
+
+In order to perform in the highly competitive Open Source and proprietary software industries, source code not only needs to be beautifully designed, it also needs to be beautiful and elegant to look at. The Joomla Coding Standards Manual is to help ensure our code is the highest quality which will make it easy to read, debug, and maintain. 
+
+## Guiding Principles
+
+Since readable code is more maintainable, the compass that guides us in achieving that goal is a set of well thought out coding standards for the different software languages that are employed in the Joomla software project. Joomla has a solid heritage of striving to support a great looking product with great looking code. 
+
+This manual compiles the collective wisdom of past and present contributors to the project to form the definitive standard for coding in Joomla, whether that is for the core Joomla Framework or an extension that forms part of the stack of the Joomla CMS. This manual also serves as a lighthouse to the Joomla developer community, to safely guide developers around the pitfalls of becoming lackadaisical with respect to writing clean, beautiful code.
+
+The Joomla Coding Standards borrows heavily from the PEAR coding standard for PHP files, augmenting and diverging where it is deemed sensible to do so.
+
+There are [tools available](appendices/analysis.md) to help your code conform to our standards.
+
+## Contributing to this manual
+
+If you want to contribute and improve this manual, you can find the source files at [https://github.com/joomla/coding-standards/tree/gh-pages](https://github.com/joomla/coding-standards/tree/gh-pages).
\ No newline at end of file
diff --git a/manual/zh-TW/menu.md b/manual/zh-TW/menu.md
new file mode 100644
index 00000000..ce266484
--- /dev/null
+++ b/manual/zh-TW/menu.md
@@ -0,0 +1,15 @@
+- [Introduction](coding-standards/introduction.md)
+- [Source Code Management](coding-standards/chapters/source-code-management.md)
+- **Coding Standards**
+    - [Basic Guidelines](coding-standards/chapters/basic-guidelines.md)
+    - [Inline Code Comments](coding-standards/chapters/inline-comments.md)
+    - [DocBlocks](coding-standards/chapters/docblocks.md)
+    - [PHP Code](coding-standards/chapters/php.md)
+    - [XML](coding-standards/chapters/xml.md)
+- **Clientside Syntax Styleguides**
+    - [HTML](coding-standards/chapters/html.md)
+    - [CSS](coding-standards/chapters/css.md)
+    - [JavaScript](coding-standards/chapters/javascript.md)
+- **Appendices**
+    - [Code Analysis Tools](appendices/analysis.md)
+    - [Examples](appendices/examples.md)	
\ No newline at end of file
diff --git a/manual/zh-TW/version.md b/manual/zh-TW/version.md
new file mode 100644
index 00000000..170de3a3
--- /dev/null
+++ b/manual/zh-TW/version.md
@@ -0,0 +1 @@
+Version 1.0
\ No newline at end of file

From f90d26844f76dc01f79d0b7ad217d40811bf41d5 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Tue, 23 Sep 2014 00:11:39 +0800
Subject: [PATCH 02/33] Added Immediately Invoked Function Expression for
 Mootools

---
 assets/js/manual.js | 186 ++++++++++++++++++++++----------------------
 1 file changed, 94 insertions(+), 92 deletions(-)

diff --git a/assets/js/manual.js b/assets/js/manual.js
index e98fe855..de5e58e7 100644
--- a/assets/js/manual.js
+++ b/assets/js/manual.js
@@ -1,101 +1,103 @@
-var populateWindow = function(link) {
-	var markdownRequest = new Request({
-		"url": here + 'manual/en-US/' + link,
-		"method": "get",
-		"onSuccess": function(response) {
-			$('docwin').set('html', marked(response));
-		}
-	}).send();
+;(function($) {
+    var populateWindow = function(link) {
+        var markdownRequest = new Request({
+            "url": here + 'manual/en-US/' + link,
+            "method": "get",
+            "onSuccess": function(response) {
+                $('docwin').set('html', marked(response));
+            }
+        }).send();
 
-	$$('.nav-list li').each(
-		function(item) {
-			if (item.getElements('a').length == 0) {
-				item.addClass('nav-header');
-			}
-		}
-	);
+        $$('.nav-list li').each(
+            function(item) {
+                if (item.getElements('a').length == 0) {
+                    item.addClass('nav-header');
+                }
+            }
+        );
 
-	$$('.nav-list a').each(
-		function(item, index)
-		{
-			if (link == item.get('href'))
-			{
-				item.getParent('li').addClass('active');
-			}
-			else
-			{
-				item.getParent('li').removeClass('active');
-			}
-		}.bind(this)
-	);
-}
+        $$('.nav-list a').each(
+            function(item, index)
+            {
+                if (link == item.get('href'))
+                {
+                    item.getParent('li').addClass('active');
+                }
+                else
+                {
+                    item.getParent('li').removeClass('active');
+                }
+            }.bind(this)
+        );
+    }
 
-var populateMenu = function() {
-	var markdownRequest = new Request({
-		"url": here + 'manual/en-US/menu.md',
-		"method": "get",
-		"onSuccess": function (response) {
-			$('doc-menu').set('html', marked(response));
-			$$('#doc-menu ul').each(function(el) {
-				el.addClass('nav');
-				el.addClass('nav-list');
-			});
+    var populateMenu = function() {
+        var markdownRequest = new Request({
+            "url": here + 'manual/en-US/menu.md',
+            "method": "get",
+            "onSuccess": function (response) {
+                $('doc-menu').set('html', marked(response));
+                $$('#doc-menu ul').each(function(el) {
+                    el.addClass('nav');
+                    el.addClass('nav-list');
+                });
 
-			$$('.nav-list li').each(
-				function(item) {
-					if (item.getElements('a').length == 0) {
-						item.addClass('nav-header');
-					}
-				}
-			);
-		}
-	}).send();
-}
+                $$('.nav-list li').each(
+                    function(item) {
+                        if (item.getElements('a').length == 0) {
+                            item.addClass('nav-header');
+                        }
+                    }
+                );
+            }
+        }).send();
+    }
 
-var populateVersion = function() {
-	var versionRequest = new Request({
-		"url": here + 'manual/en-US/version.md',
-		"method": "get",
-		"onSuccess": function(response) {
-			$('version').set('html', marked(response));
-		}
-	}).send();
-}
+    var populateVersion = function() {
+        var versionRequest = new Request({
+            "url": here + 'manual/en-US/version.md',
+            "method": "get",
+            "onSuccess": function(response) {
+                $('version').set('html', marked(response));
+            }
+        }).send();
+    }
 
-window.addEvent('domready', function() {
-	var urlParts = document.URL.split('?', 2);
-	state = {};
-	here = urlParts[0];
+    window.addEvent('domready', function() {
+        var urlParts = document.URL.split('?', 2);
+        state = {};
+        here = urlParts[0];
 
-	if (urlParts.length > 1)
-	{
-		var currentDoc = urlParts[1];
-	}
-	else
-	{
-		var currentDoc = "coding-standards/introduction.md";
-	}
+        if (urlParts.length > 1)
+        {
+            var currentDoc = urlParts[1];
+        }
+        else
+        {
+            var currentDoc = "coding-standards/introduction.md";
+        }
 
-	marked.setOptions({
-		gfm: true,
-		pedantic: false,
-		sanitize: false,
-		highlight: function(code, lang) {
-			var that;
-			Rainbow.color(code, lang, function(hl_code) { that = hl_code; });
-			return that;
-		}
-	})
-	populateMenu();
-	populateWindow(currentDoc);
-	populateVersion();
+        marked.setOptions({
+            gfm: true,
+            pedantic: false,
+            sanitize: false,
+            highlight: function(code, lang) {
+                var that;
+                Rainbow.color(code, lang, function(hl_code) { that = hl_code; });
+                return that;
+            }
+        })
+        populateMenu();
+        populateWindow(currentDoc);
+        populateVersion();
 
-	document.id('main').addEvent('click:relay(a)', function (event, target) {
-		if (target.get('href').substring(0, 4) != 'http' && target.get('href').substring(0, 1) != '#')
-		{
-			populateWindow(target.get('href'));
-			event.preventDefault();
-			history.pushState(state, target.get('href'), "?" + target.get('href'));
-		}
-	});
-});
+        document.id('main').addEvent('click:relay(a)', function (event, target) {
+            if (target.get('href').substring(0, 4) != 'http' && target.get('href').substring(0, 1) != '#')
+            {
+                populateWindow(target.get('href'));
+                event.preventDefault();
+                history.pushState(state, target.get('href'), "?" + target.get('href'));
+            }
+        });
+    });
+})(document.id)

From c21626e288e5621b9e3fc05c6e5eab1c0fbb5bf5 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Tue, 23 Sep 2014 00:12:15 +0800
Subject: [PATCH 03/33] Added jQuery ver 1.11.1

---
 assets/js/jquery-1.11.1.min.js | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 assets/js/jquery-1.11.1.min.js

diff --git a/assets/js/jquery-1.11.1.min.js b/assets/js/jquery-1.11.1.min.js
new file mode 100644
index 00000000..7ac04f5b
--- /dev/null
+++ b/assets/js/jquery-1.11.1.min.js
@@ -0,0 +1,4 @@
+/*! jQuery v1.11.1 | (c) 2005, 2014 jQuery Foundation, Inc. | jquery.org/license */
+!function(a,b){"object"==typeof module&&"object"==typeof module.exports?module.exports=a.document?b(a,!0):function(a){if(!a.document)throw new Error("jQuery requires a window with a document");return b(a)}:b(a)}("undefined"!=typeof window?window:this,function(a,b){var c=[],d=c.slice,e=c.concat,f=c.push,g=c.indexOf,h={},i=h.toString,j=h.hasOwnProperty,k={},l="1.11.1",m=function(a,b){return new m.fn.init(a,b)},n=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,o=/^-ms-/,p=/-([\da-z])/gi,q=function(a,b){return b.toUpperCase()};m.fn=m.prototype={jquery:l,constructor:m,selector:"",length:0,toArray:function(){return d.call(this)},get:function(a){return null!=a?0>a?this[a+this.length]:this[a]:d.call(this)},pushStack:function(a){var b=m.merge(this.constructor(),a);return b.prevObject=this,b.context=this.context,b},each:function(a,b){return m.each(this,a,b)},map:function(a){return this.pushStack(m.map(this,function(b,c){return a.call(b,c,b)}))},slice:function(){return this.pushStack(d.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(a){var b=this.length,c=+a+(0>a?b:0);return this.pushStack(c>=0&&b>c?[this[c]]:[])},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:c.sort,splice:c.splice},m.extend=m.fn.extend=function(){var a,b,c,d,e,f,g=arguments[0]||{},h=1,i=arguments.length,j=!1;for("boolean"==typeof g&&(j=g,g=arguments[h]||{},h++),"object"==typeof g||m.isFunction(g)||(g={}),h===i&&(g=this,h--);i>h;h++)if(null!=(e=arguments[h]))for(d in e)a=g[d],c=e[d],g!==c&&(j&&c&&(m.isPlainObject(c)||(b=m.isArray(c)))?(b?(b=!1,f=a&&m.isArray(a)?a:[]):f=a&&m.isPlainObject(a)?a:{},g[d]=m.extend(j,f,c)):void 0!==c&&(g[d]=c));return g},m.extend({expando:"jQuery"+(l+Math.random()).replace(/\D/g,""),isReady:!0,error:function(a){throw new Error(a)},noop:function(){},isFunction:function(a){return"function"===m.type(a)},isArray:Array.isArray||function(a){return"array"===m.type(a)},isWindow:function(a){return null!=a&&a==a.window},isNumeric:function(a){return!m.isArray(a)&&a-parseFloat(a)>=0},isEmptyObject:function(a){var b;for(b in a)return!1;return!0},isPlainObject:function(a){var b;if(!a||"object"!==m.type(a)||a.nodeType||m.isWindow(a))return!1;try{if(a.constructor&&!j.call(a,"constructor")&&!j.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}if(k.ownLast)for(b in a)return j.call(a,b);for(b in a);return void 0===b||j.call(a,b)},type:function(a){return null==a?a+"":"object"==typeof a||"function"==typeof a?h[i.call(a)]||"object":typeof a},globalEval:function(b){b&&m.trim(b)&&(a.execScript||function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return a.replace(o,"ms-").replace(p,q)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toLowerCase()===b.toLowerCase()},each:function(a,b,c){var d,e=0,f=a.length,g=r(a);if(c){if(g){for(;f>e;e++)if(d=b.apply(a[e],c),d===!1)break}else for(e in a)if(d=b.apply(a[e],c),d===!1)break}else if(g){for(;f>e;e++)if(d=b.call(a[e],e,a[e]),d===!1)break}else for(e in a)if(d=b.call(a[e],e,a[e]),d===!1)break;return a},trim:function(a){return null==a?"":(a+"").replace(n,"")},makeArray:function(a,b){var c=b||[];return null!=a&&(r(Object(a))?m.merge(c,"string"==typeof a?[a]:a):f.call(c,a)),c},inArray:function(a,b,c){var d;if(b){if(g)return g.call(b,a,c);for(d=b.length,c=c?0>c?Math.max(0,d+c):c:0;d>c;c++)if(c in b&&b[c]===a)return c}return-1},merge:function(a,b){var c=+b.length,d=0,e=a.length;while(c>d)a[e++]=b[d++];if(c!==c)while(void 0!==b[d])a[e++]=b[d++];return a.length=e,a},grep:function(a,b,c){for(var d,e=[],f=0,g=a.length,h=!c;g>f;f++)d=!b(a[f],f),d!==h&&e.push(a[f]);return e},map:function(a,b,c){var d,f=0,g=a.length,h=r(a),i=[];if(h)for(;g>f;f++)d=b(a[f],f,c),null!=d&&i.push(d);else for(f in a)d=b(a[f],f,c),null!=d&&i.push(d);return e.apply([],i)},guid:1,proxy:function(a,b){var c,e,f;return"string"==typeof b&&(f=a[b],b=a,a=f),m.isFunction(a)?(c=d.call(arguments,2),e=function(){return a.apply(b||this,c.concat(d.call(arguments)))},e.guid=a.guid=a.guid||m.guid++,e):void 0},now:function(){return+new Date},support:k}),m.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(a,b){h["[object "+b+"]"]=b.toLowerCase()});function r(a){var b=a.length,c=m.type(a);return"function"===c||m.isWindow(a)?!1:1===a.nodeType&&b?!0:"array"===c||0===b||"number"==typeof b&&b>0&&b-1 in a}var s=function(a){var b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u="sizzle"+-new Date,v=a.document,w=0,x=0,y=gb(),z=gb(),A=gb(),B=function(a,b){return a===b&&(l=!0),0},C="undefined",D=1<<31,E={}.hasOwnProperty,F=[],G=F.pop,H=F.push,I=F.push,J=F.slice,K=F.indexOf||function(a){for(var b=0,c=this.length;c>b;b++)if(this[b]===a)return b;return-1},L="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",N="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",O=N.replace("w","w#"),P="\\["+M+"*("+N+")(?:"+M+"*([*^$|!~]?=)"+M+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+O+"))|)"+M+"*\\]",Q=":("+N+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+P+")*)|.*)\\)|)",R=new RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),S=new RegExp("^"+M+"*,"+M+"*"),T=new RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),U=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),V=new RegExp(Q),W=new RegExp("^"+O+"$"),X={ID:new RegExp("^#("+N+")"),CLASS:new RegExp("^\\.("+N+")"),TAG:new RegExp("^("+N.replace("w","w*")+")"),ATTR:new RegExp("^"+P),PSEUDO:new RegExp("^"+Q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+L+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,$=/^[^{]+\{\s*\[native \w/,_=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ab=/[+~]/,bb=/'|\\/g,cb=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),db=function(a,b,c){var d="0x"+b-65536;return d!==d||c?b:0>d?String.fromCharCode(d+65536):String.fromCharCode(d>>10|55296,1023&d|56320)};try{I.apply(F=J.call(v.childNodes),v.childNodes),F[v.childNodes.length].nodeType}catch(eb){I={apply:F.length?function(a,b){H.apply(a,J.call(b))}:function(a,b){var c=a.length,d=0;while(a[c++]=b[d++]);a.length=c-1}}}function fb(a,b,d,e){var f,h,j,k,l,o,r,s,w,x;if((b?b.ownerDocument||b:v)!==n&&m(b),b=b||n,d=d||[],!a||"string"!=typeof a)return d;if(1!==(k=b.nodeType)&&9!==k)return[];if(p&&!e){if(f=_.exec(a))if(j=f[1]){if(9===k){if(h=b.getElementById(j),!h||!h.parentNode)return d;if(h.id===j)return d.push(h),d}else if(b.ownerDocument&&(h=b.ownerDocument.getElementById(j))&&t(b,h)&&h.id===j)return d.push(h),d}else{if(f[2])return I.apply(d,b.getElementsByTagName(a)),d;if((j=f[3])&&c.getElementsByClassName&&b.getElementsByClassName)return I.apply(d,b.getElementsByClassName(j)),d}if(c.qsa&&(!q||!q.test(a))){if(s=r=u,w=b,x=9===k&&a,1===k&&"object"!==b.nodeName.toLowerCase()){o=g(a),(r=b.getAttribute("id"))?s=r.replace(bb,"\\$&"):b.setAttribute("id",s),s="[id='"+s+"'] ",l=o.length;while(l--)o[l]=s+qb(o[l]);w=ab.test(a)&&ob(b.parentNode)||b,x=o.join(",")}if(x)try{return I.apply(d,w.querySelectorAll(x)),d}catch(y){}finally{r||b.removeAttribute("id")}}}return i(a.replace(R,"$1"),b,d,e)}function gb(){var a=[];function b(c,e){return a.push(c+" ")>d.cacheLength&&delete b[a.shift()],b[c+" "]=e}return b}function hb(a){return a[u]=!0,a}function ib(a){var b=n.createElement("div");try{return!!a(b)}catch(c){return!1}finally{b.parentNode&&b.parentNode.removeChild(b),b=null}}function jb(a,b){var c=a.split("|"),e=a.length;while(e--)d.attrHandle[c[e]]=b}function kb(a,b){var c=b&&a,d=c&&1===a.nodeType&&1===b.nodeType&&(~b.sourceIndex||D)-(~a.sourceIndex||D);if(d)return d;if(c)while(c=c.nextSibling)if(c===b)return-1;return a?1:-1}function lb(a){return function(b){var c=b.nodeName.toLowerCase();return"input"===c&&b.type===a}}function mb(a){return function(b){var c=b.nodeName.toLowerCase();return("input"===c||"button"===c)&&b.type===a}}function nb(a){return hb(function(b){return b=+b,hb(function(c,d){var e,f=a([],c.length,b),g=f.length;while(g--)c[e=f[g]]&&(c[e]=!(d[e]=c[e]))})})}function ob(a){return a&&typeof a.getElementsByTagName!==C&&a}c=fb.support={},f=fb.isXML=function(a){var b=a&&(a.ownerDocument||a).documentElement;return b?"HTML"!==b.nodeName:!1},m=fb.setDocument=function(a){var b,e=a?a.ownerDocument||a:v,g=e.defaultView;return e!==n&&9===e.nodeType&&e.documentElement?(n=e,o=e.documentElement,p=!f(e),g&&g!==g.top&&(g.addEventListener?g.addEventListener("unload",function(){m()},!1):g.attachEvent&&g.attachEvent("onunload",function(){m()})),c.attributes=ib(function(a){return a.className="i",!a.getAttribute("className")}),c.getElementsByTagName=ib(function(a){return a.appendChild(e.createComment("")),!a.getElementsByTagName("*").length}),c.getElementsByClassName=$.test(e.getElementsByClassName)&&ib(function(a){return a.innerHTML="<div class='a'></div><div class='a i'></div>",a.firstChild.className="i",2===a.getElementsByClassName("i").length}),c.getById=ib(function(a){return o.appendChild(a).id=u,!e.getElementsByName||!e.getElementsByName(u).length}),c.getById?(d.find.ID=function(a,b){if(typeof b.getElementById!==C&&p){var c=b.getElementById(a);return c&&c.parentNode?[c]:[]}},d.filter.ID=function(a){var b=a.replace(cb,db);return function(a){return a.getAttribute("id")===b}}):(delete d.find.ID,d.filter.ID=function(a){var b=a.replace(cb,db);return function(a){var c=typeof a.getAttributeNode!==C&&a.getAttributeNode("id");return c&&c.value===b}}),d.find.TAG=c.getElementsByTagName?function(a,b){return typeof b.getElementsByTagName!==C?b.getElementsByTagName(a):void 0}:function(a,b){var c,d=[],e=0,f=b.getElementsByTagName(a);if("*"===a){while(c=f[e++])1===c.nodeType&&d.push(c);return d}return f},d.find.CLASS=c.getElementsByClassName&&function(a,b){return typeof b.getElementsByClassName!==C&&p?b.getElementsByClassName(a):void 0},r=[],q=[],(c.qsa=$.test(e.querySelectorAll))&&(ib(function(a){a.innerHTML="<select msallowclip=''><option selected=''></option></select>",a.querySelectorAll("[msallowclip^='']").length&&q.push("[*^$]="+M+"*(?:''|\"\")"),a.querySelectorAll("[selected]").length||q.push("\\["+M+"*(?:value|"+L+")"),a.querySelectorAll(":checked").length||q.push(":checked")}),ib(function(a){var b=e.createElement("input");b.setAttribute("type","hidden"),a.appendChild(b).setAttribute("name","D"),a.querySelectorAll("[name=d]").length&&q.push("name"+M+"*[*^$|!~]?="),a.querySelectorAll(":enabled").length||q.push(":enabled",":disabled"),a.querySelectorAll("*,:x"),q.push(",.*:")})),(c.matchesSelector=$.test(s=o.matches||o.webkitMatchesSelector||o.mozMatchesSelector||o.oMatchesSelector||o.msMatchesSelector))&&ib(function(a){c.disconnectedMatch=s.call(a,"div"),s.call(a,"[s!='']:x"),r.push("!=",Q)}),q=q.length&&new RegExp(q.join("|")),r=r.length&&new RegExp(r.join("|")),b=$.test(o.compareDocumentPosition),t=b||$.test(o.contains)?function(a,b){var c=9===a.nodeType?a.documentElement:a,d=b&&b.parentNode;return a===d||!(!d||1!==d.nodeType||!(c.contains?c.contains(d):a.compareDocumentPosition&&16&a.compareDocumentPosition(d)))}:function(a,b){if(b)while(b=b.parentNode)if(b===a)return!0;return!1},B=b?function(a,b){if(a===b)return l=!0,0;var d=!a.compareDocumentPosition-!b.compareDocumentPosition;return d?d:(d=(a.ownerDocument||a)===(b.ownerDocument||b)?a.compareDocumentPosition(b):1,1&d||!c.sortDetached&&b.compareDocumentPosition(a)===d?a===e||a.ownerDocument===v&&t(v,a)?-1:b===e||b.ownerDocument===v&&t(v,b)?1:k?K.call(k,a)-K.call(k,b):0:4&d?-1:1)}:function(a,b){if(a===b)return l=!0,0;var c,d=0,f=a.parentNode,g=b.parentNode,h=[a],i=[b];if(!f||!g)return a===e?-1:b===e?1:f?-1:g?1:k?K.call(k,a)-K.call(k,b):0;if(f===g)return kb(a,b);c=a;while(c=c.parentNode)h.unshift(c);c=b;while(c=c.parentNode)i.unshift(c);while(h[d]===i[d])d++;return d?kb(h[d],i[d]):h[d]===v?-1:i[d]===v?1:0},e):n},fb.matches=function(a,b){return fb(a,null,null,b)},fb.matchesSelector=function(a,b){if((a.ownerDocument||a)!==n&&m(a),b=b.replace(U,"='$1']"),!(!c.matchesSelector||!p||r&&r.test(b)||q&&q.test(b)))try{var d=s.call(a,b);if(d||c.disconnectedMatch||a.document&&11!==a.document.nodeType)return d}catch(e){}return fb(b,n,null,[a]).length>0},fb.contains=function(a,b){return(a.ownerDocument||a)!==n&&m(a),t(a,b)},fb.attr=function(a,b){(a.ownerDocument||a)!==n&&m(a);var e=d.attrHandle[b.toLowerCase()],f=e&&E.call(d.attrHandle,b.toLowerCase())?e(a,b,!p):void 0;return void 0!==f?f:c.attributes||!p?a.getAttribute(b):(f=a.getAttributeNode(b))&&f.specified?f.value:null},fb.error=function(a){throw new Error("Syntax error, unrecognized expression: "+a)},fb.uniqueSort=function(a){var b,d=[],e=0,f=0;if(l=!c.detectDuplicates,k=!c.sortStable&&a.slice(0),a.sort(B),l){while(b=a[f++])b===a[f]&&(e=d.push(f));while(e--)a.splice(d[e],1)}return k=null,a},e=fb.getText=function(a){var b,c="",d=0,f=a.nodeType;if(f){if(1===f||9===f||11===f){if("string"==typeof a.textContent)return a.textContent;for(a=a.firstChild;a;a=a.nextSibling)c+=e(a)}else if(3===f||4===f)return a.nodeValue}else while(b=a[d++])c+=e(b);return c},d=fb.selectors={cacheLength:50,createPseudo:hb,match:X,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(a){return a[1]=a[1].replace(cb,db),a[3]=(a[3]||a[4]||a[5]||"").replace(cb,db),"~="===a[2]&&(a[3]=" "+a[3]+" "),a.slice(0,4)},CHILD:function(a){return a[1]=a[1].toLowerCase(),"nth"===a[1].slice(0,3)?(a[3]||fb.error(a[0]),a[4]=+(a[4]?a[5]+(a[6]||1):2*("even"===a[3]||"odd"===a[3])),a[5]=+(a[7]+a[8]||"odd"===a[3])):a[3]&&fb.error(a[0]),a},PSEUDO:function(a){var b,c=!a[6]&&a[2];return X.CHILD.test(a[0])?null:(a[3]?a[2]=a[4]||a[5]||"":c&&V.test(c)&&(b=g(c,!0))&&(b=c.indexOf(")",c.length-b)-c.length)&&(a[0]=a[0].slice(0,b),a[2]=c.slice(0,b)),a.slice(0,3))}},filter:{TAG:function(a){var b=a.replace(cb,db).toLowerCase();return"*"===a?function(){return!0}:function(a){return a.nodeName&&a.nodeName.toLowerCase()===b}},CLASS:function(a){var b=y[a+" "];return b||(b=new RegExp("(^|"+M+")"+a+"("+M+"|$)"))&&y(a,function(a){return b.test("string"==typeof a.className&&a.className||typeof a.getAttribute!==C&&a.getAttribute("class")||"")})},ATTR:function(a,b,c){return function(d){var e=fb.attr(d,a);return null==e?"!="===b:b?(e+="","="===b?e===c:"!="===b?e!==c:"^="===b?c&&0===e.indexOf(c):"*="===b?c&&e.indexOf(c)>-1:"$="===b?c&&e.slice(-c.length)===c:"~="===b?(" "+e+" ").indexOf(c)>-1:"|="===b?e===c||e.slice(0,c.length+1)===c+"-":!1):!0}},CHILD:function(a,b,c,d,e){var f="nth"!==a.slice(0,3),g="last"!==a.slice(-4),h="of-type"===b;return 1===d&&0===e?function(a){return!!a.parentNode}:function(b,c,i){var j,k,l,m,n,o,p=f!==g?"nextSibling":"previousSibling",q=b.parentNode,r=h&&b.nodeName.toLowerCase(),s=!i&&!h;if(q){if(f){while(p){l=b;while(l=l[p])if(h?l.nodeName.toLowerCase()===r:1===l.nodeType)return!1;o=p="only"===a&&!o&&"nextSibling"}return!0}if(o=[g?q.firstChild:q.lastChild],g&&s){k=q[u]||(q[u]={}),j=k[a]||[],n=j[0]===w&&j[1],m=j[0]===w&&j[2],l=n&&q.childNodes[n];while(l=++n&&l&&l[p]||(m=n=0)||o.pop())if(1===l.nodeType&&++m&&l===b){k[a]=[w,n,m];break}}else if(s&&(j=(b[u]||(b[u]={}))[a])&&j[0]===w)m=j[1];else while(l=++n&&l&&l[p]||(m=n=0)||o.pop())if((h?l.nodeName.toLowerCase()===r:1===l.nodeType)&&++m&&(s&&((l[u]||(l[u]={}))[a]=[w,m]),l===b))break;return m-=e,m===d||m%d===0&&m/d>=0}}},PSEUDO:function(a,b){var c,e=d.pseudos[a]||d.setFilters[a.toLowerCase()]||fb.error("unsupported pseudo: "+a);return e[u]?e(b):e.length>1?(c=[a,a,"",b],d.setFilters.hasOwnProperty(a.toLowerCase())?hb(function(a,c){var d,f=e(a,b),g=f.length;while(g--)d=K.call(a,f[g]),a[d]=!(c[d]=f[g])}):function(a){return e(a,0,c)}):e}},pseudos:{not:hb(function(a){var b=[],c=[],d=h(a.replace(R,"$1"));return d[u]?hb(function(a,b,c,e){var f,g=d(a,null,e,[]),h=a.length;while(h--)(f=g[h])&&(a[h]=!(b[h]=f))}):function(a,e,f){return b[0]=a,d(b,null,f,c),!c.pop()}}),has:hb(function(a){return function(b){return fb(a,b).length>0}}),contains:hb(function(a){return function(b){return(b.textContent||b.innerText||e(b)).indexOf(a)>-1}}),lang:hb(function(a){return W.test(a||"")||fb.error("unsupported lang: "+a),a=a.replace(cb,db).toLowerCase(),function(b){var c;do if(c=p?b.lang:b.getAttribute("xml:lang")||b.getAttribute("lang"))return c=c.toLowerCase(),c===a||0===c.indexOf(a+"-");while((b=b.parentNode)&&1===b.nodeType);return!1}}),target:function(b){var c=a.location&&a.location.hash;return c&&c.slice(1)===b.id},root:function(a){return a===o},focus:function(a){return a===n.activeElement&&(!n.hasFocus||n.hasFocus())&&!!(a.type||a.href||~a.tabIndex)},enabled:function(a){return a.disabled===!1},disabled:function(a){return a.disabled===!0},checked:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&!!a.checked||"option"===b&&!!a.selected},selected:function(a){return a.parentNode&&a.parentNode.selectedIndex,a.selected===!0},empty:function(a){for(a=a.firstChild;a;a=a.nextSibling)if(a.nodeType<6)return!1;return!0},parent:function(a){return!d.pseudos.empty(a)},header:function(a){return Z.test(a.nodeName)},input:function(a){return Y.test(a.nodeName)},button:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&"button"===a.type||"button"===b},text:function(a){var b;return"input"===a.nodeName.toLowerCase()&&"text"===a.type&&(null==(b=a.getAttribute("type"))||"text"===b.toLowerCase())},first:nb(function(){return[0]}),last:nb(function(a,b){return[b-1]}),eq:nb(function(a,b,c){return[0>c?c+b:c]}),even:nb(function(a,b){for(var c=0;b>c;c+=2)a.push(c);return a}),odd:nb(function(a,b){for(var c=1;b>c;c+=2)a.push(c);return a}),lt:nb(function(a,b,c){for(var d=0>c?c+b:c;--d>=0;)a.push(d);return a}),gt:nb(function(a,b,c){for(var d=0>c?c+b:c;++d<b;)a.push(d);return a})}},d.pseudos.nth=d.pseudos.eq;for(b in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})d.pseudos[b]=lb(b);for(b in{submit:!0,reset:!0})d.pseudos[b]=mb(b);function pb(){}pb.prototype=d.filters=d.pseudos,d.setFilters=new pb,g=fb.tokenize=function(a,b){var c,e,f,g,h,i,j,k=z[a+" "];if(k)return b?0:k.slice(0);h=a,i=[],j=d.preFilter;while(h){(!c||(e=S.exec(h)))&&(e&&(h=h.slice(e[0].length)||h),i.push(f=[])),c=!1,(e=T.exec(h))&&(c=e.shift(),f.push({value:c,type:e[0].replace(R," ")}),h=h.slice(c.length));for(g in d.filter)!(e=X[g].exec(h))||j[g]&&!(e=j[g](e))||(c=e.shift(),f.push({value:c,type:g,matches:e}),h=h.slice(c.length));if(!c)break}return b?h.length:h?fb.error(a):z(a,i).slice(0)};function qb(a){for(var b=0,c=a.length,d="";c>b;b++)d+=a[b].value;return d}function rb(a,b,c){var d=b.dir,e=c&&"parentNode"===d,f=x++;return b.first?function(b,c,f){while(b=b[d])if(1===b.nodeType||e)return a(b,c,f)}:function(b,c,g){var h,i,j=[w,f];if(g){while(b=b[d])if((1===b.nodeType||e)&&a(b,c,g))return!0}else while(b=b[d])if(1===b.nodeType||e){if(i=b[u]||(b[u]={}),(h=i[d])&&h[0]===w&&h[1]===f)return j[2]=h[2];if(i[d]=j,j[2]=a(b,c,g))return!0}}}function sb(a){return a.length>1?function(b,c,d){var e=a.length;while(e--)if(!a[e](b,c,d))return!1;return!0}:a[0]}function tb(a,b,c){for(var d=0,e=b.length;e>d;d++)fb(a,b[d],c);return c}function ub(a,b,c,d,e){for(var f,g=[],h=0,i=a.length,j=null!=b;i>h;h++)(f=a[h])&&(!c||c(f,d,e))&&(g.push(f),j&&b.push(h));return g}function vb(a,b,c,d,e,f){return d&&!d[u]&&(d=vb(d)),e&&!e[u]&&(e=vb(e,f)),hb(function(f,g,h,i){var j,k,l,m=[],n=[],o=g.length,p=f||tb(b||"*",h.nodeType?[h]:h,[]),q=!a||!f&&b?p:ub(p,m,a,h,i),r=c?e||(f?a:o||d)?[]:g:q;if(c&&c(q,r,h,i),d){j=ub(r,n),d(j,[],h,i),k=j.length;while(k--)(l=j[k])&&(r[n[k]]=!(q[n[k]]=l))}if(f){if(e||a){if(e){j=[],k=r.length;while(k--)(l=r[k])&&j.push(q[k]=l);e(null,r=[],j,i)}k=r.length;while(k--)(l=r[k])&&(j=e?K.call(f,l):m[k])>-1&&(f[j]=!(g[j]=l))}}else r=ub(r===g?r.splice(o,r.length):r),e?e(null,g,r,i):I.apply(g,r)})}function wb(a){for(var b,c,e,f=a.length,g=d.relative[a[0].type],h=g||d.relative[" "],i=g?1:0,k=rb(function(a){return a===b},h,!0),l=rb(function(a){return K.call(b,a)>-1},h,!0),m=[function(a,c,d){return!g&&(d||c!==j)||((b=c).nodeType?k(a,c,d):l(a,c,d))}];f>i;i++)if(c=d.relative[a[i].type])m=[rb(sb(m),c)];else{if(c=d.filter[a[i].type].apply(null,a[i].matches),c[u]){for(e=++i;f>e;e++)if(d.relative[a[e].type])break;return vb(i>1&&sb(m),i>1&&qb(a.slice(0,i-1).concat({value:" "===a[i-2].type?"*":""})).replace(R,"$1"),c,e>i&&wb(a.slice(i,e)),f>e&&wb(a=a.slice(e)),f>e&&qb(a))}m.push(c)}return sb(m)}function xb(a,b){var c=b.length>0,e=a.length>0,f=function(f,g,h,i,k){var l,m,o,p=0,q="0",r=f&&[],s=[],t=j,u=f||e&&d.find.TAG("*",k),v=w+=null==t?1:Math.random()||.1,x=u.length;for(k&&(j=g!==n&&g);q!==x&&null!=(l=u[q]);q++){if(e&&l){m=0;while(o=a[m++])if(o(l,g,h)){i.push(l);break}k&&(w=v)}c&&((l=!o&&l)&&p--,f&&r.push(l))}if(p+=q,c&&q!==p){m=0;while(o=b[m++])o(r,s,g,h);if(f){if(p>0)while(q--)r[q]||s[q]||(s[q]=G.call(i));s=ub(s)}I.apply(i,s),k&&!f&&s.length>0&&p+b.length>1&&fb.uniqueSort(i)}return k&&(w=v,j=t),r};return c?hb(f):f}return h=fb.compile=function(a,b){var c,d=[],e=[],f=A[a+" "];if(!f){b||(b=g(a)),c=b.length;while(c--)f=wb(b[c]),f[u]?d.push(f):e.push(f);f=A(a,xb(e,d)),f.selector=a}return f},i=fb.select=function(a,b,e,f){var i,j,k,l,m,n="function"==typeof a&&a,o=!f&&g(a=n.selector||a);if(e=e||[],1===o.length){if(j=o[0]=o[0].slice(0),j.length>2&&"ID"===(k=j[0]).type&&c.getById&&9===b.nodeType&&p&&d.relative[j[1].type]){if(b=(d.find.ID(k.matches[0].replace(cb,db),b)||[])[0],!b)return e;n&&(b=b.parentNode),a=a.slice(j.shift().value.length)}i=X.needsContext.test(a)?0:j.length;while(i--){if(k=j[i],d.relative[l=k.type])break;if((m=d.find[l])&&(f=m(k.matches[0].replace(cb,db),ab.test(j[0].type)&&ob(b.parentNode)||b))){if(j.splice(i,1),a=f.length&&qb(j),!a)return I.apply(e,f),e;break}}}return(n||h(a,o))(f,b,!p,e,ab.test(a)&&ob(b.parentNode)||b),e},c.sortStable=u.split("").sort(B).join("")===u,c.detectDuplicates=!!l,m(),c.sortDetached=ib(function(a){return 1&a.compareDocumentPosition(n.createElement("div"))}),ib(function(a){return a.innerHTML="<a href='#'></a>","#"===a.firstChild.getAttribute("href")})||jb("type|href|height|width",function(a,b,c){return c?void 0:a.getAttribute(b,"type"===b.toLowerCase()?1:2)}),c.attributes&&ib(function(a){return a.innerHTML="<input/>",a.firstChild.setAttribute("value",""),""===a.firstChild.getAttribute("value")})||jb("value",function(a,b,c){return c||"input"!==a.nodeName.toLowerCase()?void 0:a.defaultValue}),ib(function(a){return null==a.getAttribute("disabled")})||jb(L,function(a,b,c){var d;return c?void 0:a[b]===!0?b.toLowerCase():(d=a.getAttributeNode(b))&&d.specified?d.value:null}),fb}(a);m.find=s,m.expr=s.selectors,m.expr[":"]=m.expr.pseudos,m.unique=s.uniqueSort,m.text=s.getText,m.isXMLDoc=s.isXML,m.contains=s.contains;var t=m.expr.match.needsContext,u=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,v=/^.[^:#\[\.,]*$/;function w(a,b,c){if(m.isFunction(b))return m.grep(a,function(a,d){return!!b.call(a,d,a)!==c});if(b.nodeType)return m.grep(a,function(a){return a===b!==c});if("string"==typeof b){if(v.test(b))return m.filter(b,a,c);b=m.filter(b,a)}return m.grep(a,function(a){return m.inArray(a,b)>=0!==c})}m.filter=function(a,b,c){var d=b[0];return c&&(a=":not("+a+")"),1===b.length&&1===d.nodeType?m.find.matchesSelector(d,a)?[d]:[]:m.find.matches(a,m.grep(b,function(a){return 1===a.nodeType}))},m.fn.extend({find:function(a){var b,c=[],d=this,e=d.length;if("string"!=typeof a)return this.pushStack(m(a).filter(function(){for(b=0;e>b;b++)if(m.contains(d[b],this))return!0}));for(b=0;e>b;b++)m.find(a,d[b],c);return c=this.pushStack(e>1?m.unique(c):c),c.selector=this.selector?this.selector+" "+a:a,c},filter:function(a){return this.pushStack(w(this,a||[],!1))},not:function(a){return this.pushStack(w(this,a||[],!0))},is:function(a){return!!w(this,"string"==typeof a&&t.test(a)?m(a):a||[],!1).length}});var x,y=a.document,z=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,A=m.fn.init=function(a,b){var c,d;if(!a)return this;if("string"==typeof a){if(c="<"===a.charAt(0)&&">"===a.charAt(a.length-1)&&a.length>=3?[null,a,null]:z.exec(a),!c||!c[1]&&b)return!b||b.jquery?(b||x).find(a):this.constructor(b).find(a);if(c[1]){if(b=b instanceof m?b[0]:b,m.merge(this,m.parseHTML(c[1],b&&b.nodeType?b.ownerDocument||b:y,!0)),u.test(c[1])&&m.isPlainObject(b))for(c in b)m.isFunction(this[c])?this[c](b[c]):this.attr(c,b[c]);return this}if(d=y.getElementById(c[2]),d&&d.parentNode){if(d.id!==c[2])return x.find(a);this.length=1,this[0]=d}return this.context=y,this.selector=a,this}return a.nodeType?(this.context=this[0]=a,this.length=1,this):m.isFunction(a)?"undefined"!=typeof x.ready?x.ready(a):a(m):(void 0!==a.selector&&(this.selector=a.selector,this.context=a.context),m.makeArray(a,this))};A.prototype=m.fn,x=m(y);var B=/^(?:parents|prev(?:Until|All))/,C={children:!0,contents:!0,next:!0,prev:!0};m.extend({dir:function(a,b,c){var d=[],e=a[b];while(e&&9!==e.nodeType&&(void 0===c||1!==e.nodeType||!m(e).is(c)))1===e.nodeType&&d.push(e),e=e[b];return d},sibling:function(a,b){for(var c=[];a;a=a.nextSibling)1===a.nodeType&&a!==b&&c.push(a);return c}}),m.fn.extend({has:function(a){var b,c=m(a,this),d=c.length;return this.filter(function(){for(b=0;d>b;b++)if(m.contains(this,c[b]))return!0})},closest:function(a,b){for(var c,d=0,e=this.length,f=[],g=t.test(a)||"string"!=typeof a?m(a,b||this.context):0;e>d;d++)for(c=this[d];c&&c!==b;c=c.parentNode)if(c.nodeType<11&&(g?g.index(c)>-1:1===c.nodeType&&m.find.matchesSelector(c,a))){f.push(c);break}return this.pushStack(f.length>1?m.unique(f):f)},index:function(a){return a?"string"==typeof a?m.inArray(this[0],m(a)):m.inArray(a.jquery?a[0]:a,this):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(a,b){return this.pushStack(m.unique(m.merge(this.get(),m(a,b))))},addBack:function(a){return this.add(null==a?this.prevObject:this.prevObject.filter(a))}});function D(a,b){do a=a[b];while(a&&1!==a.nodeType);return a}m.each({parent:function(a){var b=a.parentNode;return b&&11!==b.nodeType?b:null},parents:function(a){return m.dir(a,"parentNode")},parentsUntil:function(a,b,c){return m.dir(a,"parentNode",c)},next:function(a){return D(a,"nextSibling")},prev:function(a){return D(a,"previousSibling")},nextAll:function(a){return m.dir(a,"nextSibling")},prevAll:function(a){return m.dir(a,"previousSibling")},nextUntil:function(a,b,c){return m.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return m.dir(a,"previousSibling",c)},siblings:function(a){return m.sibling((a.parentNode||{}).firstChild,a)},children:function(a){return m.sibling(a.firstChild)},contents:function(a){return m.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:m.merge([],a.childNodes)}},function(a,b){m.fn[a]=function(c,d){var e=m.map(this,b,c);return"Until"!==a.slice(-5)&&(d=c),d&&"string"==typeof d&&(e=m.filter(d,e)),this.length>1&&(C[a]||(e=m.unique(e)),B.test(a)&&(e=e.reverse())),this.pushStack(e)}});var E=/\S+/g,F={};function G(a){var b=F[a]={};return m.each(a.match(E)||[],function(a,c){b[c]=!0}),b}m.Callbacks=function(a){a="string"==typeof a?F[a]||G(a):m.extend({},a);var b,c,d,e,f,g,h=[],i=!a.once&&[],j=function(l){for(c=a.memory&&l,d=!0,f=g||0,g=0,e=h.length,b=!0;h&&e>f;f++)if(h[f].apply(l[0],l[1])===!1&&a.stopOnFalse){c=!1;break}b=!1,h&&(i?i.length&&j(i.shift()):c?h=[]:k.disable())},k={add:function(){if(h){var d=h.length;!function f(b){m.each(b,function(b,c){var d=m.type(c);"function"===d?a.unique&&k.has(c)||h.push(c):c&&c.length&&"string"!==d&&f(c)})}(arguments),b?e=h.length:c&&(g=d,j(c))}return this},remove:function(){return h&&m.each(arguments,function(a,c){var d;while((d=m.inArray(c,h,d))>-1)h.splice(d,1),b&&(e>=d&&e--,f>=d&&f--)}),this},has:function(a){return a?m.inArray(a,h)>-1:!(!h||!h.length)},empty:function(){return h=[],e=0,this},disable:function(){return h=i=c=void 0,this},disabled:function(){return!h},lock:function(){return i=void 0,c||k.disable(),this},locked:function(){return!i},fireWith:function(a,c){return!h||d&&!i||(c=c||[],c=[a,c.slice?c.slice():c],b?i.push(c):j(c)),this},fire:function(){return k.fireWith(this,arguments),this},fired:function(){return!!d}};return k},m.extend({Deferred:function(a){var b=[["resolve","done",m.Callbacks("once memory"),"resolved"],["reject","fail",m.Callbacks("once memory"),"rejected"],["notify","progress",m.Callbacks("memory")]],c="pending",d={state:function(){return c},always:function(){return e.done(arguments).fail(arguments),this},then:function(){var a=arguments;return m.Deferred(function(c){m.each(b,function(b,f){var g=m.isFunction(a[b])&&a[b];e[f[1]](function(){var a=g&&g.apply(this,arguments);a&&m.isFunction(a.promise)?a.promise().done(c.resolve).fail(c.reject).progress(c.notify):c[f[0]+"With"](this===d?c.promise():this,g?[a]:arguments)})}),a=null}).promise()},promise:function(a){return null!=a?m.extend(a,d):d}},e={};return d.pipe=d.then,m.each(b,function(a,f){var g=f[2],h=f[3];d[f[1]]=g.add,h&&g.add(function(){c=h},b[1^a][2].disable,b[2][2].lock),e[f[0]]=function(){return e[f[0]+"With"](this===e?d:this,arguments),this},e[f[0]+"With"]=g.fireWith}),d.promise(e),a&&a.call(e,e),e},when:function(a){var b=0,c=d.call(arguments),e=c.length,f=1!==e||a&&m.isFunction(a.promise)?e:0,g=1===f?a:m.Deferred(),h=function(a,b,c){return function(e){b[a]=this,c[a]=arguments.length>1?d.call(arguments):e,c===i?g.notifyWith(b,c):--f||g.resolveWith(b,c)}},i,j,k;if(e>1)for(i=new Array(e),j=new Array(e),k=new Array(e);e>b;b++)c[b]&&m.isFunction(c[b].promise)?c[b].promise().done(h(b,k,c)).fail(g.reject).progress(h(b,j,i)):--f;return f||g.resolveWith(k,c),g.promise()}});var H;m.fn.ready=function(a){return m.ready.promise().done(a),this},m.extend({isReady:!1,readyWait:1,holdReady:function(a){a?m.readyWait++:m.ready(!0)},ready:function(a){if(a===!0?!--m.readyWait:!m.isReady){if(!y.body)return setTimeout(m.ready);m.isReady=!0,a!==!0&&--m.readyWait>0||(H.resolveWith(y,[m]),m.fn.triggerHandler&&(m(y).triggerHandler("ready"),m(y).off("ready")))}}});function I(){y.addEventListener?(y.removeEventListener("DOMContentLoaded",J,!1),a.removeEventListener("load",J,!1)):(y.detachEvent("onreadystatechange",J),a.detachEvent("onload",J))}function J(){(y.addEventListener||"load"===event.type||"complete"===y.readyState)&&(I(),m.ready())}m.ready.promise=function(b){if(!H)if(H=m.Deferred(),"complete"===y.readyState)setTimeout(m.ready);else if(y.addEventListener)y.addEventListener("DOMContentLoaded",J,!1),a.addEventListener("load",J,!1);else{y.attachEvent("onreadystatechange",J),a.attachEvent("onload",J);var c=!1;try{c=null==a.frameElement&&y.documentElement}catch(d){}c&&c.doScroll&&!function e(){if(!m.isReady){try{c.doScroll("left")}catch(a){return setTimeout(e,50)}I(),m.ready()}}()}return H.promise(b)};var K="undefined",L;for(L in m(k))break;k.ownLast="0"!==L,k.inlineBlockNeedsLayout=!1,m(function(){var a,b,c,d;c=y.getElementsByTagName("body")[0],c&&c.style&&(b=y.createElement("div"),d=y.createElement("div"),d.style.cssText="position:absolute;border:0;width:0;height:0;top:0;left:-9999px",c.appendChild(d).appendChild(b),typeof b.style.zoom!==K&&(b.style.cssText="display:inline;margin:0;border:0;padding:1px;width:1px;zoom:1",k.inlineBlockNeedsLayout=a=3===b.offsetWidth,a&&(c.style.zoom=1)),c.removeChild(d))}),function(){var a=y.createElement("div");if(null==k.deleteExpando){k.deleteExpando=!0;try{delete a.test}catch(b){k.deleteExpando=!1}}a=null}(),m.acceptData=function(a){var b=m.noData[(a.nodeName+" ").toLowerCase()],c=+a.nodeType||1;return 1!==c&&9!==c?!1:!b||b!==!0&&a.getAttribute("classid")===b};var M=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,N=/([A-Z])/g;function O(a,b,c){if(void 0===c&&1===a.nodeType){var d="data-"+b.replace(N,"-$1").toLowerCase();if(c=a.getAttribute(d),"string"==typeof c){try{c="true"===c?!0:"false"===c?!1:"null"===c?null:+c+""===c?+c:M.test(c)?m.parseJSON(c):c}catch(e){}m.data(a,b,c)}else c=void 0}return c}function P(a){var b;for(b in a)if(("data"!==b||!m.isEmptyObject(a[b]))&&"toJSON"!==b)return!1;return!0}function Q(a,b,d,e){if(m.acceptData(a)){var f,g,h=m.expando,i=a.nodeType,j=i?m.cache:a,k=i?a[h]:a[h]&&h;
+    if(k&&j[k]&&(e||j[k].data)||void 0!==d||"string"!=typeof b)return k||(k=i?a[h]=c.pop()||m.guid++:h),j[k]||(j[k]=i?{}:{toJSON:m.noop}),("object"==typeof b||"function"==typeof b)&&(e?j[k]=m.extend(j[k],b):j[k].data=m.extend(j[k].data,b)),g=j[k],e||(g.data||(g.data={}),g=g.data),void 0!==d&&(g[m.camelCase(b)]=d),"string"==typeof b?(f=g[b],null==f&&(f=g[m.camelCase(b)])):f=g,f}}function R(a,b,c){if(m.acceptData(a)){var d,e,f=a.nodeType,g=f?m.cache:a,h=f?a[m.expando]:m.expando;if(g[h]){if(b&&(d=c?g[h]:g[h].data)){m.isArray(b)?b=b.concat(m.map(b,m.camelCase)):b in d?b=[b]:(b=m.camelCase(b),b=b in d?[b]:b.split(" ")),e=b.length;while(e--)delete d[b[e]];if(c?!P(d):!m.isEmptyObject(d))return}(c||(delete g[h].data,P(g[h])))&&(f?m.cleanData([a],!0):k.deleteExpando||g!=g.window?delete g[h]:g[h]=null)}}}m.extend({cache:{},noData:{"applet ":!0,"embed ":!0,"object ":"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"},hasData:function(a){return a=a.nodeType?m.cache[a[m.expando]]:a[m.expando],!!a&&!P(a)},data:function(a,b,c){return Q(a,b,c)},removeData:function(a,b){return R(a,b)},_data:function(a,b,c){return Q(a,b,c,!0)},_removeData:function(a,b){return R(a,b,!0)}}),m.fn.extend({data:function(a,b){var c,d,e,f=this[0],g=f&&f.attributes;if(void 0===a){if(this.length&&(e=m.data(f),1===f.nodeType&&!m._data(f,"parsedAttrs"))){c=g.length;while(c--)g[c]&&(d=g[c].name,0===d.indexOf("data-")&&(d=m.camelCase(d.slice(5)),O(f,d,e[d])));m._data(f,"parsedAttrs",!0)}return e}return"object"==typeof a?this.each(function(){m.data(this,a)}):arguments.length>1?this.each(function(){m.data(this,a,b)}):f?O(f,a,m.data(f,a)):void 0},removeData:function(a){return this.each(function(){m.removeData(this,a)})}}),m.extend({queue:function(a,b,c){var d;return a?(b=(b||"fx")+"queue",d=m._data(a,b),c&&(!d||m.isArray(c)?d=m._data(a,b,m.makeArray(c)):d.push(c)),d||[]):void 0},dequeue:function(a,b){b=b||"fx";var c=m.queue(a,b),d=c.length,e=c.shift(),f=m._queueHooks(a,b),g=function(){m.dequeue(a,b)};"inprogress"===e&&(e=c.shift(),d--),e&&("fx"===b&&c.unshift("inprogress"),delete f.stop,e.call(a,g,f)),!d&&f&&f.empty.fire()},_queueHooks:function(a,b){var c=b+"queueHooks";return m._data(a,c)||m._data(a,c,{empty:m.Callbacks("once memory").add(function(){m._removeData(a,b+"queue"),m._removeData(a,c)})})}}),m.fn.extend({queue:function(a,b){var c=2;return"string"!=typeof a&&(b=a,a="fx",c--),arguments.length<c?m.queue(this[0],a):void 0===b?this:this.each(function(){var c=m.queue(this,a,b);m._queueHooks(this,a),"fx"===a&&"inprogress"!==c[0]&&m.dequeue(this,a)})},dequeue:function(a){return this.each(function(){m.dequeue(this,a)})},clearQueue:function(a){return this.queue(a||"fx",[])},promise:function(a,b){var c,d=1,e=m.Deferred(),f=this,g=this.length,h=function(){--d||e.resolveWith(f,[f])};"string"!=typeof a&&(b=a,a=void 0),a=a||"fx";while(g--)c=m._data(f[g],a+"queueHooks"),c&&c.empty&&(d++,c.empty.add(h));return h(),e.promise(b)}});var S=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,T=["Top","Right","Bottom","Left"],U=function(a,b){return a=b||a,"none"===m.css(a,"display")||!m.contains(a.ownerDocument,a)},V=m.access=function(a,b,c,d,e,f,g){var h=0,i=a.length,j=null==c;if("object"===m.type(c)){e=!0;for(h in c)m.access(a,b,h,c[h],!0,f,g)}else if(void 0!==d&&(e=!0,m.isFunction(d)||(g=!0),j&&(g?(b.call(a,d),b=null):(j=b,b=function(a,b,c){return j.call(m(a),c)})),b))for(;i>h;h++)b(a[h],c,g?d:d.call(a[h],h,b(a[h],c)));return e?a:j?b.call(a):i?b(a[0],c):f},W=/^(?:checkbox|radio)$/i;!function(){var a=y.createElement("input"),b=y.createElement("div"),c=y.createDocumentFragment();if(b.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",k.leadingWhitespace=3===b.firstChild.nodeType,k.tbody=!b.getElementsByTagName("tbody").length,k.htmlSerialize=!!b.getElementsByTagName("link").length,k.html5Clone="<:nav></:nav>"!==y.createElement("nav").cloneNode(!0).outerHTML,a.type="checkbox",a.checked=!0,c.appendChild(a),k.appendChecked=a.checked,b.innerHTML="<textarea>x</textarea>",k.noCloneChecked=!!b.cloneNode(!0).lastChild.defaultValue,c.appendChild(b),b.innerHTML="<input type='radio' checked='checked' name='t'/>",k.checkClone=b.cloneNode(!0).cloneNode(!0).lastChild.checked,k.noCloneEvent=!0,b.attachEvent&&(b.attachEvent("onclick",function(){k.noCloneEvent=!1}),b.cloneNode(!0).click()),null==k.deleteExpando){k.deleteExpando=!0;try{delete b.test}catch(d){k.deleteExpando=!1}}}(),function(){var b,c,d=y.createElement("div");for(b in{submit:!0,change:!0,focusin:!0})c="on"+b,(k[b+"Bubbles"]=c in a)||(d.setAttribute(c,"t"),k[b+"Bubbles"]=d.attributes[c].expando===!1);d=null}();var X=/^(?:input|select|textarea)$/i,Y=/^key/,Z=/^(?:mouse|pointer|contextmenu)|click/,$=/^(?:focusinfocus|focusoutblur)$/,_=/^([^.]*)(?:\.(.+)|)$/;function ab(){return!0}function bb(){return!1}function cb(){try{return y.activeElement}catch(a){}}m.event={global:{},add:function(a,b,c,d,e){var f,g,h,i,j,k,l,n,o,p,q,r=m._data(a);if(r){c.handler&&(i=c,c=i.handler,e=i.selector),c.guid||(c.guid=m.guid++),(g=r.events)||(g=r.events={}),(k=r.handle)||(k=r.handle=function(a){return typeof m===K||a&&m.event.triggered===a.type?void 0:m.event.dispatch.apply(k.elem,arguments)},k.elem=a),b=(b||"").match(E)||[""],h=b.length;while(h--)f=_.exec(b[h])||[],o=q=f[1],p=(f[2]||"").split(".").sort(),o&&(j=m.event.special[o]||{},o=(e?j.delegateType:j.bindType)||o,j=m.event.special[o]||{},l=m.extend({type:o,origType:q,data:d,handler:c,guid:c.guid,selector:e,needsContext:e&&m.expr.match.needsContext.test(e),namespace:p.join(".")},i),(n=g[o])||(n=g[o]=[],n.delegateCount=0,j.setup&&j.setup.call(a,d,p,k)!==!1||(a.addEventListener?a.addEventListener(o,k,!1):a.attachEvent&&a.attachEvent("on"+o,k))),j.add&&(j.add.call(a,l),l.handler.guid||(l.handler.guid=c.guid)),e?n.splice(n.delegateCount++,0,l):n.push(l),m.event.global[o]=!0);a=null}},remove:function(a,b,c,d,e){var f,g,h,i,j,k,l,n,o,p,q,r=m.hasData(a)&&m._data(a);if(r&&(k=r.events)){b=(b||"").match(E)||[""],j=b.length;while(j--)if(h=_.exec(b[j])||[],o=q=h[1],p=(h[2]||"").split(".").sort(),o){l=m.event.special[o]||{},o=(d?l.delegateType:l.bindType)||o,n=k[o]||[],h=h[2]&&new RegExp("(^|\\.)"+p.join("\\.(?:.*\\.|)")+"(\\.|$)"),i=f=n.length;while(f--)g=n[f],!e&&q!==g.origType||c&&c.guid!==g.guid||h&&!h.test(g.namespace)||d&&d!==g.selector&&("**"!==d||!g.selector)||(n.splice(f,1),g.selector&&n.delegateCount--,l.remove&&l.remove.call(a,g));i&&!n.length&&(l.teardown&&l.teardown.call(a,p,r.handle)!==!1||m.removeEvent(a,o,r.handle),delete k[o])}else for(o in k)m.event.remove(a,o+b[j],c,d,!0);m.isEmptyObject(k)&&(delete r.handle,m._removeData(a,"events"))}},trigger:function(b,c,d,e){var f,g,h,i,k,l,n,o=[d||y],p=j.call(b,"type")?b.type:b,q=j.call(b,"namespace")?b.namespace.split("."):[];if(h=l=d=d||y,3!==d.nodeType&&8!==d.nodeType&&!$.test(p+m.event.triggered)&&(p.indexOf(".")>=0&&(q=p.split("."),p=q.shift(),q.sort()),g=p.indexOf(":")<0&&"on"+p,b=b[m.expando]?b:new m.Event(p,"object"==typeof b&&b),b.isTrigger=e?2:3,b.namespace=q.join("."),b.namespace_re=b.namespace?new RegExp("(^|\\.)"+q.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,b.result=void 0,b.target||(b.target=d),c=null==c?[b]:m.makeArray(c,[b]),k=m.event.special[p]||{},e||!k.trigger||k.trigger.apply(d,c)!==!1)){if(!e&&!k.noBubble&&!m.isWindow(d)){for(i=k.delegateType||p,$.test(i+p)||(h=h.parentNode);h;h=h.parentNode)o.push(h),l=h;l===(d.ownerDocument||y)&&o.push(l.defaultView||l.parentWindow||a)}n=0;while((h=o[n++])&&!b.isPropagationStopped())b.type=n>1?i:k.bindType||p,f=(m._data(h,"events")||{})[b.type]&&m._data(h,"handle"),f&&f.apply(h,c),f=g&&h[g],f&&f.apply&&m.acceptData(h)&&(b.result=f.apply(h,c),b.result===!1&&b.preventDefault());if(b.type=p,!e&&!b.isDefaultPrevented()&&(!k._default||k._default.apply(o.pop(),c)===!1)&&m.acceptData(d)&&g&&d[p]&&!m.isWindow(d)){l=d[g],l&&(d[g]=null),m.event.triggered=p;try{d[p]()}catch(r){}m.event.triggered=void 0,l&&(d[g]=l)}return b.result}},dispatch:function(a){a=m.event.fix(a);var b,c,e,f,g,h=[],i=d.call(arguments),j=(m._data(this,"events")||{})[a.type]||[],k=m.event.special[a.type]||{};if(i[0]=a,a.delegateTarget=this,!k.preDispatch||k.preDispatch.call(this,a)!==!1){h=m.event.handlers.call(this,a,j),b=0;while((f=h[b++])&&!a.isPropagationStopped()){a.currentTarget=f.elem,g=0;while((e=f.handlers[g++])&&!a.isImmediatePropagationStopped())(!a.namespace_re||a.namespace_re.test(e.namespace))&&(a.handleObj=e,a.data=e.data,c=((m.event.special[e.origType]||{}).handle||e.handler).apply(f.elem,i),void 0!==c&&(a.result=c)===!1&&(a.preventDefault(),a.stopPropagation()))}return k.postDispatch&&k.postDispatch.call(this,a),a.result}},handlers:function(a,b){var c,d,e,f,g=[],h=b.delegateCount,i=a.target;if(h&&i.nodeType&&(!a.button||"click"!==a.type))for(;i!=this;i=i.parentNode||this)if(1===i.nodeType&&(i.disabled!==!0||"click"!==a.type)){for(e=[],f=0;h>f;f++)d=b[f],c=d.selector+" ",void 0===e[c]&&(e[c]=d.needsContext?m(c,this).index(i)>=0:m.find(c,this,null,[i]).length),e[c]&&e.push(d);e.length&&g.push({elem:i,handlers:e})}return h<b.length&&g.push({elem:this,handlers:b.slice(h)}),g},fix:function(a){if(a[m.expando])return a;var b,c,d,e=a.type,f=a,g=this.fixHooks[e];g||(this.fixHooks[e]=g=Z.test(e)?this.mouseHooks:Y.test(e)?this.keyHooks:{}),d=g.props?this.props.concat(g.props):this.props,a=new m.Event(f),b=d.length;while(b--)c=d[b],a[c]=f[c];return a.target||(a.target=f.srcElement||y),3===a.target.nodeType&&(a.target=a.target.parentNode),a.metaKey=!!a.metaKey,g.filter?g.filter(a,f):a},props:"altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(a,b){return null==a.which&&(a.which=null!=b.charCode?b.charCode:b.keyCode),a}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(a,b){var c,d,e,f=b.button,g=b.fromElement;return null==a.pageX&&null!=b.clientX&&(d=a.target.ownerDocument||y,e=d.documentElement,c=d.body,a.pageX=b.clientX+(e&&e.scrollLeft||c&&c.scrollLeft||0)-(e&&e.clientLeft||c&&c.clientLeft||0),a.pageY=b.clientY+(e&&e.scrollTop||c&&c.scrollTop||0)-(e&&e.clientTop||c&&c.clientTop||0)),!a.relatedTarget&&g&&(a.relatedTarget=g===a.target?b.toElement:g),a.which||void 0===f||(a.which=1&f?1:2&f?3:4&f?2:0),a}},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==cb()&&this.focus)try{return this.focus(),!1}catch(a){}},delegateType:"focusin"},blur:{trigger:function(){return this===cb()&&this.blur?(this.blur(),!1):void 0},delegateType:"focusout"},click:{trigger:function(){return m.nodeName(this,"input")&&"checkbox"===this.type&&this.click?(this.click(),!1):void 0},_default:function(a){return m.nodeName(a.target,"a")}},beforeunload:{postDispatch:function(a){void 0!==a.result&&a.originalEvent&&(a.originalEvent.returnValue=a.result)}}},simulate:function(a,b,c,d){var e=m.extend(new m.Event,c,{type:a,isSimulated:!0,originalEvent:{}});d?m.event.trigger(e,null,b):m.event.dispatch.call(b,e),e.isDefaultPrevented()&&c.preventDefault()}},m.removeEvent=y.removeEventListener?function(a,b,c){a.removeEventListener&&a.removeEventListener(b,c,!1)}:function(a,b,c){var d="on"+b;a.detachEvent&&(typeof a[d]===K&&(a[d]=null),a.detachEvent(d,c))},m.Event=function(a,b){return this instanceof m.Event?(a&&a.type?(this.originalEvent=a,this.type=a.type,this.isDefaultPrevented=a.defaultPrevented||void 0===a.defaultPrevented&&a.returnValue===!1?ab:bb):this.type=a,b&&m.extend(this,b),this.timeStamp=a&&a.timeStamp||m.now(),void(this[m.expando]=!0)):new m.Event(a,b)},m.Event.prototype={isDefaultPrevented:bb,isPropagationStopped:bb,isImmediatePropagationStopped:bb,preventDefault:function(){var a=this.originalEvent;this.isDefaultPrevented=ab,a&&(a.preventDefault?a.preventDefault():a.returnValue=!1)},stopPropagation:function(){var a=this.originalEvent;this.isPropagationStopped=ab,a&&(a.stopPropagation&&a.stopPropagation(),a.cancelBubble=!0)},stopImmediatePropagation:function(){var a=this.originalEvent;this.isImmediatePropagationStopped=ab,a&&a.stopImmediatePropagation&&a.stopImmediatePropagation(),this.stopPropagation()}},m.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(a,b){m.event.special[a]={delegateType:b,bindType:b,handle:function(a){var c,d=this,e=a.relatedTarget,f=a.handleObj;return(!e||e!==d&&!m.contains(d,e))&&(a.type=f.origType,c=f.handler.apply(this,arguments),a.type=b),c}}}),k.submitBubbles||(m.event.special.submit={setup:function(){return m.nodeName(this,"form")?!1:void m.event.add(this,"click._submit keypress._submit",function(a){var b=a.target,c=m.nodeName(b,"input")||m.nodeName(b,"button")?b.form:void 0;c&&!m._data(c,"submitBubbles")&&(m.event.add(c,"submit._submit",function(a){a._submit_bubble=!0}),m._data(c,"submitBubbles",!0))})},postDispatch:function(a){a._submit_bubble&&(delete a._submit_bubble,this.parentNode&&!a.isTrigger&&m.event.simulate("submit",this.parentNode,a,!0))},teardown:function(){return m.nodeName(this,"form")?!1:void m.event.remove(this,"._submit")}}),k.changeBubbles||(m.event.special.change={setup:function(){return X.test(this.nodeName)?(("checkbox"===this.type||"radio"===this.type)&&(m.event.add(this,"propertychange._change",function(a){"checked"===a.originalEvent.propertyName&&(this._just_changed=!0)}),m.event.add(this,"click._change",function(a){this._just_changed&&!a.isTrigger&&(this._just_changed=!1),m.event.simulate("change",this,a,!0)})),!1):void m.event.add(this,"beforeactivate._change",function(a){var b=a.target;X.test(b.nodeName)&&!m._data(b,"changeBubbles")&&(m.event.add(b,"change._change",function(a){!this.parentNode||a.isSimulated||a.isTrigger||m.event.simulate("change",this.parentNode,a,!0)}),m._data(b,"changeBubbles",!0))})},handle:function(a){var b=a.target;return this!==b||a.isSimulated||a.isTrigger||"radio"!==b.type&&"checkbox"!==b.type?a.handleObj.handler.apply(this,arguments):void 0},teardown:function(){return m.event.remove(this,"._change"),!X.test(this.nodeName)}}),k.focusinBubbles||m.each({focus:"focusin",blur:"focusout"},function(a,b){var c=function(a){m.event.simulate(b,a.target,m.event.fix(a),!0)};m.event.special[b]={setup:function(){var d=this.ownerDocument||this,e=m._data(d,b);e||d.addEventListener(a,c,!0),m._data(d,b,(e||0)+1)},teardown:function(){var d=this.ownerDocument||this,e=m._data(d,b)-1;e?m._data(d,b,e):(d.removeEventListener(a,c,!0),m._removeData(d,b))}}}),m.fn.extend({on:function(a,b,c,d,e){var f,g;if("object"==typeof a){"string"!=typeof b&&(c=c||b,b=void 0);for(f in a)this.on(f,b,c,a[f],e);return this}if(null==c&&null==d?(d=b,c=b=void 0):null==d&&("string"==typeof b?(d=c,c=void 0):(d=c,c=b,b=void 0)),d===!1)d=bb;else if(!d)return this;return 1===e&&(g=d,d=function(a){return m().off(a),g.apply(this,arguments)},d.guid=g.guid||(g.guid=m.guid++)),this.each(function(){m.event.add(this,a,d,c,b)})},one:function(a,b,c,d){return this.on(a,b,c,d,1)},off:function(a,b,c){var d,e;if(a&&a.preventDefault&&a.handleObj)return d=a.handleObj,m(a.delegateTarget).off(d.namespace?d.origType+"."+d.namespace:d.origType,d.selector,d.handler),this;if("object"==typeof a){for(e in a)this.off(e,b,a[e]);return this}return(b===!1||"function"==typeof b)&&(c=b,b=void 0),c===!1&&(c=bb),this.each(function(){m.event.remove(this,a,c,b)})},trigger:function(a,b){return this.each(function(){m.event.trigger(a,b,this)})},triggerHandler:function(a,b){var c=this[0];return c?m.event.trigger(a,b,c,!0):void 0}});function db(a){var b=eb.split("|"),c=a.createDocumentFragment();if(c.createElement)while(b.length)c.createElement(b.pop());return c}var eb="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",fb=/ jQuery\d+="(?:null|\d+)"/g,gb=new RegExp("<(?:"+eb+")[\\s/>]","i"),hb=/^\s+/,ib=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,jb=/<([\w:]+)/,kb=/<tbody/i,lb=/<|&#?\w+;/,mb=/<(?:script|style|link)/i,nb=/checked\s*(?:[^=]|=\s*.checked.)/i,ob=/^$|\/(?:java|ecma)script/i,pb=/^true\/(.*)/,qb=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g,rb={option:[1,"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],area:[1,"<map>","</map>"],param:[1,"<object>","</object>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:k.htmlSerialize?[0,"",""]:[1,"X<div>","</div>"]},sb=db(y),tb=sb.appendChild(y.createElement("div"));rb.optgroup=rb.option,rb.tbody=rb.tfoot=rb.colgroup=rb.caption=rb.thead,rb.th=rb.td;function ub(a,b){var c,d,e=0,f=typeof a.getElementsByTagName!==K?a.getElementsByTagName(b||"*"):typeof a.querySelectorAll!==K?a.querySelectorAll(b||"*"):void 0;if(!f)for(f=[],c=a.childNodes||a;null!=(d=c[e]);e++)!b||m.nodeName(d,b)?f.push(d):m.merge(f,ub(d,b));return void 0===b||b&&m.nodeName(a,b)?m.merge([a],f):f}function vb(a){W.test(a.type)&&(a.defaultChecked=a.checked)}function wb(a,b){return m.nodeName(a,"table")&&m.nodeName(11!==b.nodeType?b:b.firstChild,"tr")?a.getElementsByTagName("tbody")[0]||a.appendChild(a.ownerDocument.createElement("tbody")):a}function xb(a){return a.type=(null!==m.find.attr(a,"type"))+"/"+a.type,a}function yb(a){var b=pb.exec(a.type);return b?a.type=b[1]:a.removeAttribute("type"),a}function zb(a,b){for(var c,d=0;null!=(c=a[d]);d++)m._data(c,"globalEval",!b||m._data(b[d],"globalEval"))}function Ab(a,b){if(1===b.nodeType&&m.hasData(a)){var c,d,e,f=m._data(a),g=m._data(b,f),h=f.events;if(h){delete g.handle,g.events={};for(c in h)for(d=0,e=h[c].length;e>d;d++)m.event.add(b,c,h[c][d])}g.data&&(g.data=m.extend({},g.data))}}function Bb(a,b){var c,d,e;if(1===b.nodeType){if(c=b.nodeName.toLowerCase(),!k.noCloneEvent&&b[m.expando]){e=m._data(b);for(d in e.events)m.removeEvent(b,d,e.handle);b.removeAttribute(m.expando)}"script"===c&&b.text!==a.text?(xb(b).text=a.text,yb(b)):"object"===c?(b.parentNode&&(b.outerHTML=a.outerHTML),k.html5Clone&&a.innerHTML&&!m.trim(b.innerHTML)&&(b.innerHTML=a.innerHTML)):"input"===c&&W.test(a.type)?(b.defaultChecked=b.checked=a.checked,b.value!==a.value&&(b.value=a.value)):"option"===c?b.defaultSelected=b.selected=a.defaultSelected:("input"===c||"textarea"===c)&&(b.defaultValue=a.defaultValue)}}m.extend({clone:function(a,b,c){var d,e,f,g,h,i=m.contains(a.ownerDocument,a);if(k.html5Clone||m.isXMLDoc(a)||!gb.test("<"+a.nodeName+">")?f=a.cloneNode(!0):(tb.innerHTML=a.outerHTML,tb.removeChild(f=tb.firstChild)),!(k.noCloneEvent&&k.noCloneChecked||1!==a.nodeType&&11!==a.nodeType||m.isXMLDoc(a)))for(d=ub(f),h=ub(a),g=0;null!=(e=h[g]);++g)d[g]&&Bb(e,d[g]);if(b)if(c)for(h=h||ub(a),d=d||ub(f),g=0;null!=(e=h[g]);g++)Ab(e,d[g]);else Ab(a,f);return d=ub(f,"script"),d.length>0&&zb(d,!i&&ub(a,"script")),d=h=e=null,f},buildFragment:function(a,b,c,d){for(var e,f,g,h,i,j,l,n=a.length,o=db(b),p=[],q=0;n>q;q++)if(f=a[q],f||0===f)if("object"===m.type(f))m.merge(p,f.nodeType?[f]:f);else if(lb.test(f)){h=h||o.appendChild(b.createElement("div")),i=(jb.exec(f)||["",""])[1].toLowerCase(),l=rb[i]||rb._default,h.innerHTML=l[1]+f.replace(ib,"<$1></$2>")+l[2],e=l[0];while(e--)h=h.lastChild;if(!k.leadingWhitespace&&hb.test(f)&&p.push(b.createTextNode(hb.exec(f)[0])),!k.tbody){f="table"!==i||kb.test(f)?"<table>"!==l[1]||kb.test(f)?0:h:h.firstChild,e=f&&f.childNodes.length;while(e--)m.nodeName(j=f.childNodes[e],"tbody")&&!j.childNodes.length&&f.removeChild(j)}m.merge(p,h.childNodes),h.textContent="";while(h.firstChild)h.removeChild(h.firstChild);h=o.lastChild}else p.push(b.createTextNode(f));h&&o.removeChild(h),k.appendChecked||m.grep(ub(p,"input"),vb),q=0;while(f=p[q++])if((!d||-1===m.inArray(f,d))&&(g=m.contains(f.ownerDocument,f),h=ub(o.appendChild(f),"script"),g&&zb(h),c)){e=0;while(f=h[e++])ob.test(f.type||"")&&c.push(f)}return h=null,o},cleanData:function(a,b){for(var d,e,f,g,h=0,i=m.expando,j=m.cache,l=k.deleteExpando,n=m.event.special;null!=(d=a[h]);h++)if((b||m.acceptData(d))&&(f=d[i],g=f&&j[f])){if(g.events)for(e in g.events)n[e]?m.event.remove(d,e):m.removeEvent(d,e,g.handle);j[f]&&(delete j[f],l?delete d[i]:typeof d.removeAttribute!==K?d.removeAttribute(i):d[i]=null,c.push(f))}}}),m.fn.extend({text:function(a){return V(this,function(a){return void 0===a?m.text(this):this.empty().append((this[0]&&this[0].ownerDocument||y).createTextNode(a))},null,a,arguments.length)},append:function(){return this.domManip(arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=wb(this,a);b.appendChild(a)}})},prepend:function(){return this.domManip(arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=wb(this,a);b.insertBefore(a,b.firstChild)}})},before:function(){return this.domManip(arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this)})},after:function(){return this.domManip(arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this.nextSibling)})},remove:function(a,b){for(var c,d=a?m.filter(a,this):this,e=0;null!=(c=d[e]);e++)b||1!==c.nodeType||m.cleanData(ub(c)),c.parentNode&&(b&&m.contains(c.ownerDocument,c)&&zb(ub(c,"script")),c.parentNode.removeChild(c));return this},empty:function(){for(var a,b=0;null!=(a=this[b]);b++){1===a.nodeType&&m.cleanData(ub(a,!1));while(a.firstChild)a.removeChild(a.firstChild);a.options&&m.nodeName(a,"select")&&(a.options.length=0)}return this},clone:function(a,b){return a=null==a?!1:a,b=null==b?a:b,this.map(function(){return m.clone(this,a,b)})},html:function(a){return V(this,function(a){var b=this[0]||{},c=0,d=this.length;if(void 0===a)return 1===b.nodeType?b.innerHTML.replace(fb,""):void 0;if(!("string"!=typeof a||mb.test(a)||!k.htmlSerialize&&gb.test(a)||!k.leadingWhitespace&&hb.test(a)||rb[(jb.exec(a)||["",""])[1].toLowerCase()])){a=a.replace(ib,"<$1></$2>");try{for(;d>c;c++)b=this[c]||{},1===b.nodeType&&(m.cleanData(ub(b,!1)),b.innerHTML=a);b=0}catch(e){}}b&&this.empty().append(a)},null,a,arguments.length)},replaceWith:function(){var a=arguments[0];return this.domManip(arguments,function(b){a=this.parentNode,m.cleanData(ub(this)),a&&a.replaceChild(b,this)}),a&&(a.length||a.nodeType)?this:this.remove()},detach:function(a){return this.remove(a,!0)},domManip:function(a,b){a=e.apply([],a);var c,d,f,g,h,i,j=0,l=this.length,n=this,o=l-1,p=a[0],q=m.isFunction(p);if(q||l>1&&"string"==typeof p&&!k.checkClone&&nb.test(p))return this.each(function(c){var d=n.eq(c);q&&(a[0]=p.call(this,c,d.html())),d.domManip(a,b)});if(l&&(i=m.buildFragment(a,this[0].ownerDocument,!1,this),c=i.firstChild,1===i.childNodes.length&&(i=c),c)){for(g=m.map(ub(i,"script"),xb),f=g.length;l>j;j++)d=i,j!==o&&(d=m.clone(d,!0,!0),f&&m.merge(g,ub(d,"script"))),b.call(this[j],d,j);if(f)for(h=g[g.length-1].ownerDocument,m.map(g,yb),j=0;f>j;j++)d=g[j],ob.test(d.type||"")&&!m._data(d,"globalEval")&&m.contains(h,d)&&(d.src?m._evalUrl&&m._evalUrl(d.src):m.globalEval((d.text||d.textContent||d.innerHTML||"").replace(qb,"")));i=c=null}return this}}),m.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){m.fn[a]=function(a){for(var c,d=0,e=[],g=m(a),h=g.length-1;h>=d;d++)c=d===h?this:this.clone(!0),m(g[d])[b](c),f.apply(e,c.get());return this.pushStack(e)}});var Cb,Db={};function Eb(b,c){var d,e=m(c.createElement(b)).appendTo(c.body),f=a.getDefaultComputedStyle&&(d=a.getDefaultComputedStyle(e[0]))?d.display:m.css(e[0],"display");return e.detach(),f}function Fb(a){var b=y,c=Db[a];return c||(c=Eb(a,b),"none"!==c&&c||(Cb=(Cb||m("<iframe frameborder='0' width='0' height='0'/>")).appendTo(b.documentElement),b=(Cb[0].contentWindow||Cb[0].contentDocument).document,b.write(),b.close(),c=Eb(a,b),Cb.detach()),Db[a]=c),c}!function(){var a;k.shrinkWrapBlocks=function(){if(null!=a)return a;a=!1;var b,c,d;return c=y.getElementsByTagName("body")[0],c&&c.style?(b=y.createElement("div"),d=y.createElement("div"),d.style.cssText="position:absolute;border:0;width:0;height:0;top:0;left:-9999px",c.appendChild(d).appendChild(b),typeof b.style.zoom!==K&&(b.style.cssText="-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;display:block;margin:0;border:0;padding:1px;width:1px;zoom:1",b.appendChild(y.createElement("div")).style.width="5px",a=3!==b.offsetWidth),c.removeChild(d),a):void 0}}();var Gb=/^margin/,Hb=new RegExp("^("+S+")(?!px)[a-z%]+$","i"),Ib,Jb,Kb=/^(top|right|bottom|left)$/;a.getComputedStyle?(Ib=function(a){return a.ownerDocument.defaultView.getComputedStyle(a,null)},Jb=function(a,b,c){var d,e,f,g,h=a.style;return c=c||Ib(a),g=c?c.getPropertyValue(b)||c[b]:void 0,c&&(""!==g||m.contains(a.ownerDocument,a)||(g=m.style(a,b)),Hb.test(g)&&Gb.test(b)&&(d=h.width,e=h.minWidth,f=h.maxWidth,h.minWidth=h.maxWidth=h.width=g,g=c.width,h.width=d,h.minWidth=e,h.maxWidth=f)),void 0===g?g:g+""}):y.documentElement.currentStyle&&(Ib=function(a){return a.currentStyle},Jb=function(a,b,c){var d,e,f,g,h=a.style;return c=c||Ib(a),g=c?c[b]:void 0,null==g&&h&&h[b]&&(g=h[b]),Hb.test(g)&&!Kb.test(b)&&(d=h.left,e=a.runtimeStyle,f=e&&e.left,f&&(e.left=a.currentStyle.left),h.left="fontSize"===b?"1em":g,g=h.pixelLeft+"px",h.left=d,f&&(e.left=f)),void 0===g?g:g+""||"auto"});function Lb(a,b){return{get:function(){var c=a();if(null!=c)return c?void delete this.get:(this.get=b).apply(this,arguments)}}}!function(){var b,c,d,e,f,g,h;if(b=y.createElement("div"),b.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",d=b.getElementsByTagName("a")[0],c=d&&d.style){c.cssText="float:left;opacity:.5",k.opacity="0.5"===c.opacity,k.cssFloat=!!c.cssFloat,b.style.backgroundClip="content-box",b.cloneNode(!0).style.backgroundClip="",k.clearCloneStyle="content-box"===b.style.backgroundClip,k.boxSizing=""===c.boxSizing||""===c.MozBoxSizing||""===c.WebkitBoxSizing,m.extend(k,{reliableHiddenOffsets:function(){return null==g&&i(),g},boxSizingReliable:function(){return null==f&&i(),f},pixelPosition:function(){return null==e&&i(),e},reliableMarginRight:function(){return null==h&&i(),h}});function i(){var b,c,d,i;c=y.getElementsByTagName("body")[0],c&&c.style&&(b=y.createElement("div"),d=y.createElement("div"),d.style.cssText="position:absolute;border:0;width:0;height:0;top:0;left:-9999px",c.appendChild(d).appendChild(b),b.style.cssText="-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;display:block;margin-top:1%;top:1%;border:1px;padding:1px;width:4px;position:absolute",e=f=!1,h=!0,a.getComputedStyle&&(e="1%"!==(a.getComputedStyle(b,null)||{}).top,f="4px"===(a.getComputedStyle(b,null)||{width:"4px"}).width,i=b.appendChild(y.createElement("div")),i.style.cssText=b.style.cssText="-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;display:block;margin:0;border:0;padding:0",i.style.marginRight=i.style.width="0",b.style.width="1px",h=!parseFloat((a.getComputedStyle(i,null)||{}).marginRight)),b.innerHTML="<table><tr><td></td><td>t</td></tr></table>",i=b.getElementsByTagName("td"),i[0].style.cssText="margin:0;border:0;padding:0;display:none",g=0===i[0].offsetHeight,g&&(i[0].style.display="",i[1].style.display="none",g=0===i[0].offsetHeight),c.removeChild(d))}}}(),m.swap=function(a,b,c,d){var e,f,g={};for(f in b)g[f]=a.style[f],a.style[f]=b[f];e=c.apply(a,d||[]);for(f in b)a.style[f]=g[f];return e};var Mb=/alpha\([^)]*\)/i,Nb=/opacity\s*=\s*([^)]*)/,Ob=/^(none|table(?!-c[ea]).+)/,Pb=new RegExp("^("+S+")(.*)$","i"),Qb=new RegExp("^([+-])=("+S+")","i"),Rb={position:"absolute",visibility:"hidden",display:"block"},Sb={letterSpacing:"0",fontWeight:"400"},Tb=["Webkit","O","Moz","ms"];function Ub(a,b){if(b in a)return b;var c=b.charAt(0).toUpperCase()+b.slice(1),d=b,e=Tb.length;while(e--)if(b=Tb[e]+c,b in a)return b;return d}function Vb(a,b){for(var c,d,e,f=[],g=0,h=a.length;h>g;g++)d=a[g],d.style&&(f[g]=m._data(d,"olddisplay"),c=d.style.display,b?(f[g]||"none"!==c||(d.style.display=""),""===d.style.display&&U(d)&&(f[g]=m._data(d,"olddisplay",Fb(d.nodeName)))):(e=U(d),(c&&"none"!==c||!e)&&m._data(d,"olddisplay",e?c:m.css(d,"display"))));for(g=0;h>g;g++)d=a[g],d.style&&(b&&"none"!==d.style.display&&""!==d.style.display||(d.style.display=b?f[g]||"":"none"));return a}function Wb(a,b,c){var d=Pb.exec(b);return d?Math.max(0,d[1]-(c||0))+(d[2]||"px"):b}function Xb(a,b,c,d,e){for(var f=c===(d?"border":"content")?4:"width"===b?1:0,g=0;4>f;f+=2)"margin"===c&&(g+=m.css(a,c+T[f],!0,e)),d?("content"===c&&(g-=m.css(a,"padding"+T[f],!0,e)),"margin"!==c&&(g-=m.css(a,"border"+T[f]+"Width",!0,e))):(g+=m.css(a,"padding"+T[f],!0,e),"padding"!==c&&(g+=m.css(a,"border"+T[f]+"Width",!0,e)));return g}function Yb(a,b,c){var d=!0,e="width"===b?a.offsetWidth:a.offsetHeight,f=Ib(a),g=k.boxSizing&&"border-box"===m.css(a,"boxSizing",!1,f);if(0>=e||null==e){if(e=Jb(a,b,f),(0>e||null==e)&&(e=a.style[b]),Hb.test(e))return e;d=g&&(k.boxSizingReliable()||e===a.style[b]),e=parseFloat(e)||0}return e+Xb(a,b,c||(g?"border":"content"),d,f)+"px"}m.extend({cssHooks:{opacity:{get:function(a,b){if(b){var c=Jb(a,"opacity");return""===c?"1":c}}}},cssNumber:{columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":k.cssFloat?"cssFloat":"styleFloat"},style:function(a,b,c,d){if(a&&3!==a.nodeType&&8!==a.nodeType&&a.style){var e,f,g,h=m.camelCase(b),i=a.style;if(b=m.cssProps[h]||(m.cssProps[h]=Ub(i,h)),g=m.cssHooks[b]||m.cssHooks[h],void 0===c)return g&&"get"in g&&void 0!==(e=g.get(a,!1,d))?e:i[b];if(f=typeof c,"string"===f&&(e=Qb.exec(c))&&(c=(e[1]+1)*e[2]+parseFloat(m.css(a,b)),f="number"),null!=c&&c===c&&("number"!==f||m.cssNumber[h]||(c+="px"),k.clearCloneStyle||""!==c||0!==b.indexOf("background")||(i[b]="inherit"),!(g&&"set"in g&&void 0===(c=g.set(a,c,d)))))try{i[b]=c}catch(j){}}},css:function(a,b,c,d){var e,f,g,h=m.camelCase(b);return b=m.cssProps[h]||(m.cssProps[h]=Ub(a.style,h)),g=m.cssHooks[b]||m.cssHooks[h],g&&"get"in g&&(f=g.get(a,!0,c)),void 0===f&&(f=Jb(a,b,d)),"normal"===f&&b in Sb&&(f=Sb[b]),""===c||c?(e=parseFloat(f),c===!0||m.isNumeric(e)?e||0:f):f}}),m.each(["height","width"],function(a,b){m.cssHooks[b]={get:function(a,c,d){return c?Ob.test(m.css(a,"display"))&&0===a.offsetWidth?m.swap(a,Rb,function(){return Yb(a,b,d)}):Yb(a,b,d):void 0},set:function(a,c,d){var e=d&&Ib(a);return Wb(a,c,d?Xb(a,b,d,k.boxSizing&&"border-box"===m.css(a,"boxSizing",!1,e),e):0)}}}),k.opacity||(m.cssHooks.opacity={get:function(a,b){return Nb.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=m.isNumeric(b)?"alpha(opacity="+100*b+")":"",f=d&&d.filter||c.filter||"";c.zoom=1,(b>=1||""===b)&&""===m.trim(f.replace(Mb,""))&&c.removeAttribute&&(c.removeAttribute("filter"),""===b||d&&!d.filter)||(c.filter=Mb.test(f)?f.replace(Mb,e):f+" "+e)}}),m.cssHooks.marginRight=Lb(k.reliableMarginRight,function(a,b){return b?m.swap(a,{display:"inline-block"},Jb,[a,"marginRight"]):void 0}),m.each({margin:"",padding:"",border:"Width"},function(a,b){m.cssHooks[a+b]={expand:function(c){for(var d=0,e={},f="string"==typeof c?c.split(" "):[c];4>d;d++)e[a+T[d]+b]=f[d]||f[d-2]||f[0];return e}},Gb.test(a)||(m.cssHooks[a+b].set=Wb)}),m.fn.extend({css:function(a,b){return V(this,function(a,b,c){var d,e,f={},g=0;if(m.isArray(b)){for(d=Ib(a),e=b.length;e>g;g++)f[b[g]]=m.css(a,b[g],!1,d);return f}return void 0!==c?m.style(a,b,c):m.css(a,b)},a,b,arguments.length>1)},show:function(){return Vb(this,!0)},hide:function(){return Vb(this)},toggle:function(a){return"boolean"==typeof a?a?this.show():this.hide():this.each(function(){U(this)?m(this).show():m(this).hide()})}});function Zb(a,b,c,d,e){return new Zb.prototype.init(a,b,c,d,e)}m.Tween=Zb,Zb.prototype={constructor:Zb,init:function(a,b,c,d,e,f){this.elem=a,this.prop=c,this.easing=e||"swing",this.options=b,this.start=this.now=this.cur(),this.end=d,this.unit=f||(m.cssNumber[c]?"":"px")
+},cur:function(){var a=Zb.propHooks[this.prop];return a&&a.get?a.get(this):Zb.propHooks._default.get(this)},run:function(a){var b,c=Zb.propHooks[this.prop];return this.pos=b=this.options.duration?m.easing[this.easing](a,this.options.duration*a,0,1,this.options.duration):a,this.now=(this.end-this.start)*b+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),c&&c.set?c.set(this):Zb.propHooks._default.set(this),this}},Zb.prototype.init.prototype=Zb.prototype,Zb.propHooks={_default:{get:function(a){var b;return null==a.elem[a.prop]||a.elem.style&&null!=a.elem.style[a.prop]?(b=m.css(a.elem,a.prop,""),b&&"auto"!==b?b:0):a.elem[a.prop]},set:function(a){m.fx.step[a.prop]?m.fx.step[a.prop](a):a.elem.style&&(null!=a.elem.style[m.cssProps[a.prop]]||m.cssHooks[a.prop])?m.style(a.elem,a.prop,a.now+a.unit):a.elem[a.prop]=a.now}}},Zb.propHooks.scrollTop=Zb.propHooks.scrollLeft={set:function(a){a.elem.nodeType&&a.elem.parentNode&&(a.elem[a.prop]=a.now)}},m.easing={linear:function(a){return a},swing:function(a){return.5-Math.cos(a*Math.PI)/2}},m.fx=Zb.prototype.init,m.fx.step={};var $b,_b,ac=/^(?:toggle|show|hide)$/,bc=new RegExp("^(?:([+-])=|)("+S+")([a-z%]*)$","i"),cc=/queueHooks$/,dc=[ic],ec={"*":[function(a,b){var c=this.createTween(a,b),d=c.cur(),e=bc.exec(b),f=e&&e[3]||(m.cssNumber[a]?"":"px"),g=(m.cssNumber[a]||"px"!==f&&+d)&&bc.exec(m.css(c.elem,a)),h=1,i=20;if(g&&g[3]!==f){f=f||g[3],e=e||[],g=+d||1;do h=h||".5",g/=h,m.style(c.elem,a,g+f);while(h!==(h=c.cur()/d)&&1!==h&&--i)}return e&&(g=c.start=+g||+d||0,c.unit=f,c.end=e[1]?g+(e[1]+1)*e[2]:+e[2]),c}]};function fc(){return setTimeout(function(){$b=void 0}),$b=m.now()}function gc(a,b){var c,d={height:a},e=0;for(b=b?1:0;4>e;e+=2-b)c=T[e],d["margin"+c]=d["padding"+c]=a;return b&&(d.opacity=d.width=a),d}function hc(a,b,c){for(var d,e=(ec[b]||[]).concat(ec["*"]),f=0,g=e.length;g>f;f++)if(d=e[f].call(c,b,a))return d}function ic(a,b,c){var d,e,f,g,h,i,j,l,n=this,o={},p=a.style,q=a.nodeType&&U(a),r=m._data(a,"fxshow");c.queue||(h=m._queueHooks(a,"fx"),null==h.unqueued&&(h.unqueued=0,i=h.empty.fire,h.empty.fire=function(){h.unqueued||i()}),h.unqueued++,n.always(function(){n.always(function(){h.unqueued--,m.queue(a,"fx").length||h.empty.fire()})})),1===a.nodeType&&("height"in b||"width"in b)&&(c.overflow=[p.overflow,p.overflowX,p.overflowY],j=m.css(a,"display"),l="none"===j?m._data(a,"olddisplay")||Fb(a.nodeName):j,"inline"===l&&"none"===m.css(a,"float")&&(k.inlineBlockNeedsLayout&&"inline"!==Fb(a.nodeName)?p.zoom=1:p.display="inline-block")),c.overflow&&(p.overflow="hidden",k.shrinkWrapBlocks()||n.always(function(){p.overflow=c.overflow[0],p.overflowX=c.overflow[1],p.overflowY=c.overflow[2]}));for(d in b)if(e=b[d],ac.exec(e)){if(delete b[d],f=f||"toggle"===e,e===(q?"hide":"show")){if("show"!==e||!r||void 0===r[d])continue;q=!0}o[d]=r&&r[d]||m.style(a,d)}else j=void 0;if(m.isEmptyObject(o))"inline"===("none"===j?Fb(a.nodeName):j)&&(p.display=j);else{r?"hidden"in r&&(q=r.hidden):r=m._data(a,"fxshow",{}),f&&(r.hidden=!q),q?m(a).show():n.done(function(){m(a).hide()}),n.done(function(){var b;m._removeData(a,"fxshow");for(b in o)m.style(a,b,o[b])});for(d in o)g=hc(q?r[d]:0,d,n),d in r||(r[d]=g.start,q&&(g.end=g.start,g.start="width"===d||"height"===d?1:0))}}function jc(a,b){var c,d,e,f,g;for(c in a)if(d=m.camelCase(c),e=b[d],f=a[c],m.isArray(f)&&(e=f[1],f=a[c]=f[0]),c!==d&&(a[d]=f,delete a[c]),g=m.cssHooks[d],g&&"expand"in g){f=g.expand(f),delete a[d];for(c in f)c in a||(a[c]=f[c],b[c]=e)}else b[d]=e}function kc(a,b,c){var d,e,f=0,g=dc.length,h=m.Deferred().always(function(){delete i.elem}),i=function(){if(e)return!1;for(var b=$b||fc(),c=Math.max(0,j.startTime+j.duration-b),d=c/j.duration||0,f=1-d,g=0,i=j.tweens.length;i>g;g++)j.tweens[g].run(f);return h.notifyWith(a,[j,f,c]),1>f&&i?c:(h.resolveWith(a,[j]),!1)},j=h.promise({elem:a,props:m.extend({},b),opts:m.extend(!0,{specialEasing:{}},c),originalProperties:b,originalOptions:c,startTime:$b||fc(),duration:c.duration,tweens:[],createTween:function(b,c){var d=m.Tween(a,j.opts,b,c,j.opts.specialEasing[b]||j.opts.easing);return j.tweens.push(d),d},stop:function(b){var c=0,d=b?j.tweens.length:0;if(e)return this;for(e=!0;d>c;c++)j.tweens[c].run(1);return b?h.resolveWith(a,[j,b]):h.rejectWith(a,[j,b]),this}}),k=j.props;for(jc(k,j.opts.specialEasing);g>f;f++)if(d=dc[f].call(j,a,k,j.opts))return d;return m.map(k,hc,j),m.isFunction(j.opts.start)&&j.opts.start.call(a,j),m.fx.timer(m.extend(i,{elem:a,anim:j,queue:j.opts.queue})),j.progress(j.opts.progress).done(j.opts.done,j.opts.complete).fail(j.opts.fail).always(j.opts.always)}m.Animation=m.extend(kc,{tweener:function(a,b){m.isFunction(a)?(b=a,a=["*"]):a=a.split(" ");for(var c,d=0,e=a.length;e>d;d++)c=a[d],ec[c]=ec[c]||[],ec[c].unshift(b)},prefilter:function(a,b){b?dc.unshift(a):dc.push(a)}}),m.speed=function(a,b,c){var d=a&&"object"==typeof a?m.extend({},a):{complete:c||!c&&b||m.isFunction(a)&&a,duration:a,easing:c&&b||b&&!m.isFunction(b)&&b};return d.duration=m.fx.off?0:"number"==typeof d.duration?d.duration:d.duration in m.fx.speeds?m.fx.speeds[d.duration]:m.fx.speeds._default,(null==d.queue||d.queue===!0)&&(d.queue="fx"),d.old=d.complete,d.complete=function(){m.isFunction(d.old)&&d.old.call(this),d.queue&&m.dequeue(this,d.queue)},d},m.fn.extend({fadeTo:function(a,b,c,d){return this.filter(U).css("opacity",0).show().end().animate({opacity:b},a,c,d)},animate:function(a,b,c,d){var e=m.isEmptyObject(a),f=m.speed(b,c,d),g=function(){var b=kc(this,m.extend({},a),f);(e||m._data(this,"finish"))&&b.stop(!0)};return g.finish=g,e||f.queue===!1?this.each(g):this.queue(f.queue,g)},stop:function(a,b,c){var d=function(a){var b=a.stop;delete a.stop,b(c)};return"string"!=typeof a&&(c=b,b=a,a=void 0),b&&a!==!1&&this.queue(a||"fx",[]),this.each(function(){var b=!0,e=null!=a&&a+"queueHooks",f=m.timers,g=m._data(this);if(e)g[e]&&g[e].stop&&d(g[e]);else for(e in g)g[e]&&g[e].stop&&cc.test(e)&&d(g[e]);for(e=f.length;e--;)f[e].elem!==this||null!=a&&f[e].queue!==a||(f[e].anim.stop(c),b=!1,f.splice(e,1));(b||!c)&&m.dequeue(this,a)})},finish:function(a){return a!==!1&&(a=a||"fx"),this.each(function(){var b,c=m._data(this),d=c[a+"queue"],e=c[a+"queueHooks"],f=m.timers,g=d?d.length:0;for(c.finish=!0,m.queue(this,a,[]),e&&e.stop&&e.stop.call(this,!0),b=f.length;b--;)f[b].elem===this&&f[b].queue===a&&(f[b].anim.stop(!0),f.splice(b,1));for(b=0;g>b;b++)d[b]&&d[b].finish&&d[b].finish.call(this);delete c.finish})}}),m.each(["toggle","show","hide"],function(a,b){var c=m.fn[b];m.fn[b]=function(a,d,e){return null==a||"boolean"==typeof a?c.apply(this,arguments):this.animate(gc(b,!0),a,d,e)}}),m.each({slideDown:gc("show"),slideUp:gc("hide"),slideToggle:gc("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(a,b){m.fn[a]=function(a,c,d){return this.animate(b,a,c,d)}}),m.timers=[],m.fx.tick=function(){var a,b=m.timers,c=0;for($b=m.now();c<b.length;c++)a=b[c],a()||b[c]!==a||b.splice(c--,1);b.length||m.fx.stop(),$b=void 0},m.fx.timer=function(a){m.timers.push(a),a()?m.fx.start():m.timers.pop()},m.fx.interval=13,m.fx.start=function(){_b||(_b=setInterval(m.fx.tick,m.fx.interval))},m.fx.stop=function(){clearInterval(_b),_b=null},m.fx.speeds={slow:600,fast:200,_default:400},m.fn.delay=function(a,b){return a=m.fx?m.fx.speeds[a]||a:a,b=b||"fx",this.queue(b,function(b,c){var d=setTimeout(b,a);c.stop=function(){clearTimeout(d)}})},function(){var a,b,c,d,e;b=y.createElement("div"),b.setAttribute("className","t"),b.innerHTML="  <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",d=b.getElementsByTagName("a")[0],c=y.createElement("select"),e=c.appendChild(y.createElement("option")),a=b.getElementsByTagName("input")[0],d.style.cssText="top:1px",k.getSetAttribute="t"!==b.className,k.style=/top/.test(d.getAttribute("style")),k.hrefNormalized="/a"===d.getAttribute("href"),k.checkOn=!!a.value,k.optSelected=e.selected,k.enctype=!!y.createElement("form").enctype,c.disabled=!0,k.optDisabled=!e.disabled,a=y.createElement("input"),a.setAttribute("value",""),k.input=""===a.getAttribute("value"),a.value="t",a.setAttribute("type","radio"),k.radioValue="t"===a.value}();var lc=/\r/g;m.fn.extend({val:function(a){var b,c,d,e=this[0];{if(arguments.length)return d=m.isFunction(a),this.each(function(c){var e;1===this.nodeType&&(e=d?a.call(this,c,m(this).val()):a,null==e?e="":"number"==typeof e?e+="":m.isArray(e)&&(e=m.map(e,function(a){return null==a?"":a+""})),b=m.valHooks[this.type]||m.valHooks[this.nodeName.toLowerCase()],b&&"set"in b&&void 0!==b.set(this,e,"value")||(this.value=e))});if(e)return b=m.valHooks[e.type]||m.valHooks[e.nodeName.toLowerCase()],b&&"get"in b&&void 0!==(c=b.get(e,"value"))?c:(c=e.value,"string"==typeof c?c.replace(lc,""):null==c?"":c)}}}),m.extend({valHooks:{option:{get:function(a){var b=m.find.attr(a,"value");return null!=b?b:m.trim(m.text(a))}},select:{get:function(a){for(var b,c,d=a.options,e=a.selectedIndex,f="select-one"===a.type||0>e,g=f?null:[],h=f?e+1:d.length,i=0>e?h:f?e:0;h>i;i++)if(c=d[i],!(!c.selected&&i!==e||(k.optDisabled?c.disabled:null!==c.getAttribute("disabled"))||c.parentNode.disabled&&m.nodeName(c.parentNode,"optgroup"))){if(b=m(c).val(),f)return b;g.push(b)}return g},set:function(a,b){var c,d,e=a.options,f=m.makeArray(b),g=e.length;while(g--)if(d=e[g],m.inArray(m.valHooks.option.get(d),f)>=0)try{d.selected=c=!0}catch(h){d.scrollHeight}else d.selected=!1;return c||(a.selectedIndex=-1),e}}}}),m.each(["radio","checkbox"],function(){m.valHooks[this]={set:function(a,b){return m.isArray(b)?a.checked=m.inArray(m(a).val(),b)>=0:void 0}},k.checkOn||(m.valHooks[this].get=function(a){return null===a.getAttribute("value")?"on":a.value})});var mc,nc,oc=m.expr.attrHandle,pc=/^(?:checked|selected)$/i,qc=k.getSetAttribute,rc=k.input;m.fn.extend({attr:function(a,b){return V(this,m.attr,a,b,arguments.length>1)},removeAttr:function(a){return this.each(function(){m.removeAttr(this,a)})}}),m.extend({attr:function(a,b,c){var d,e,f=a.nodeType;if(a&&3!==f&&8!==f&&2!==f)return typeof a.getAttribute===K?m.prop(a,b,c):(1===f&&m.isXMLDoc(a)||(b=b.toLowerCase(),d=m.attrHooks[b]||(m.expr.match.bool.test(b)?nc:mc)),void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=m.find.attr(a,b),null==e?void 0:e):null!==c?d&&"set"in d&&void 0!==(e=d.set(a,c,b))?e:(a.setAttribute(b,c+""),c):void m.removeAttr(a,b))},removeAttr:function(a,b){var c,d,e=0,f=b&&b.match(E);if(f&&1===a.nodeType)while(c=f[e++])d=m.propFix[c]||c,m.expr.match.bool.test(c)?rc&&qc||!pc.test(c)?a[d]=!1:a[m.camelCase("default-"+c)]=a[d]=!1:m.attr(a,c,""),a.removeAttribute(qc?c:d)},attrHooks:{type:{set:function(a,b){if(!k.radioValue&&"radio"===b&&m.nodeName(a,"input")){var c=a.value;return a.setAttribute("type",b),c&&(a.value=c),b}}}}}),nc={set:function(a,b,c){return b===!1?m.removeAttr(a,c):rc&&qc||!pc.test(c)?a.setAttribute(!qc&&m.propFix[c]||c,c):a[m.camelCase("default-"+c)]=a[c]=!0,c}},m.each(m.expr.match.bool.source.match(/\w+/g),function(a,b){var c=oc[b]||m.find.attr;oc[b]=rc&&qc||!pc.test(b)?function(a,b,d){var e,f;return d||(f=oc[b],oc[b]=e,e=null!=c(a,b,d)?b.toLowerCase():null,oc[b]=f),e}:function(a,b,c){return c?void 0:a[m.camelCase("default-"+b)]?b.toLowerCase():null}}),rc&&qc||(m.attrHooks.value={set:function(a,b,c){return m.nodeName(a,"input")?void(a.defaultValue=b):mc&&mc.set(a,b,c)}}),qc||(mc={set:function(a,b,c){var d=a.getAttributeNode(c);return d||a.setAttributeNode(d=a.ownerDocument.createAttribute(c)),d.value=b+="","value"===c||b===a.getAttribute(c)?b:void 0}},oc.id=oc.name=oc.coords=function(a,b,c){var d;return c?void 0:(d=a.getAttributeNode(b))&&""!==d.value?d.value:null},m.valHooks.button={get:function(a,b){var c=a.getAttributeNode(b);return c&&c.specified?c.value:void 0},set:mc.set},m.attrHooks.contenteditable={set:function(a,b,c){mc.set(a,""===b?!1:b,c)}},m.each(["width","height"],function(a,b){m.attrHooks[b]={set:function(a,c){return""===c?(a.setAttribute(b,"auto"),c):void 0}}})),k.style||(m.attrHooks.style={get:function(a){return a.style.cssText||void 0},set:function(a,b){return a.style.cssText=b+""}});var sc=/^(?:input|select|textarea|button|object)$/i,tc=/^(?:a|area)$/i;m.fn.extend({prop:function(a,b){return V(this,m.prop,a,b,arguments.length>1)},removeProp:function(a){return a=m.propFix[a]||a,this.each(function(){try{this[a]=void 0,delete this[a]}catch(b){}})}}),m.extend({propFix:{"for":"htmlFor","class":"className"},prop:function(a,b,c){var d,e,f,g=a.nodeType;if(a&&3!==g&&8!==g&&2!==g)return f=1!==g||!m.isXMLDoc(a),f&&(b=m.propFix[b]||b,e=m.propHooks[b]),void 0!==c?e&&"set"in e&&void 0!==(d=e.set(a,c,b))?d:a[b]=c:e&&"get"in e&&null!==(d=e.get(a,b))?d:a[b]},propHooks:{tabIndex:{get:function(a){var b=m.find.attr(a,"tabindex");return b?parseInt(b,10):sc.test(a.nodeName)||tc.test(a.nodeName)&&a.href?0:-1}}}}),k.hrefNormalized||m.each(["href","src"],function(a,b){m.propHooks[b]={get:function(a){return a.getAttribute(b,4)}}}),k.optSelected||(m.propHooks.selected={get:function(a){var b=a.parentNode;return b&&(b.selectedIndex,b.parentNode&&b.parentNode.selectedIndex),null}}),m.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){m.propFix[this.toLowerCase()]=this}),k.enctype||(m.propFix.enctype="encoding");var uc=/[\t\r\n\f]/g;m.fn.extend({addClass:function(a){var b,c,d,e,f,g,h=0,i=this.length,j="string"==typeof a&&a;if(m.isFunction(a))return this.each(function(b){m(this).addClass(a.call(this,b,this.className))});if(j)for(b=(a||"").match(E)||[];i>h;h++)if(c=this[h],d=1===c.nodeType&&(c.className?(" "+c.className+" ").replace(uc," "):" ")){f=0;while(e=b[f++])d.indexOf(" "+e+" ")<0&&(d+=e+" ");g=m.trim(d),c.className!==g&&(c.className=g)}return this},removeClass:function(a){var b,c,d,e,f,g,h=0,i=this.length,j=0===arguments.length||"string"==typeof a&&a;if(m.isFunction(a))return this.each(function(b){m(this).removeClass(a.call(this,b,this.className))});if(j)for(b=(a||"").match(E)||[];i>h;h++)if(c=this[h],d=1===c.nodeType&&(c.className?(" "+c.className+" ").replace(uc," "):"")){f=0;while(e=b[f++])while(d.indexOf(" "+e+" ")>=0)d=d.replace(" "+e+" "," ");g=a?m.trim(d):"",c.className!==g&&(c.className=g)}return this},toggleClass:function(a,b){var c=typeof a;return"boolean"==typeof b&&"string"===c?b?this.addClass(a):this.removeClass(a):this.each(m.isFunction(a)?function(c){m(this).toggleClass(a.call(this,c,this.className,b),b)}:function(){if("string"===c){var b,d=0,e=m(this),f=a.match(E)||[];while(b=f[d++])e.hasClass(b)?e.removeClass(b):e.addClass(b)}else(c===K||"boolean"===c)&&(this.className&&m._data(this,"__className__",this.className),this.className=this.className||a===!1?"":m._data(this,"__className__")||"")})},hasClass:function(a){for(var b=" "+a+" ",c=0,d=this.length;d>c;c++)if(1===this[c].nodeType&&(" "+this[c].className+" ").replace(uc," ").indexOf(b)>=0)return!0;return!1}}),m.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(a,b){m.fn[b]=function(a,c){return arguments.length>0?this.on(b,null,a,c):this.trigger(b)}}),m.fn.extend({hover:function(a,b){return this.mouseenter(a).mouseleave(b||a)},bind:function(a,b,c){return this.on(a,null,b,c)},unbind:function(a,b){return this.off(a,null,b)},delegate:function(a,b,c,d){return this.on(b,a,c,d)},undelegate:function(a,b,c){return 1===arguments.length?this.off(a,"**"):this.off(b,a||"**",c)}});var vc=m.now(),wc=/\?/,xc=/(,)|(\[|{)|(}|])|"(?:[^"\\\r\n]|\\["\\\/bfnrt]|\\u[\da-fA-F]{4})*"\s*:?|true|false|null|-?(?!0\d)\d+(?:\.\d+|)(?:[eE][+-]?\d+|)/g;m.parseJSON=function(b){if(a.JSON&&a.JSON.parse)return a.JSON.parse(b+"");var c,d=null,e=m.trim(b+"");return e&&!m.trim(e.replace(xc,function(a,b,e,f){return c&&b&&(d=0),0===d?a:(c=e||b,d+=!f-!e,"")}))?Function("return "+e)():m.error("Invalid JSON: "+b)},m.parseXML=function(b){var c,d;if(!b||"string"!=typeof b)return null;try{a.DOMParser?(d=new DOMParser,c=d.parseFromString(b,"text/xml")):(c=new ActiveXObject("Microsoft.XMLDOM"),c.async="false",c.loadXML(b))}catch(e){c=void 0}return c&&c.documentElement&&!c.getElementsByTagName("parsererror").length||m.error("Invalid XML: "+b),c};var yc,zc,Ac=/#.*$/,Bc=/([?&])_=[^&]*/,Cc=/^(.*?):[ \t]*([^\r\n]*)\r?$/gm,Dc=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Ec=/^(?:GET|HEAD)$/,Fc=/^\/\//,Gc=/^([\w.+-]+:)(?:\/\/(?:[^\/?#]*@|)([^\/?#:]*)(?::(\d+)|)|)/,Hc={},Ic={},Jc="*/".concat("*");try{zc=location.href}catch(Kc){zc=y.createElement("a"),zc.href="",zc=zc.href}yc=Gc.exec(zc.toLowerCase())||[];function Lc(a){return function(b,c){"string"!=typeof b&&(c=b,b="*");var d,e=0,f=b.toLowerCase().match(E)||[];if(m.isFunction(c))while(d=f[e++])"+"===d.charAt(0)?(d=d.slice(1)||"*",(a[d]=a[d]||[]).unshift(c)):(a[d]=a[d]||[]).push(c)}}function Mc(a,b,c,d){var e={},f=a===Ic;function g(h){var i;return e[h]=!0,m.each(a[h]||[],function(a,h){var j=h(b,c,d);return"string"!=typeof j||f||e[j]?f?!(i=j):void 0:(b.dataTypes.unshift(j),g(j),!1)}),i}return g(b.dataTypes[0])||!e["*"]&&g("*")}function Nc(a,b){var c,d,e=m.ajaxSettings.flatOptions||{};for(d in b)void 0!==b[d]&&((e[d]?a:c||(c={}))[d]=b[d]);return c&&m.extend(!0,a,c),a}function Oc(a,b,c){var d,e,f,g,h=a.contents,i=a.dataTypes;while("*"===i[0])i.shift(),void 0===e&&(e=a.mimeType||b.getResponseHeader("Content-Type"));if(e)for(g in h)if(h[g]&&h[g].test(e)){i.unshift(g);break}if(i[0]in c)f=i[0];else{for(g in c){if(!i[0]||a.converters[g+" "+i[0]]){f=g;break}d||(d=g)}f=f||d}return f?(f!==i[0]&&i.unshift(f),c[f]):void 0}function Pc(a,b,c,d){var e,f,g,h,i,j={},k=a.dataTypes.slice();if(k[1])for(g in a.converters)j[g.toLowerCase()]=a.converters[g];f=k.shift();while(f)if(a.responseFields[f]&&(c[a.responseFields[f]]=b),!i&&d&&a.dataFilter&&(b=a.dataFilter(b,a.dataType)),i=f,f=k.shift())if("*"===f)f=i;else if("*"!==i&&i!==f){if(g=j[i+" "+f]||j["* "+f],!g)for(e in j)if(h=e.split(" "),h[1]===f&&(g=j[i+" "+h[0]]||j["* "+h[0]])){g===!0?g=j[e]:j[e]!==!0&&(f=h[0],k.unshift(h[1]));break}if(g!==!0)if(g&&a["throws"])b=g(b);else try{b=g(b)}catch(l){return{state:"parsererror",error:g?l:"No conversion from "+i+" to "+f}}}return{state:"success",data:b}}m.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:zc,type:"GET",isLocal:Dc.test(yc[1]),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Jc,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":m.parseJSON,"text xml":m.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(a,b){return b?Nc(Nc(a,m.ajaxSettings),b):Nc(m.ajaxSettings,a)},ajaxPrefilter:Lc(Hc),ajaxTransport:Lc(Ic),ajax:function(a,b){"object"==typeof a&&(b=a,a=void 0),b=b||{};var c,d,e,f,g,h,i,j,k=m.ajaxSetup({},b),l=k.context||k,n=k.context&&(l.nodeType||l.jquery)?m(l):m.event,o=m.Deferred(),p=m.Callbacks("once memory"),q=k.statusCode||{},r={},s={},t=0,u="canceled",v={readyState:0,getResponseHeader:function(a){var b;if(2===t){if(!j){j={};while(b=Cc.exec(f))j[b[1].toLowerCase()]=b[2]}b=j[a.toLowerCase()]}return null==b?null:b},getAllResponseHeaders:function(){return 2===t?f:null},setRequestHeader:function(a,b){var c=a.toLowerCase();return t||(a=s[c]=s[c]||a,r[a]=b),this},overrideMimeType:function(a){return t||(k.mimeType=a),this},statusCode:function(a){var b;if(a)if(2>t)for(b in a)q[b]=[q[b],a[b]];else v.always(a[v.status]);return this},abort:function(a){var b=a||u;return i&&i.abort(b),x(0,b),this}};if(o.promise(v).complete=p.add,v.success=v.done,v.error=v.fail,k.url=((a||k.url||zc)+"").replace(Ac,"").replace(Fc,yc[1]+"//"),k.type=b.method||b.type||k.method||k.type,k.dataTypes=m.trim(k.dataType||"*").toLowerCase().match(E)||[""],null==k.crossDomain&&(c=Gc.exec(k.url.toLowerCase()),k.crossDomain=!(!c||c[1]===yc[1]&&c[2]===yc[2]&&(c[3]||("http:"===c[1]?"80":"443"))===(yc[3]||("http:"===yc[1]?"80":"443")))),k.data&&k.processData&&"string"!=typeof k.data&&(k.data=m.param(k.data,k.traditional)),Mc(Hc,k,b,v),2===t)return v;h=k.global,h&&0===m.active++&&m.event.trigger("ajaxStart"),k.type=k.type.toUpperCase(),k.hasContent=!Ec.test(k.type),e=k.url,k.hasContent||(k.data&&(e=k.url+=(wc.test(e)?"&":"?")+k.data,delete k.data),k.cache===!1&&(k.url=Bc.test(e)?e.replace(Bc,"$1_="+vc++):e+(wc.test(e)?"&":"?")+"_="+vc++)),k.ifModified&&(m.lastModified[e]&&v.setRequestHeader("If-Modified-Since",m.lastModified[e]),m.etag[e]&&v.setRequestHeader("If-None-Match",m.etag[e])),(k.data&&k.hasContent&&k.contentType!==!1||b.contentType)&&v.setRequestHeader("Content-Type",k.contentType),v.setRequestHeader("Accept",k.dataTypes[0]&&k.accepts[k.dataTypes[0]]?k.accepts[k.dataTypes[0]]+("*"!==k.dataTypes[0]?", "+Jc+"; q=0.01":""):k.accepts["*"]);for(d in k.headers)v.setRequestHeader(d,k.headers[d]);if(k.beforeSend&&(k.beforeSend.call(l,v,k)===!1||2===t))return v.abort();u="abort";for(d in{success:1,error:1,complete:1})v[d](k[d]);if(i=Mc(Ic,k,b,v)){v.readyState=1,h&&n.trigger("ajaxSend",[v,k]),k.async&&k.timeout>0&&(g=setTimeout(function(){v.abort("timeout")},k.timeout));try{t=1,i.send(r,x)}catch(w){if(!(2>t))throw w;x(-1,w)}}else x(-1,"No Transport");function x(a,b,c,d){var j,r,s,u,w,x=b;2!==t&&(t=2,g&&clearTimeout(g),i=void 0,f=d||"",v.readyState=a>0?4:0,j=a>=200&&300>a||304===a,c&&(u=Oc(k,v,c)),u=Pc(k,u,v,j),j?(k.ifModified&&(w=v.getResponseHeader("Last-Modified"),w&&(m.lastModified[e]=w),w=v.getResponseHeader("etag"),w&&(m.etag[e]=w)),204===a||"HEAD"===k.type?x="nocontent":304===a?x="notmodified":(x=u.state,r=u.data,s=u.error,j=!s)):(s=x,(a||!x)&&(x="error",0>a&&(a=0))),v.status=a,v.statusText=(b||x)+"",j?o.resolveWith(l,[r,x,v]):o.rejectWith(l,[v,x,s]),v.statusCode(q),q=void 0,h&&n.trigger(j?"ajaxSuccess":"ajaxError",[v,k,j?r:s]),p.fireWith(l,[v,x]),h&&(n.trigger("ajaxComplete",[v,k]),--m.active||m.event.trigger("ajaxStop")))}return v},getJSON:function(a,b,c){return m.get(a,b,c,"json")},getScript:function(a,b){return m.get(a,void 0,b,"script")}}),m.each(["get","post"],function(a,b){m[b]=function(a,c,d,e){return m.isFunction(c)&&(e=e||d,d=c,c=void 0),m.ajax({url:a,type:b,dataType:e,data:c,success:d})}}),m.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(a,b){m.fn[b]=function(a){return this.on(b,a)}}),m._evalUrl=function(a){return m.ajax({url:a,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0})},m.fn.extend({wrapAll:function(a){if(m.isFunction(a))return this.each(function(b){m(this).wrapAll(a.call(this,b))});if(this[0]){var b=m(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&1===a.firstChild.nodeType)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){return this.each(m.isFunction(a)?function(b){m(this).wrapInner(a.call(this,b))}:function(){var b=m(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=m.isFunction(a);return this.each(function(c){m(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){m.nodeName(this,"body")||m(this).replaceWith(this.childNodes)}).end()}}),m.expr.filters.hidden=function(a){return a.offsetWidth<=0&&a.offsetHeight<=0||!k.reliableHiddenOffsets()&&"none"===(a.style&&a.style.display||m.css(a,"display"))},m.expr.filters.visible=function(a){return!m.expr.filters.hidden(a)};var Qc=/%20/g,Rc=/\[\]$/,Sc=/\r?\n/g,Tc=/^(?:submit|button|image|reset|file)$/i,Uc=/^(?:input|select|textarea|keygen)/i;function Vc(a,b,c,d){var e;if(m.isArray(b))m.each(b,function(b,e){c||Rc.test(a)?d(a,e):Vc(a+"["+("object"==typeof e?b:"")+"]",e,c,d)});else if(c||"object"!==m.type(b))d(a,b);else for(e in b)Vc(a+"["+e+"]",b[e],c,d)}m.param=function(a,b){var c,d=[],e=function(a,b){b=m.isFunction(b)?b():null==b?"":b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};if(void 0===b&&(b=m.ajaxSettings&&m.ajaxSettings.traditional),m.isArray(a)||a.jquery&&!m.isPlainObject(a))m.each(a,function(){e(this.name,this.value)});else for(c in a)Vc(c,a[c],b,e);return d.join("&").replace(Qc,"+")},m.fn.extend({serialize:function(){return m.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var a=m.prop(this,"elements");return a?m.makeArray(a):this}).filter(function(){var a=this.type;return this.name&&!m(this).is(":disabled")&&Uc.test(this.nodeName)&&!Tc.test(a)&&(this.checked||!W.test(a))}).map(function(a,b){var c=m(this).val();return null==c?null:m.isArray(c)?m.map(c,function(a){return{name:b.name,value:a.replace(Sc,"\r\n")}}):{name:b.name,value:c.replace(Sc,"\r\n")}}).get()}}),m.ajaxSettings.xhr=void 0!==a.ActiveXObject?function(){return!this.isLocal&&/^(get|post|head|put|delete|options)$/i.test(this.type)&&Zc()||$c()}:Zc;var Wc=0,Xc={},Yc=m.ajaxSettings.xhr();a.ActiveXObject&&m(a).on("unload",function(){for(var a in Xc)Xc[a](void 0,!0)}),k.cors=!!Yc&&"withCredentials"in Yc,Yc=k.ajax=!!Yc,Yc&&m.ajaxTransport(function(a){if(!a.crossDomain||k.cors){var b;return{send:function(c,d){var e,f=a.xhr(),g=++Wc;if(f.open(a.type,a.url,a.async,a.username,a.password),a.xhrFields)for(e in a.xhrFields)f[e]=a.xhrFields[e];a.mimeType&&f.overrideMimeType&&f.overrideMimeType(a.mimeType),a.crossDomain||c["X-Requested-With"]||(c["X-Requested-With"]="XMLHttpRequest");for(e in c)void 0!==c[e]&&f.setRequestHeader(e,c[e]+"");f.send(a.hasContent&&a.data||null),b=function(c,e){var h,i,j;if(b&&(e||4===f.readyState))if(delete Xc[g],b=void 0,f.onreadystatechange=m.noop,e)4!==f.readyState&&f.abort();else{j={},h=f.status,"string"==typeof f.responseText&&(j.text=f.responseText);try{i=f.statusText}catch(k){i=""}h||!a.isLocal||a.crossDomain?1223===h&&(h=204):h=j.text?200:404}j&&d(h,i,j,f.getAllResponseHeaders())},a.async?4===f.readyState?setTimeout(b):f.onreadystatechange=Xc[g]=b:b()},abort:function(){b&&b(void 0,!0)}}}});function Zc(){try{return new a.XMLHttpRequest}catch(b){}}function $c(){try{return new a.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}}m.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/(?:java|ecma)script/},converters:{"text script":function(a){return m.globalEval(a),a}}}),m.ajaxPrefilter("script",function(a){void 0===a.cache&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),m.ajaxTransport("script",function(a){if(a.crossDomain){var b,c=y.head||m("head")[0]||y.documentElement;return{send:function(d,e){b=y.createElement("script"),b.async=!0,a.scriptCharset&&(b.charset=a.scriptCharset),b.src=a.url,b.onload=b.onreadystatechange=function(a,c){(c||!b.readyState||/loaded|complete/.test(b.readyState))&&(b.onload=b.onreadystatechange=null,b.parentNode&&b.parentNode.removeChild(b),b=null,c||e(200,"success"))},c.insertBefore(b,c.firstChild)},abort:function(){b&&b.onload(void 0,!0)}}}});var _c=[],ad=/(=)\?(?=&|$)|\?\?/;m.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var a=_c.pop()||m.expando+"_"+vc++;return this[a]=!0,a}}),m.ajaxPrefilter("json jsonp",function(b,c,d){var e,f,g,h=b.jsonp!==!1&&(ad.test(b.url)?"url":"string"==typeof b.data&&!(b.contentType||"").indexOf("application/x-www-form-urlencoded")&&ad.test(b.data)&&"data");return h||"jsonp"===b.dataTypes[0]?(e=b.jsonpCallback=m.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,h?b[h]=b[h].replace(ad,"$1"+e):b.jsonp!==!1&&(b.url+=(wc.test(b.url)?"&":"?")+b.jsonp+"="+e),b.converters["script json"]=function(){return g||m.error(e+" was not called"),g[0]},b.dataTypes[0]="json",f=a[e],a[e]=function(){g=arguments},d.always(function(){a[e]=f,b[e]&&(b.jsonpCallback=c.jsonpCallback,_c.push(e)),g&&m.isFunction(f)&&f(g[0]),g=f=void 0}),"script"):void 0}),m.parseHTML=function(a,b,c){if(!a||"string"!=typeof a)return null;"boolean"==typeof b&&(c=b,b=!1),b=b||y;var d=u.exec(a),e=!c&&[];return d?[b.createElement(d[1])]:(d=m.buildFragment([a],b,e),e&&e.length&&m(e).remove(),m.merge([],d.childNodes))};var bd=m.fn.load;m.fn.load=function(a,b,c){if("string"!=typeof a&&bd)return bd.apply(this,arguments);var d,e,f,g=this,h=a.indexOf(" ");return h>=0&&(d=m.trim(a.slice(h,a.length)),a=a.slice(0,h)),m.isFunction(b)?(c=b,b=void 0):b&&"object"==typeof b&&(f="POST"),g.length>0&&m.ajax({url:a,type:f,dataType:"html",data:b}).done(function(a){e=arguments,g.html(d?m("<div>").append(m.parseHTML(a)).find(d):a)}).complete(c&&function(a,b){g.each(c,e||[a.responseText,b,a])}),this},m.expr.filters.animated=function(a){return m.grep(m.timers,function(b){return a===b.elem}).length};var cd=a.document.documentElement;function dd(a){return m.isWindow(a)?a:9===a.nodeType?a.defaultView||a.parentWindow:!1}m.offset={setOffset:function(a,b,c){var d,e,f,g,h,i,j,k=m.css(a,"position"),l=m(a),n={};"static"===k&&(a.style.position="relative"),h=l.offset(),f=m.css(a,"top"),i=m.css(a,"left"),j=("absolute"===k||"fixed"===k)&&m.inArray("auto",[f,i])>-1,j?(d=l.position(),g=d.top,e=d.left):(g=parseFloat(f)||0,e=parseFloat(i)||0),m.isFunction(b)&&(b=b.call(a,c,h)),null!=b.top&&(n.top=b.top-h.top+g),null!=b.left&&(n.left=b.left-h.left+e),"using"in b?b.using.call(a,n):l.css(n)}},m.fn.extend({offset:function(a){if(arguments.length)return void 0===a?this:this.each(function(b){m.offset.setOffset(this,a,b)});var b,c,d={top:0,left:0},e=this[0],f=e&&e.ownerDocument;if(f)return b=f.documentElement,m.contains(b,e)?(typeof e.getBoundingClientRect!==K&&(d=e.getBoundingClientRect()),c=dd(f),{top:d.top+(c.pageYOffset||b.scrollTop)-(b.clientTop||0),left:d.left+(c.pageXOffset||b.scrollLeft)-(b.clientLeft||0)}):d},position:function(){if(this[0]){var a,b,c={top:0,left:0},d=this[0];return"fixed"===m.css(d,"position")?b=d.getBoundingClientRect():(a=this.offsetParent(),b=this.offset(),m.nodeName(a[0],"html")||(c=a.offset()),c.top+=m.css(a[0],"borderTopWidth",!0),c.left+=m.css(a[0],"borderLeftWidth",!0)),{top:b.top-c.top-m.css(d,"marginTop",!0),left:b.left-c.left-m.css(d,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||cd;while(a&&!m.nodeName(a,"html")&&"static"===m.css(a,"position"))a=a.offsetParent;return a||cd})}}),m.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(a,b){var c=/Y/.test(b);m.fn[a]=function(d){return V(this,function(a,d,e){var f=dd(a);return void 0===e?f?b in f?f[b]:f.document.documentElement[d]:a[d]:void(f?f.scrollTo(c?m(f).scrollLeft():e,c?e:m(f).scrollTop()):a[d]=e)},a,d,arguments.length,null)}}),m.each(["top","left"],function(a,b){m.cssHooks[b]=Lb(k.pixelPosition,function(a,c){return c?(c=Jb(a,b),Hb.test(c)?m(a).position()[b]+"px":c):void 0})}),m.each({Height:"height",Width:"width"},function(a,b){m.each({padding:"inner"+a,content:b,"":"outer"+a},function(c,d){m.fn[d]=function(d,e){var f=arguments.length&&(c||"boolean"!=typeof d),g=c||(d===!0||e===!0?"margin":"border");return V(this,function(b,c,d){var e;return m.isWindow(b)?b.document.documentElement["client"+a]:9===b.nodeType?(e=b.documentElement,Math.max(b.body["scroll"+a],e["scroll"+a],b.body["offset"+a],e["offset"+a],e["client"+a])):void 0===d?m.css(b,c,g):m.style(b,c,d,g)},b,f?d:void 0,f,null)}})}),m.fn.size=function(){return this.length},m.fn.andSelf=m.fn.addBack,"function"==typeof define&&define.amd&&define("jquery",[],function(){return m});var ed=a.jQuery,fd=a.$;return m.noConflict=function(b){return a.$===m&&(a.$=fd),b&&a.jQuery===m&&(a.jQuery=ed),m},typeof b===K&&(a.jQuery=a.$=m),m});
\ No newline at end of file

From b3860de0bb42c6a90bb90a5950b65656c543b480 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Tue, 23 Sep 2014 02:00:21 +0800
Subject: [PATCH 04/33] Added Dropdown menu for multi-languages support.

---
 index.html | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index e3e15852..3467e804 100644
--- a/index.html
+++ b/index.html
@@ -33,7 +33,20 @@
             <span class="icon-bar"></span>
             <span class="icon-bar"></span>
           </a>
-          <a class="brand" href="/coding-standards/">Joomla! Coding Standards Manual</a>
+          <a class="brand" href="">Joomla! Coding Standards Manual</a>
+          <ul class="nav pull-right">
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+                Language:
+                <span id="language-select">English</span>
+                <b class="caret"></b>
+              </a>
+              <ul id="language-item" class="dropdown-menu">
+                <li><a href="en-US">English</a></li>
+                <li><a href="zh-TW">中文 (繁體)</a></li>
+              </ul>
+            </li>
+          </ul>
         </div>
       </div>
     </div>
@@ -74,6 +87,7 @@ <h4>License</h4>
     <!-- Le javascript
     ================================================== -->
     <!-- Placed at the end of the document so the pages load faster -->
+	<script src="assets/js/jquery-1.11.1.min.js"></script>
 	<script src="assets/js/mootools.js"></script>
 	<script src="assets/js/marked.js"></script>
 	<script src="assets/js/rainbow.js"></script>
@@ -83,6 +97,6 @@ <h4>License</h4>
 	<script src="assets/js/language/javascript.js"></script>
 	<script src="assets/js/language/php.js"></script>
 	<script src="assets/js/manual.js"></script>
-
+	<script src="assets/js/bootstrap.js"></script>
 	</body>
 </html>

From e17096d7e08ae54c4c8e004d0ba86127ffccf716 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Tue, 23 Sep 2014 02:02:55 +0800
Subject: [PATCH 05/33] Added multi-languages support to manual.js, it can now
 detect the selected locale and re-render content.

---
 assets/js/manual.js | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/assets/js/manual.js b/assets/js/manual.js
index de5e58e7..f09cadf2 100644
--- a/assets/js/manual.js
+++ b/assets/js/manual.js
@@ -1,7 +1,7 @@
 ;(function($) {
     var populateWindow = function(link) {
         var markdownRequest = new Request({
-            "url": here + 'manual/en-US/' + link,
+            "url": here + 'manual/' + locale + '/' + link,
             "method": "get",
             "onSuccess": function(response) {
                 $('docwin').set('html', marked(response));
@@ -33,7 +33,7 @@
 
     var populateMenu = function() {
         var markdownRequest = new Request({
-            "url": here + 'manual/en-US/menu.md',
+            "url": here + 'manual/' + locale + '/menu.md',
             "method": "get",
             "onSuccess": function (response) {
                 $('doc-menu').set('html', marked(response));
@@ -55,7 +55,7 @@
 
     var populateVersion = function() {
         var versionRequest = new Request({
-            "url": here + 'manual/en-US/version.md',
+            "url": here + 'manual/' + locale + '/version.md',
             "method": "get",
             "onSuccess": function(response) {
                 $('version').set('html', marked(response));
@@ -67,6 +67,7 @@
         var urlParts = document.URL.split('?', 2);
         state = {};
         here = urlParts[0];
+        locale = 'en-US';
 
         if (urlParts.length > 1)
         {
@@ -91,6 +92,16 @@
         populateWindow(currentDoc);
         populateVersion();
 
+        document.id('language-item').addEvent('click:relay(a)', function (event, target) {
+            locale = target.get('href');
+            populateWindow(currentDoc);
+            event.preventDefault();
+
+            // Update display text on dropdown menu
+            var currentLang = target.get('html');
+            $('language-select').set('html', currentLang);
+        });
+
         document.id('main').addEvent('click:relay(a)', function (event, target) {
             if (target.get('href').substring(0, 4) != 'http' && target.get('href').substring(0, 1) != '#')
             {

From 3401692e1a785326133f66e53779fbde202691c6 Mon Sep 17 00:00:00 2001
From: skylying <linsutim@gmail.com>
Date: Wed, 24 Sep 2014 16:40:23 +0800
Subject: [PATCH 06/33] add raw translation of javascript coding standards

---
 .../coding-standards/chapters/javascript.md   | 163 ++++++++++++++----
 1 file changed, 129 insertions(+), 34 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/javascript.md b/manual/zh-TW/coding-standards/chapters/javascript.md
index b27fde09..996f0af7 100644
--- a/manual/zh-TW/coding-standards/chapters/javascript.md
+++ b/manual/zh-TW/coding-standards/chapters/javascript.md
@@ -1,45 +1,51 @@
 ## JavaScript
 
-### Contents
-
-1. [Naming Conventions](#naming-conventions)
-    - [Variables](#naming-conventions-variables)
-    - [Functions](#naming-conventions-functions)
-    - [Reserved Words](#naming-conventions-reserved)
-2. [Syntax Style](#syntax-style)
-    - [Indentation](#syntax-indentation)
-    - [Spacing](#syntax-spacing)
-    - [Commas](#syntax-commas)
-    - [Semicolons](#syntax-semicolons)
-    - [Quotes](#syntax-quotes)
-3. [Types](#types)
-4. [Functions](#functions)
-5. [Conditional Statements](#conditional-statements)
-6. [Blocks & Multi-line Statements](#blocks)
-7. [Comments](#comments)
+### 本文
+
+1. [命名準則](#naming-conventions)
+    - [變數](#naming-conventions-variables)
+    - [函式](#naming-conventions-functions)
+    - [保留字元](#naming-conventions-reserved)
+2. [語法](#syntax-style)
+    - [縮排](#syntax-indentation)
+    - [空白](#syntax-spacing)
+    - [逗號](#syntax-commas)
+    - [分號](#syntax-semicolons)
+    - [引號](#syntax-quotes)
+3. [變數類型](#types)
+4. [函式](#functions)
+5. [條件式](#conditional-statements)
+6. [程式區塊 (單行與多行)](#blocks)
+7. [註解](#comments)
 
 <a name="naming-conventions"></a>
-## Naming Conventions
+## 命名準則
 
 Use descriptive words or terse phrases for names.
+命名應以具有描述性或簡潔為準則
 
 Variables and Functions should be camel case, starting with a lowercase letter: `likeThis`
+變數與函式應以駝峰式命名，並以小寫英文字母開頭：`likeThis`
 
 <a name="naming-conventions-variables"></a>
-### Variables
+### 變數
 
 **Use names that describe what the variable is:**
+**使用描述變數意義的命名準則**
 
 `var element = document.getElementById('elementId');`
 
 **Iterators are the exception**
+遞回函式內的變數則不在此限
 
 Use i for index in a loop (and subsequent letters when necessary for nested iteration).
+例如在迴圈中允許使用 `i` 作為索引值 (遇到巢狀結構時使用下一個英文字母：`j`)
 
 <a name="naming-conventions-functions"></a>
-### Functions
+### 函式
 
 **Use names that describe what the function does:**
+**使用描述函式功能的命名準則**
 
 ```
 function getSomeData() {
@@ -47,50 +53,65 @@ function getSomeData() {
 }
 ```
 <a name="naming-conventions-reserved"></a>
-### Reserved Words
+### 保留字元
 
 Do not use reserved words for anything other than their intended use. The list of: [Reserved Words](http://es5.github.io/#x7.6.1)
+非必要狀況下不要使用保留字元作為命名。完整的保留字元列表：[保留字元列表](http://es5.github.io/#x7.6.1)
 
 ---
 
 <a name="syntax-style"></a>
-## Syntax Style
+## 語法
 
 <a name="syntax-indentation"></a>
-### Indentation
+### 縮排
 - Don't mix tabs and spaces.
+請勿混淆 tab 與 spaces
 - Tabs, 4 spaces
+Tab 等同 4 個 spaces
 
 <a name="syntax-spacing"></a>
-### Spacing
+### 空白
 - No whitespace at the end of line or on blank lines.
+行末不可含有空白字元 (空行亦同)
 - Unary special-character operators (e.g., !, ++) must not have space next to their operand.
+單元運算子(例如：!, ++)前後不可包含空白字元
 - Any , and ; must not have preceding space.
+任何 , 以及 ; 不可前綴空白字元 (例如：[ 'name', 'age' ])
 - Any ; used as a statement terminator must be at the end of the line.
+以分號(;)結束程式區塊時，分號(;)必須放在行末
 - Any : after a property name in an object definition must not have preceding space.
+在物件內定義屬性時使用的冒號(:)不可前綴空白字元 (例如：{"name": "jack"})
 - The ? and : in a ternary conditional must have space on both sides.
+三元運算式中的 ? 以及 : 前後都必須包含空白字元
 - No filler spaces in empty constructs (e.g., {}, [], fn())
+空白宣告中不需要包含空白字元 (例如：{}, [], fn())
 - New line at the end of each file.
+檔案末尾需有一行空白
 
 **Array:**
+**陣列:**
 
 ```
 var array = [ 'foo', 'bar' ];
 ```
 
 **Function call:**
+**函式呼叫:**
 
 ```
 foo( arg );
 ```
 
 **Function call with multiple arguments:**
+**多變數的函式呼叫:**
 
 ```
 foo( 'string', object );
 ```
 
 **Conditional Statements**
+**條件式**
 
 ```
 if ( condition ) {
@@ -113,11 +134,13 @@ for ( prop in object ) {
 ```
 
 
-#### Exceptions
+#### 空白字元例外狀況
 
 **First or only argument is an object, array or callback function.**
+**函式的第一個變數是物件、陣列或是 callback 函式時:**
 
 **No space before the first argument:**
+**第一個變數不需前綴空白字元**
 
 ```
 foo({
@@ -133,8 +156,10 @@ foo(function() {
 ```
 
 **Function with a callback, object, or array as the last argument:**
+**函式的最後一個變數是物件、陣列或是 callback 函式時:**
 
 No space after the last argument.
+**最後一個變數不需後綴空白字元:**
 
 ```
 foo( data, function() {
@@ -143,37 +168,47 @@ foo( data, function() {
 ```
 
 <a name="syntax-commas"></a>
-### Commas
+### 逗號
 
 **Place commas after:**
+**下列情形必須後綴逗號:**
 
 - variable declarations
+- 變數宣告
 - key/value pairs
+- 索引/值 配對
 
 #### Arrays
+#### 陣列
 
 Do not include a trailing comma, this will add 1 to your array's length.
+最後一個元素不需後綴逗號，這會造成陣列長度多了 1
 
 **No:**
+**錯誤:**
 
 ```
 array = [ 'foo', 'bar', ];
 ```
 
 **Yes:**
+**正確:**
 
 ```
 array = [ 'foo', 'bar' ];
 ```
 
 <a name="syntax-semicolons"></a>
-### Semicolons
+### 分號
 
 Use them where expected.
+在預期狀況下使用
 
 Semicolons should be included at the end of function expressions, but not at the end of function declarations.
+以變數宣告函式時必須以分號結尾，單純宣告函式時則不需要
 
 **Function Expression:**
+**以變數宣告函式:**
 
 ```
 var foo = function() {
@@ -182,6 +217,7 @@ var foo = function() {
 ```
 
 **Function Declaration:**
+**宣告函式:**
 
 ```
 function foo() {
@@ -190,25 +226,29 @@ function foo() {
 ```
 
 <a name="syntax-quotes"></a>
-### Quotes
+### 引號
 
 Use ' instead of "
+使用單引號而非雙引號
 
 
 ---
 
 <a name="variables"></a>
-## Variables
+## 變數
 
 ### Avoid Global Variables
+### 避免宣告全域變數
 
 **No:**
+**錯誤:**
 
 ```
 foo = 'bar';
 ```
 
 **No: implied global**
+**錯誤: 在函式範疇但仍為全域宣告**
 
 ```
 function() {
@@ -217,16 +257,20 @@ function() {
 ```
 
 **Yes:**
+**正確:**
 
 ```
 var foo = 'bar';
 ```
 
 ### Multiple Variable Declarations
+### 多個變數宣告
 
 Use one `var` declaration and separate each variable on a newline ending with a comma.
+只使用一個 `var` 作為宣告，其餘變數每個以逗號隔開並換新行
 
 **No:**
+**錯誤:**
 
 ```
 var foo = 'bar';
@@ -235,6 +279,7 @@ var baz = 'qux';
 ```
 
 **Yes:**
+**正確:**
 
 ```
 var foo = 'bar',
@@ -243,13 +288,16 @@ var foo = 'bar',
 ```
 
 <a name="types"></a>
-## Types
+## 變數類別
 
-### String
+### 字串
 
 - Concatenate long strings.
+- 過長字串應以串接形式宣告 (使用 +)
 - Place space before closing quote at the end of each string.
+- 結束字串的引號應前綴空白字元
 - Concatenation operator at the end of each subsequent string.
+- 串接運算子應放在每個字串片段的結尾
 
 ```
 var longString = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' +
@@ -260,57 +308,77 @@ var longString = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' +
     'cursus mauris.';
 ```
 
-### Number
+### 數字
 
 Use `parseInt()` or `parseFloat()` instead of unary plus, for readability.
+為了閱讀性考量，運算為數字的變數時應使用`parseInt()` 或 `parseFloat()`，而非單純的 +
 
 **No:**
+**錯誤:**
 
 ```
 var count = +document.getElementById('inputId').value;
 ```
 
 **Yes:**
+**正確:**
 
 ```
 var count = parseInt(document.getElementById('inputId').value);
 ```
 
 ### Type Checks
+### 變數類型檢查
 
 - String: `typeof object === 'string'`
+- 字串: `typeof object === 'string'`
 - Number: `typeof object === 'number'`
+- 數字: `typeof object === 'number'`
 - Boolean: `typeof object === 'boolean'`
+- 布林: `typeof object === 'boolean'`
 - Object: `typeof object === 'object'`
+- 物件: `typeof object === 'object'`
 - Plain Object: `jQuery.isPlainObject( object )`
+- 空白物件: `jQuery.isPlainObject( object )`
 - Function: `jQuery.isFunction( object )`
+- 函式: `jQuery.isFunction( object )`
 - Array: `jQuery.isArray( object )`
+- 陣列: `jQuery.isArray( object )`
 - Element: `object.nodeType`
+- HTML元素: `object.nodeType`
 - null: `object === null`
 - null or undefined: `object == null`
 
 **Undefined:**
 
 - Global Variables: `typeof variable === 'undefined'`
+- 全域變數: `typeof variable === 'undefined'`
 - Local Variables: `variable === undefined`
+- 區域變數: `variable === undefined`
 - Properties: `object.prop === undefined`
+- 屬性: `object.prop === undefined`
 
 ### Objects
+### 物件
 
 Use the literal, not constructor, syntax.
+使用大括號建立物件，而非建構方式
 
 **No:**
+**錯誤:**
 
 ```
 var myObj = new Object();
 ```
 **Yes:**
+**正確:**
 
 ```
 var myObj = {};
 ```
 
 If an object contains more than one key/value pair or an array as a value, each key/value pair should be on its own line.
+如果物件包含多組 索引/值，每一組 索引/值 都必須是一個獨立的行
 
 ```
 var myObj = {
@@ -321,21 +389,26 @@ var myObj = {
 ```
 
 ### Arrays
+### 陣列
 
 Use the literal, not constructor, syntax
+使用中括號建立物件，而非建構方式
 
 **No:**
+**錯誤:**
 
 ```
 var myArr = new Array();
 ```
 **Yes:**
+**正確:**
 
 ```
 var myArr = [];
 ```
 
 If you don't know array length use push method. This will replace the current array.
+陣列長度未知的狀況下使用 `push()`，這會取代現有陣列
 
 ```
 var myArr = [];
@@ -344,8 +417,10 @@ myArr.push('foo');
 
 <a name="functions"></a>
 ## Functions
+## 函式
 
 ### Chaining Method Calls
+### 呼叫連鎖方法
 
 ```
 $('.someElement')
@@ -356,17 +431,22 @@ $('.someElement')
 
 <a name="conditional-statements"></a>
 ## Conditional Statements
+## 條件式
 
 Use ternary syntax if:
+在下列情況使用三元運算式:
 
 - One condition
-- Result of either evaluation is one operation. 
+- 只有一個條件
+- Result of either evaluation is one operation.
+- 看不太懂 by Tim 2014-09-24
 
 ```
 joomlaRocks ? 'This is true' : 'else it is false';
 ```
 
 Otherwise, use standard syntax:
+否則就使用標準語法
 
 ```
 if ( condition ) {
@@ -377,6 +457,7 @@ if ( condition ) {
 ```
 
 **Cache length in variable for performance:**
+**將變數長度做快取以提升效能:**
 
 ```
 var i,
@@ -388,6 +469,7 @@ for ( i = 0; i < j; i++ ) {
 ```
 
 **With more than one condition:**
+**一組以上的條件時:**
 
 ```
 if ( condition &&
@@ -400,8 +482,10 @@ if ( condition &&
 ```
 
 ### Equality
+### 等式判斷
 
 Use strict equality operator === so that type is considered in comparison. Using == can produce false positives.
+使用最嚴謹的 === 判斷，這會將變數類型一同比較。使用 == 可能會造成以假為真
 
 
 ```
@@ -416,16 +500,20 @@ Use strict equality operator === so that type is considered in comparison. Using
 
 <a name="blocks"></a>
 ## Blocks & Multi-line Statements
+## 程式區塊 & 多行敘述
 
 Use curly braces on blocks that have more than one statement.
+多行程式敘述時應以大括號區隔範圍
 
 **Block with one statement:**
+**單一敘述的區塊:**
 
 ```
 if ( test ) return false;
 ```
 
 **Block with more than one statement:**
+**多行敘述的區塊:**
 
 ```
 if ( test ) {
@@ -435,12 +523,15 @@ if ( test ) {
 ```
 
 <a name="comments"></a>
-## Comments
+## 註解
 
 **Single Line**
+**單行**
 
 - Place above the code it refers to.
+- 註解放置在程式碼上方
 - A space between double forward slashes and comment text.
+- 雙斜線與註解之間應空一格
 
 ```
 // I am a single line comment.
@@ -448,10 +539,14 @@ if ( test ) {
 
 
 **Multiline**
+**多行註解**
 
 - Place above the code it refers to.
+- 多行註解應放置在說明的目標程式碼上方
 - Opening token placed on the line above first comment line, closing placed below last comment line.
+- 註解起始字元 `/*` 應放在第一行註解上方，註解結束字元 `*/` 應放在最後一行註解下方，
 - Each comment line begins with two astericks followed by a space.
+- 每一行註解應以 2 個星號與 1 個空白字元開頭
 
 ```
 /*

From 4ba4cc46647acf687c3f369fbb10b4315323bc48 Mon Sep 17 00:00:00 2001
From: skylying <linsutim@gmail.com>
Date: Thu, 25 Sep 2014 13:31:45 +0800
Subject: [PATCH 07/33] translation refector

---
 .../coding-standards/chapters/javascript.md   | 154 ++++--------------
 1 file changed, 30 insertions(+), 124 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/javascript.md b/manual/zh-TW/coding-standards/chapters/javascript.md
index 996f0af7..d8426df6 100644
--- a/manual/zh-TW/coding-standards/chapters/javascript.md
+++ b/manual/zh-TW/coding-standards/chapters/javascript.md
@@ -21,31 +21,25 @@
 <a name="naming-conventions"></a>
 ## 命名準則
 
-Use descriptive words or terse phrases for names.
-命名應以具有描述性或簡潔為準則
+**變數名稱應該描述其變數意義**
 
-Variables and Functions should be camel case, starting with a lowercase letter: `likeThis`
 變數與函式應以駝峰式命名，並以小寫英文字母開頭：`likeThis`
 
 <a name="naming-conventions-variables"></a>
 ### 變數
 
-**Use names that describe what the variable is:**
 **使用描述變數意義的命名準則**
 
 `var element = document.getElementById('elementId');`
 
-**Iterators are the exception**
-遞回函式內的變數則不在此限
+**迭代子則不在此限**
 
-Use i for index in a loop (and subsequent letters when necessary for nested iteration).
 例如在迴圈中允許使用 `i` 作為索引值 (遇到巢狀結構時使用下一個英文字母：`j`)
 
 <a name="naming-conventions-functions"></a>
 ### 函式
 
-**Use names that describe what the function does:**
-**使用描述函式功能的命名準則**
+**函數名稱應該描述該函數之功能意義**
 
 ```
 function getSomeData() {
@@ -55,8 +49,7 @@ function getSomeData() {
 <a name="naming-conventions-reserved"></a>
 ### 保留字元
 
-Do not use reserved words for anything other than their intended use. The list of: [Reserved Words](http://es5.github.io/#x7.6.1)
-非必要狀況下不要使用保留字元作為命名。完整的保留字元列表：[保留字元列表](http://es5.github.io/#x7.6.1)
+除非需要用到保留字功能的場合，否則不要在任何地方使用到保留字。完整的保留字元列表：[保留字元列表](http://es5.github.io/#x7.6.1)
 
 ---
 
@@ -65,52 +58,38 @@ Do not use reserved words for anything other than their intended use. The list o
 
 <a name="syntax-indentation"></a>
 ### 縮排
-- Don't mix tabs and spaces.
-請勿混淆 tab 與 spaces
-- Tabs, 4 spaces
+請勿混用 tab 與 spaces
 Tab 等同 4 個 spaces
 
 <a name="syntax-spacing"></a>
 ### 空白
-- No whitespace at the end of line or on blank lines.
-行末不可含有空白字元 (空行亦同)
-- Unary special-character operators (e.g., !, ++) must not have space next to their operand.
-單元運算子(例如：!, ++)前後不可包含空白字元
-- Any , and ; must not have preceding space.
-任何 , 以及 ; 不可前綴空白字元 (例如：[ 'name', 'age' ])
-- Any ; used as a statement terminator must be at the end of the line.
-以分號(;)結束程式區塊時，分號(;)必須放在行末
-- Any : after a property name in an object definition must not have preceding space.
-在物件內定義屬性時使用的冒號(:)不可前綴空白字元 (例如：{"name": "jack"})
-- The ? and : in a ternary conditional must have space on both sides.
-三元運算式中的 ? 以及 : 前後都必須包含空白字元
-- No filler spaces in empty constructs (e.g., {}, [], fn())
-空白宣告中不需要包含空白字元 (例如：{}, [], fn())
-- New line at the end of each file.
-檔案末尾需有一行空白
-
-**Array:**
+- 行末與空行不能有空白字元
+- 一元運算子(例如：!, ++)前後不可包含空白字元
+- 任何 , 以及 ; 不可前綴空白字元 (例如：[ 'name', 'age' ])
+- 以分號(;)結束程式區塊時，分號(;)必須放在行末
+- 在物件內定義屬性時使用的冒號(:)不可前綴空白字元 (例如：{"name": "jack"})
+- 三元運算子中的 ? 以及 : 前後都必須包含空白字元
+- 空白宣告中不需要包含空白字元 (例如：{}, [], fn())
+- 檔案末尾需有一空行
+
 **陣列:**
 
 ```
 var array = [ 'foo', 'bar' ];
 ```
 
-**Function call:**
 **函式呼叫:**
 
 ```
 foo( arg );
 ```
 
-**Function call with multiple arguments:**
 **多變數的函式呼叫:**
 
 ```
 foo( 'string', object );
 ```
 
-**Conditional Statements**
 **條件式**
 
 ```
@@ -136,10 +115,8 @@ for ( prop in object ) {
 
 #### 空白字元例外狀況
 
-**First or only argument is an object, array or callback function.**
 **函式的第一個變數是物件、陣列或是 callback 函式時:**
 
-**No space before the first argument:**
 **第一個變數不需前綴空白字元**
 
 ```
@@ -155,10 +132,8 @@ foo(function() {
 }, options ); // space after options argument
 ```
 
-**Function with a callback, object, or array as the last argument:**
 **函式的最後一個變數是物件、陣列或是 callback 函式時:**
 
-No space after the last argument.
 **最後一個變數不需後綴空白字元:**
 
 ```
@@ -170,28 +145,22 @@ foo( data, function() {
 <a name="syntax-commas"></a>
 ### 逗號
 
-**Place commas after:**
 **下列情形必須後綴逗號:**
 
-- variable declarations
 - 變數宣告
-- key/value pairs
 - 索引/值 配對
 
 #### Arrays
 #### 陣列
 
-Do not include a trailing comma, this will add 1 to your array's length.
 最後一個元素不需後綴逗號，這會造成陣列長度多了 1
 
-**No:**
 **錯誤:**
 
 ```
 array = [ 'foo', 'bar', ];
 ```
 
-**Yes:**
 **正確:**
 
 ```
@@ -201,13 +170,10 @@ array = [ 'foo', 'bar' ];
 <a name="syntax-semicolons"></a>
 ### 分號
 
-Use them where expected.
 在預期狀況下使用
 
-Semicolons should be included at the end of function expressions, but not at the end of function declarations.
 以變數宣告函式時必須以分號結尾，單純宣告函式時則不需要
 
-**Function Expression:**
 **以變數宣告函式:**
 
 ```
@@ -216,7 +182,6 @@ var foo = function() {
 };
 ```
 
-**Function Declaration:**
 **宣告函式:**
 
 ```
@@ -228,26 +193,21 @@ function foo() {
 <a name="syntax-quotes"></a>
 ### 引號
 
-Use ' instead of "
-使用單引號而非雙引號
-
+使用單引號(')而非雙引號(")
 
 ---
 
 <a name="variables"></a>
 ## 變數
 
-### Avoid Global Variables
 ### 避免宣告全域變數
 
-**No:**
 **錯誤:**
 
 ```
 foo = 'bar';
 ```
 
-**No: implied global**
 **錯誤: 在函式範疇但仍為全域宣告**
 
 ```
@@ -256,20 +216,16 @@ function() {
 }
 ```
 
-**Yes:**
 **正確:**
 
 ```
 var foo = 'bar';
 ```
 
-### Multiple Variable Declarations
 ### 多個變數宣告
 
-Use one `var` declaration and separate each variable on a newline ending with a comma.
-只使用一個 `var` 作為宣告，其餘變數每個以逗號隔開並換新行
+只使用一個 `var` 作為宣告，一行只能存在一個變數並在行末以逗號作為結束
 
-**No:**
 **錯誤:**
 
 ```
@@ -278,13 +234,12 @@ var bar = 'baz';
 var baz = 'qux';
 ```
 
-**Yes:**
 **正確:**
 
 ```
 var foo = 'bar',
 	bar = 'baz',
-    baz = 'qux';
+	baz = 'qux';
 ```
 
 <a name="types"></a>
@@ -292,11 +247,8 @@ var foo = 'bar',
 
 ### 字串
 
-- Concatenate long strings.
 - 過長字串應以串接形式宣告 (使用 +)
-- Place space before closing quote at the end of each string.
-- 結束字串的引號應前綴空白字元
-- Concatenation operator at the end of each subsequent string.
+- 有需要隔斷單字的空白，需要放在每一行字串的尾部，而非下一行字串的開頭
 - 串接運算子應放在每個字串片段的結尾
 
 ```
@@ -310,75 +262,56 @@ var longString = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. ' +
 
 ### 數字
 
-Use `parseInt()` or `parseFloat()` instead of unary plus, for readability.
-為了閱讀性考量，運算為數字的變數時應使用`parseInt()` 或 `parseFloat()`，而非單純的 +
+為了閱讀性考量，應使用parseInt() 或 parseFloat() 將變數轉為數字，而非用一元運算子 +
 
-**No:**
 **錯誤:**
 
 ```
 var count = +document.getElementById('inputId').value;
 ```
 
-**Yes:**
 **正確:**
 
 ```
 var count = parseInt(document.getElementById('inputId').value);
 ```
 
-### Type Checks
 ### 變數類型檢查
 
-- String: `typeof object === 'string'`
 - 字串: `typeof object === 'string'`
-- Number: `typeof object === 'number'`
 - 數字: `typeof object === 'number'`
-- Boolean: `typeof object === 'boolean'`
 - 布林: `typeof object === 'boolean'`
-- Object: `typeof object === 'object'`
 - 物件: `typeof object === 'object'`
-- Plain Object: `jQuery.isPlainObject( object )`
 - 空白物件: `jQuery.isPlainObject( object )`
-- Function: `jQuery.isFunction( object )`
 - 函式: `jQuery.isFunction( object )`
-- Array: `jQuery.isArray( object )`
 - 陣列: `jQuery.isArray( object )`
-- Element: `object.nodeType`
 - HTML元素: `object.nodeType`
 - null: `object === null`
 - null or undefined: `object == null`
 
 **Undefined:**
 
-- Global Variables: `typeof variable === 'undefined'`
 - 全域變數: `typeof variable === 'undefined'`
-- Local Variables: `variable === undefined`
 - 區域變數: `variable === undefined`
-- Properties: `object.prop === undefined`
 - 屬性: `object.prop === undefined`
 
-### Objects
 ### 物件
 
-Use the literal, not constructor, syntax.
-使用大括號建立物件，而非建構方式
+使用大括號建立物件，而非建構子方式
 
-**No:**
 **錯誤:**
 
 ```
 var myObj = new Object();
 ```
-**Yes:**
+
 **正確:**
 
 ```
 var myObj = {};
 ```
 
-If an object contains more than one key/value pair or an array as a value, each key/value pair should be on its own line.
-如果物件包含多組 索引/值，每一組 索引/值 都必須是一個獨立的行
+如果物件包含多組索引/值或陣列，每一組 索引/值 都必須是一個獨立的行
 
 ```
 var myObj = {
@@ -388,27 +321,23 @@ var myObj = {
 };
 ```
 
-### Arrays
 ### 陣列
 
-Use the literal, not constructor, syntax
-使用中括號建立物件，而非建構方式
+使用中括號建立物件，而非建構子方式
 
-**No:**
 **錯誤:**
 
 ```
 var myArr = new Array();
 ```
-**Yes:**
+
 **正確:**
 
 ```
 var myArr = [];
 ```
 
-If you don't know array length use push method. This will replace the current array.
-陣列長度未知的狀況下使用 `push()`，這會取代現有陣列
+陣列長度未知的狀況下使用 `push()`，來增加新的元素
 
 ```
 var myArr = [];
@@ -416,11 +345,9 @@ myArr.push('foo');
 ```
 
 <a name="functions"></a>
-## Functions
 ## 函式
 
-### Chaining Method Calls
-### 呼叫連鎖方法
+### 鏈狀呼叫
 
 ```
 $('.someElement')
@@ -430,22 +357,17 @@ $('.someElement')
 ```
 
 <a name="conditional-statements"></a>
-## Conditional Statements
 ## 條件式
 
-Use ternary syntax if:
-在下列情況使用三元運算式:
+在下列情況使用三元運算子:
 
-- One condition
 - 只有一個條件
-- Result of either evaluation is one operation.
-- 看不太懂 by Tim 2014-09-24
+- 程式區塊內只包含一個操作時
 
 ```
 joomlaRocks ? 'This is true' : 'else it is false';
 ```
 
-Otherwise, use standard syntax:
 否則就使用標準語法
 
 ```
@@ -456,7 +378,6 @@ if ( condition ) {
 }
 ```
 
-**Cache length in variable for performance:**
 **將變數長度做快取以提升效能:**
 
 ```
@@ -468,7 +389,6 @@ for ( i = 0; i < j; i++ ) {
 }
 ```
 
-**With more than one condition:**
 **一組以上的條件時:**
 
 ```
@@ -481,11 +401,9 @@ if ( condition &&
 }
 ```
 
-### Equality
 ### 等式判斷
 
-Use strict equality operator === so that type is considered in comparison. Using == can produce false positives.
-使用最嚴謹的 === 判斷，這會將變數類型一同比較。使用 == 可能會造成以假為真
+使用強型別等號運算子 === 判斷，這會將變數類型一同比較。使用 == 可能會造成以假為真
 
 
 ```
@@ -499,20 +417,16 @@ Use strict equality operator === so that type is considered in comparison. Using
 ```
 
 <a name="blocks"></a>
-## Blocks & Multi-line Statements
 ## 程式區塊 & 多行敘述
 
-Use curly braces on blocks that have more than one statement.
 多行程式敘述時應以大括號區隔範圍
 
-**Block with one statement:**
 **單一敘述的區塊:**
 
 ```
 if ( test ) return false;
 ```
 
-**Block with more than one statement:**
 **多行敘述的區塊:**
 
 ```
@@ -525,28 +439,20 @@ if ( test ) {
 <a name="comments"></a>
 ## 註解
 
-**Single Line**
 **單行**
 
-- Place above the code it refers to.
 - 註解放置在程式碼上方
-- A space between double forward slashes and comment text.
 - 雙斜線與註解之間應空一格
 
 ```
 // I am a single line comment.
 ```
 
-
-**Multiline**
 **多行註解**
 
-- Place above the code it refers to.
 - 多行註解應放置在說明的目標程式碼上方
-- Opening token placed on the line above first comment line, closing placed below last comment line.
 - 註解起始字元 `/*` 應放在第一行註解上方，註解結束字元 `*/` 應放在最後一行註解下方，
-- Each comment line begins with two astericks followed by a space.
-- 每一行註解應以 2 個星號與 1 個空白字元開頭
+- 每一行註解應加上 2 個星號後綴一個空白
 
 ```
 /*

From 9710c5552b1281f499880cc87b72df6e992cf7e8 Mon Sep 17 00:00:00 2001
From: skylying <linsutim@gmail.com>
Date: Tue, 30 Sep 2014 13:47:05 +0800
Subject: [PATCH 08/33] fix mark down format

---
 manual/zh-TW/coding-standards/chapters/javascript.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/javascript.md b/manual/zh-TW/coding-standards/chapters/javascript.md
index d8426df6..4e1d427b 100644
--- a/manual/zh-TW/coding-standards/chapters/javascript.md
+++ b/manual/zh-TW/coding-standards/chapters/javascript.md
@@ -58,8 +58,8 @@ function getSomeData() {
 
 <a name="syntax-indentation"></a>
 ### 縮排
-請勿混用 tab 與 spaces
-Tab 等同 4 個 spaces
+- 請勿混用 tab 與 spaces
+- Tab 等同 4 個 spaces
 
 <a name="syntax-spacing"></a>
 ### 空白

From 51afb0ccab9033b79e274386bb253bd917c0a587 Mon Sep 17 00:00:00 2001
From: leo <leo@bm-sms.com.tw>
Date: Fri, 3 Oct 2014 00:53:31 +0800
Subject: [PATCH 09/33] translate chapter "source-code-management" and "xml"

---
 .../chapters/source-code-management.md        | 23 ++++++++++---------
 manual/zh-TW/coding-standards/chapters/xml.md | 22 +++++++++---------
 2 files changed, 23 insertions(+), 22 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/source-code-management.md b/manual/zh-TW/coding-standards/chapters/source-code-management.md
index 7ee0a55c..1d77002c 100644
--- a/manual/zh-TW/coding-standards/chapters/source-code-management.md
+++ b/manual/zh-TW/coding-standards/chapters/source-code-management.md
@@ -1,24 +1,25 @@
-## Source Code Management
+##  原始碼管理
 
-Before we start talking about what Joomla! code should look like, it is appropriate to look at how and where the source code is stored. All serious software projects, whether driven by an Open Source community or developed within a company for proprietary purposes will manage the source code is some sort of source or version management system. The Joomla project uses a Distributed Version Control System (DVCS) called Git hosted at [GitHub.com](http://github.com).
+在開始講 Joomla! 的程式應該長什麼樣子之前，我們先來看看該如何和到哪裡存放原始碼。所有嚴謹的軟體專案，不管是開源社群主導的或是在一間公司開發其專屬的需求，都會利用一些資源管理或是版本管理系統來管理程式碼。Joomla 採用了名為 Git 的分散式版本管理系統 (DVCS)，並在 [GitHub.com](http://github.com) 上管理。
 
 ### The Joomla Framework
 
-The [Joomla Framework](https://github.com/joomla/joomla-framework) is a PHP framework that is designed to serve as a foundation for not only web applications (like a CMS) but other types of software such as command line applications. The files that form the Joomla Framework are stored in a Distributed Version Control System (DVCS) called Git hosted at github.com
+The [Joomla Framework](https://github.com/joomla/joomla-framework) 是一個 PHP 框架，被設計成一個開發的的基礎，不只能開發 Web 應用程式 (像是 CMS)，也能開發其他類型的軟體 (像是指令集的應用程式)。Joomla Framework 的檔案是用一個分散式版本管理系統 Git 的方式儲存在 Github.com 上。
 
-You can learn about how to get the Joomla Framework source code from the Git repository, https://github.com/joomla/joomla-framework.
+你可以在 https://github.com/joomla/joomla-framework 這個 Git repository 取得 Joomla Framework 的原始碼。
 
-Because Git treats the concepts of file revision numbers differently than Subversion, the repository revision number is not required in files (that is, the `@version` tag is not necessary).
+因為 Git 對於檔案版號的概念不同於 Subversion，版本庫的版本號碼是不需要寫在檔案中的 (沒錯，不需要使用 `@version` 的備註)。
 
 ### The Joomla CMS
-The [Joomla! CMS](https://github.com/joomla/joomla-cms) is a Content Management System (CMS) which enables you to build Web sites and powerful online applications. It's a free and OpenSource software, distributed under the GNU General Public License version 2 or later. The files that form the Joomla CMS are stored in a Distributed Version Control System (DVCS) called Git hosted at github.com
 
-You can learn about how to get the Joomla CMS source code from the Git repository, https://github.com/joomla/joomla-cms.
+The [Joomla! CMS](https://github.com/joomla/joomla-cms) 是一個內容管理系統 (CMS)，讓你可以建構網頁和強大的線上應用程式。這是一個免費且開源的軟體，以 GNU General Public License version 2 或是更新的版本來發布。Joomla CMS 的檔案是用一個分散式版本管理系統 Git 的方式儲存在 Github.com 上。
 
-Because Git treats the concepts of file revision numbers differently than Subversion, the repository revision number is not required in files (that is, the `@version` tag is not necessary).
+你可以在 https://github.com/joomla/joomla-cms 這個 Git repository 取得 Joomla CMS 的原始碼。
 
-## Compliance Tool
+因為 Git 對於檔案版號的概念不同於 Subversion，版本庫的版本號碼是不需要寫在檔案中的 (沒錯，不需要使用 `@version` 的備註)。
 
-The standards in this manual have been adopted across the Joomla project, including the [Joomla Framework](https://github.com/joomla/joomla-framework), the [Joomla! CMS](https://github.com/joomla/joomla-cms) and any other applications maintained by the project. These standards apply to source code, tests and (where applicable) documentation.
+## 共通工具
 
-A custom Joomla sniff standard for PHP files is maintained by the Joomla project and available from the code repository. The Sniff is based on the standard outlined in this document. For more information about how code standards are enforced see the analysis appendix of the manual. For information on using the Sniff see the documentation stored in its repository.
+這份標準文件已經被整個 Joomla 專案所採納，包括 [Joomla Framework](https://github.com/joomla/joomla-framework)，[Joomla! CMS](https://github.com/joomla/joomla-cms)，以及其他在此專案中被維護的應用程式。這些標準將被使用在原始碼，測試，以及文件 (可被應用的) 中。
+
+Joomla 專案維護了一份為 PHP 檔案客製的 Joomla Sniff，可以在此版本庫中下載。這份 Sniff 是基於本文件中的開發標準。要了解更多關於這份開發標準是如何施行的請看本文件的分析附錄。使用該 Sniff 的方法請看存放在此版本庫的文件。
diff --git a/manual/zh-TW/coding-standards/chapters/xml.md b/manual/zh-TW/coding-standards/chapters/xml.md
index 3c90cb85..b6f0a98e 100644
--- a/manual/zh-TW/coding-standards/chapters/xml.md
+++ b/manual/zh-TW/coding-standards/chapters/xml.md
@@ -1,22 +1,22 @@
-## XML Files
+## XML 檔案
 
-### Attributes
+### 屬性
 
-* Each attribute is on its own line.
-* The four attributes `name`, `type`, `label` and `description` should be written in this order and at the top of the element definition.
+* 各個屬性寫在自己的那一行
+* 這四個屬性 `name`, `type`, `label` 和 `description` 必須要照這個順序並且寫在 XML 元素定義的最前面
 
 ### Closing Elements
 
-Elements should be closed with the closing tag on a new line.
+元素應該在下一行被 closing tag 包起來
 
-### Exception
+### 特例
 
-When the element only has few attributes, then the whole element can stay on the same line.
-A max line length of 100 characters is recommended for good reading.
+當元素只有幾個屬性時，可以讓整個元素寫在同一行上
+為了易讀性，建議單行最長文字數為 100 個字元
 
-#### Examples
+#### 範例
 
-Element is **empty**:
+元素為 **空元素**:
 ```xml
 <field
 	name="abc"
@@ -26,7 +26,7 @@ Element is **empty**:
 	/>
 ```
 
-Element is **not empty**:
+元素為 **非空元素**:
 ```xml
 <field
 	name="abc"

From a03c89d37c85d46c40253c3354233fb108a5d76f Mon Sep 17 00:00:00 2001
From: michael520 <michael@bm-sms.com.tw>
Date: Fri, 3 Oct 2014 12:01:05 +0800
Subject: [PATCH 10/33] Translate

---
 manual/zh-TW/appendices/analysis.md | 30 +++++++++++++----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/manual/zh-TW/appendices/analysis.md b/manual/zh-TW/appendices/analysis.md
index a534f7da..f92bfda7 100644
--- a/manual/zh-TW/appendices/analysis.md
+++ b/manual/zh-TW/appendices/analysis.md
@@ -1,37 +1,33 @@
-## Coding Standards Analysis
+## 編程標準分析
 
-For new contributions we are going to be enforcing coding standards to ensure that the coding style in the source code is consistent. Ensuring that your code meets these standards will make the process of code contribution smoother.
+對於接受所貢獻出新的程式碼時，我們將會執行編程標準，以確保源程式碼的風格是一致的。也能確保你的代碼能符合此標準以順暢的進行代碼的貢獻。
 
-## Configuring Code Analysis Tools
+## 配置編程分析工具
 
-In order to improve the consistency and readability of the source code, the Joomla project runs a coding style analysis tool, CodeSniffer, everytime changes are pushed to a Joomla project's repository. 
+為了提高源程式碼的一致性和可讀性，Joomla 會使用代碼分析工具，CodeSniffer，並為了保持最新狀態，會把重要的變更與變化都會更新上 Joomla 專案的程式庫。
 
-### Running CodeSniffer
+### 執行 CodeSniffer
 
-The Joomla Coding Standards sniffer rules are written to be used with a tool called PHP CodeSniffer. Please see the [PHP CodeSniffer Pear
-Page](http://pear.php.net/package/PHP_CodeSniffer) for information on
-installing PHP CodeSniffer on your system.
+Joomla 的編程標準規則都會交由名為 PHP CodeSniffer 的工具來寫入。若要安裝 PHP CodeSniffer 至您的系統，請到這個連結: [PHP CodeSniffer Pear Page](http://pear.php.net/package/PHP_CodeSniffer)查詢相關資訊。
 
-You can run the CodeSniffer by going to the CMS, Framework, or Issue Tracker's root directory and executing 
+你可以透過 CMS (內容管理系統)，Framework (框架)，或 Issue Tracker (問題追蹤) 這些型態的系統，並置於這些程式軟體的根目錄下執行這個工具。
 
 ```
 phpcs --report=checkstyle --report-file=build/logs/checkstyle.xml --standard=/path/to/<your root>/build/phpcs/Joomla /path/to/<your root>
 ```
 
-Alternatively, if you have Ant installed on your system, you may run the CodeSniffer by going to the `<root directory>` of the Joomla project's code you want to test and executing
+此外，如果在你的系統安裝了 Ant，你必須在它所配置的中的 `<root directory>` 裡的 Joomla 根目錄下執行 CodeSniffer 來測試與運行程式碼的分析。
 
 ```
 ant phpcs
 ```
 
-#### Known Issues
+#### 已知的問題
 
--   There is currently an issue with running the Code Sniffer on the
-    Simplepie library. Pointing the sniffs at the libraries/joomla
-    directory or below will avoid the issue.
+-   在 Simplepie 的函式庫上執行 Code Sniffer 會產生一些問題，可將目標指向 libraries/joomla 即可避免。
 
-## Other Tools
+## 其它工具
 
-Here are some other tools available to developers who are planning to submit source code to the project.
+這裡有些其它可用的工具讓開發者能計畫發送源程式碼至現在的專案。
 
-### PhpStorm Code Style Scheme
+### PhpStorm 代碼樣式表

From 4b19f23288e1dd14f0291d5ddf1871fb93a7a106 Mon Sep 17 00:00:00 2001
From: leo <leo@bm-sms.com.tw>
Date: Fri, 3 Oct 2014 14:16:00 +0800
Subject: [PATCH 11/33] updated translate

---
 .../zh-TW/coding-standards/chapters/source-code-management.md   | 2 +-
 manual/zh-TW/coding-standards/chapters/xml.md                   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/source-code-management.md b/manual/zh-TW/coding-standards/chapters/source-code-management.md
index 1d77002c..bf70020b 100644
--- a/manual/zh-TW/coding-standards/chapters/source-code-management.md
+++ b/manual/zh-TW/coding-standards/chapters/source-code-management.md
@@ -4,7 +4,7 @@
 
 ### The Joomla Framework
 
-The [Joomla Framework](https://github.com/joomla/joomla-framework) 是一個 PHP 框架，被設計成一個開發的的基礎，不只能開發 Web 應用程式 (像是 CMS)，也能開發其他類型的軟體 (像是指令集的應用程式)。Joomla Framework 的檔案是用一個分散式版本管理系統 Git 的方式儲存在 Github.com 上。
+The [Joomla Framework](https://github.com/joomla/joomla-framework) 是一個 PHP 框架，被設計成一個開發的的基礎，不只能開發 Web 應用程式 (像是 CMS)，也能開發其他類型的軟體 (像是命令列的應用程式)。Joomla Framework 的檔案是用一個分散式版本管理系統 Git 的方式儲存在 Github.com 上。
 
 你可以在 https://github.com/joomla/joomla-framework 這個 Git repository 取得 Joomla Framework 的原始碼。
 
diff --git a/manual/zh-TW/coding-standards/chapters/xml.md b/manual/zh-TW/coding-standards/chapters/xml.md
index b6f0a98e..3a9d5077 100644
--- a/manual/zh-TW/coding-standards/chapters/xml.md
+++ b/manual/zh-TW/coding-standards/chapters/xml.md
@@ -11,7 +11,7 @@
 
 ### 特例
 
-當元素只有幾個屬性時，可以讓整個元素寫在同一行上
+當元素的屬性較少時，可以讓整個元素寫在同一行上
 為了易讀性，建議單行最長文字數為 100 個字元
 
 #### 範例

From 8831e10a9edf03bc09b1976fd761fbd82a520973 Mon Sep 17 00:00:00 2001
From: michael520 <michael@bm-sms.com.tw>
Date: Fri, 3 Oct 2014 14:41:52 +0800
Subject: [PATCH 12/33] Quality fix

---
 manual/zh-TW/appendices/analysis.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/manual/zh-TW/appendices/analysis.md b/manual/zh-TW/appendices/analysis.md
index f92bfda7..c9cdad6e 100644
--- a/manual/zh-TW/appendices/analysis.md
+++ b/manual/zh-TW/appendices/analysis.md
@@ -1,14 +1,14 @@
-## 編程標準分析
+## 代碼標準分析
 
-對於接受所貢獻出新的程式碼時，我們將會執行編程標準，以確保源程式碼的風格是一致的。也能確保你的代碼能符合此標準以順暢的進行代碼的貢獻。
+對於接受所貢獻出新的程式碼時，我們將會執行代碼標準，以確保源程式碼的風格是一致的。也能確保你的代碼能符合此標準以順暢的進行程式碼的貢獻。
 
-## 配置編程分析工具
+## 配置代碼分析工具
 
 為了提高源程式碼的一致性和可讀性，Joomla 會使用代碼分析工具，CodeSniffer，並為了保持最新狀態，會把重要的變更與變化都會更新上 Joomla 專案的程式庫。
 
 ### 執行 CodeSniffer
 
-Joomla 的編程標準規則都會交由名為 PHP CodeSniffer 的工具來寫入。若要安裝 PHP CodeSniffer 至您的系統，請到這個連結: [PHP CodeSniffer Pear Page](http://pear.php.net/package/PHP_CodeSniffer)查詢相關資訊。
+Joomla 的代碼標準規則都會交由名為 PHP CodeSniffer 的工具來寫入。若要安裝 PHP CodeSniffer 至您的系統，請到這個連結: [PHP CodeSniffer Pear Page](http://pear.php.net/package/PHP_CodeSniffer)查詢相關資訊。
 
 你可以透過 CMS (內容管理系統)，Framework (框架)，或 Issue Tracker (問題追蹤) 這些型態的系統，並置於這些程式軟體的根目錄下執行這個工具。
 

From 2c84c88b1082d2328565f58b0a2dec68e9de16bd Mon Sep 17 00:00:00 2001
From: michael520 <michael@bm-sms.com.tw>
Date: Fri, 3 Oct 2014 15:38:56 +0800
Subject: [PATCH 13/33] Translate menu

---
 manual/zh-TW/menu.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/manual/zh-TW/menu.md b/manual/zh-TW/menu.md
index ce266484..e869d385 100644
--- a/manual/zh-TW/menu.md
+++ b/manual/zh-TW/menu.md
@@ -1,15 +1,15 @@
-- [Introduction](coding-standards/introduction.md)
-- [Source Code Management](coding-standards/chapters/source-code-management.md)
-- **Coding Standards**
-    - [Basic Guidelines](coding-standards/chapters/basic-guidelines.md)
-    - [Inline Code Comments](coding-standards/chapters/inline-comments.md)
-    - [DocBlocks](coding-standards/chapters/docblocks.md)
-    - [PHP Code](coding-standards/chapters/php.md)
+- [簡介](coding-standards/introduction.md)
+- [源碼管理](coding-standards/chapters/source-code-management.md)
+- **代碼標準**
+    - [基礎指引](coding-standards/chapters/basic-guidelines.md)
+    - [行內註解](coding-standards/chapters/inline-comments.md)
+    - [區塊註解(DocBlocks)](coding-standards/chapters/docblocks.md)
+    - [PHP編碼標準](coding-standards/chapters/php.md)
     - [XML](coding-standards/chapters/xml.md)
-- **Clientside Syntax Styleguides**
+- **使用者端語法風格指引**
     - [HTML](coding-standards/chapters/html.md)
     - [CSS](coding-standards/chapters/css.md)
     - [JavaScript](coding-standards/chapters/javascript.md)
-- **Appendices**
-    - [Code Analysis Tools](appendices/analysis.md)
-    - [Examples](appendices/examples.md)	
\ No newline at end of file
+- **附錄**
+    - [程式碼分析工具](appendices/analysis.md)
+    - [範例](appendices/examples.md)

From 945123c0a2355057e8059d20b465afef13a258c0 Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Fri, 3 Oct 2014 17:24:09 +0800
Subject: [PATCH 14/33] Translate Introduction

---
 manual/zh-TW/coding-standards/introduction.md | 20 +++++++++----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/manual/zh-TW/coding-standards/introduction.md b/manual/zh-TW/coding-standards/introduction.md
index 7c11c059..7b85d03c 100644
--- a/manual/zh-TW/coding-standards/introduction.md
+++ b/manual/zh-TW/coding-standards/introduction.md
@@ -1,19 +1,17 @@
-## Introduction
+## 前言
 
-Good coding standards are important in any software development project. These standards are even more important when a large, diverse and worldwide community of developers are contributing to a project. One of the things that sets good software apart from great software is not only the features or the actual function the software performs, but the quality of its source code. 
+好的編碼規範對於任何軟體開發專案來說都是非常重要的。這些標準對於大型、多樣化且世界級的開發者社群在對專案提交貢獻時尤其重要。讓軟體變得更好的其中一項因素，在於他的原始碼品質有多優良，而非提供了多少優異的功能。
 
-In order to perform in the highly competitive Open Source and proprietary software industries, source code not only needs to be beautifully designed, it also needs to be beautiful and elegant to look at. The Joomla Coding Standards Manual is to help ensure our code is the highest quality which will make it easy to read, debug, and maintain. 
+為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。Joomla 編碼標準就是用來幫助我們確認程式碼擁有最高的品質，以使其易於閱讀、除錯與維護的手冊。
 
-## Guiding Principles
+## 指導原則
 
-Since readable code is more maintainable, the compass that guides us in achieving that goal is a set of well thought out coding standards for the different software languages that are employed in the Joomla software project. Joomla has a solid heritage of striving to support a great looking product with great looking code. 
+可讀性高的代碼也是易於維護的，且能夠指引我們實現一種目標，也就是依靠深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座燈塔，以安全的指引社群開發者們編寫漂亮、乾淨的代碼。
 
-This manual compiles the collective wisdom of past and present contributors to the project to form the definitive standard for coding in Joomla, whether that is for the core Joomla Framework or an extension that forms part of the stack of the Joomla CMS. This manual also serves as a lighthouse to the Joomla developer community, to safely guide developers around the pitfalls of becoming lackadaisical with respect to writing clean, beautiful code.
+Joomla 編碼標準在 PHP 檔案的部份大量借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
 
-The Joomla Coding Standards borrows heavily from the PEAR coding standard for PHP files, augmenting and diverging where it is deemed sensible to do so.
+我們準備了一些 [好用的工具](appendices/analysis.md) 來幫助您確認您的代碼符合我們的標準。
 
-There are [tools available](appendices/analysis.md) to help your code conform to our standards.
+## 貢獻與改善這份手冊
 
-## Contributing to this manual
-
-If you want to contribute and improve this manual, you can find the source files at [https://github.com/joomla/coding-standards/tree/gh-pages](https://github.com/joomla/coding-standards/tree/gh-pages).
\ No newline at end of file
+如果您想要改善這份手冊並提交貢獻，可以在 [https://github.com/joomla/coding-standards/tree/gh-pages](https://github.com/joomla/coding-standards/tree/gh-pages) 之中找到其原始文件。

From 3e1660bfbfeaf722ff056cc49ffe7d99238bb713 Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Fri, 3 Oct 2014 17:32:14 +0800
Subject: [PATCH 15/33] Update introduction.md

---
 manual/zh-TW/coding-standards/introduction.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/manual/zh-TW/coding-standards/introduction.md b/manual/zh-TW/coding-standards/introduction.md
index 7b85d03c..47971cf1 100644
--- a/manual/zh-TW/coding-standards/introduction.md
+++ b/manual/zh-TW/coding-standards/introduction.md
@@ -6,7 +6,9 @@
 
 ## 指導原則
 
-可讀性高的代碼也是易於維護的，且能夠指引我們實現一種目標，也就是依靠深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座燈塔，以安全的指引社群開發者們編寫漂亮、乾淨的代碼。
+可讀性高的代碼也是易於維護的，且能夠指引我們實現一種目標，也就是依靠深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。
+
+這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座燈塔，以安全的指引社群開發者們編寫漂亮、乾淨的代碼。
 
 Joomla 編碼標準在 PHP 檔案的部份大量借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
 

From 4de75d23592d182813707d0e1e7b42a48a19b98c Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Fri, 3 Oct 2014 20:29:29 +0800
Subject: [PATCH 16/33] Update introduction.md

---
 manual/zh-TW/coding-standards/introduction.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/manual/zh-TW/coding-standards/introduction.md b/manual/zh-TW/coding-standards/introduction.md
index 47971cf1..ff434807 100644
--- a/manual/zh-TW/coding-standards/introduction.md
+++ b/manual/zh-TW/coding-standards/introduction.md
@@ -1,18 +1,18 @@
 ## 前言
 
-好的編碼規範對於任何軟體開發專案來說都是非常重要的。這些標準對於大型、多樣化且世界級的開發者社群在對專案提交貢獻時尤其重要。讓軟體變得更好的其中一項因素，在於他的原始碼品質有多優良，而非提供了多少優異的功能。
+好的編碼規範對於任何軟體開發專案來說都是非常重要的。當大型、多樣化且世界級的開發者社群在對專案提交貢獻時，這些標準尤其重要。令軟體變得更好的其中一項因素，並非它提供了多少優異的功能，而在於他的原始碼品質有多優良。
 
-為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。Joomla 編碼標準就是用來幫助我們確認程式碼擁有最高的品質，以使其易於閱讀、除錯與維護的手冊。
+為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。Joomla 編碼標準就是用來幫助我們確認程式碼擁有最高的品質，使其易於閱讀、除錯與維護的手冊。
 
 ## 指導原則
 
-可讀性高的代碼也是易於維護的，且能夠指引我們實現一種目標，也就是依靠深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。
+可讀性高的代碼也是易於維護的，且能夠指引我們實現一種目標，也就是依靠深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案的理想。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。
 
 這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座燈塔，以安全的指引社群開發者們編寫漂亮、乾淨的代碼。
 
 Joomla 編碼標準在 PHP 檔案的部份大量借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
 
-我們準備了一些 [好用的工具](appendices/analysis.md) 來幫助您確認您的代碼符合我們的標準。
+我們準備了一些 [好用的工具](appendices/analysis.md) 來幫助您確認您的代碼是否符合我們的標準。
 
 ## 貢獻與改善這份手冊
 

From d562b5147868e8a31ef754e8be7d2bf955b0da90 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Mon, 29 Sep 2014 19:51:34 +0800
Subject: [PATCH 17/33] =?UTF-8?q?html.md=20=E7=BF=BB=E8=AD=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../zh-TW/coding-standards/chapters/html.md   | 133 +++++++++---------
 1 file changed, 70 insertions(+), 63 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/html.md b/manual/zh-TW/coding-standards/chapters/html.md
index 9a7a641f..bb08666b 100644
--- a/manual/zh-TW/coding-standards/chapters/html.md
+++ b/manual/zh-TW/coding-standards/chapters/html.md
@@ -1,6 +1,6 @@
 ## html
 
-These guidelines have been assembled following an examination of emerging practices, ideas and existing styleguides, and include items from:
+這份準則是透過檢視一些新興的程式實作、想法、以及現有的編碼規範所集思廣益而成，並引用以下清單中所使用的概念：
 
 1. [Google's html styleguide](http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml)
 2. [JQuery's HTML Styleguide](http://contribute.jquery.org/style-guide/html/)
@@ -11,34 +11,36 @@ These guidelines have been assembled following an examination of emerging practi
 
 ### Doctype
 
-Always use the minimal, versionless doctype.
+永遠使用精簡且不帶版本號的 html 文件宣告。
 
 ```html
 <!doctype html>
 ```
 
-### Language
+### 語言
 
-Always define which language the page is written in.
+永遠定義該頁面所使用的語言
 
 ```html
 <html lang="en">
 ```
 
-### Encoding
-Always define the character encoding. The encoding should be defined as early as possible.
-Make sure your editor uses UTF-8 as character encoding, without a byte order mark (UTF-8, no BOM).
-Do not specify the encoding of style sheets as these assume UTF-8.
+### 編碼
+
+永遠需定義字源編碼。編碼在程式之中越早定義越好。
+確認你的編輯器是使用 UTF-8 的字源編碼，且不使用位元組順序記號(byte order mark)。
+不要在樣式表中設定編碼，因為樣式表的編碼已經預設為 UTF-8。
 
 ```html
 <meta charset="utf-8">
 ```
 
-[More on encodings and when and how to specify them can be found in Handling character encodings in HTML and CSS](http://www.w3.org/International/tutorials/tutorial-char-enc/)
-
+[更多有關如何以及何時設定這些編碼，請見此篇文章 Handling character encodings in HTML and CSS](http://www.w3.org/International/tutorials/tutorial-char-enc/)
 
 ### Capitalisation
-All html should be lowercase; element names, attributes, attribute values (unless text/CDATA), CSS selectors, properties, and property values (with the exception of strings). Additionally, there is no need to use CDATA to escape inline JavaScript, formerly a requirement to meet XML strictness in XHTML.
+### 大小寫規則
+
+所有 html 皆必須為小寫；元素名稱、屬性、屬性值(除非是 text/CDATA)、CSS 選擇器、變數、變數值(字串例外，可有大小寫)。此外，在使用內嵌的 JavaScript 時不需使用跳脫字串 CDTA，這在以前是為了讓 XHTML 符合 XML 標準時所要求的規定。
 
 ```html
 <!-- Good -->
@@ -60,11 +62,11 @@ a {
 }
 ```
 
-### Protocol
+### 通訊協定
 
-Omit the protocol portion (http:, https:) from URLs pointing to images and other media files, style sheets, and scripts unless they are not available over both protocols.
+在圖片、多媒體、樣式表或任何腳本程式的 URLs 連結上，省略通訊協定的部分 (http:, https:)，除非其來源不屬於這兩種通訊協定的範疇。
 
-This prevents mixed content issues and results in minor file size savings.
+這可以避免混合內容的安全性問題，並小量減少檔案大小。
 
 ```html
 <!-- Good -->
@@ -74,12 +76,13 @@ This prevents mixed content issues and results in minor file size savings.
 <link rel="stylesheet" href="http://joomla.org/css/main.css">
 ```
 
-### Elements and Attributes
+### 元素及屬性
 
-Always include html, head, and body tags.
+永遠加入 html，head 和 body 標籤。
+
+### Type 屬性
+引入樣式表時不要使用 type 屬性(除非不是使用CSS)。引入腳本程式時不要使用 type 屬性(除非不是使用JavaScript)。
 
-### Type attributes
-Do not use type or attributes for style sheets (unless not using CSS) and scripts (unless not using JavaScript).
 ```html
 <!-- Good -->
 <link rel="stylesheet" href="//joomla.org/css/main.css">
@@ -88,8 +91,9 @@ Do not use type or attributes for style sheets (unless not using CSS) and script
 <link rel="stylesheet" href="//joomla.org/css/main.css" type="text/css">
 ```
 
-### Language attributes
-Do not use language attributes on script tags.
+### Language 屬性
+使用 Script 標籤時不要使用 language 屬性。
+
 ```html
 <!-- Good -->
 <script href="//code.jquery.com/jquery-latest.js">
@@ -99,17 +103,16 @@ Do not use language attributes on script tags.
 ```
 
 
-### Attributes
+### 屬性
+屬性的值需在前後使用雙引號("")，並且忽略可選(Optional)之屬性。
 
-Attribute values should be quoted using double ("") quotes. Optional attributes should be omitted.
 ```html
 <!-- Good -->
 <script src="//code.jquery.com/jquery-latest.js"></script>
 <!-- Bad -->
 <script src='//code.jquery.com/jquery-latest.js'></script>
 ```
-
-Use attribute/value pairs for boolean attributes
+布林值形態的屬性需使用 屬性/值 對。
 ```html
 <!-- Good -->
 <input type="checkbox" value="on" checked="checked">
@@ -117,12 +120,12 @@ Use attribute/value pairs for boolean attributes
 <input type="checkbox" value="on" checked>
 ```
 
-HTML attributes should be listed in an order that reflects the fact that class names are the primary interface through which CSS and JavaScript select elements.
+HTML 元素中的屬性值應以 class 為首並建議依以下順序排列，這同時反映出 class 名稱在 css 與 javascript 中是最主要的選擇器 (selector)
 
 1. class
 2. id
 3. data-*
-4. Everything else
+4. 任何其他的屬性
 ```html
 <!-- Good -->
 <a class="[some-value]" id="[some-value]" data-name="[some-value]" href="[some-value]">Text</a>
@@ -130,7 +133,7 @@ HTML attributes should be listed in an order that reflects the fact that class n
 <a href="[some-value]" class="[some-value]" id="[some-value]" data-name="[some-value]">Text</a>
 ```
 
-Elements with multiple attributes can have attributes arranged across multiple lines in an effort to improve readability and produce more useful diffs:
+當元素標籤擁有多個屬性值的時候可以以多行顯示，來提升文件的可讀性並產生更好用的 diffs:
 
 ```html
 <a class="[some-value]"
@@ -141,8 +144,10 @@ Elements with multiple attributes can have attributes arranged across multiple l
 </a>
 ```
 
-### Elements
-Optional closing tags may not be omitted.
+### 元素
+
+當元素結尾標籤是可選的時候，永遠不要省略結尾標籤。
+
 ```html
 <!-- Good -->
 <p>The quick brown fox jumps over the lazy dog.</p>
@@ -150,7 +155,8 @@ Optional closing tags may not be omitted.
 <p>The quick brown fox jumps over the lazy dog.
 ```
 
-Self-closing (void) elements should not be closed. Trailing forward slashes and spaces should be omitted.
+可以自我閉合(Self-closing)的元素不應該有閉合標籤，結尾的斜線以及空白必須忽略。
+
 ```html
 <!-- Good -->
 <img src="//images/logo.png" alt="">
@@ -159,8 +165,8 @@ Self-closing (void) elements should not be closed. Trailing forward slashes and
 ```
 
 
-### Formatting
-Use a new line for every block, list, or table element, and indent every such child element.
+### 格式
+每個區塊標籤(div, list 或 table)都應該使用單獨的一行，並在每一個子元素縮排。
 
 ```html
 <!-- Good -->
@@ -178,11 +184,11 @@ Use a new line for every block, list, or table element, and indent every such ch
 </ul></div>
 ```
 
-We prefer readability over file-size savings when it comes to maintaining existing files. Plenty of whitespace is encouraged. Use whitespace to visually separate groups of related markup and to improve the readability and maintainability of your HTML. Use two empty lines between larger blocks, and use a single empty line between child blocks of larger blocks. Be consistent. (If you are worried about your document's size, spaces (as well as repeated use of the same strings - for instance class names) are excellent candidates for compression. Also, you may use a markup minifier to decrease your document's file size.)
+當維護程式碼時，相較於節省檔案大小我們偏好以可讀性作為優先考量。我們鼓勵適當且足夠的空白。使用空白來使不同的群組在視覺上有所區分，並提高您的 HTML 的可維護性以及可讀性。主要的大區塊以兩行空白隔開，其大區塊之內的小區塊以一行空白隔開。注意維持其一致性。如果您擔心文件的大小，空白(包含一些重複被使用的字串、class 等等)是被很適合被壓縮的目標之一，您可以使用一些標記語言的壓縮器來縮減檔案大小。
 
-Keep line-length to a sensible maximum, e.g., 80 columns.
+單行的長度應維持在適當的合理範圍內，如: 80 columns
 
-Tip: configure your editor to "show invisibles". This will allow you to eliminate end of line whitespace, eliminate unintended blank line whitespace, and avoid polluting commits.
+小技巧：設定您的編輯器選項為 "show invisibles"。這個選項可以替您消除不必要的空白，不會讓您的 commit 被過多的空行所影響顯示。
 
 ```html
 <blockquote>
@@ -211,9 +217,9 @@ Tip: configure your editor to "show invisibles". This will allow you to eliminat
 </table>
 ```
 
-### Indentation
-Don't indent inside html, body, script, or style. Indent inside head and all other elements.
-Indent by four spaces at a time. Don’t use tabs or mix tabs and spaces for indentation.
+### 縮排
+html、body、script 或 style 等等的標籤底下不需要縮排。head 以及任何其他的標籤底下都需縮排。
+縮排一次是四個空白。不要使用 tab 縮排或是把 tab 和空白混著使用。
 
 
 ```html
@@ -246,8 +252,9 @@ Indent by four spaces at a time. Don’t use tabs or mix tabs and spaces for ind
 </html>
 ```
 
-### Trailing Whitespace
-Remove trailing white spaces. Trailing white spaces are unnecessary and can complicate diffs.
+### 後綴空白
+
+移除後綴的空白。後綴空白是不必要的而且會造成複雜的 diffs 顯示.
 
 ```html
 <!-- Good -->
@@ -259,9 +266,11 @@ Remove trailing white spaces. Trailing white spaces are unnecessary and can comp
 
 
 ### Entity References
-Do not use entity references. There is no need to use entity references like &mdash;, &rdquo;, or &#x263a;, assuming the same encoding (UTF-8) is used for files and editors as well as among teams.
 
-The only exceptions apply to characters with special meaning in HTML (like < and &) as well as control or “invisible” characters (like no-break spaces).
+不要使用字符實體引用(entity references)。若開發團隊中每位成員的編輯器編碼都相同的話(都為UTF-8)，便不需要使用例如 &mdash;、&rdquo; 或 &#x263a。
+
+唯有的例外是，當該字符在 HTML 之中具有特殊意義 (如 < 和 &)、控制碼或屬於 "看不見 (invisible) " 的字元時(像是 ```&nbsp;``` non-breaking spaces)
+
 ```html
 <!-- Good -->
 <p>The currency symbol for the Euro is “€”.</p>
@@ -270,9 +279,10 @@ The only exceptions apply to characters with special meaning in HTML (like < and
 <p>The currency symbol for the Euro is &ldquo;&eur;&rdquo;.</p>
 ```
 
-### Inline CSS
+### 行內樣式(Inline CSS)
+
+不要使用行內樣式。當使用 JavaScript 去改變樣式或狀態時，如果可以，儘量使用 Unobtrusive JavaScript(一種將Javascript從HTML結構抽離的設計概念)的模式去改變或新增 class 名稱。
 
-Inline CSS must be avoided. When altering states using JavaScript, use CSS to define your states, and only use onobtrusive JavaScript to alter class names whenever possible.
 ```html
 <!-- Good -->
 <a class="is-link-disabled" href="//index.php">Home</a>
@@ -283,14 +293,16 @@ Inline CSS must be avoided. When altering states using JavaScript, use CSS to de
 
 @todo more meaningful example.
 
-### Style Attributes
-You should not use border, align, valign, or clear attributes. Avoid use of style attributes, except where using syndicated content or internal syndicating systems.
+### Style 屬性
+
+你不應該使用 border、align、valign 或 clear 等等的屬性。不要使用 style 屬性。避免使用 style 屬性，除非使用 syndicated content 或 internal syndicating systems。
 
+### 語意化
 
-### Semantics
-Use HTML according to its purpose. For example, use heading elements for headings, p elements for paragraphs, a elements for anchors, etc.
+根據其意義使用 HTML。舉例來說，使用標題元素(h1 ~ h6)來表示標題，段落元素 p 表示段落，連結元素 a 表示連結等等。
+
+依據不同的考量來使用 HTML 對於易使用性、重複使用性以及程式碼效率等等是相當重要的。
 
-Using HTML according to its purpose is important for accessibility, reuse, and code efficiency reasons.
 ```html
 <!-- Good -->
 <a href="subscriptions/">View subscriptions</a>
@@ -299,19 +311,18 @@ Using HTML according to its purpose is important for accessibility, reuse, and c
 <div onclick="goToSubscriptions();">View subscriptions</div>
 ```
 
+### 標記(Markup)
 
-
-### Markup
-
-#### Image Tags
-Image elements (<img>) must have an alt attribute. Height and width attributes are optional and may be omitted.
+#### 圖片標籤
+圖片元素 (<img>) 必須包含 alt 屬性. Height 和 width 屬性是可選的，可以被忽略。
 
 
 @todo add examples from here http://www.bbc.co.uk/guidelines/futuremedia/technical/semantic_markup.shtml
 
-### Comments
+### 註解
 @todo: comment styles in JS, CSS, HTML
-For more complex blocks of HTML, it may be useful to add a comment to the closing tag:
+HTML 中複雜的區塊可以在結束標籤之後加上一段註解：
+
 ```html
 <div class="parent">
 
@@ -321,10 +332,8 @@ For more complex blocks of HTML, it may be useful to add a comment to the closin
 </div><!-- /parent -->
 ```
 
-
-
-### Mark todos
-Highlight todos by using the keyword TODO, eg:
+### 在檔案中標記 Todo
+在檔案中註解待完成清單時可以使用 TODO 關鍵字，例如：
 
 ```html
 <!-- TODO: add active item class -->
@@ -334,9 +343,7 @@ Highlight todos by using the keyword TODO, eg:
 </ul>
 ```
 
-
-
-### Markup validation tools
+### 標記驗證工具
 @todo: list various testing tools:
 * http://validator.w3.org/nu/
 * http://csslint.net/

From 4cbd708667d223e67e545023bfcb252407a525d1 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Mon, 6 Oct 2014 11:19:57 +0800
Subject: [PATCH 18/33] =?UTF-8?q?CSS.md=20=E7=BF=BB=E8=AD=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 manual/zh-TW/coding-standards/chapters/css.md | 107 +++++++++---------
 1 file changed, 54 insertions(+), 53 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/css.md b/manual/zh-TW/coding-standards/chapters/css.md
index 91979236..9254d65d 100644
--- a/manual/zh-TW/coding-standards/chapters/css.md
+++ b/manual/zh-TW/coding-standards/chapters/css.md
@@ -1,93 +1,93 @@
 ## CSS
-These guidelines have been assembled following an examination of emerging practices, ideas and existing styleguides, namely:
+這份準則是透過檢視一些新興的程式實作、想法、以及現有的編碼規範所集思廣益而成，並引用以下清單中所使用的概念：
 
 1. [OOCSS Code Standards](https://github.com/stubbornella/oocss-code-standards)
 2. [Oneweb Style Guide](https://github.com/nternetinspired/OneWeb/blob/master/STYLEGUIDE.md)
 3. [Idiomatic CSS](https://github.com/necolas/idiomatic-css)
 
 
-## Commenting
+## 註解
+
+### 主要段落
+主要的程式碼段落必須以完整的註解區塊作為開頭，例如：
 
-### Major sections
-Major code sections should be named in caps and within a full comment block, eg:
 ```css
 /* ==========================================================================
    PRIMARY NAVIGATION
    ========================================================================== */
 ```
 
-### Sub sections
-Subsections should be normally cased and within an open comment block.
+### 次要段落
+次要段落須以開放式的註解區塊為開頭：
+
 ```css
 /* Mobile navigation
    ========================================================================== */
 ```
 
-### Verbose comments
+### 文字註解
 ```css
 /**
- * Short description using Doxygen-style comment format
+ * 短的註解描述使用 Doxygen 風格的註解格式
  *
  * The first sentence of the long description starts here and continues on this
  * line for a while finally concluding here at the end of this paragraph.
  *
- * The long description is ideal for more detailed explanations and
- * documentation. It can include example HTML, URLs, or any other information
- * that is deemed necessary or useful.
+ * 長的註解描述很適合做詳細的解釋與說明。如果有需要，可以使用 HTML、URLs 或其他資訊作為範例。
  *
  * @tag This is a tag named 'tag'
  *
- * TODO: This is a todo statement that describes an atomic task to be completed
- *   at a later date. It wraps after 80 characters and following lines are
- *   indented by 2 spaces.
+ * TODO: 這是一個註解區塊中 todo 的範例，描述之後需要被完成的項目。
+ *   一行應小於 80 個字元，換行之後須以兩個空白作為縮排開頭
  */
  ```
 
-### Basic comments
+### 基本註解方式
 ```css
 /* Basic comment */
 ```
 
-### Uncompiled LESS/Scss comments
+### 為編譯的 LESS/Scss 註解
 ```css
-// These are stripped on compile.
+// 這段註解在編譯的時候會被移除
 ```
 
-## Class naming
-Use dashes to create compound class names:
+## Class 命名方式
+使用破折號 (-) 來處理復合式命名：
 
 ```css
-/* Good - use dashes */
+/* 正確 - 使用破折號 */
 .compound-class-name {…}
 
-/* Bad - uses underscores */
+/* 錯誤 - 使用底線 */
 .compound_class_name {…}
 
-/* Bad - uses camelCase */
+/* 錯誤 - 使用駝峰式命名 */
 .compoundClassName {…}
 
-/* Bad - does not use seperators */
+/* 錯誤 - 不使用符號分隔 */
 .compoundclassname {…}
 ```
 
-### Indentation
-Rules should be indented one tab (equal to 4 spaces):
+### 縮排
+須以一個 tab 來縮排 (等於 4 個空白)
 
 ```css
-/* Good */
+/* 正確 */
 .example {
 	color: #000;
 	visibility: hidden;
 }
 
-/* Bad - all on one line */
+/* 錯誤 - 寫在同一行 */
 .example {color: #000; visibility: hidden;}
 ```
 
+LESS/Scss 也應該正確被縮排寫成巢狀，其子選擇器還有樣式規則都應該縮排。巢狀的規則須以一空行作為間隔：
 LESS/Scss should also be nested , with child selectors and rules indented again. Nested rules should also be spaced by one line:
 
 ```css
-/* Good */
+/* 正確 */
 .example {
 
   > li {
@@ -101,7 +101,7 @@ LESS/Scss should also be nested , with child selectors and rules indented again.
   }
 
 }
-/* Bad - nested rules not indented */
+/* 錯誤 - 巢狀的樣式沒有正確縮排 */
 .example {
 
 	> li {
@@ -115,7 +115,7 @@ LESS/Scss should also be nested , with child selectors and rules indented again.
 	}
 
 }
-/* Bad - nested rules not spaced */
+/* 錯誤 - 巢狀的規則沒有以一空行作為間隔 */
 .example {
   > li {
     float: none;
@@ -127,93 +127,94 @@ LESS/Scss should also be nested , with child selectors and rules indented again.
 }
 ```
 
-### Alignment
-The opening brace must be on the same line as the last selector and preceded by a space. The closing brace must be on its own line after the last property and be indented to the same level as the opening brace.
+### 對齊
+左大括號必須跟選擇器位於同一行，並前綴一空白字元。右大括號須存在於最後一個屬性規則之後並獨立於新的一行，且應與左大括號處於相同的縮排。
 
 ```css
-/* Good */
+/* 正確 */
 .example {
     color: #fff;
 }
 
-/* Bad - closing brace is in the wrong place */
+/* 錯誤 - 右大括號的位置錯了，沒有正確縮排 */
 .example {
     color: #fff;
     }
 
-/* Bad - opening brace missing space */
+/* 錯誤 - 左大括號之前沒有空白 */
 .example{
     color: #fff;
 }
 ```
 
-### Property Format
-Each property must be on its own line and indented one level. There should be no space before the colon and one space after. All properties must end with a semicolon.
+### 樣式屬性格式
+每一個屬性都應該存在獨立的一行，並縮排一個層級。冒號之前不應該有空白字元，但須後綴一空白字元。所有的樣式屬性須以分號 (;) 作為結尾。
 
 ```css
-/* Good */
+/* 正確 */
 .example {
     background: black;
     color: #fff;
 }
 
-/* Bad - missing spaces after colons */
+/* 錯誤 - 冒號後面沒有後綴空白 */
 .example {
     background:black;
     color:#fff;
 }
 
-/* Bad - missing last semicolon */
+/* 錯誤 - 沒有以分號作為結尾 */
 .example {
     background: black;
     color: #fff
 }
 ```
 
-### HEX values
-HEX values must be declared in lowercase and shorthand:
+### HEX 值
+HEX 值應該使用小寫並以最小縮寫宣告：
+
 ```css
-/* Good */
+/* 正確 */
 .example {
     color: #eee;
 }
 
-/* Bad */
+/* 錯誤 */
 .example {
     color: #EEEEEE;
 }
 ```
 
-### Attribute selectors
-Always use double quotes around attribute selectors.
+### HTML 屬性選擇器
+屬性選擇器須以雙引號包含。
 
 ```css
-/* Good */
+/* 正確 */
 input[type="button"] {
     ...
 }
 
-/* Bad - missing quotes */
+/* 錯誤 - 沒有雙引號 */
 input[type=button] {
     ...
 }
 
-/* Bad - using single quote */
+/* 錯誤 - 使用單引號 */
 input[type='button'] {
     ...
 }
 ```
 
-### Zero value units
-Zero values should not carry units.
+### 零值的單位
+零值不應該使用單位。
 
 ```css
-/* Good */
+/* 正確 */
 .example {
    padding: 0;
 }
 
-/* Bad - uses units */
+/* 錯誤 - 使用單位 */
 .example {
    padding: 0px;
 }

From 2736b52e2b01ca2ae7b5f5d20f77fbf9e03dfd8e Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Mon, 6 Oct 2014 12:42:18 +0800
Subject: [PATCH 19/33] Update introduction.md

---
 manual/zh-TW/coding-standards/introduction.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/manual/zh-TW/coding-standards/introduction.md b/manual/zh-TW/coding-standards/introduction.md
index ff434807..8242c4fc 100644
--- a/manual/zh-TW/coding-standards/introduction.md
+++ b/manual/zh-TW/coding-standards/introduction.md
@@ -1,6 +1,6 @@
 ## 前言
 
-好的編碼規範對於任何軟體開發專案來說都是非常重要的。當大型、多樣化且世界級的開發者社群在對專案提交貢獻時，這些標準尤其重要。令軟體變得更好的其中一項因素，並非它提供了多少優異的功能，而在於他的原始碼品質有多優良。
+好的編碼規範對於任何軟體開發專案來說都是非常重要的。當大型、多樣化且世界級的開發者社群在對專案提交貢獻時，這些標準尤其重要。令軟體變得更好的其中一項因素，不只在於它提供了多少優異的功能，也需關注它的原始碼品質有多優良。
 
 為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。Joomla 編碼標準就是用來幫助我們確認程式碼擁有最高的品質，使其易於閱讀、除錯與維護的手冊。
 

From 9fa82d0e0c9a1a944f5f42d20263ba0e80284df8 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Mon, 6 Oct 2014 14:33:21 +0800
Subject: [PATCH 20/33] =?UTF-8?q?=E9=8C=AF=E5=AD=97=EF=BC=8C=E6=AD=A3?=
 =?UTF-8?q?=E7=A2=BA=20good=20=E9=8C=AF=E8=AA=A4=20bad?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 manual/zh-TW/coding-standards/chapters/css.md |  2 +-
 .../zh-TW/coding-standards/chapters/html.md   | 64 +++++++++----------
 2 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/css.md b/manual/zh-TW/coding-standards/chapters/css.md
index 9254d65d..3b9267a9 100644
--- a/manual/zh-TW/coding-standards/chapters/css.md
+++ b/manual/zh-TW/coding-standards/chapters/css.md
@@ -47,7 +47,7 @@
 /* Basic comment */
 ```
 
-### 為編譯的 LESS/Scss 註解
+### 未編譯的 LESS/Scss 註解
 ```css
 // 這段註解在編譯的時候會被移除
 ```
diff --git a/manual/zh-TW/coding-standards/chapters/html.md b/manual/zh-TW/coding-standards/chapters/html.md
index bb08666b..0840f4f3 100644
--- a/manual/zh-TW/coding-standards/chapters/html.md
+++ b/manual/zh-TW/coding-standards/chapters/html.md
@@ -28,7 +28,7 @@
 ### 編碼
 
 永遠需定義字源編碼。編碼在程式之中越早定義越好。
-確認你的編輯器是使用 UTF-8 的字源編碼，且不使用位元組順序記號(byte order mark)。
+確認你的編輯器是使用 UTF-8 的字源編碼，且不使用 BOM (byte order mark 位元組順序記號)。
 不要在樣式表中設定編碼，因為樣式表的編碼已經預設為 UTF-8。
 
 ```html
@@ -43,20 +43,20 @@
 所有 html 皆必須為小寫；元素名稱、屬性、屬性值(除非是 text/CDATA)、CSS 選擇器、變數、變數值(字串例外，可有大小寫)。此外，在使用內嵌的 JavaScript 時不需使用跳脫字串 CDTA，這在以前是為了讓 XHTML 符合 XML 標準時所要求的規定。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <img src="joomla.png" alt="Joomla">
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <A HREF="/">Home</A>
 ```
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 a {
     color: #a3a3a3;
 }
 
-<!-- Bad -->
+<!-- 錯誤 -->
 a {
     color: #A3A3A3;
 }
@@ -69,10 +69,10 @@ a {
 這可以避免混合內容的安全性問題，並小量減少檔案大小。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <link rel="stylesheet" href="//joomla.org/css/main.css">
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <link rel="stylesheet" href="http://joomla.org/css/main.css">
 ```
 
@@ -84,10 +84,10 @@ a {
 引入樣式表時不要使用 type 屬性(除非不是使用CSS)。引入腳本程式時不要使用 type 屬性(除非不是使用JavaScript)。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <link rel="stylesheet" href="//joomla.org/css/main.css">
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <link rel="stylesheet" href="//joomla.org/css/main.css" type="text/css">
 ```
 
@@ -95,10 +95,10 @@ a {
 使用 Script 標籤時不要使用 language 屬性。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <script href="//code.jquery.com/jquery-latest.js">
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <script href="//code.jquery.com/jquery-latest.js" language="javascript">
 ```
 
@@ -107,16 +107,16 @@ a {
 屬性的值需在前後使用雙引號("")，並且忽略可選(Optional)之屬性。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <script src="//code.jquery.com/jquery-latest.js"></script>
-<!-- Bad -->
+<!-- 錯誤 -->
 <script src='//code.jquery.com/jquery-latest.js'></script>
 ```
 布林值形態的屬性需使用 屬性/值 對。
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <input type="checkbox" value="on" checked="checked">
-<!-- Bad -->
+<!-- 錯誤 -->
 <input type="checkbox" value="on" checked>
 ```
 
@@ -127,9 +127,9 @@ HTML 元素中的屬性值應以 class 為首並建議依以下順序排列，
 3. data-*
 4. 任何其他的屬性
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <a class="[some-value]" id="[some-value]" data-name="[some-value]" href="[some-value]">Text</a>
-<!-- Bad -->
+<!-- 錯誤 -->
 <a href="[some-value]" class="[some-value]" id="[some-value]" data-name="[some-value]">Text</a>
 ```
 
@@ -149,18 +149,18 @@ HTML 元素中的屬性值應以 class 為首並建議依以下順序排列，
 當元素結尾標籤是可選的時候，永遠不要省略結尾標籤。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <p>The quick brown fox jumps over the lazy dog.</p>
-<!-- Bad -->
+<!-- 錯誤 -->
 <p>The quick brown fox jumps over the lazy dog.
 ```
 
 可以自我閉合(Self-closing)的元素不應該有閉合標籤，結尾的斜線以及空白必須忽略。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <img src="//images/logo.png" alt="">
-<!-- Bad -->
+<!-- 錯誤 -->
 <img src="//images/logo.png" alt="" />
 ```
 
@@ -169,7 +169,7 @@ HTML 元素中的屬性值應以 class 為首並建議依以下順序排列，
 每個區塊標籤(div, list 或 table)都應該使用單獨的一行，並在每一個子元素縮排。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <div>
 	<ul>
 	  <li>Home</li>
@@ -177,7 +177,7 @@ HTML 元素中的屬性值應以 class 為首並建議依以下順序排列，
 	</ul>
 </div>
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <div><ul>
   <li>Home</li>
   <li>Blog</li>
@@ -223,7 +223,7 @@ html、body、script 或 style 等等的標籤底下不需要縮排。head 以
 
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <!doctype html>
 <html lang="en">
 <head>
@@ -257,10 +257,10 @@ html、body、script 或 style 等等的標籤底下不需要縮排。head 以
 移除後綴的空白。後綴空白是不必要的而且會造成複雜的 diffs 顯示.
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <p>Yes please.</p>
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <p>No, thank you. </p>
 ```
 
@@ -272,10 +272,10 @@ html、body、script 或 style 等等的標籤底下不需要縮排。head 以
 唯有的例外是，當該字符在 HTML 之中具有特殊意義 (如 < 和 &)、控制碼或屬於 "看不見 (invisible) " 的字元時(像是 ```&nbsp;``` non-breaking spaces)
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <p>The currency symbol for the Euro is “€”.</p>
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <p>The currency symbol for the Euro is &ldquo;&eur;&rdquo;.</p>
 ```
 
@@ -284,10 +284,10 @@ html、body、script 或 style 等等的標籤底下不需要縮排。head 以
 不要使用行內樣式。當使用 JavaScript 去改變樣式或狀態時，如果可以，儘量使用 Unobtrusive JavaScript(一種將Javascript從HTML結構抽離的設計概念)的模式去改變或新增 class 名稱。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <a class="is-link-disabled" href="//index.php">Home</a>
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <a href="//index.php" style="text-decoration: line-through;">Home</a>
 ```
 
@@ -304,10 +304,10 @@ html、body、script 或 style 等等的標籤底下不需要縮排。head 以
 依據不同的考量來使用 HTML 對於易使用性、重複使用性以及程式碼效率等等是相當重要的。
 
 ```html
-<!-- Good -->
+<!-- 正確 -->
 <a href="subscriptions/">View subscriptions</a>
 
-<!-- Bad -->
+<!-- 錯誤 -->
 <div onclick="goToSubscriptions();">View subscriptions</div>
 ```
 

From 3da6c77349ea51e8b464ddda5f8d4235472c81cb Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Mon, 6 Oct 2014 15:03:47 +0800
Subject: [PATCH 21/33] Update introduction.md

---
 manual/zh-TW/coding-standards/introduction.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/manual/zh-TW/coding-standards/introduction.md b/manual/zh-TW/coding-standards/introduction.md
index 8242c4fc..dbb28413 100644
--- a/manual/zh-TW/coding-standards/introduction.md
+++ b/manual/zh-TW/coding-standards/introduction.md
@@ -6,7 +6,7 @@
 
 ## 指導原則
 
-可讀性高的代碼也是易於維護的，且能夠指引我們實現一種目標，也就是依靠深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案的理想。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。
+可讀性高的代碼也是易於維護的，而靠著一套針對 Joomla! 所使用的各種程式語言所攥寫的完善編碼標準，能夠指引我們實現可讀性的這個目標。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。
 
 這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座燈塔，以安全的指引社群開發者們編寫漂亮、乾淨的代碼。
 

From 1400b9970a3188e6da1584a0b07db32d9ae570c3 Mon Sep 17 00:00:00 2001
From: wayne <wayne@bm-sms.com.tw>
Date: Tue, 7 Oct 2014 12:36:56 +0800
Subject: [PATCH 22/33] =?UTF-8?q?=E6=96=B0=E7=BF=BB=E8=AD=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../coding-standards/chapters/docblocks.md    | 117 +++++++++---------
 1 file changed, 57 insertions(+), 60 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/docblocks.md b/manual/zh-TW/coding-standards/chapters/docblocks.md
index 74965f46..6ac3830e 100644
--- a/manual/zh-TW/coding-standards/chapters/docblocks.md
+++ b/manual/zh-TW/coding-standards/chapters/docblocks.md
@@ -1,32 +1,32 @@
-## DocBlocks
+## 區塊註解
 
-Documentation headers for PHP code in: files, classes, class properties, methods and functions, called the docblocks, follow a convention similar to JavaDoc or phpDOC.
+被使用在 PHP 程式碼中(如：文件、類別、類別屬性、方法和函數) 的說明標頭被稱作區塊註解 (docblocks)，攥寫方式遵循類似 JavaDoc 或 phpDOC 所使用的慣例。
 
-These "DocBlocks" borrow from the PEAR standard but have some variations specific for Joomla and the Joomla projects.
+這些區塊註解是仿效 PEAR 的標準，但是針對 Joomla 和 Joomla projects 做了些許的變更。
 
-Whereas normal code indenting uses real tabs, all whitespace in a Docblock uses real spaces. This provides better readability in source code browsers. The minimum whitespace between any text elements, such as tags, variable types, variable names and tag descriptions, is two real spaces. Variable types and tag descriptions should be aligned according to the longest Docblock tag and type-plus-variable respectively.
+區塊註解裡的空白都是使用空白鍵而縮排都是使用tab，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
 
-Code contributed to the Joomla project that will become the copyright of the project is not allowed to include @author tags. You should update the contribution log in CREDITS.php. Joomla's philosophy is that the code is written "all together" and there is no notion of any one person "owning" any section of code. The @author tags are permitted in third-party libraries that are included in the core libraries.
+@author 將成為 Joomla project 版權一部分而貢獻出來的程式不允許使用 @auther 標籤。您必須更新您的(CREDITS.php 在 contribution log)。 Joomla程式原則是"互助"，所以並不會在Joomla程式碼提出或是感謝某人提供或擁有任何程式碼。@author標籤 在Joomla第三方核心程式編碼是被允許的。
 
-Files included from third party sources must leave DocBlocks intact. Layout files use the same DocBlocks as other PHP files.
+第三方程式資源編碼必須要留下完整的註解檔說明，說明註解寫法必須與其他PHP文件相同。
 
-### File DocBlock Headers
-The file header DocBlock consists of the following required and optional elements in the following order:
-Short description (optional unless the file contains more than two classes or functions), followed by a blank line). Long description (optional, followed by a blank line).
+### 區塊註解
+區塊註解必須按照以下必填或非必填規則。
+簡短的說明(非必填，除非該文件包含兩個以上的物件或函數，結尾處需要斷行)。
+詳細的說明(非必填，結尾處需要斷行)。
 
-* @category (optional and rarely used)
-* @package (generally optional but required when files contain only procedural code)
-* @subpackage (optional)
-* @author (optional but only permitted in non-Joomla source files, for example, included third-party libraries like Geshi)
-* @copyright (required)
-* @license (required and must be compatible with the Joomla license)
-* @deprecated (optional)
-* @link (optional)
-* @see (optional)
-* @since (generally optional but required when files contain only procedural code)
-
-Example of a DocBlock Header:
+* @category (非必填，極少使用)
+* @package (通常是非必填，但當程式碼是持續性就是必填)
+* @subpackage (非必填)
+* @author (非必填但只被允許在非Joomla程式資源裡, 像是第三方套件Geshi)
+* @copyright (必填)
+* @license (必填，證照必須要可以跟Joomla相容)
+* @deprecated (非必填)
+* @link (非必填)
+* @see (非必填)
+* @since (通常是非必填，但當程式碼是持續性就是必填)
 
+區塊註解範例：
 ```php
 /**
  * @package     Joomla.Installation
@@ -37,25 +37,25 @@ Example of a DocBlock Header:
  */
 ```
 
-### Class Definitions
-Class definitions start on a new line and the opening and closing braces are also placed on new lines. Class methods must follow the guidelines for Function Definitions. Properties and methods must follow OOP standards and be declared appropriately (using public, protected, private and static as applicable).
-Class definitions, properties and methods must each be provided with a DocBlock in accordance with the following sections.
-
-#### Class DocBlock Headers
-The class Docblock consists of the following required and optional elements in the fol-lowing order.
-Short description (required, unless the file contains more than two classes or functions), followed by a blank line). Long description (optional, followed by a blank line).
-* @category (optional and rarely used)
-* @package (required)
-* @subpackage (optional)
-* @author (optional but only permitted in non-Joomla source files, for example, included third-party libraries like Geshi)
-* @copyright (optional unless different from the file Docblock)
-* @license (optional unless different from the file Docblock)
-* @deprecated (optional)
-* @link (optional)
-* @see (optional)
-* @since (required, being the version of the software the class was introduced)
-
-Example of a Class file DocBlock header:
+### 物件定義
+物件定義必須在新的行列而結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循面OOP的標準，並進行適當的宣告（使用公共，保護，私有和靜態如適用）。
+物件定義，屬性和方法必須在提供在區塊註解並遵循以下條件。
+
+#### 物件區塊註解
+物件註解有包含在以下各種必填或非必填元素：
+簡單區塊註解 (必填, 除非該文件包含兩個以上的物件或函數，結尾處需要斷行)
+* @category (非必填，極少使用))
+* @package (必填)
+* @subpackage (非必填)
+* @author (非必填但只被允許在非Joomla程式資源裡, 像是第三方套件Geshi)
+* @copyright (非必填除非是不同的文件註解)
+* @license (非必填除非是不同的文件註解)
+* @deprecated (非必填)
+* @link (非必填)
+* @see (非必填)
+* @since (必填，該 class 剛被採用時軟體的版本)
+
+物件區塊註解範例：
 ```php
 /**
  * Controller class to initialise the database for the Joomla Installer.
@@ -66,16 +66,15 @@ Example of a Class file DocBlock header:
  */
 ```
 
-#### Class Property DocBlocks 
-The class property Docblock consists of the following required and optional elements in the following order.
-Short description (required, followed by a blank line)
-
-* @var (required, followed by the property type)
-* @deprecated (optional)
-* @since (required)
+#### 物件屬性區塊註解：
+物件屬性區塊註解包含以下必填和非必填的條件規則。
+簡短說明（非必填，結尾處需要斷行）
 
-Example of Class property DocBlock:
+* @var（必填，必須是屬性類型）
+* @deprecated（非必填）
+* @since（必填）
 
+物件屬性區塊註解的範例：
 ```php
 	/**
 	 * The generated user ID
@@ -86,20 +85,18 @@ Example of Class property DocBlock:
 	protected static $userId = 0;
 ```
 
+#### 物件方法區塊註解和函式區塊註解
+函數必須在一個新的行列和結束括號也放在新行列。空行應先行指定的返回值。
 
+函數定義必須按照以下區塊註解條件規則。
 
-#### Class Method DocBlocks and Functions DocBlocks
-Function definitions start on a new line and the opening and closing braces are also placed on new lines. An empty line should precede lines specifying the return value.
-
-Function definitions must include a documentation comment in accordance with the Commenting section of this document.
-
-* Short description (required, followed by a blank line)
-* Long description (optional, followed by a blank line)
-* @param (required if there are method or function arguments, the last @param tag is followed by a blank line)
-* @return (required, followed by a blank line)
-* All other tags in alphabetical order, however @since is always required.
+* 簡短說明（必填，結尾處需要斷行）
+* 詳細的說明（非必填，結尾處需要斷行）
+* @param（必填，如果有方法或函數參數，最後@param標籤後面跟著一個斷行）
+* @return（必填，結尾處需要斷行）
+* 其他標籤須按字母排序，不管怎樣一定要有 @since。
 
-Example of Method DocBlock:
+函數註解範例：
 ```php
 	/**
 	 * Set a controller class suffix for a given HTTP method.
@@ -118,7 +115,7 @@ Example of Method DocBlock:
 	public function setHttpMethodSuffix($method, $suffix)
 ```
 
-If a function definition goes over multiple lines, all lines must be indented with one tab and the closing brace must go on the same line as the last parameter.
+如果一個函數太多的行數，所有的行數都必須使用tab來做縮排而結束括號必須跟最後一個參數同一行。
 
 ```php
 function fooBar($param1, $param2, 

From 1baf39164982cb75808f8b2bb244026846106aa1 Mon Sep 17 00:00:00 2001
From: wayne <wayne@bm-sms.com.tw>
Date: Tue, 7 Oct 2014 13:15:26 +0800
Subject: [PATCH 23/33] =?UTF-8?q?=E7=BF=BB=E8=AD=AFrevised2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 manual/zh-TW/coding-standards/chapters/docblocks.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/docblocks.md b/manual/zh-TW/coding-standards/chapters/docblocks.md
index 6ac3830e..77a69588 100644
--- a/manual/zh-TW/coding-standards/chapters/docblocks.md
+++ b/manual/zh-TW/coding-standards/chapters/docblocks.md
@@ -4,9 +4,9 @@
 
 這些區塊註解是仿效 PEAR 的標準，但是針對 Joomla 和 Joomla projects 做了些許的變更。
 
-區塊註解裡的空白都是使用空白鍵而縮排都是使用tab，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
+區塊註解裡的空白都是使用空白鍵而一般程式碼的縮排則使用 tabs 字元，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
 
-@author 將成為 Joomla project 版權一部分而貢獻出來的程式不允許使用 @auther 標籤。您必須更新您的(CREDITS.php 在 contribution log)。 Joomla程式原則是"互助"，所以並不會在Joomla程式碼提出或是感謝某人提供或擁有任何程式碼。@author標籤 在Joomla第三方核心程式編碼是被允許的。
+貢獻到 Joomla 專案下的程式碼，其版權將屬於 Joomla 專案，因此我們不允許其內包含 @author 標籤。您必須在 CREDITS.php 中更新您的貢獻記錄。Joomla 的哲學是：程式碼是被 "共同" 撰寫的，任何人都不能主張其擁有 Joomla 專案中的程式碼片段。然而，在核心 libraries 之中所使用的第三方 libraries 則允許使用 @author 標簽。
 
 第三方程式資源編碼必須要留下完整的註解檔說明，說明註解寫法必須與其他PHP文件相同。
 
@@ -38,11 +38,11 @@
 ```
 
 ### 物件定義
-物件定義必須在新的行列而結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循面OOP的標準，並進行適當的宣告（使用公共，保護，私有和靜態如適用）。
+物件定義必須在新的行列而開結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循 OOP 的標準，並進行適當的宣告（選擇適合的 public, protected, private 和 static 使用）。
 物件定義，屬性和方法必須在提供在區塊註解並遵循以下條件。
 
 #### 物件區塊註解
-物件註解有包含在以下各種必填或非必填元素：
+物件註解定義必須按照以下區塊註解條件規則。
 簡單區塊註解 (必填, 除非該文件包含兩個以上的物件或函數，結尾處需要斷行)
 * @category (非必填，極少使用))
 * @package (必填)
@@ -67,7 +67,7 @@
 ```
 
 #### 物件屬性區塊註解：
-物件屬性區塊註解包含以下必填和非必填的條件規則。
+物件屬性區塊註解定義必須按照以下區塊註解條件規則。
 簡短說明（非必填，結尾處需要斷行）
 
 * @var（必填，必須是屬性類型）
@@ -94,7 +94,7 @@
 * 詳細的說明（非必填，結尾處需要斷行）
 * @param（必填，如果有方法或函數參數，最後@param標籤後面跟著一個斷行）
 * @return（必填，結尾處需要斷行）
-* 其他標籤須按字母排序，不管怎樣一定要有 @since。
+* 其他標籤須按字母排序，不管怎樣一定要有 @since
 
 函數註解範例：
 ```php

From 0a4f85139f0fccb679db05a9957e59641f8e263f Mon Sep 17 00:00:00 2001
From: wayne <wayne@bm-sms.com.tw>
Date: Tue, 7 Oct 2014 15:49:26 +0800
Subject: [PATCH 24/33] revised3

---
 .../coding-standards/chapters/docblocks.md    | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/docblocks.md b/manual/zh-TW/coding-standards/chapters/docblocks.md
index 77a69588..2cc9b3bc 100644
--- a/manual/zh-TW/coding-standards/chapters/docblocks.md
+++ b/manual/zh-TW/coding-standards/chapters/docblocks.md
@@ -1,10 +1,10 @@
 ## 區塊註解
 
-被使用在 PHP 程式碼中(如：文件、類別、類別屬性、方法和函數) 的說明標頭被稱作區塊註解 (docblocks)，攥寫方式遵循類似 JavaDoc 或 phpDOC 所使用的慣例。
+被使用在 PHP 程式碼中 (如：文件、類別、類別屬性、方法和函數) 的說明標頭被稱作區塊註解 (docblocks)，攥寫方式遵循類似 JavaDoc 或 phpDOC 所使用的慣例。
 
 這些區塊註解是仿效 PEAR 的標準，但是針對 Joomla 和 Joomla projects 做了些許的變更。
 
-區塊註解裡的空白都是使用空白鍵而一般程式碼的縮排則使用 tabs 字元，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
+區塊註解裡所有的空白都是使用空白鍵然而一般程式的縮排使用 tab 鍵，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
 
 貢獻到 Joomla 專案下的程式碼，其版權將屬於 Joomla 專案，因此我們不允許其內包含 @author 標籤。您必須在 CREDITS.php 中更新您的貢獻記錄。Joomla 的哲學是：程式碼是被 "共同" 撰寫的，任何人都不能主張其擁有 Joomla 專案中的程式碼片段。然而，在核心 libraries 之中所使用的第三方 libraries 則允許使用 @author 標簽。
 
@@ -12,15 +12,15 @@
 
 ### 區塊註解
 區塊註解必須按照以下必填或非必填規則。
-簡短的說明(非必填，除非該文件包含兩個以上的物件或函數，結尾處需要斷行)。
-詳細的說明(非必填，結尾處需要斷行)。
+簡短說明 (非必填，除非該文件包含兩個以上的物件或函數，結尾處需要斷行)。
+詳細說明 (非必填，結尾處需要斷行)。
 
 * @category (非必填，極少使用)
 * @package (通常是非必填，但當程式碼是持續性就是必填)
 * @subpackage (非必填)
-* @author (非必填但只被允許在非Joomla程式資源裡, 像是第三方套件Geshi)
+* @author (非必填但只被允許在非 Joomla 程式資源裡，像是第三方套件 Geshi)
 * @copyright (必填)
-* @license (必填，證照必須要可以跟Joomla相容)
+* @license (必填，證照必須要可以跟 Joomla 相容)
 * @deprecated (非必填)
 * @link (非必填)
 * @see (非必填)
@@ -38,16 +38,16 @@
 ```
 
 ### 物件定義
-物件定義必須在新的行列而開結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循 OOP 的標準，並進行適當的宣告（選擇適合的 public, protected, private 和 static 使用）。
+物件定義必須在新的行列而開結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循 OOP 的標準，並進行適當的宣告（選擇適合的 public, protected, private 和 static 使用)。
 物件定義，屬性和方法必須在提供在區塊註解並遵循以下條件。
 
 #### 物件區塊註解
 物件註解定義必須按照以下區塊註解條件規則。
-簡單區塊註解 (必填, 除非該文件包含兩個以上的物件或函數，結尾處需要斷行)
-* @category (非必填，極少使用))
+簡單區塊註解 (必填，除非該文件包含兩個以上的物件或函數，結尾處需要斷行)
+* @category (非必填，極少使用)
 * @package (必填)
 * @subpackage (非必填)
-* @author (非必填但只被允許在非Joomla程式資源裡, 像是第三方套件Geshi)
+* @author (非必填但只被允許在非 Joomla 程式資源裡，像是第三方套件 Geshi)
 * @copyright (非必填除非是不同的文件註解)
 * @license (非必填除非是不同的文件註解)
 * @deprecated (非必填)
@@ -68,7 +68,7 @@
 
 #### 物件屬性區塊註解：
 物件屬性區塊註解定義必須按照以下區塊註解條件規則。
-簡短說明（非必填，結尾處需要斷行）
+簡短說明（非必填，結尾處需要斷行）。
 
 * @var（必填，必須是屬性類型）
 * @deprecated（非必填）
@@ -91,8 +91,8 @@
 函數定義必須按照以下區塊註解條件規則。
 
 * 簡短說明（必填，結尾處需要斷行）
-* 詳細的說明（非必填，結尾處需要斷行）
-* @param（必填，如果有方法或函數參數，最後@param標籤後面跟著一個斷行）
+* 詳細說明（非必填，結尾處需要斷行）
+* @param（必填，如果有方法或函數參數，最後 @param 標籤後面跟著一個斷行）
 * @return（必填，結尾處需要斷行）
 * 其他標籤須按字母排序，不管怎樣一定要有 @since
 
@@ -115,7 +115,7 @@
 	public function setHttpMethodSuffix($method, $suffix)
 ```
 
-如果一個函數太多的行數，所有的行數都必須使用tab來做縮排而結束括號必須跟最後一個參數同一行。
+如果一個函數定義太多的行數，所有的行數都必須使用tab來做縮排而結束括號必須跟最後一個參數同一行。
 
 ```php
 function fooBar($param1, $param2, 

From 0e7076dbae258e14bddb1624152e0780f90e9c6a Mon Sep 17 00:00:00 2001
From: wayne <wayne@bm-sms.com.tw>
Date: Tue, 7 Oct 2014 17:18:34 +0800
Subject: [PATCH 25/33] =?UTF-8?q?=E6=94=B9"=E9=96=8B=E9=A0=AD"=E5=92=8C?=
 =?UTF-8?q?=E5=8A=A0=E9=80=97=E8=99=9F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 manual/zh-TW/coding-standards/chapters/docblocks.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/docblocks.md b/manual/zh-TW/coding-standards/chapters/docblocks.md
index 2cc9b3bc..c04725f4 100644
--- a/manual/zh-TW/coding-standards/chapters/docblocks.md
+++ b/manual/zh-TW/coding-standards/chapters/docblocks.md
@@ -4,14 +4,14 @@
 
 這些區塊註解是仿效 PEAR 的標準，但是針對 Joomla 和 Joomla projects 做了些許的變更。
 
-區塊註解裡所有的空白都是使用空白鍵然而一般程式的縮排使用 tab 鍵，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
+區塊註解裡所有的空白都是使用空白鍵，然而一般程式的縮排使用 tab 鍵，這樣的好處是使區塊註解能更有良好的閱讀性。任何的文字元素、標籤、變數、變數名稱、標籤說明至少都需要兩個空白鍵，並以最長的那個註解作為排版的對齊。
 
 貢獻到 Joomla 專案下的程式碼，其版權將屬於 Joomla 專案，因此我們不允許其內包含 @author 標籤。您必須在 CREDITS.php 中更新您的貢獻記錄。Joomla 的哲學是：程式碼是被 "共同" 撰寫的，任何人都不能主張其擁有 Joomla 專案中的程式碼片段。然而，在核心 libraries 之中所使用的第三方 libraries 則允許使用 @author 標簽。
 
 第三方程式資源編碼必須要留下完整的註解檔說明，說明註解寫法必須與其他PHP文件相同。
 
-### 區塊註解
-區塊註解必須按照以下必填或非必填規則。
+### 區塊註解開頭
+文件區塊註解開頭必須按照以下必填或非必填規則。
 簡短說明 (非必填，除非該文件包含兩個以上的物件或函數，結尾處需要斷行)。
 詳細說明 (非必填，結尾處需要斷行)。
 
@@ -26,7 +26,7 @@
 * @see (非必填)
 * @since (通常是非必填，但當程式碼是持續性就是必填)
 
-區塊註解範例：
+區塊註解開頭範例：
 ```php
 /**
  * @package     Joomla.Installation

From ab151df3c6502c288efe70651018a6cf437fdbfd Mon Sep 17 00:00:00 2001
From: wayne <wayne@bm-sms.com.tw>
Date: Tue, 7 Oct 2014 20:45:34 +0800
Subject: [PATCH 26/33] revised 4th

---
 .../coding-standards/chapters/docblocks.md    | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/docblocks.md b/manual/zh-TW/coding-standards/chapters/docblocks.md
index c04725f4..86e140bd 100644
--- a/manual/zh-TW/coding-standards/chapters/docblocks.md
+++ b/manual/zh-TW/coding-standards/chapters/docblocks.md
@@ -1,6 +1,6 @@
 ## 區塊註解
 
-被使用在 PHP 程式碼中 (如：文件、類別、類別屬性、方法和函數) 的說明標頭被稱作區塊註解 (docblocks)，攥寫方式遵循類似 JavaDoc 或 phpDOC 所使用的慣例。
+被使用在 PHP 程式碼中 (如：文件、類別、類別屬性、方法和函數) 的說明標頭被稱作區塊註解 (docblocks)，撰寫方式遵循類似 JavaDoc 或 phpDOC 所使用的慣例。
 
 這些區塊註解是仿效 PEAR 的標準，但是針對 Joomla 和 Joomla projects 做了些許的變更。
 
@@ -16,15 +16,15 @@
 詳細說明 (非必填，結尾處需要斷行)。
 
 * @category (非必填，極少使用)
-* @package (通常是非必填，但當程式碼是持續性就是必填)
+* @package (通常是非必填，但當是流程用程式碼就是必填)
 * @subpackage (非必填)
-* @author (非必填但只被允許在非 Joomla 程式資源裡，像是第三方套件 Geshi)
+* @author (非必填但只被允許在非 Joomla 程式資源裡，像是 Geshi 之類的第三方套件)
 * @copyright (必填)
-* @license (必填，證照必須要可以跟 Joomla 相容)
+* @license (必填，需要是和 Joomla 授權相容)
 * @deprecated (非必填)
 * @link (非必填)
 * @see (非必填)
-* @since (通常是非必填，但當程式碼是持續性就是必填)
+* @since (通常是非必填，但當是流程用程式碼就是必填)
 
 區塊註解開頭範例：
 ```php
@@ -38,7 +38,7 @@
 ```
 
 ### 物件定義
-物件定義必須在新的行列而開結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循 OOP 的標準，並進行適當的宣告（選擇適合的 public, protected, private 和 static 使用)。
+物件定義必須在新的行列而開結束括號也放在新行列。物件方法必須遵循函數定義的準則。屬性和方法必須遵循 OOP 的標準，並進行適當的宣告 (選擇適合的 public, protected, private 和 static 使用)。
 物件定義，屬性和方法必須在提供在區塊註解並遵循以下條件。
 
 #### 物件區塊註解
@@ -47,7 +47,7 @@
 * @category (非必填，極少使用)
 * @package (必填)
 * @subpackage (非必填)
-* @author (非必填但只被允許在非 Joomla 程式資源裡，像是第三方套件 Geshi)
+* @author (非必填但只被允許在非 Joomla 程式資源裡，像是 Geshi 之類的第三方套件)
 * @copyright (非必填除非是不同的文件註解)
 * @license (非必填除非是不同的文件註解)
 * @deprecated (非必填)
@@ -68,11 +68,11 @@
 
 #### 物件屬性區塊註解：
 物件屬性區塊註解定義必須按照以下區塊註解條件規則。
-簡短說明（非必填，結尾處需要斷行）。
+簡短說明 (非必填，結尾處需要斷行)。
 
-* @var（必填，必須是屬性類型）
-* @deprecated（非必填）
-* @since（必填）
+* @var (必填，必須是屬性類型)
+* @deprecated (非必填)
+* @since (必填)
 
 物件屬性區塊註解的範例：
 ```php
@@ -90,10 +90,10 @@
 
 函數定義必須按照以下區塊註解條件規則。
 
-* 簡短說明（必填，結尾處需要斷行）
-* 詳細說明（非必填，結尾處需要斷行）
-* @param（必填，如果有方法或函數參數，最後 @param 標籤後面跟著一個斷行）
-* @return（必填，結尾處需要斷行）
+* 簡短說明 (必填，結尾處需要斷行)
+* 詳細說明 (非必填，結尾處需要斷行)
+* @param (必填，如果有方法或函數參數，最後 @param 標籤後面跟著一個斷行)
+* @return (必填，結尾處需要斷行)
 * 其他標籤須按字母排序，不管怎樣一定要有 @since
 
 函數註解範例：
@@ -115,10 +115,10 @@
 	public function setHttpMethodSuffix($method, $suffix)
 ```
 
-如果一個函數定義太多的行數，所有的行數都必須使用tab來做縮排而結束括號必須跟最後一個參數同一行。
+如果多行的函式定義，所有的行數都必須使用 tab 來做縮排而結束括號必須跟最後一個參數同一行。
 
 ```php
-function fooBar($param1, $param2, 
+function fooBar($param1, $param2,
     $param3, $param4) 
 { 
     // Body of method. 

From 414a1557d9535d295d99f72c8de887eda483d481 Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Mon, 13 Oct 2014 10:54:40 +0800
Subject: [PATCH 27/33] Fix php chapter

---
 manual/zh-TW/coding-standards/chapters/php.md | 41 +++++++++++++++----
 1 file changed, 34 insertions(+), 7 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/php.md b/manual/zh-TW/coding-standards/chapters/php.md
index eae76d4a..62ae1595 100644
--- a/manual/zh-TW/coding-standards/chapters/php.md
+++ b/manual/zh-TW/coding-standards/chapters/php.md
@@ -1,6 +1,6 @@
-## 語言結構
+# 語言結構
 
-### PHP 標籤
+## PHP 標籤
 
 永遠使用長標籤： `<?php ?>` 來包裹 PHP 程式碼，不使用短標籤 `<? ?>`。這可以確保您的程式碼可執行在大多數未經設定的主機環境。
 
@@ -8,7 +8,13 @@
 
 檔案結尾必須永遠由一個空行結束。
 
-### 引入程式
+## 一般
+
+依據 PSR-2 規範中的 [Keywords and True/False/Null](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md#25-keywords-and-truefalsenull) 所述：
+
+> PHP [關鍵字](http://php.net/manual/en/reserved.keywords.php) 「必須」是小寫. PHP 常數如 true, false, and null 也必須是小寫。
+
+## 引入程式
 
 當您想要無條件引入一個檔案時，應使用 `require_once`。當您要有條件的引入一個檔案（例如 factory 類別與其方法），則用 `include_once`。這兩者都可以確保檔案不被二次載入。兩種用法共享檔案清單，所以混用不會有任何問題。被 `require_once` 引入的檔案不會再被 `include_once` 引入一次。
 
@@ -21,7 +27,7 @@
 
 您不應該把檔案路徑用括號包起來。
 
-### 兼容 E_STRICT 的 PHP 程式
+## 兼容 E_STRICT 的 PHP 程式
 
 我們必須秉持並實踐 PHP 5.3 以上所支持的物件導向設計模式。Joomla! 一直致力於讓原始碼符合 E_STRICT 標準。
 
@@ -135,6 +141,25 @@ $ref1 = &$this->sql;
 >
 > 在 PHP 5 ，物件不再需要參照符號，所有物件皆是參照。
 
+## 字串連接的間距
+
+當使用字串連接時， `.` 符號的左右兩旁應該要有一格空白。例如：
+
+``` php
+$id = 1;
+echo JRoute('index.php?option=com_foo&task=foo.edit&id=' . (int) $id);
+```
+
+如果字串連接符在一行中的開頭或結尾時，兩者的間距都不是必要的。例如：
+
+``` php
+$id = 1
+echo JRoute::_(
+    'index.php?option=com_foo&task=foo.edit&id=' . (int) $id
+    . '&layout=special'
+);
+```
+
 ## 陣列
 
 陣列元素的指派可稍微排版，當多行時，可用 Tab 縮排。每行跟隨一個都逗號結尾，最後一行可包含逗號，這是 PHP 允許的寫法，對於程式碼 diff 比對時也有所幫助。
@@ -161,7 +186,9 @@ $options = array(
 //$code = broken($fixme);
 ```
 
-### 文件區塊註解
+更多行內註解的詳細內容請參見 [行內註解](coding-standards/chapters/inline-comments.md) 章節
+
+### 區塊註解
 
 在 PHP、Javascript、檔案中的所有類別、成員屬性、方法與函式，皆需要區塊註解，並遵循 JavaDoc 或 phpDoc 的約定。
 
@@ -395,7 +422,7 @@ class JFooHelper
 
 ### 邏輯例外 LogicException
 
-在 API 的使用方式上發生的明確問題會丟出 LogicException 的例外。例如：如果有個依賴參數失效時（你試圖操作一個未被載入的物件）。
+當 API 的使用並不正確時，丟出 LogicException 的例外。例如：當某個程式內的相依情況出現錯誤時（你試圖操作一個未被載入的物件）。
 
 下方的子類別也可被用於適當的情境下：
 
@@ -413,7 +440,7 @@ class JFooHelper
 
 #### DomainException
 
-該例外和 InvalidArgumentException 類似，但會在一數值未依附在一已定義的有效資料群集的情形下丟出該例外。例如：試圖載入一個"mongodb"的資料庫引擎，但該引擎尚未在 API 中實作。
+該例外和 `InvalidArgumentException` 類似，但會在一數值未依附在一已定義的有效資料群集的情形下丟出該例外。例如：試圖載入一個 mongodb 的資料庫引擎，但該引擎尚未在 API 中實作。
 
 #### LengthException
 

From 59359daddbb7a6d3d67b1538de95dcbbb5d0ffc8 Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Mon, 13 Oct 2014 11:29:04 +0800
Subject: [PATCH 28/33] Add Inline comment

---
 manual/zh-TW/_old/comments.md                 |  66 +++++------
 .../chapters/inline-comments.md               | 103 +++++++++---------
 2 files changed, 86 insertions(+), 83 deletions(-)

diff --git a/manual/zh-TW/_old/comments.md b/manual/zh-TW/_old/comments.md
index 4482e7ef..1b90a6cb 100644
--- a/manual/zh-TW/_old/comments.md
+++ b/manual/zh-TW/_old/comments.md
@@ -1,4 +1,4 @@
-## 註解
+## 行內註解
 
 此章節將告訴您在程式碼中寫入詳細的文字註解。而在程式碼中的註解文字並不能加以插入文件區塊。為該程式碼下註解的目的就是解釋該段的程式碼的運作跟用途。
 
@@ -10,37 +10,50 @@
 
 ## 註解的格式
 
-註解一個區塊的程式碼或是超過兩行者應該使用(c)風格的'/**/'，並應與同一空間/標籤規則文檔塊的每一行使用'*'。 如果你需要一個大的引進考慮這個塊是否應被分為一個方法來降低複雜性並因此提供了一個完整的文檔塊。
+註解一個區塊的程式碼或是超過兩行者應該使用(c)風格的'/**/'，並應與同一空間/標籤規則文檔塊的每一行使用'*'。 如果你需要一個大的引進考慮這個塊是否應被分為一個方法來降低複雜性並因此提供了一個完整的區塊註解。
 
 註解必需要處於一個優先的地位來解釋程式碼運作的方式。像是要做為一個參考或引用，註解的位置就應該不必跟程式碼置於同一行(與它們放在程式碼的後方做為一個引用)。它們必需跟自己同一行來放置。
 
 不要在每行的註解跟每行的程式碼之間插入空白行。(在註解的區塊中不要有空白行)
 
-應該是要用一個區塊的方式，也就是說程式碼一個區塊註解一個區塊，然後各個區塊間用一行空白行區隔。
+單行註解與多行註解之上永遠都要有一個空行，除非他們在一個程式區塊的開頭。(因為你不該在 `}` 之後出現空行)
 
-註解應該跟程式碼的縮排對齊以便優於參考，使用同縮排方式跟隨註解之後。
+例如這段程式，第一段註解之前沒有空行（因為在 `{` 之後），但第二段註解前我們就會希望要空一行。
 
-註解應該要用(tab)來縮排。(跟程式碼一樣，而不是與文件區塊同排)。
+``` php
+while (!$done)
+{
+	// We don't want an infinite loop here.
+	$done = true;
+}
+
+//Now let's do something interesting.
+$result = somethingInteresting();
+```
+
+註解應該跟其所參照的程式碼對齊，並使用相同的縮排方式。
+
+註解應該要用(tab)來縮排。(跟程式碼一樣，而不是與區塊註解一樣)。
 
 ## 註解的內容表達
 
 註解的語系必需要是en-GB (請參考下方範例)。
 
-必需要在//與開頭之間有空隔。
+必需要在 `//` 與開頭之間有空隔。
 
-下一個新行的註解必需大寫以開頭，除非這個新行是延續上一個註解的句子。然而，程式碼是有分大小寫的。
+下一個新行的註解必需大寫以開頭，除非這個新行是延續上一個註解的句子。當那段註解是程式碼且是大小寫敏感的時候則例外。
 
-程式碼所含了特別的相容性去保證其它軟體的正常運作(例如一個特定的瀏覽器或特定的內容管理軟體或需要向下相容往後版本的理由)而必需要特別標明。如果有個不明確的未來或由理要移除這一段程式碼，則讓它處於一個不會去用到的舊程式碼或暫時的去做一個版本的發佈。
+程式碼中包含了特別的部份去確保與其他軟體的相容性時（例如為了相容瀏覽器或 CMS 的舊版時），應該要刻意且清楚的描述它。如果有打算在未來的某時間點刪除這段程式碼，請標註它但不要使用棄用 (deprecation) 標籤或標註特定版本。
 
 在所有註解中檢查拼字跟語法。(請參考下方範例)。
 
 只使用一行來完整整個句子。
 
-而不是使用文件區塊，如果有適合下註解的方式可使用 See:、 Link: 和 Note: 這些標籤。
+See:、 link: 和 note: 這些標籤盡量用在區塊註解中而非一般註解。
 
-除此之外有特別的關係去解釋該內容，則不要使用 HTML 於解註中。
+除非有特別的需求，否則不要在註解中使用 HTML。
 
-不要留下註解過的程式碼，除非有明確解釋這樣做的理由，在這樣的情況下，註解說明“程式碼需要被註解”則將不會意外移除。
+不要留下被註解的程式碼，除非有明確解釋這樣做的理由，在這樣的情況下，使用註解說明「這段程式碼是刻意註解的」可以避免意外的被他人移除掉。
 
 註釋可能包括一些程式碼可能在未來會有延展性來修改程式碼，表示了這個程式碼是不完整的或是要用來準備有前瞻性的陳述，也是不一個待辦事項。
 
@@ -52,55 +65,46 @@
 
 ## 常見的拼寫和語法錯誤檢查。
 
-Joomla的貢獻者包括許多非母語的EN-GB，有時會有拼寫和語法錯誤，這使得它可以理解的。同時，有些人解讀評論也都是非母語，甚至可能使用自動翻譯理解的註釋。這使得它非常重要的意見應遵循正確的EN-GB的拼寫和語法規則。不幸的是，這可能會非常棘手。
+Joomla的貢獻者包括許多並非以 en-GB 為母語的人，有時會有拼寫和語法錯誤，這是可以理解的。 同時，有些人也是以非母語的概念去解讀註解內容，甚至可能使用自動翻譯去理解這些註解。因此遵循正確的 en-GB 的拼寫和語法規則是非常重要的。不幸的是，這可能會有點困難。
 
-維基百科提供在en-US和en-GB之間很常見的差異做了一個很好的詮釋。http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences 請留意有某些情況下EN-GB的常見用法（而不是實際的規則）略高於EN-AU不相同，使用EN-AU被認為是可以接受的。
+維基百科在 [en-US 與 en-GB 之間常見的不同點](http://www.wikiwand.com/en/American_and_British_English_spelling_differences) 這篇文章中提供了不錯的說明。請留意有某些情況下 en-GB 的常見用法（而不是實際的規則）與 en-AU 略有不同，此時使用 en-AU 是可以接受的。
 
-### S 跟 Z 的對決
+### S 與 Z
 
-EN-GB最常使用``ISE其中的en-US將使用`IZE`，比如`正常化，而不是'正常化'`。 （請注意，有一些例外情況和 en-GB 之間和 en-AU 共同使用一些差別。）
+EN-GB最常使用 `ise` ，而 en-US 較常使用 `ize` ，比如應使用 `normalise` 而不是 `normalize`。 （請注意，有一些例外情況和，且 en-GB 和 en-AU 之間的常見用法又有一些差別。）
 
 使用單引號是英文的棘手的部分之一。
 
 ### Lets 與 let’s
 
-Lets means permits or allows to:
-讓我們準許這樣做 :
+Lets 表示允許這樣做:
 
 ```php
 // This lets the user enter data
-// 這裡讓我們給使用者輸入一些資料
 ```
 
-Let’s is a contraction for let us and means we are going to do this now:
-讓`我們的縮短為我們和這樣的意思來做:
+Let’s 是 let us 的縮寫且代表我們正要開始進行這個動作:
 
 ```php
 // Let's validate the field
-// 讓`我們檢查這個欄位
 ```
 
-### Its versus it’s
-### 它是 和 它`是
+### Its 與 it’s
 
-Its is the possessive form of it:
-它是它的所有格形式
+Its 是 it 的所有格:
 
 ```php
 // Get its ID
-// 取得它的唉滴，俊郎....
 ```
 
-It’s is a contraction of it is
-它`是它的一個縮寫
+It’s 是 it is 的縮寫
 
 ```php
 // It's time to save
-// 它`是時候去解救了...俊郎郎郎
 ```
 
 ### 在 Joomla 下所拼寫一些常用的單詞。
 
--   依賴的
-
+- dependant (依賴)
+- deprecated (被棄用的)
 
diff --git a/manual/zh-TW/coding-standards/chapters/inline-comments.md b/manual/zh-TW/coding-standards/chapters/inline-comments.md
index 9bbecfb8..594036e9 100644
--- a/manual/zh-TW/coding-standards/chapters/inline-comments.md
+++ b/manual/zh-TW/coding-standards/chapters/inline-comments.md
@@ -1,110 +1,109 @@
-## Inline Code Comments
+## 行內註解
 
-This chapter covers inline code commenting in more detail. Inline comments are all comments not included in doc blocs. The goal of in line commenting is to explain code in context. Such explanation may take many different forms.
+此章節將告訴您在程式碼中寫入詳細的文字註解。而在程式碼中的註解文字並不能加以插入文件區塊。為該程式碼下註解的目的就是解釋該段的程式碼的運作跟用途。
 
-Comments that are written in a readable and narrative style, especially when explaining a complex process, are encouraged. In general they should be placed close to the code explained rather than before the entire block of code.
+註解能用可人為且易閱讀的方式去述敘該程式碼中複雜的運算，幫助瞭解程式碼之間的運作關係，下註解是值德鼓勵去實行的美德。
 
-Comments should be as sentence like as possible, which is to say that they should be complete and readable, not in short hand.
+註解盡可能的用一句話解釋完畢，應該是說，它們應該是有完整的思思並可以完全理解的，而不是只有太簡短而帶過。
 
-Comments are not a replacement for detailed doc blocks. Comments serve to explain the logic and structure of code itself rather than the use of code.
+註解是不能代替詳細的文檔區塊。它是用來說明代碼本身的羅輯結構，而不是去使用程式碼。
 
-### Formatting of Comments
+## 註解的格式
 
-Comment blocks that introduce large sections of code and are more than 2 lines long should use `/* */` (C) style and should use `*` on each line with the same space/tab rules as doc blocks. If you need a large introduction consider whether this block should be separated into a method to reduce complexity and therefore providing a full docblock.
+註解一個區塊的程式碼或是超過兩行者應該使用(c)風格的'/**/'，並應與同一空間/標籤規則文檔塊的每一行使用'*'。 如果你需要一個大的引進考慮這個塊是否應被分為一個方法來降低複雜性並因此提供了一個完整的區塊註解。
 
-Comments should precede the code they refer to. As a corollary, comments should not be on the same line as the code to which they refer (which puts them after the code they reference). They should be on their own lines.
+註解必需要處於一個優先的地位來解釋程式碼運作的方式。像是要做為一個參考或引用，註解的位置就應該不必跟程式碼置於同一行(與它們放在程式碼的後方做為一個引用)。它們必需跟自己同一行來放置。
 
-Don’t use a blank line between comments and the code they refer to (no space underneath a comment block).
+不要在每行的註解跟每行的程式碼之間插入空白行。(在註解的區塊中不要有空白行)
 
-Always have a single blank line before a comment or block of comments unless the comment (or block) is at the beginning of a code structure. ( You should not have a blank line after a '{' line )
+單行註解與多行註解之上永遠都要有一個空行，除非他們在一個程式區塊的開頭。(因為你不該在 `}` 之後出現空行)
 
-For example in the following case there is no new line before the first comment (because it follows a '{' line) but we do want a new line before the second comment:
+例如這段程式，第一段註解之前沒有空行（因為在 `{` 之後），但第二段註解前我們就會希望要空一行。
 
-```php
-  while (!$done)
-  {
-    // We don't want an infinite loop here.
-    $done = true;
-  }
-  
-  //Now let's do something interesting.
-  $result = somethingInteresting();
+``` php
+while (!$done)
+{
+	// We don't want an infinite loop here.
+	$done = true;
+}
+
+//Now let's do something interesting.
+$result = somethingInteresting();
 ```
 
-Comments should align with the code they refer to, using the same indenting as the line that follows the comment.
+註解應該跟其所參照的程式碼對齊，並使用相同的縮排方式。
 
-Comments should be indented with tabs (like code, not like doc blocks).
+註解應該要用(tab)來縮排。(跟程式碼一樣，而不是與區塊註解一樣)。
 
-### Content of comments
+## 註解的內容表達
 
-Comments should use en-GB (See below).
+註解的語系必需要是en-GB (請參考下方範例)。
 
-Always have a space between // and the start of comment text.
+必需要在 `//` 與開頭之間有空隔。
 
-New lines should always start with an upper case letter unless The line is a continuation of a complete sentence The term is code and is case sensitive.
+下一個新行的註解必需大寫以開頭，除非這個新行是延續上一個註解的句子。當那段註解是程式碼且是大小寫敏感的時候則例外。
 
-Code that is included specifically to assure compatibility with other software (for example specific browsers or a specific version of the CMS or for backward compatibility reasons) should be clearly marked as such. If there is the intention to remove specific code at a future point, state that but do not use a deprecation tag or specify a release (this can be hard to predict).
+程式碼中包含了特別的部份去確保與其他軟體的相容性時（例如為了相容瀏覽器或 CMS 的舊版時），應該要刻意且清楚的描述它。如果有打算在未來的某時間點刪除這段程式碼，請標註它但不要使用棄用 (deprecation) 標籤或標註特定版本。
 
-Check spelling and grammar on all comments (see below).
+在所有註解中檢查拼字跟語法。(請參考下方範例)。
 
-Only end a line with a period if it is a full sentence.
+只使用一行來完整整個句子。
 
-Rather than use docblock tags use See:, Link: and Note: for comments if appropriate.
+See:、 link: 和 note: 這些標籤盡量用在區塊註解中而非一般註解。
 
-Do not use HTML in comments unless specifically related to the comment content.
+除非有特別的需求，否則不要在註解中使用 HTML。
 
-Do not leave commented code unless there is a clearly explained reason for doing so. In such a case, a comment saying "Code intentionally commented" will prevent accidental removal.
+不要留下被註解的程式碼，除非有明確解釋這樣做的理由，在這樣的情況下，使用註解說明「這段程式碼是刻意註解的」可以避免意外的被他人移除掉。
 
-Comments may include forward looking statements of how something will be extended or modified in the future, but not todos indicating that code is not complete or ready to use.
+註釋可能包括一些程式碼可能在未來會有延展性來修改程式碼，表示了這個程式碼是不完整的或是要用來準備有前瞻性的陳述，也是不一個待辦事項。
 
-Remember that humor and sarcasm are difficult to translate.
+請記住幽默和諷剌是很難翻譯。
 
-### Acronyms
+## 縮寫字
 
-Capitalise all letters of acronyms such as HTML, XML, SQL, GMT, and UTC. This is an exception to the general use of en-GB rules.
+大寫首字母縮寫詞，如HTML，XML，SQL，GMT和UTC的所有字母。這些都是例外，一般使用EN-GB的規則。
 
-### Common spelling and grammar errors for which to check.
+## 常見的拼寫和語法錯誤檢查。
 
-Joomla contributors include many non-native speakers of en-GB which makes it understandable that there are sometimes spelling and grammar errors. At the same time, some people reading comments also are non native speakers and may even use automated translation to understand comments. This makes it very important that comments should follow proper en-GB spelling and grammar rules. Unfortunately, these can be tricky.
+Joomla的貢獻者包括許多並非以 en-GB 為母語的人，有時會有拼寫和語法錯誤，這是可以理解的。 同時，有些人也是以非母語的概念去解讀註解內容，甚至可能使用自動翻譯去理解這些註解。因此遵循正確的 en-GB 的拼寫和語法規則是非常重要的。不幸的是，這可能會有點困難。
 
-Wikipedia provides a good summary of [common differences between en-US and en-GB](http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences). Note that there are some instances where en-GB common usage (but not actual rules) varies slightly from en-AU and using en-AU is considered acceptable.
+維基百科在 [en-US 與 en-GB 之間常見的不同點](http://www.wikiwand.com/en/American_and_British_English_spelling_differences) 這篇文章中提供了不錯的說明。請留意有某些情況下 en-GB 的常見用法（而不是實際的規則）與 en-AU 略有不同，此時使用 en-AU 是可以接受的。
 
-#### S vs Z
+### S 與 Z
 
-en-GB most commonly uses `ise` where en-US would use `ize`, such as `normalise` instead of `normalize`. (Note that there are some exceptions to this rule and some differences between en-GB and en-AU in common usage.)
+EN-GB最常使用 `ise` ，而 en-US 較常使用 `ize` ，比如應使用 `normalise` 而不是 `normalize`。 （請注意，有一些例外情況和，且 en-GB 和 en-AU 之間的常見用法又有一些差別。）
 
-Use of apostrophes is one of the trickier parts of English.
+使用單引號是英文的棘手的部分之一。
 
-#### Lets versus let’s
+### Lets 與 let’s
 
-Lets means permits or allows to:
+Lets 表示允許這樣做:
 
 ```php
 // This lets the user enter data
 ```
 
-Let’s is a contraction for let us and means we are going to do this now:
+Let’s 是 let us 的縮寫且代表我們正要開始進行這個動作:
 
 ```php
 // Let's validate the field
 ```
 
-#### Its versus it’s
+### Its 與 it’s
 
-Its is the possessive form of it:
+Its 是 it 的所有格:
 
 ```php
 // Get its ID
 ```
 
-It’s is a contraction of it is
+It’s 是 it is 的縮寫
 
 ```php
 // It's time to save
 ```
 
-#### The correct Joomla spelling of some commonly used words.
-
--   dependant
--	deprecated
+### 在 Joomla 下所拼寫一些常用的單詞。
 
+- dependant (依賴)
+- deprecated (被棄用的)

From 212fe9ac9a324e4839cc8062a9d48cda1f80adbd Mon Sep 17 00:00:00 2001
From: Simon Asika <asika32764@gmail.com>
Date: Mon, 13 Oct 2014 12:39:45 +0800
Subject: [PATCH 29/33] Update inline-comments.md

---
 manual/zh-TW/coding-standards/chapters/inline-comments.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/manual/zh-TW/coding-standards/chapters/inline-comments.md b/manual/zh-TW/coding-standards/chapters/inline-comments.md
index 594036e9..c2051744 100644
--- a/manual/zh-TW/coding-standards/chapters/inline-comments.md
+++ b/manual/zh-TW/coding-standards/chapters/inline-comments.md
@@ -2,7 +2,7 @@
 
 此章節將告訴您在程式碼中寫入詳細的文字註解。而在程式碼中的註解文字並不能加以插入文件區塊。為該程式碼下註解的目的就是解釋該段的程式碼的運作跟用途。
 
-註解能用可人為且易閱讀的方式去述敘該程式碼中複雜的運算，幫助瞭解程式碼之間的運作關係，下註解是值德鼓勵去實行的美德。
+我們鼓勵註解用易於閱讀和敘事的風格撰寫，尤其是在解釋一個複雜流程的時候。一般來說註解應該置於要被解釋的程式碼附近，而非在一整個程式區塊前面。
 
 註解盡可能的用一句話解釋完畢，應該是說，它們應該是有完整的思思並可以完全理解的，而不是只有太簡短而帶過。
 

From 10b46423b2abc8808d601583d0022a3d53245280 Mon Sep 17 00:00:00 2001
From: michael520 <michael@bm-sms.com.tw>
Date: Mon, 27 Oct 2014 15:33:53 +0800
Subject: [PATCH 30/33] Quality fix.

---
 .../chapters/inline-comments.md               | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/manual/zh-TW/coding-standards/chapters/inline-comments.md b/manual/zh-TW/coding-standards/chapters/inline-comments.md
index c2051744..97763a8b 100644
--- a/manual/zh-TW/coding-standards/chapters/inline-comments.md
+++ b/manual/zh-TW/coding-standards/chapters/inline-comments.md
@@ -1,33 +1,33 @@
 ## 行內註解
 
-此章節將告訴您在程式碼中寫入詳細的文字註解。而在程式碼中的註解文字並不能加以插入文件區塊。為該程式碼下註解的目的就是解釋該段的程式碼的運作跟用途。
+此章節涵蓋更詳細的行內註解方式。行內註解指的是那些除了註解區塊之外的註解。行內註解的目的是以有脈絡的方式來解釋程式內容，這樣的解釋內容可能有各種不同的形式。
 
 我們鼓勵註解用易於閱讀和敘事的風格撰寫，尤其是在解釋一個複雜流程的時候。一般來說註解應該置於要被解釋的程式碼附近，而非在一整個程式區塊前面。
 
 註解盡可能的用一句話解釋完畢，應該是說，它們應該是有完整的思思並可以完全理解的，而不是只有太簡短而帶過。
 
-註解是不能代替詳細的文檔區塊。它是用來說明代碼本身的羅輯結構，而不是去使用程式碼。
+註解是不能代替詳細的區塊註解。它是用來說明代碼本身的邏輯與結構，而不是去使用程式碼。
 
-## 註解的格式
+### 註解格式
 
-註解一個區塊的程式碼或是超過兩行者應該使用(c)風格的'/**/'，並應與同一空間/標籤規則文檔塊的每一行使用'*'。 如果你需要一個大的引進考慮這個塊是否應被分為一個方法來降低複雜性並因此提供了一個完整的區塊註解。
+註解區塊要講解一個大程式區塊而且有超過兩行以上的註解時，需要使用 `/* */` 的註解方式，而且每一行使用 `*` 以及與區塊註解一樣的空白 / tab 鍵規則。如果你需要大篇福的講解，可以考慮將該程式區塊拆解成一個 method 來降低複雜度，更可因此提供一個完整的區塊註解。
 
-註解必需要處於一個優先的地位來解釋程式碼運作的方式。像是要做為一個參考或引用，註解的位置就應該不必跟程式碼置於同一行(與它們放在程式碼的後方做為一個引用)。它們必需跟自己同一行來放置。
+註解必需放在相關程式碼之前，依此推論，註解不該與相關程式碼放在同一行上 (把註解放在程式碼之後)，它們需各自在自己的行數上。
 
-不要在每行的註解跟每行的程式碼之間插入空白行。(在註解的區塊中不要有空白行)
+不要在註解與相關的程式碼之間留下空行 (沒有空白字元在註解的下面)。
 
-單行註解與多行註解之上永遠都要有一個空行，除非他們在一個程式區塊的開頭。(因為你不該在 `}` 之後出現空行)
+單行註解或多行註解之前一定要有一個空行，除非他們在一個程式區塊的開頭 (你不該在 `}` 之後出現空行)。
 
-例如這段程式，第一段註解之前沒有空行（因為在 `{` 之後），但第二段註解前我們就會希望要空一行。
+例如這段程式，第一段註解之前沒有空行 (因為在 `{` 之後)，但第二段註解前我們是真的需要換行。
 
-``` php
+```php
 while (!$done)
 {
 	// We don't want an infinite loop here.
 	$done = true;
 }
 
-//Now let's do something interesting.
+// Now let's do something interesting.
 $result = somethingInteresting();
 ```
 
@@ -35,21 +35,21 @@ $result = somethingInteresting();
 
 註解應該要用(tab)來縮排。(跟程式碼一樣，而不是與區塊註解一樣)。
 
-## 註解的內容表達
+### 註解內文 
 
 註解的語系必需要是en-GB (請參考下方範例)。
 
-必需要在 `//` 與開頭之間有空隔。
+在 `//` 與註解文字之間一定要有一個空白。
 
-下一個新行的註解必需大寫以開頭，除非這個新行是延續上一個註解的句子。當那段註解是程式碼且是大小寫敏感的時候則例外。
+每行註解需要以大寫字母開頭，除非該行是接續著一個完整的句子，或是文字為程式碼而且是需要注意大小寫的。
 
-程式碼中包含了特別的部份去確保與其他軟體的相容性時（例如為了相容瀏覽器或 CMS 的舊版時），應該要刻意且清楚的描述它。如果有打算在未來的某時間點刪除這段程式碼，請標註它但不要使用棄用 (deprecation) 標籤或標註特定版本。
+某段程式碼為確保與其他軟體的相容性時 (例如為了相容瀏覽器或特定版本的 CMS 時)，應該要清楚地描述它。如果預計在未來的某時間點刪除某段程式碼，請標註它但不要使用 「棄用 (deprecation)」 標籤或標註特定版本 (版本較難以預知)。
 
 在所有註解中檢查拼字跟語法。(請參考下方範例)。
 
-只使用一行來完整整個句子。
+只在完整的句子使用句點做結尾。
 
-See:、 link: 和 note: 這些標籤盡量用在區塊註解中而非一般註解。
+與其使用區塊註解的標籤，適當地在註解中使用 See:、Link: 和 Note: 。
 
 除非有特別的需求，否則不要在註解中使用 HTML。
 
@@ -59,23 +59,23 @@ See:、 link: 和 note: 這些標籤盡量用在區塊註解中而非一般註
 
 請記住幽默和諷剌是很難翻譯。
 
-## 縮寫字
+### 縮寫字
 
-大寫首字母縮寫詞，如HTML，XML，SQL，GMT和UTC的所有字母。這些都是例外，一般使用EN-GB的規則。
+縮寫字所有的字母都要大寫，像是 HTML，XML，SQL，GMT 和 UTC 等。而像 en-GB 的規則是一種例外。
 
-## 常見的拼寫和語法錯誤檢查。
+### 常見的拼寫和語法錯誤檢查。
 
-Joomla的貢獻者包括許多並非以 en-GB 為母語的人，有時會有拼寫和語法錯誤，這是可以理解的。 同時，有些人也是以非母語的概念去解讀註解內容，甚至可能使用自動翻譯去理解這些註解。因此遵循正確的 en-GB 的拼寫和語法規則是非常重要的。不幸的是，這可能會有點困難。
+Joomla的貢獻者包括許多並非以 en-GB 為母語的人，有時會有拼寫和語法錯誤，這是可以理解的。 同時，有些人也是以非母語的概念去解讀註解內容，甚至可能使用翻譯機去理解這些註解。因此遵循正確的 en-GB 的拼寫和語法規則是非常重要的。不幸的是，這可能會有點困難。
 
-維基百科在 [en-US 與 en-GB 之間常見的不同點](http://www.wikiwand.com/en/American_and_British_English_spelling_differences) 這篇文章中提供了不錯的說明。請留意有某些情況下 en-GB 的常見用法（而不是實際的規則）與 en-AU 略有不同，此時使用 en-AU 是可以接受的。
+維基百科在 [en-US 與 en-GB 之間常見的不同點](http://www.wikiwand.com/en/American_and_British_English_spelling_differences) 這篇文章中提供了不錯的說明。請留意有某些情況下 en-GB 的常見用法 (而不是實際的規則) 與 en-AU 略有不同，此時使用 en-AU 是可以接受的。
 
-### S 與 Z
+#### S 與 Z
 
-EN-GB最常使用 `ise` ，而 en-US 較常使用 `ize` ，比如應使用 `normalise` 而不是 `normalize`。 （請注意，有一些例外情況和，且 en-GB 和 en-AU 之間的常見用法又有一些差別。）
+EN-GB最常使用 `ise` ，而 en-US 較常使用 `ize` ，比如應使用 `normalise` 而不是 `normalize`。 (請注意，有一些例外情況而且 en-GB 和 en-AU 之間的常見用法又有一些差別。)
 
-使用單引號是英文的棘手的部分之一。
+使用單引號是英文較棘手的部分之一。
 
-### Lets 與 let’s
+#### Lets 與 let’s
 
 Lets 表示允許這樣做:
 
@@ -103,7 +103,7 @@ It’s 是 it is 的縮寫
 // It's time to save
 ```
 
-### 在 Joomla 下所拼寫一些常用的單詞。
+#### 在 Joomla 中常用單詞的正確寫法。
 
 - dependant (依賴)
 - deprecated (被棄用的)

From 0239e86206fa02915673f98c89979cb5d310351d Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Tue, 28 Oct 2014 12:14:01 +0800
Subject: [PATCH 31/33] After language menu selected. populate menu

---
 assets/js/manual.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/assets/js/manual.js b/assets/js/manual.js
index f09cadf2..23e9da54 100644
--- a/assets/js/manual.js
+++ b/assets/js/manual.js
@@ -94,6 +94,7 @@
 
         document.id('language-item').addEvent('click:relay(a)', function (event, target) {
             locale = target.get('href');
+            populateMenu();
             populateWindow(currentDoc);
             event.preventDefault();
 
@@ -105,6 +106,7 @@
         document.id('main').addEvent('click:relay(a)', function (event, target) {
             if (target.get('href').substring(0, 4) != 'http' && target.get('href').substring(0, 1) != '#')
             {
+                populateMenu();
                 populateWindow(target.get('href'));
                 event.preventDefault();
                 history.pushState(state, target.get('href'), "?" + target.get('href'));

From 3d44a04ea43154dca3be8bd5fd35ed9c63ff8b96 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Tue, 28 Oct 2014 16:23:49 +0800
Subject: [PATCH 32/33] Use language.md to track multi-lang.

---
 assets/js/manual.js      | 19 ++++++++++++++++++-
 index.html               |  4 +---
 manual/en-US/language.md |  2 ++
 manual/language.md       |  2 ++
 4 files changed, 23 insertions(+), 4 deletions(-)
 create mode 100644 manual/en-US/language.md
 create mode 100644 manual/language.md

diff --git a/assets/js/manual.js b/assets/js/manual.js
index 23e9da54..616c148b 100644
--- a/assets/js/manual.js
+++ b/assets/js/manual.js
@@ -53,6 +53,22 @@
         }).send();
     }
 
+    var populateLanguage = function() {
+        var markdownRequest = new Request({
+            "url": here + 'manual/' + locale + '/language.md',
+            "method": "get",
+            "onSuccess": function (response) {
+                var parser = new DOMParser(),
+                    list = parser.parseFromString(marked(response), 'text/xml');
+
+                $$(list.getElementsByTagName('li')).each(
+                    function(item) {
+                        $('language-items').grab(item);
+                    });
+            }
+        }).send();
+    }
+
     var populateVersion = function() {
         var versionRequest = new Request({
             "url": here + 'manual/' + locale + '/version.md',
@@ -89,10 +105,11 @@
             }
         })
         populateMenu();
+        populateLanguage();
         populateWindow(currentDoc);
         populateVersion();
 
-        document.id('language-item').addEvent('click:relay(a)', function (event, target) {
+        document.id('language-items').addEvent('click:relay(a)', function (event, target) {
             locale = target.get('href');
             populateMenu();
             populateWindow(currentDoc);
diff --git a/index.html b/index.html
index 3467e804..9f84e19d 100644
--- a/index.html
+++ b/index.html
@@ -41,9 +41,7 @@
                 <span id="language-select">English</span>
                 <b class="caret"></b>
               </a>
-              <ul id="language-item" class="dropdown-menu">
-                <li><a href="en-US">English</a></li>
-                <li><a href="zh-TW">中文 (繁體)</a></li>
+              <ul id="language-items" class="dropdown-menu">
               </ul>
             </li>
           </ul>
diff --git a/manual/en-US/language.md b/manual/en-US/language.md
new file mode 100644
index 00000000..1a96d5e3
--- /dev/null
+++ b/manual/en-US/language.md
@@ -0,0 +1,2 @@
+- [English](en-US)
+- [中文 (繁體)](zh-TW)
\ No newline at end of file
diff --git a/manual/language.md b/manual/language.md
new file mode 100644
index 00000000..1a96d5e3
--- /dev/null
+++ b/manual/language.md
@@ -0,0 +1,2 @@
+- [English](en-US)
+- [中文 (繁體)](zh-TW)
\ No newline at end of file

From 4db3a4b482779895e79eb765c4d49be8fac96513 Mon Sep 17 00:00:00 2001
From: bblurock <llwbenson@gmail.com>
Date: Mon, 3 Nov 2014 23:03:14 +0800
Subject: [PATCH 33/33] Removed outdated zh-TW translation.

---
 manual/zh-TW/_old/README.md           |  28 --
 manual/zh-TW/_old/basic-guidelines.md |  33 --
 manual/zh-TW/_old/comments.md         | 110 ------
 manual/zh-TW/_old/php.md              | 477 --------------------------
 manual/zh-TW/_old/preface.md          |   8 -
 5 files changed, 656 deletions(-)
 delete mode 100644 manual/zh-TW/_old/README.md
 delete mode 100644 manual/zh-TW/_old/basic-guidelines.md
 delete mode 100644 manual/zh-TW/_old/comments.md
 delete mode 100644 manual/zh-TW/_old/php.md
 delete mode 100644 manual/zh-TW/_old/preface.md

diff --git a/manual/zh-TW/_old/README.md b/manual/zh-TW/_old/README.md
deleted file mode 100644
index 6154079b..00000000
--- a/manual/zh-TW/_old/README.md
+++ /dev/null
@@ -1,28 +0,0 @@
-Joomla 編碼標準中文版
-=============================
-
-The Joomla coding standard Chinese version.
-
-1. [前言 - Preface](preface.md) (完成)
-2. [基礎導覽 - Basic Guidelines](basic-guidelines.md) (完成)
-3. [註解 - Comments](comments.md) (未完成)
-4. [編碼標準 - PHP](php.md) (完成)
-
------
-
-讓一個軟體變得更好的因素，並不只在於其提供了多少優異的功能，而在於他的原始碼品質有多優良。為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。
-
-可讀性高的代碼也是易於維護的，且能夠指引我們實現依賴深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案的目標。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座能安全指引開發者編寫漂亮、乾淨代碼的燈塔，以避開懶惰所造成的陷阱。
-
-Joomla 的編碼標準大量的借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
-
------
-
-## 貢獻者
-
-* Asika - @asika32764
-* Michael - @michael520
-* Tim - @skylying
-* Leo - @gourrymk2
-* Lewis - @AEdesWeb
-* Benson - @bblurock 
diff --git a/manual/zh-TW/_old/basic-guidelines.md b/manual/zh-TW/_old/basic-guidelines.md
deleted file mode 100644
index 90852462..00000000
--- a/manual/zh-TW/_old/basic-guidelines.md
+++ /dev/null
@@ -1,33 +0,0 @@
-## 基礎大綱
-
-本章節旨在說明基礎的檔案規則
-
-## 檔案格式
-
-所有針對 Joomla 開發的檔案格式都必須存為 ASCII text、使用 UTF-8 編碼字型並且經過 Unix 格式化。以行為單位的程式碼必須使用換行字元(LF)作為結尾。換行字元的表示法為：10(序數)、012(八進位)、0A(十六進位)。不要使用純CR回車符(例如蘋果電腦)或是CRLF組合(例如windows電腦)。
-
-## 拼字
-
-所有使用在程式碼註解、類別、函式、變數、常數的命名原則都必須根據英式英文(en_GB)原則。但有些例外是可允許的，例如某些已內建在 PHP API 中常見的程式用語，或其他慣例用語如 "color" 這樣已制定的用法便可沿用美式英文
-
-## 縮排
-
-縮排一律使用 Tab 鈕(根據國際 PEAR 準則)。編碼時使用的 IDE 如 Eclipse 需設定 Tab 為4個空白字元長度。
-
-## 行寬
-
-原則上每行程式碼並沒有最大長度限制，但根據國際標準值，150字元能夠在不需要水平滾動的狀況下達到最好的可讀性。若遇到換行會影響輸出結果的情況(例如 PHP/HTML 混合的結構檔案)，更長的程式碼也是被允許的。
-
-## 優良範例
-
-以下提供一些外部資源，讓大家可以參考這些資源以及相關寫法：
-
-* [Joomla 開發者網路](http://developer.joomla.org/) - 所有開發相關資源都可由此尋找
-* [Joomla 開發教學文件](http://docs.joomla.org/Developers) - 官方完整的開發教學 Wiki
-* [PEAR 編碼標準](http://pear.php.net/manual/en/standards.php)
-* [Allman 縮排風格 (Wiki)](http://en.wikipedia.org/wiki/Indent_style#Allman_style)
-* [Joomla Coding Standards Github](https://github.com/joomla/coding-standards) - 儲存 PHP Codesniffer 設定檔等等
-* [Joomla CodeSniffer](http://docs.joomla.org/Joomla_CodeSniffer) - Joomla 開發過程與 IDE 的整合
-* [Secure coding guidelines](http://docs.joomla.org/Secure_coding_guidelines) - 安全性編碼導覽
-
-本清單將隨時補充~~~
diff --git a/manual/zh-TW/_old/comments.md b/manual/zh-TW/_old/comments.md
deleted file mode 100644
index 1b90a6cb..00000000
--- a/manual/zh-TW/_old/comments.md
+++ /dev/null
@@ -1,110 +0,0 @@
-## 行內註解
-
-此章節將告訴您在程式碼中寫入詳細的文字註解。而在程式碼中的註解文字並不能加以插入文件區塊。為該程式碼下註解的目的就是解釋該段的程式碼的運作跟用途。
-
-註解能用可人為且易閱讀的方式去述敘該程式碼中複雜的運算，幫助瞭解程式碼之間的運作關係，下註解是值德鼓勵去實行的美德。
-
-註解盡可能的用一句話解釋完畢，應該是說，它們應該是有完整的思思並可以完全理解的，而不是只有太簡短而帶過。
-
-註解是不能代替詳細的文檔區塊。它是用來說明代碼本身的羅輯結構，而不是去使用程式碼。
-
-## 註解的格式
-
-註解一個區塊的程式碼或是超過兩行者應該使用(c)風格的'/**/'，並應與同一空間/標籤規則文檔塊的每一行使用'*'。 如果你需要一個大的引進考慮這個塊是否應被分為一個方法來降低複雜性並因此提供了一個完整的區塊註解。
-
-註解必需要處於一個優先的地位來解釋程式碼運作的方式。像是要做為一個參考或引用，註解的位置就應該不必跟程式碼置於同一行(與它們放在程式碼的後方做為一個引用)。它們必需跟自己同一行來放置。
-
-不要在每行的註解跟每行的程式碼之間插入空白行。(在註解的區塊中不要有空白行)
-
-單行註解與多行註解之上永遠都要有一個空行，除非他們在一個程式區塊的開頭。(因為你不該在 `}` 之後出現空行)
-
-例如這段程式，第一段註解之前沒有空行（因為在 `{` 之後），但第二段註解前我們就會希望要空一行。
-
-``` php
-while (!$done)
-{
-	// We don't want an infinite loop here.
-	$done = true;
-}
-
-//Now let's do something interesting.
-$result = somethingInteresting();
-```
-
-註解應該跟其所參照的程式碼對齊，並使用相同的縮排方式。
-
-註解應該要用(tab)來縮排。(跟程式碼一樣，而不是與區塊註解一樣)。
-
-## 註解的內容表達
-
-註解的語系必需要是en-GB (請參考下方範例)。
-
-必需要在 `//` 與開頭之間有空隔。
-
-下一個新行的註解必需大寫以開頭，除非這個新行是延續上一個註解的句子。當那段註解是程式碼且是大小寫敏感的時候則例外。
-
-程式碼中包含了特別的部份去確保與其他軟體的相容性時（例如為了相容瀏覽器或 CMS 的舊版時），應該要刻意且清楚的描述它。如果有打算在未來的某時間點刪除這段程式碼，請標註它但不要使用棄用 (deprecation) 標籤或標註特定版本。
-
-在所有註解中檢查拼字跟語法。(請參考下方範例)。
-
-只使用一行來完整整個句子。
-
-See:、 link: 和 note: 這些標籤盡量用在區塊註解中而非一般註解。
-
-除非有特別的需求，否則不要在註解中使用 HTML。
-
-不要留下被註解的程式碼，除非有明確解釋這樣做的理由，在這樣的情況下，使用註解說明「這段程式碼是刻意註解的」可以避免意外的被他人移除掉。
-
-註釋可能包括一些程式碼可能在未來會有延展性來修改程式碼，表示了這個程式碼是不完整的或是要用來準備有前瞻性的陳述，也是不一個待辦事項。
-
-請記住幽默和諷剌是很難翻譯。
-
-## 縮寫字
-
-大寫首字母縮寫詞，如HTML，XML，SQL，GMT和UTC的所有字母。這些都是例外，一般使用EN-GB的規則。
-
-## 常見的拼寫和語法錯誤檢查。
-
-Joomla的貢獻者包括許多並非以 en-GB 為母語的人，有時會有拼寫和語法錯誤，這是可以理解的。 同時，有些人也是以非母語的概念去解讀註解內容，甚至可能使用自動翻譯去理解這些註解。因此遵循正確的 en-GB 的拼寫和語法規則是非常重要的。不幸的是，這可能會有點困難。
-
-維基百科在 [en-US 與 en-GB 之間常見的不同點](http://www.wikiwand.com/en/American_and_British_English_spelling_differences) 這篇文章中提供了不錯的說明。請留意有某些情況下 en-GB 的常見用法（而不是實際的規則）與 en-AU 略有不同，此時使用 en-AU 是可以接受的。
-
-### S 與 Z
-
-EN-GB最常使用 `ise` ，而 en-US 較常使用 `ize` ，比如應使用 `normalise` 而不是 `normalize`。 （請注意，有一些例外情況和，且 en-GB 和 en-AU 之間的常見用法又有一些差別。）
-
-使用單引號是英文的棘手的部分之一。
-
-### Lets 與 let’s
-
-Lets 表示允許這樣做:
-
-```php
-// This lets the user enter data
-```
-
-Let’s 是 let us 的縮寫且代表我們正要開始進行這個動作:
-
-```php
-// Let's validate the field
-```
-
-### Its 與 it’s
-
-Its 是 it 的所有格:
-
-```php
-// Get its ID
-```
-
-It’s 是 it is 的縮寫
-
-```php
-// It's time to save
-```
-
-### 在 Joomla 下所拼寫一些常用的單詞。
-
-- dependant (依賴)
-- deprecated (被棄用的)
-
diff --git a/manual/zh-TW/_old/php.md b/manual/zh-TW/_old/php.md
deleted file mode 100644
index eae76d4a..00000000
--- a/manual/zh-TW/_old/php.md
+++ /dev/null
@@ -1,477 +0,0 @@
-## 語言結構
-
-### PHP 標籤
-
-永遠使用長標籤： `<?php ?>` 來包裹 PHP 程式碼，不使用短標籤 `<? ?>`。這可以確保您的程式碼可執行在大多數未經設定的主機環境。
-
-如果檔案中只包含PHP程式碼，則不應該包含結尾標籤 `?>`。這個標籤在 PHP 中不是必要的。這樣子可以避免在系統輸出前，不小心讓任何空白預先送出 header ，這會造成 Joomla 的 Session 功能錯誤 (參見 PHP 手冊的說明 [Instruction separation](http://php.net/basic-syntax.instruction-separation))。
-
-檔案結尾必須永遠由一個空行結束。
-
-### 引入程式
-
-當您想要無條件引入一個檔案時，應使用 `require_once`。當您要有條件的引入一個檔案（例如 factory 類別與其方法），則用 `include_once`。這兩者都可以確保檔案不被二次載入。兩種用法共享檔案清單，所以混用不會有任何問題。被 `require_once` 引入的檔案不會再被 `include_once` 引入一次。
-
-> **注意**
->
-> `include_once` 與 `require_once` 是 PHP 關鍵字，不是函式，寫法應該如下:
->
->
-> `require_once JPATH_COMPONENT . ’/helpers/helper.php’;`
-
-您不應該把檔案路徑用括號包起來。
-
-### 兼容 E_STRICT 的 PHP 程式
-
-我們必須秉持並實踐 PHP 5.3 以上所支持的物件導向設計模式。Joomla! 一直致力於讓原始碼符合 E_STRICT 標準。
-
-## 全域變數
-
-盡量減少使用全域變數或超全域變數，用物件導向或工廠(Factory)模式替代之。
-
-## 控制結構
-
-所有的控制結構必須在關鍵字與起始括號之間放置一個空白字元，而開頭、結尾括號與邏輯判斷式之間無空格。這是為了區隔控制結構與函式以方便辨認，而括號內必須要包含邏輯。
-
-所有的控制結構關鍵字，如： `if`, `else`, `do`, `for`, `foreach`, `try`, `catch`, `switch` 與 `while` 皆採 [Allman](http://en.wikipedia.org/wiki/Indent_style#Allman_style) 風格，關鍵字本身必須在一個新行，而語言區塊（大括號）的開頭與結束也接需再一個新行中。
-
-### _if-else_ 範例
-
-```php
-if ($test)
-{
-	echo 'True';
-}
-
-// 註解可寫在此
-// 要注意的是 "elseif" 採用單一單字而非拆開成 "else if"
-
-elseif ($test === false)
-{
-	echo 'Really false';
-}
-else
-{
-	echo 'A white lie';
-}
-```
-
-如果控制結構的判斷式需要多行，則第二行開始需要一個 Tab 縮排，結尾括號需要再同一行上。
-
-```php
-if ($test1
-	&& $test2)
-{
-	echo 'True';
-}
-```
-
-### _do-while_ 範例
-
-
-```php
-do
-{
-	$i++;
-}
-while ($i < 10);
-```
-
-### _for_ 範例
-
-```php
-for ($i = 0; $i < $n; $i++)
-{
-	echo 'Increment = ' . $i;
-}
-```
-
-### _foreach_ 範例
-
-```php
-foreach ($rows as $index => $row)
-{
-	echo 'Index = ' . $id . ', Value = ' . $row;
-}
-```
-
-### _while_ 範例
-
-```php
-while (!$done)
-{
-	$done = true;
-}
-```
-
-### _switch_ 範例
-
-當使用 `switch` 時， `case` 關鍵字必須縮排一次，而 `break` 關鍵字必須獨立在新的一行，且相較於 `case` 再縮排一次。
-
-```php
-switch ($value)
-{
-	case 'a':
-		echo 'A';
-		break;
-
-	default:
-		echo 'I give up';
-		break;
-}
-```
-
-## 參照
-
-當使用變數參照時，參照符號應該距離等號一個空白字元，且跟後面的變數緊鄰，沒有空白。
-
-範例:
-
-```php
-$ref1 = &$this->sql;
-```
-
-> **注意**
->
-> 在 PHP 5 ，物件不再需要參照符號，所有物件皆是參照。
-
-## 陣列
-
-陣列元素的指派可稍微排版，當多行時，可用 Tab 縮排。每行跟隨一個都逗號結尾，最後一行可包含逗號，這是 PHP 允許的寫法，對於程式碼 diff 比對時也有所幫助。
-
-範例:
-
-```php
-$options = array(
-	'foo'	=> 'foo',
-	'spam'	=> 'spam',
-);
-```
-
-## 註解
-
-行內註解可用 C 語言風格的 `/* ... */` 或 C++ 的單行註解 `// ...`。 C 風格的註解通常被用在文件開頭、類別、函式等等的文件標頭。而 C++ 風格單行註解則常用在程式解釋與提醒。註解對於幫助其他開發人員理解程式碼的目的有非常大的幫助，甚至包含您自己也能受惠。當程式碼開始進行複雜操作時，永遠記得要加上註解。至於 Perl 與 Shell 的井號 (`#`)註解則不建議使用，目前在 PHP 中也不再允許此類註解。
-
-您可以在某些情況下藉由註解掉整段程式碼或類別函式以用於調整程式功能，但應該在最終提交到核心前去除這些註解或不再需要的程式區塊。
-
-例如，不要在提交的程式碼中包含以下片段:
-
-```php
-// 這段程式碼未來需要修復
-//$code = broken($fixme);
-```
-
-### 文件區塊註解
-
-在 PHP、Javascript、檔案中的所有類別、成員屬性、方法與函式，皆需要區塊註解，並遵循 JavaDoc 或 phpDoc 的約定。
-
-這些 "區塊註解 (DocBlocks)" 從 PEAR 引用而來，但也為了 Joomla Framework 做了一點改變。
-
-雖然一般的縮排皆使用標準 Tab 來縮進，但區塊註解中，我們使用空格來排版，這提供了原始碼更優良的可讀性。任何文字元素，如標籤、變數的類型、變數名稱與標籤描述的最小距離必須是兩個空格。變數類型和標籤說明應分別按照最長的標籤和變數類型、變數描述對齊。
-
-如果使用了 `@package` 標籤，必須是 "Joomla.Platform"。
-
-除果使用了 `@subpackage` ，必須是 /joomla/ 資料夾下的頂層目錄名稱，例如: Application, Database, Html 等等。
-
-> 註: 在 Joomla Framework 中，不再使用 `@package` 與 `@subpackage`。
-
-貢獻給 Joomla 的程式碼，將成為專案的資產，不允許擁有 `@author` 標籤。你應該在 CREDITS.php 更新貢獻紀錄。Joomla 的理念是這樣的，所有的程式是一起發展編寫出來的，並沒有任何一個人擁有任何代碼中的一個部分。不過 `@author` 標籤允許使用在被包含進核心函式庫的第三方函式庫。
-
-從第三方函式庫引入的檔案，其區塊註解必須完好無損。Layout 的檔案使用跟其他 PHP 檔案一樣的區塊註解。
-
-### 檔案文件標頭註解
-
-文件標頭註解有以下內容且按照順序
-
--   簡易說明 (選填, 除非超過兩個以上類別或方法) 結束空一行.
--   完整說明 (選填) 結束空一行.
--   `@category` (選填)
--   `@package` (通常是選填, 但如果檔案只包含程序邏輯(無類別)則必填)
--   `@subpackage` (選填)
--   `@author` (選填, 但只允許在非的Joomla源文件，例如，包括第三方函式庫例如 Geshi)
--   `@copyright` (必填)
--   `@license` (必填且必須是相容於 Joomla 所使用的授權條款)
--   `@deprecated` (選填)
--   `@link` (選填)
--   `@see` (選填)
--   `@since` (通常是選填，但如果檔案只包含程序邏輯(無類別)則必填)
-
-```
-/**
- * @package     Joomla.Platform
- * @subpackage  Database
- * @copyright   Copyright 2005 - 2010 Open Source Matters. All rights re-served.
- * @license     GNU General Public License version 2 or later; see LICENSE.txt
- */
-```
-
-## 函式呼叫
-
-呼叫函式時, 函式名稱跟參數括號中不能有空白, 而第一個帶入參數也不得有空白; 每個參數逗點後一個空白隔開 (如果有的話), 最後一個參數跟括號沒有空格. 參數帶值等號前後需有空白. 可以多行對齊.
-
-```php
-// 單函式呼叫
-$foo = bar($var1, $var2);
-
-// 多函式呼叫
-$short  = bar('short');
-$medium = bar('medium');
-$long   = bar('long');
-```
-
-## 函式定義
-
-函式定義需開始並獨立於一新行，開始與結束的括號也需分別被放置於一新行。在負責處理回傳值的程式碼前應插入一空行。
-
-函數定義必須包含註解說明，根據本文件中的註解章節所規範之規則予以撰寫。
-
--   簡易說明 (必要，結束需空一行)
--   完整說明 (選填，結束需空一行)
--   `@param` (若函式有參數則此欄位為必要，並於最後一個`@param`標簽之後新增一空行)
--   `@return` (必要，結束需空一行)
--   其餘標簽依據字母順序排列，需注意 @since 標籤永遠為必要。
-
-```php
-/**
- * An utility class.
- *
- * @package     Joomla.Platform
- * @subpackage  XBase
- *
- * @param       string  $path  The library path in dot notation.
- *
- * @return      void
- *
- * @since       1.6
- */
-function jimport($path)
-{
-	// Body of method.
-}
-```
-
-如果一個函數定義橫跨數行，第二行起的每一行皆需以一個 tab 作縮排，結束括號需與最後一個參數存在於同一行。
-
-```php
-function fooBar($param1, $param2,
-	$param3, $param4)
-{
-	// Body of method.
-}
-```
-
-## 類別定義
-
-類別定義需開始並獨立於一新行，開始與結束的括號也需被分別放置於一新行。類別方法(Class Methods)需根據函數定義標準來撰寫。類別的屬性及方法需根據物件導向(OOP)標準適當宣告(使用適合的 public, protected, private 和 static 等屬性)
-
-類別的定義、屬性及方法皆需撰寫對應的註解區塊(DocBlock)，根據接下來的準則規範。
-
-### 類別註解區塊標頭
-
-類別註解區塊包含以下必要及非必要欄位，並依照下列順序排列。
-
--   簡易說明(必要，除非該檔案擁有兩個以上之類別或函數)
--   完整說明(選填，結束需空一行)
--   `@category` (選填，很少用到)
--   `@package` (必要)
--   `@subpackage` (選填)
--   `@author` (選填，但只允許在非joomla的程式碼中，舉例來說，如：使用第三方函式庫如Geshi)
--   `@copyright` (選填，除非與檔案文件註解表頭(file Docblock)不同)
--   `@license` (選填，除非與檔案文件註解表頭(file Docblock)不同)
--   `@deprecated` (選填)
--   `@link` (選填)
--   `@see` (選填)
--   `@since` (必填, 根據類別第一次出現時的程式版本號)
-
-### 類別屬性註解區塊
-
-類別屬性註解區塊包含以下必要及非必要欄位，並依照下列順序排列。
-
--   簡易說明(必要，除非該檔案擁有兩個以上之類別或函數)
--   `@var` (必要，於該屬性後其後註明屬性種類(property type))
--   `@deprecated` (選填)
--   `@since` (必填)
-
-### 類別方法註解區塊
-
-類別方法註解區塊是依據PHP函式之規則做撰寫(如上述)。
-
-```php
-/**
- * An utility class.
- *
- * @package     Joomla.Platform
- * @subpackage  XBase
- * @since       1.6
- */
-class JClass extends JObject
-{
-	/**
-	 * Human readable name
-	 *
-	 * @var    string
-	 * @since  1.6
-	 */
-	public $name;
-
-	/**
-	 * Method to get the name of the class.
-	 *
-	 * @param   string  $case  Optionally return in upper/lower case.
-	 *
-	 * @return  boolean  True if successfully loaded, false otherwise.
-	 *
-	 * @since   1.6
-	 */
-	public function getName($case = null)
-	{
-		// Body of method.
-
-		return $this->name;
-	}
-}
-```
-
-## 命名慣例
-
-### 類別
-
-類別應給予描述性的名稱。在可能的情況下應避免縮寫。類別名稱總是以一個大寫字母開頭，且採用駝峰式 (CamelCase) 命名法則，即便名字中包含傳統上常用大寫的字彙(如 HTML, XML)。唯一例外是必須由 J 開頭的核心類別後面可接上一個大寫字母。
-
-範例:
-
--   JHtmlHelper
--   JXmlParser
--   JModel
-
-### 函式與方法
-
-函式與方法採用 "studly caps" 風格 (也稱作 "bumpy case" 或 "camel caps")。 名稱起始的字母必須是小寫，而每個新單字的首個字母為大寫。而在 Joomla 框架中的函式必須由小寫字母 'j' 開頭。
-
-範例:
-
--   connect();
--   getData();
--   buildSomeWidget();
--   jImport();
--   jDoSomething();
-
-類別的私有成員屬性 (就是說只被用在他所宣告出來的類別內部的成員屬性) ，開頭有一個底線。屬性名稱採用底線命名風格 (也就是說，單字被底線區  隔開來)，且應該全部小寫。
-
-範例:
-
-```php
-class JFooHelper
-{
-	protected $field_name = null;
-
-	private $_status = null;
-
-	protected function sort()
-	{
-	}
-}
-```
-
-### 常數
-
-常數應永遠為大寫，並用底線分隔單字。總是在常數前加上 `J` 且運用一些眾人常識和慣例來避免常數名稱太長。你 *應該* 使用類別或封包 (package) 中已經使用的名稱。例如在 'Joomla\Application\Web\Router' 中的常數，以 `JRoute_` 開頭。
-
-### 全域變數
-
-不要使用全域變數。採用靜態類別與屬性或常數替代。
-
-### 一般情況下的變數與類別屬性
-
-一般情況下的變數，遵循函式的慣例。
-
-類別的屬性應該設為 null 或其他適當的預設值。
-
-## 例外處理
-
-例外處理應當只用於錯誤處理上。
-
-下面的章節將指出如何照語意使用 [PHP 標準函式庫 (SPL) 的 Exceptions](http://php.net/manual/en/spl.exceptions.php)。
-
-### 邏輯例外 LogicException
-
-在 API 的使用方式上發生的明確問題會丟出 LogicException 的例外。例如：如果有個依賴參數失效時（你試圖操作一個未被載入的物件）。
-
-下方的子類別也可被用於適當的情境下：
-
-#### BadFunctionCallException
-
-如果一個 callback 參照到一個未定義的函式(function) 或是缺少了一些參數時可以丟出該例外。例如：如果 `is_callable()` 或其他類似的函式用在一個函式(function)上時得到失敗的結果。
-
-#### BadMethodCallException
-
-如果一個 callback 參照到一個未定義的方法(method) 或是缺少了一些參數時可以丟出該例外。例如：如果 `is_callable()` 或其他類似的函式用在一個方法(method)上時得到失敗的結果。 另一個例子可能是找不到某些使用魔術方法的參數。
-
-#### InvalidArgumentException
-
-當有不合規格的輸入發生時丟出該例外。
-
-#### DomainException
-
-該例外和 InvalidArgumentException 類似，但會在一數值未依附在一已定義的有效資料群集的情形下丟出該例外。例如：試圖載入一個"mongodb"的資料庫引擎，但該引擎尚未在 API 中實作。
-
-#### LengthException
-
-當作一參數的長度檢查失敗時丟出該例外。例如：一個檔案的雜湊值不是一個指定長度的字串。
-
-#### OutOfRangeException
-
-該例外較少被實際的應用，但可在存取一個非法的索引值時丟出該例外。
-
-### 執行期例外 RuntimeException
-
-當外部實體或環境造成你無法控制的問題因而產生錯誤時，便丟出 RuntimeException 的例外。當一個錯誤的產生不能明確地被判斷出來時，預設丟出該例外。例如：你試圖連到資料庫但資料庫卻無法使用 (伺服器掛掉之類的)。另一個例子可能為 SQL 查詢語句的錯誤。
-
-#### UnexpectedValueException
-
-當一個非預期的結果發生時應當丟出該種類的例外。例如：當一個函式預期是要回傳布林值卻回傳字串時。
-
-#### OutOfBoundsException
-
-該例外較少實際的應用，但也許當某個值不為合法的索引值時丟出該例外。
-
-#### OverflowException
-
-該例外較少實際的應用，但也許當你加入一個元素到已經滿載的容器物件時丟出該例外。
-
-#### RangeException
-
-該例外較少實際的應用，但也許在程式執行期間丟出該例外以指出一個範圍的錯誤。通常這是指除了運算虧位/溢位之外的錯誤。該例外為 DomainException 的 runtime 版本。
-
-#### UnderflowException
-
-該例外較少實際的應用，但也許當你從一個空的容器物件中移除一個元素時丟出該例外。
-
-### 例外處理的文件撰寫
-
-每個函式(function)或方法(method)必須要註解使用到的例外，用 @throws 的標籤和丟出例外的物件名稱作註解。每種例外只須備被註解一次。註解的說明非必須。
-
-## SQL 查詢語句
-
-SQL 的保留字要全用大寫，其他的文字符號 (當然被引號包起來的文字為例外) 為小寫。
-
-全部的 table 名稱必須要用 `#__` 的前綴字而不是用 `jos_` 去讀取 Joomla 的內容，並允許替換為使用者定義的資料庫前綴字。查詢語句也必須使用 JDatabaseQuery API。
-
-```php
-// Get the database connector.
-$db = JFactory::getDBO();
-
-// Get the query from the database connector.
-$query = $db->getQuery(true);
-
-// Build the query programatically (using chaining if desired).
-$query->select('u.*')
-	// Use the qn alias for the quoteName method to quote table names.
-	->from($db->qn('#__users').' AS u'));
-
-// Tell the database connector what query to run.
-$db->setQuery($query);
-
-// Invoke the query or data retrieval helper.
-$users = $db->loadObjectList();
-```
diff --git a/manual/zh-TW/_old/preface.md b/manual/zh-TW/_old/preface.md
deleted file mode 100644
index 16575742..00000000
--- a/manual/zh-TW/_old/preface.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# Preface - 前言
-
-讓一個軟體變得更好的因素，並不只在於其提供了多少優異的功能，而在於他的原始碼品質有多優良。為了在競爭激烈的開源環境與專有軟體中佔有一席之地，原始碼不只需要優美的結構設計，更需要在閱讀上看起來同樣美麗而優雅。
-
-可讀性高的代碼也是易於維護的，且能夠指引我們實現依賴深思熟慮的標準設計來讓許多不同程式語言專案的工程師一同維護專案的目標。Joomla! 有著堅實的傳統與努力過程來實現一個偉大的產品與美觀的代碼。這份文件彙整過去和現在許多貢獻者的集體智慧，形成一個權威的標準，無論是核心Joomla!框架還是CMS的擴充套件。而這份文件也可以成為一座能安全指引開發者編寫漂亮、乾淨代碼的燈塔，以避開懶惰所造成的陷阱。
-
-Joomla 的編碼標準大量的借鑑 PEAR 標準，並在這之上做了一定程度被認為是明智的增加與擴充。
-