[Update #14] docblock翻譯 #16

takeshiwayne · 2014-10-06T10:10:44Z

asika32764 · 2014-10-06T13:06:01Z

@LeoOnTheEarth 幫忙 review 一下吧

asika32764 · 2014-10-06T13:06:33Z

manual/zh-TW/coding-standards/chapters/docblocks.md

@@ -1,32 +1,32 @@
-## DocBlocks
+## 註釋


一般 docblock 叫區塊註解

註解區塊比較順吧?

搜尋一下是以區塊註解較多

2014-10-06 22:50 GMT+08:00 Leo [email protected]:

In manual/zh-TW/coding-standards/chapters/docblocks.md:

@@ -1,32 +1,32 @@
-## DocBlocks
+## 註釋

註解區塊比較順吧?

—
Reply to this email directly or view it on GitHub
https://github.com/smstw/joomla-coding-standards/pull/16/files#r18460688
.

Best Regard

Simon Asika | Kwang Po Tung | 董冠伯

Founder: Asikart Extension http://ext.asikart.com/

CTO: SMS Taiwan http://www.bm-sms.com.tw/

Mobile: 886-928-565-747

Github: https://github.com/asika32764

那就翻區塊註解吧！ 👍

bblurock · 2014-10-07T04:40:43Z

manual/zh-TW/coding-standards/chapters/docblocks.md


-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第三方核心程式編碼是被允許的。


我覺得這樣比較順

貢獻到 Joomla 專案下的程式碼會成為 Joomla 專案版權所有，使用 @author 標簽是不被允許的。您必須在 CREDITS.php 中更新您的貢獻記錄。Joomla 的哲學是：程式碼是被 "共同" 撰寫的，任何人都不能主張其擁有 Joomla 專案中的程式碼片段。然而，在核心 libraries 之中所使用的第三方 libraries 則允許使用 @author 標簽。

將成為 Joomla project 版權一部分而貢獻出來的程式不允許使用 @auther 標籤
我剛剛講過被洗掉了 =_=...

另外 @bblurock 翻的還是太直接了，要轉化成一些中文的講法
翻譯有時候不是逐句去翻，可以先把一個段落看完，再思考原文的意思再翻會比較好

那整段翻成：
所有的程式編碼將成為 Joomla project 版權一部分而貢獻出來的程式不允許使用 @auther 標籤。您必須在 CREDITS.php 中更新您的貢獻記錄。Joomla 的哲學是：程式碼是被 "共同" 撰寫的，任何人都不能主張其擁有 Joomla 專案中的程式碼片段。然而，在核心 libraries 之中所使用的第三方 libraries 則允許使用 @author 標簽。

ＯＫ？

@bblurock 這段白話文蠻好閱讀的阿，跟原文差異似乎也不大

開頭地一句這樣翻吧

貢獻到 Joomla 專案下的程式碼，其版權將屬於 Joomla 專案，因此我們不允許其內包含 @author 標籤。

bblurock · 2014-10-07T04:45:20Z

還有每個英文字 Egnlish 跟中文字之間應該左右都有空格。

可以簡單 Follow 一下這個規範 - 中文文案排版指北。

LeoOnTheEarth · 2014-10-07T09:02:34Z

manual/zh-TW/coding-standards/chapters/docblocks.md


-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 所使用的慣例。


撰寫 方式
攥寫 的 攥 是怎麼打出來的啊XD...

寸哥眼睛你偷開外掛....我都沒注意到

LeoOnTheEarth · 2014-10-07T09:32:17Z

manual/zh-TW/coding-standards/chapters/docblocks.md

+* @category (非必填，極少使用)
+* @package (通常是非必填，但當程式碼是持續性就是必填)
+* @subpackage (非必填)
+* @author (非必填但只被允許在非 Joomla 程式資源裡，像是第三方套件 Geshi)


像是 Geshi 之類的第三方套件

LeoOnTheEarth · 2014-10-07T10:46:18Z

要把改好的東西 push 上來啊...

asika32764 · 2014-10-13T02:34:17Z

這個 PR 狀況如何？

takeshiwayne · 2014-10-13T03:15:26Z

改好哩，再麻煩@LeoOnTheEarth der der 有空再看一下。沒問題就可以merge 了

LeoOnTheEarth · 2014-10-13T03:35:43Z

OK 了，merge...

[Update #14] docblock翻譯

asika32764 assigned LeoOnTheEarth Oct 6, 2014

asika32764 reviewed Oct 6, 2014
View reviewed changes

takeshiwayne force-pushed the docblock branch 2 times, most recently from 988ff62 to 9e0a9ef Compare October 7, 2014 04:34

新翻譯

1400b99

bblurock reviewed Oct 7, 2014
View reviewed changes

翻譯revised2

1baf391

takeshiwayne force-pushed the docblock branch from 156b1b6 to 1baf391 Compare October 7, 2014 05:15

revised3

0a4f851

takeshiwayne force-pushed the docblock branch from bab1428 to 0a4f851 Compare October 7, 2014 07:49

LeoOnTheEarth reviewed Oct 7, 2014
View reviewed changes

改"開頭"和加逗號

0e7076d

LeoOnTheEarth reviewed Oct 7, 2014
View reviewed changes

revised 4th

ab151df

LeoOnTheEarth added a commit that referenced this pull request Oct 13, 2014

Merge pull request #16 from takeshiwayne/docblock

113bde6

[Update #14] docblock翻譯

LeoOnTheEarth merged commit 113bde6 into smstw:gh-pages Oct 13, 2014

LeoOnTheEarth mentioned this pull request Oct 23, 2014

Docblock 翻譯 #14

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Update #14] docblock翻譯 #16

[Update #14] docblock翻譯 #16

takeshiwayne commented Oct 6, 2014

asika32764 commented Oct 6, 2014

asika32764 Oct 6, 2014

LeoOnTheEarth Oct 6, 2014

asika32764 Oct 6, 2014

takeshiwayne Oct 7, 2014

bblurock Oct 7, 2014

LeoOnTheEarth Oct 7, 2014

LeoOnTheEarth Oct 7, 2014

takeshiwayne Oct 7, 2014

asika32764 Oct 7, 2014

asika32764 Oct 7, 2014

bblurock commented Oct 7, 2014

LeoOnTheEarth Oct 7, 2014

takeshiwayne Oct 7, 2014

LeoOnTheEarth Oct 7, 2014

takeshiwayne Oct 7, 2014

LeoOnTheEarth commented Oct 7, 2014

asika32764 commented Oct 13, 2014

takeshiwayne commented Oct 13, 2014

LeoOnTheEarth commented Oct 13, 2014


		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第三方核心程式編碼是被允許的。


		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 所使用的慣例。

[Update #14] docblock翻譯 #16

[Update #14] docblock翻譯 #16

Conversation

takeshiwayne commented Oct 6, 2014

asika32764 commented Oct 6, 2014

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Simon Asika | Kwang Po Tung | 董冠伯

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

bblurock commented Oct 7, 2014

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

LeoOnTheEarth commented Oct 7, 2014

asika32764 commented Oct 13, 2014

takeshiwayne commented Oct 13, 2014

LeoOnTheEarth commented Oct 13, 2014