編輯“WordPress:Submitting Bugs”（章節(jié)）

==錯(cuò)誤報(bào)告和解決方案的詳細(xì)內(nèi)容==

下面的部分給上述的提綱添加了詳細(xì)內(nèi)容。

=== 報(bào)告錯(cuò)誤之前 ===

如WordPress這么大的項(xiàng)目，如此多的使用者提交錯(cuò)誤報(bào)告，很有可能你的錯(cuò)誤已經(jīng)被提交過(guò)了，正因?yàn)檫@樣，檢查并確定系統(tǒng)中它還沒(méi)有被提交過(guò)是很重要的。如果你剛開始在WordPress中使用提交錯(cuò)誤，在提交之前和有經(jīng)驗(yàn)的開發(fā)人員討論這個(gè)問(wèn)題是個(gè)好辦法。請(qǐng)按照下面的步驟。

# 在Trac中通過(guò)使用[http://trac.wordpress.org/search 搜索]或者是[http://trac.wordpress.org/query 查詢]來(lái)查找你的錯(cuò)誤或者是功能請(qǐng)求。
#* 如果你的問(wèn)題已經(jīng)被提交過(guò)了，請(qǐng)不要重復(fù)提交。如果你有更深入的信息，登陸并添加信息記錄到已存在的錯(cuò)誤中。
#* 如果你的問(wèn)題相似，但是不完全和另一個(gè)問(wèn)題相同，你可以決定是否添加一個(gè)記錄到相似問(wèn)題中，或者是重新提交。很難決定是否你的問(wèn)題可以作為一個(gè)新的問(wèn)題提交，但是通常情況下，如果你只是有更多信息來(lái)提交的話，打開問(wèn)題，簡(jiǎn)單的添加一個(gè)記錄就可以了。 如果你有個(gè)完全不同的問(wèn)題，或者如果你正經(jīng)歷了一個(gè)重復(fù)的以前解決過(guò)的問(wèn)題，可以提交一個(gè)新錯(cuò)誤。
#* 如果你的問(wèn)題最近提交了也關(guān)閉了，但是你不同意這樣的解決方法，你可以重新打開ticket添加注釋，寫明你的理由。
# 想在Trac上在提交之前討論一個(gè)錯(cuò)誤， (如判斷它是否是一個(gè)WordPress核心的而不是插件或者主題的錯(cuò)誤)，你可以在[http://wordpress.org/support/ WordPress 支持論壇]上發(fā)個(gè)帖子，在[[WordPress:WordPress IRC Live Help|#wordpress IRC 頻道]] 討論你的問(wèn)題，或者在[[WordPress:Mailing Lists#Testers|檢測(cè)器]] 或[[WordPress:Mailing Lists#hackers|Hackers]]郵件列表上參與郵件討論。
=== 提交錯(cuò)誤 ===

