From 945123c0a2355057e8059d20b465afef13a258c0 Mon Sep 17 00:00:00 2001 From: Simon Asika Date: Fri, 3 Oct 2014 17:24:09 +0800 Subject: [PATCH 1/5] 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 Date: Fri, 3 Oct 2014 17:32:14 +0800 Subject: [PATCH 2/5] 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 Date: Fri, 3 Oct 2014 20:29:29 +0800 Subject: [PATCH 3/5] 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 2736b52e2b01ca2ae7b5f5d20f77fbf9e03dfd8e Mon Sep 17 00:00:00 2001 From: Simon Asika Date: Mon, 6 Oct 2014 12:42:18 +0800 Subject: [PATCH 4/5] 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 3da6c77349ea51e8b464ddda5f8d4235472c81cb Mon Sep 17 00:00:00 2001 From: Simon Asika Date: Mon, 6 Oct 2014 15:03:47 +0800 Subject: [PATCH 5/5] 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的擴充套件。而這份文件也可以成為一座燈塔，以安全的指引社群開發者們編寫漂亮、乾淨的代碼。