Add zh-TW folder

Author: asika32764

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 

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) - 安全性編碼導覽
+
+本清單將隨時補充~~~

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 下所拼寫一些常用的單詞。
+
+-   依賴的
+
+