[http://trac.wordpress.org/ Trac]是官方WordPress錯(cuò)誤跟蹤器的名字。它使用開發(fā)源碼跟蹤軟件[http://projects.edgewall.com/trac/ Trac]，它是 [http://www.edgewall.com/ Edgewall Software]的產(chǎn)品。安裝下面的步驟在Trac建立一個(gè)好的錯(cuò)誤報(bào)告:

# 閱讀 [[WordPress:#Before You Report a Bug|提交錯(cuò)誤之前(上面)]], 然后驗(yàn)證你有一個(gè)新的可以提交的錯(cuò)誤。
# 閱讀[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html 如何有效的提交錯(cuò)誤]這個(gè)文章，和[http://trac.wordpress.org/wiki/TracTickets Trac Ticket 文檔].
#使用你的 using your [http://wordpress.org/support/ 支持論壇]的用戶名和密碼登陸[http://trac.wordpress.org/ WordPress Trac]。如果你沒(méi)有帳戶， [http://wordpress.org/support/register.php 注冊(cè)] 一個(gè)這樣才可以登陸Trac。這隊(duì)伍你錯(cuò)誤的交流是必需的。因?yàn)殚_發(fā)人員可能需要更多的信息(而你不能創(chuàng)建ticket 如果不登陸的話).
 在新的ticket頁(yè)面上填寫如下信息:
#; 簡(jiǎn)單摘要: 讓摘要簡(jiǎn)短但是要包含信息并且準(zhǔn)確，因?yàn)檫@是ticket的標(biāo)題，將會(huì)顯示在搜索結(jié)果中。
#; 完整的描述: 填寫你的錯(cuò)誤或者是功能要求的完整的描述。包括一個(gè)問(wèn)題的描述，別人可以重復(fù)這個(gè)問(wèn)題的步驟，也可以是一個(gè)錯(cuò)誤的運(yùn)轉(zhuǎn)的例子 (如 URL), 或者是一個(gè)為什么問(wèn)題值得更正的描述。同樣包括關(guān)于你的平臺(tái)的信息，如操作系統(tǒng)，網(wǎng)絡(luò)服務(wù)器軟件，PHP 版本, MySQL 版本, WordPress 版本。你描述的越好，解決錯(cuò)誤的可能性就越大。
#; Ticket 屬性:
#:; 優(yōu)先級(jí): 你需要確定這個(gè)問(wèn)題的優(yōu)先權(quán) – 這個(gè)錯(cuò)誤有多緊急。除非它是一個(gè)致命的錯(cuò)誤，最好是讓它保持默認(rèn)狀態(tài)，因?yàn)殚_發(fā)人員通常都是按照錯(cuò)誤優(yōu)先級(jí)的排序來(lái)的。
#:; 組件: 選擇發(fā)現(xiàn)問(wèn)題所在的WordPress組件
#:; 嚴(yán)重 : 這個(gè)問(wèn)題的''重要性''。選擇一個(gè)severity基于你認(rèn)為這個(gè)問(wèn)題有多嚴(yán)重，如果有疑問(wèn)，就保持默認(rèn)的''Normal''.
#:; 分配: 如果你知道有負(fù)責(zé)存在錯(cuò)誤的代碼的開發(fā)人員，把他們的Trac用戶名放在這里。你也可以自己為這個(gè)錯(cuò)誤負(fù)責(zé)，把你自己的Trac用戶名放在這里就可以了。這是可以選擇的，這可以讓開發(fā)人員更快的注意到這個(gè)錯(cuò)誤。
#:; 里程表: 最遲在哪個(gè)版本這個(gè)問(wèn)題會(huì)被解決。不要更改它。這是WordPress 開發(fā)人員設(shè)置的。
#:; 版本: 錯(cuò)誤發(fā)現(xiàn)的WordPress 版本。你可以在管理面板的頁(yè)腳找到WordPress版本號(hào)。
#:; 關(guān)鍵詞: 關(guān)鍵詞讓開發(fā)人員更容易的找到錯(cuò)誤所在，確定它的影響范圍。例如'posting'， 一個(gè)涉及到WordPress發(fā)表文章機(jī)制的錯(cuò)誤的關(guān)鍵詞。同樣，有標(biāo)準(zhǔn)關(guān)鍵詞用來(lái)標(biāo)記你的錯(cuò)誤的狀態(tài)(參見(jiàn) [[WordPress:#Trac Keywords|Trac 關(guān)鍵詞]] 下面).
#:; CC: 錯(cuò)誤信息和更新信息發(fā)送的對(duì)象。如果你想保持可以被通知到，把你自己的Trac名字寫上。 當(dāng)這個(gè)報(bào)告有任何更改的時(shí)候，你將會(huì)被郵件通知。不要忽視這些郵件; 做出任何改動(dòng)后，確定查看一下報(bào)告更新。開發(fā)人員可能需要從你這里獲得更多的信息，這是他們與你聯(lián)系的唯一的方法。 '''注意''': 你需要進(jìn)入Trac ''設(shè)置''頁(yè)面來(lái)設(shè)置你的email地址。把他放到你的支持論壇個(gè)人資料里并不能讓你的資料進(jìn)入Trac以達(dá)到接收CC信息的目的。
# 點(diǎn)擊 '''提交Ticket''' (預(yù)覽之后). 然后返回。

=== 找到錯(cuò)誤修正 ===

如果你想修正WordPress核心部分的錯(cuò)誤，但是不知道修正哪個(gè)，這里是一些關(guān)于如何找到修正的錯(cuò)誤的建議:
* 仔細(xì)閱讀 [http://trac.wordpress.org/report/13 需要關(guān)于Trac的補(bǔ)丁報(bào)告] (列出了沒(méi)有標(biāo)出"has_patch"關(guān)鍵詞的錯(cuò)誤)， [http://trac.wordpress.org/report/18 缺乏關(guān)于Trac的附件報(bào)告] (列出了沒(méi)有補(bǔ)丁文件的錯(cuò)誤)，或者是其他對(duì)于看起來(lái)比較有趣的錯(cuò)誤的 [http://trac.wordpress.org/report Trac 報(bào)告].
* 發(fā)送郵件信息到[[WordPress:Mailing_Lists#Hackers|wp-hackers 郵件列表]] 詢問(wèn)你能幫什么忙. 
* 有時(shí)也有一些錯(cuò)誤幫助在 <tt>#wordpress-dev</tt> [[WordPress:IRC|IRC]] 頻道。
* 偶然在<tt>#wordpress-bugs</tt>上有錯(cuò)誤日。你可以在[[WordPress:WordPress Bug Hunts|錯(cuò)誤搜尋]]上閱讀關(guān)于什么錯(cuò)誤日發(fā)生了什么，并且預(yù)定[[WordPress:Mailing_Lists#Hackers|wp-hackers]]或者是 [[WordPress:Mailing_Lists#Testers|wp-testers]] 郵件列表來(lái)找出它們是什么時(shí)候出現(xiàn)的。
* 考慮加入[http://lists.automattic.com/mailman/listinfo/wp-trac wp-trac 郵件列表] 來(lái)參與關(guān)于每個(gè)[http://trac.wordpress.org/report Trac Ticket]的討論。


=== 打補(bǔ)丁 ===

如果你熟悉[[WordPress:Glossary#PHP|PHP]]和 [[WordPress:Glossary#MySQL|MySQL]]，并且想幫助WordPress發(fā)展，那么我們鼓勵(lì)你為WordPress 的錯(cuò)誤打上補(bǔ)丁。如下是打補(bǔ)丁的步驟:

#閱讀 [[#WordPress:Finding Bugs to Fix|找到錯(cuò)誤修正(上面)]], 然后在[http://trac.wordpress.org Trac]中找到錯(cuò)誤并修正
#使用你[http://wordpress.org/support/register.php 注冊(cè)]的用戶名和密碼連接到[http://wordpress.org/download/svn/ WordPress Subversion (SVN) Repository]，閱讀 [[WordPress:Using Subversion|使用子版本]]，如果你對(duì)SVN不熟悉的話。所有的補(bǔ)丁都會(huì)被提交的SVN，而不考慮最新的代碼。
# 找出如何通過(guò)修改WordPress核心文件修正錯(cuò)誤。你可能想在結(jié)束之前在[[WordPress:Mailing_Lists#Hackers|wp-hackers 郵件列表]]上討論你的解決方案。
# 測(cè)試你的修改，驗(yàn)證錯(cuò)誤已經(jīng)被修正，而且在此過(guò)程中沒(méi)有其他的WordPress內(nèi)的東西被破壞。
# 創(chuàng)建一個(gè)包含你的修改的''補(bǔ)丁文件''。這完全與修正文件和SVN中的源文件''不同''。參見(jiàn)[http://asymptomatic.net/2005/12/03/586/how-to-patch-wordpress 如何為WordPress打補(bǔ)丁 by Owen Winkler]獲得詳細(xì)說(shuō)明。有Linux/Mac 的說(shuō)明，[http://markjaquith.wordpress.com/2005/11/02/my-wordpress-toolbox/ Mark Jaquith 的工具書]中的命令行使用者，和[http://blog.ftwr.co.uk/archives/2005/11/03/windows-wordpress-toolbox/ Westi的Blog]中Windows Tortoise SVN 的使用者.
# 使用[http://trac.wordpress.org/ Trac]的 ''Attach file'' 按鈕上傳到ticket，添加 ''has-patch''到關(guān)鍵詞中。如果補(bǔ)丁需要測(cè)試，你可以把''needs-testing''也添加上，或者其他的Trac 關(guān)鍵詞; 參見(jiàn) [[#WordPress:Trac Keywords|Trac 關(guān)鍵詞 (下面)]] 獲得更多信息。

=== Trac 關(guān)鍵詞 ===

有很多有固定意思的關(guān)鍵詞經(jīng)常在[http://trac.wordpress.org Trac]中使用; 一些可以通過(guò)[http://trac.wordpress.org/report Trac Reports]搜索。

;reporter-feedback : 提交人的回復(fù)是必需的。深入的調(diào)查如果沒(méi)有經(jīng)歷過(guò)問(wèn)題本身的人的回復(fù)的話是靠不住的。

;has-patch : 已經(jīng)附上ticket的解決方法，準(zhǔn)備好再次檢查或者是提交。

;needs-testing : 某人需要測(cè)試這個(gè)解決方案

;2nd-opinion : 需要另外一個(gè)人來(lái)傳遞一個(gè)關(guān)于問(wèn)題或者解決方案的觀點(diǎn)

;dev-feedback : 需要開發(fā)人員的回復(fù) (不常用)

;tested : 補(bǔ)丁測(cè)試過(guò)了. 當(dāng)添加這個(gè)標(biāo)簽時(shí)請(qǐng)加入測(cè)試的文件名字，補(bǔ)丁如何測(cè)試的，和使用了哪個(gè)WordPress版本(包括SVN版本號(hào)，如果不是官方發(fā)布的版本的話).

;commit : 補(bǔ)丁已經(jīng)被某個(gè)開發(fā)團(tuán)體中可以信任的人檢查過(guò)，測(cè)試過(guò); 這樣這個(gè)補(bǔ)丁就已經(jīng)準(zhǔn)備添加到WordPress核心文件中了.

;needs-patch : ticket已經(jīng)被檢查過(guò)，發(fā)現(xiàn)描述為解決，但是標(biāo)記為特別需要一個(gè)補(bǔ)丁，或者提交的補(bǔ)丁不能使用需要重新做

;needs-unit-tests : ticket已經(jīng)通過(guò)檢查，發(fā)現(xiàn)描述為解決，我們希望一個(gè)聯(lián)合測(cè)試，來(lái)測(cè)試功能性，因?yàn)樘峤磺案鞣N補(bǔ)丁的存在造成導(dǎo)致其他問(wèn)題的風(fēng)險(xiǎn)很高。

;needs-doc : 需要代碼的內(nèi)嵌文檔。這可以是在它們被提交之前保存ticket單獨(dú)文件或者是帶有新函數(shù)補(bǔ)丁需要的文檔資料。 

=== 錯(cuò)誤解決方案===

Trac 中的ticket 在''open''狀態(tài)下開始，最終到''closed''。當(dāng)一個(gè)ticket關(guān)閉后，它會(huì)被以下某個(gè)狀態(tài)之一標(biāo)記:

* 如果你的錯(cuò)誤已經(jīng)提交到別的地方，它將以''duplicate''結(jié)束. 
* 如果錯(cuò)誤在最新的版本代碼中已經(jīng)修正(可能不是你在運(yùn)行的版本除非你有一個(gè)本地測(cè)試的blog)，標(biāo)記為''fixed''.
* 如果確定你的錯(cuò)誤事實(shí)上不是錯(cuò)誤，而是你故意的行為，會(huì)標(biāo)記為''invalid''.
* 如果沒(méi)有其他人可以重現(xiàn)你所描述的現(xiàn)象，會(huì)以''worksforme''結(jié)束。
* 如果你的錯(cuò)誤是一個(gè)功能請(qǐng)求，而開發(fā)人員不想讓它出現(xiàn)在核心代碼中，標(biāo)記為 ''wontfix''.

請(qǐng)驗(yàn)證你的錯(cuò)誤在提交時(shí)不屬于其中任何一種。