WIKI使用導航
站長百科導航
站長專題
- 網(wǎng)站推廣
- 網(wǎng)站程序
- 網(wǎng)站賺錢
- 虛擬主機
- cPanel
- 網(wǎng)址導航專題
- 云計算
- 微博營銷
- 虛擬主機管理系統(tǒng)
- 開放平臺
- WIKI程序與應用
- 美國十大主機
WordPress: Submitting Bugs:修訂間差異
(新頁面: Every application has bugs -- as long as humans write code, there will continue to be errors in software. Some errors are trivial, while others are cr...) ? |
小無編輯摘要 ? |
||
(未顯示3個用戶的10個中間版本) | |||
第1行: | 第1行: | ||
<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>導航:</strong> [[WordPress:WordPress文檔|上一級]] | [[WordPress]] | {{Template:WordPress導航}}</span> | |||
<div style="clear:both;"></div> | |||
每種軟件都有[[WordPress:Wikipedia:Computer bug|錯誤]] – 只要是人寫代碼,軟件中就會有錯誤,有些錯誤是微不足道的,但是有些是非常嚴重的。開源項目如 [[WordPress:WordPress| WordPress]] 需要使用者的參與來找出軟件中的錯誤,同樣也包括新功能的開發(fā)。 | |||
所有類型的反饋— 不管是真正的錯誤還是有用的請求— 都在WordPress 中用同樣的方法提交。閱讀WordPress關于如何提交錯誤和問題的信息... 你可能會想要閱讀[[WordPress:Contributing to WordPress|為WordPress做貢獻]]來找出如何為文檔資料和WordPress其他方面做貢獻。 | |||
== 提交安全問題 == | |||
當我們試著防止出現(xiàn)安全問題時,我們不能認為它們不會出現(xiàn)。如果你相信你在WordPress某個版本中找到了安全問題,發(fā)郵件到<tt>WordPress.org</tt>上的<tt>security</tt> 區(qū)域,我們將盡力盡快解決。 | |||
通知賣主(這里是指WordPress開發(fā)人員)是在發(fā)布之前的安全問題的標準練習,這樣可以準備好修正版本,這造成的損失可以降低到最小。 | |||
== 提交插件和主題中的錯誤 == | |||
如果你在使用時插件或者主題中發(fā)現(xiàn)了錯誤,'''不要''' 使用本文中的方法進行提交! 本文提供的方法只適用于WordPress核心文件的錯誤,不適合于插件和主題中的錯誤。 | |||
[http://dev.wp-plugins.org/ WordPress插件庫]中的插件有一個來自 WordPress 核心的[http://dev.wp-plugins.org/report 單獨的錯誤跟蹤系統(tǒng)]。有一個如何使用這個系統(tǒng)的 [http://dev.wp-plugins.org/wiki/TracTickets 單獨的說明]。 | |||
對于不在官方庫中的插件和主題,查看其附帶的文檔資料作為關于如何提交錯誤的說明。如果沒有錯誤提交信息,你需要直接聯(lián)系作者。 | |||
== | ==錯誤提交和解決總覽== | ||
提交和解決WordPress錯誤的過程有幾步,這里是一個總的概括,下面可以找到更多細節(jié)。 | |||
# 用戶發(fā)現(xiàn)了錯誤,出現(xiàn)在WordPress核心文件中 (不在主題或者插件中). | |||
# 用戶嘗試著確認這確實是一個錯誤。參見 [[#WordPress:Before You Report a Bug|提交錯誤之前(下面)]]. | |||
# 如果確定它是一個錯誤,用戶提交錯誤報告到[http://trac.wordpress.org/ Trac],叫做''ticket'',WordPress錯誤跟蹤系統(tǒng)。參見[[#WordPress:Reporting a Bug|提交錯誤 (下面)]]. | |||
# WordPress 開發(fā)人員 (可能也是象你一樣的志愿者) 確認錯誤的確存在,然后它應該被修正。然后象在票上做記號那樣標記出來。參見[[#WordPress:Trac Keywords|Trac 關鍵詞列表(下面)]] 和 [[#WordPress:Bug Resolutions|錯誤解決方案(下面)]]. | |||
# WordPress 開發(fā)人員 (可能是你)決定修復這個錯誤。開發(fā)者可能選擇通過點擊ticket底部附近的 ''Accept ticket''操作來負責這個錯誤,盡管這不是必須的。然后開發(fā)人員指出如何修復這個錯誤,創(chuàng)建一個或者多個補丁,上傳到Trac. 參見 [[#WordPress:Patching Bugs|錯誤補丁(下面)]]。同樣的,如果你想要幫助修復錯誤,但是不知道需要修復哪個錯誤,參見[[#WordPress:Finding Bugs to Fix|找到錯誤并修復 (下面)]]. | |||
# WordPress開發(fā)小組成員(包括志愿者)測試補丁,查看是否錯誤被修復了而沒有影響到其他東西。它們添加評論和關鍵詞到ticket,顯示出它們的結(jié)果。參見 [[#WordPress:Trac Keywords|Trac 關鍵詞列表(下面)]]. | |||
# WordPress 開發(fā)員中的一個擁有修改官方WordPress源代碼權(quán)限的人(Matt Mullenweg, Ryan Boren, Mark Jaquith or Peter Westwood) ''提交'' 補丁給SVN庫中的核心代碼。如果錯誤和補丁被他們所信任的某人驗證過后,他們會這樣做的。 | |||
# 最后,提交補丁的這個人設定ticket狀態(tài)為''closed'',結(jié)論是''fixed''。參見 [[#WordPress:Bug Resolutions|錯誤結(jié)論(下面)]]. | |||
==錯誤報告和解決方案的詳細內(nèi)容== | |||
下面的部分給上述的提綱添加了詳細內(nèi)容。 | |||
=== 報告錯誤之前 === | |||
如WordPress這么大的項目,如此多的使用者提交錯誤報告,很有可能你的錯誤已經(jīng)被提交過了,正因為這樣,檢查并確定系統(tǒng)中它還沒有被提交過是很重要的。如果你剛開始在WordPress中使用提交錯誤,在提交之前和有經(jīng)驗的開發(fā)人員討論這個問題是個好辦法。請按照下面的步驟。 | |||
# 在Trac中通過使用[http://trac.wordpress.org/search 搜索]或者是[http://trac.wordpress.org/query 查詢]來查找你的錯誤或者是功能請求。 | |||
#* 如果你的問題已經(jīng)被提交過了,請不要重復提交。如果你有更深入的信息,登陸并添加信息記錄到已存在的錯誤中。 | |||
#* 如果你的問題相似,但是不完全和另一個問題相同,你可以決定是否添加一個記錄到相似問題中,或者是重新提交。很難決定是否你的問題可以作為一個新的問題提交,但是通常情況下,如果你只是有更多信息來提交的話,打開問題,簡單的添加一個記錄就可以了。 如果你有個完全不同的問題,或者如果你正經(jīng)歷了一個重復的以前解決過的問題,可以提交一個新錯誤。 | |||
#* 如果你的問題最近提交了也關閉了,但是你不同意這樣的解決方法,你可以重新打開ticket添加注釋,寫明你的理由。 | |||
# 想在Trac上在提交之前討論一個錯誤, (如判斷它是否是一個WordPress核心的而不是插件或者主題的錯誤),你可以在[http://wordpress.org/support/ WordPress 支持論壇]上發(fā)個帖子,在[[WordPress:WordPress IRC Live Help|#wordpress IRC 頻道]] 討論你的問題,或者在[[WordPress:Mailing Lists#Testers|檢測器]] 或[[WordPress:Mailing Lists#hackers|Hackers]]郵件列表上參與郵件討論。 | |||
=== 提交錯誤 === | |||
[http://trac.wordpress.org/ Trac]是官方WordPress錯誤跟蹤器的名字。它使用開發(fā)源碼跟蹤軟件[http://projects.edgewall.com/trac/ Trac],它是 [http://www.edgewall.com/ Edgewall Software]的產(chǎn)品。安裝下面的步驟在Trac建立一個好的錯誤報告: | |||
# 閱讀 [[WordPress:#Before You Report a Bug|提交錯誤之前(上面)]], 然后驗證你有一個新的可以提交的錯誤。 | |||
# 閱讀[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html 如何有效的提交錯誤]這個文章,和[http://trac.wordpress.org/wiki/TracTickets Trac Ticket 文檔]. | |||
#使用你的 using your [http://wordpress.org/support/ 支持論壇]的用戶名和密碼登陸[http://trac.wordpress.org/ WordPress Trac]。如果你沒有帳戶, [http://wordpress.org/support/register.php 注冊] 一個這樣才可以登陸Trac。這隊伍你錯誤的交流是必需的。因為開發(fā)人員可能需要更多的信息(而你不能創(chuàng)建ticket 如果不登陸的話). | |||
在新的ticket頁面上填寫如下信息: | |||
#; 簡單摘要: 讓摘要簡短但是要包含信息并且準確,因為這是ticket的標題,將會顯示在搜索結(jié)果中。 | |||
#; 完整的描述: 填寫你的錯誤或者是功能要求的完整的描述。包括一個問題的描述,別人可以重復這個問題的步驟,也可以是一個錯誤的運轉(zhuǎn)的例子 (如 URL), 或者是一個為什么問題值得更正的描述。同樣包括關于你的平臺的信息,如操作系統(tǒng),網(wǎng)絡服務器軟件,PHP 版本, MySQL 版本, WordPress 版本。你描述的越好,解決錯誤的可能性就越大。 | |||
#; Ticket 屬性: | |||
#:; 優(yōu)先級: 你需要確定這個問題的優(yōu)先權(quán) – 這個錯誤有多緊急。除非它是一個致命的錯誤,最好是讓它保持默認狀態(tài),因為開發(fā)人員通常都是按照錯誤優(yōu)先級的排序來的。 | |||
#:; 組件: 選擇發(fā)現(xiàn)問題所在的WordPress組件 | |||
#:; 嚴重 : 這個問題的''重要性''。選擇一個severity基于你認為這個問題有多嚴重,如果有疑問,就保持默認的''Normal''. | |||
#:; 分配: 如果你知道有負責存在錯誤的代碼的開發(fā)人員,把他們的Trac用戶名放在這里。你也可以自己為這個錯誤負責,把你自己的Trac用戶名放在這里就可以了。這是可以選擇的,這可以讓開發(fā)人員更快的注意到這個錯誤。 | |||
#:; 里程表: 最遲在哪個版本這個問題會被解決。不要更改它。這是WordPress 開發(fā)人員設置的。 | |||
#:; 版本: 錯誤發(fā)現(xiàn)的WordPress 版本。你可以在管理面板的頁腳找到WordPress版本號。 | |||
#:; 關鍵詞: 關鍵詞讓開發(fā)人員更容易的找到錯誤所在,確定它的影響范圍。例如'posting', 一個涉及到WordPress發(fā)表文章機制的錯誤的關鍵詞。同樣,有標準關鍵詞用來標記你的錯誤的狀態(tài)(參見 [[WordPress:#Trac Keywords|Trac 關鍵詞]] 下面). | |||
#:; CC: 錯誤信息和更新信息發(fā)送的對象。如果你想保持可以被通知到,把你自己的Trac名字寫上。 當這個報告有任何更改的時候,你將會被郵件通知。不要忽視這些郵件; 做出任何改動后,確定查看一下報告更新。開發(fā)人員可能需要從你這里獲得更多的信息,這是他們與你聯(lián)系的唯一的方法。 '''注意''': 你需要進入Trac ''設置''頁面來設置你的email地址。把他放到你的支持論壇個人資料里并不能讓你的資料進入Trac以達到接收CC信息的目的。 | |||
# 點擊 '''提交Ticket''' (預覽之后). 然后返回。 | |||
=== 找到錯誤修正 === | |||
如果你想修正WordPress核心部分的錯誤,但是不知道修正哪個,這里是一些關于如何找到修正的錯誤的建議: | |||
* 仔細閱讀 [http://trac.wordpress.org/report/13 需要關于Trac的補丁報告] (列出了沒有標出"has_patch"關鍵詞的錯誤), [http://trac.wordpress.org/report/18 缺乏關于Trac的附件報告] (列出了沒有補丁文件的錯誤),或者是其他對于看起來比較有趣的錯誤的 [http://trac.wordpress.org/report Trac 報告]. | |||
* 發(fā)送郵件信息到[[WordPress:Mailing_Lists#Hackers|wp-hackers 郵件列表]] 詢問你能幫什么忙. ? | |||
* 有時也有一些錯誤幫助在 <tt>#wordpress-dev</tt> [[WordPress:IRC|IRC]] 頻道。 | |||
* 偶然在<tt>#wordpress-bugs</tt>上有錯誤日。你可以在[[WordPress:WordPress Bug Hunts|錯誤搜尋]]上閱讀關于什么錯誤日發(fā)生了什么,并且預定[[WordPress:Mailing_Lists#Hackers|wp-hackers]]或者是 [[WordPress:Mailing_Lists#Testers|wp-testers]] 郵件列表來找出它們是什么時候出現(xiàn)的。 | |||
* 考慮加入[http://lists.automattic.com/mailman/listinfo/wp-trac wp-trac 郵件列表] 來參與關于每個[http://trac.wordpress.org/report Trac Ticket]的討論。 | |||
# | |||
# | |||
# | |||
# | |||
=== 打補丁 === | |||
如果你熟悉[[WordPress:Glossary#PHP|PHP]]和 [[WordPress:Glossary#MySQL|MySQL]],并且想幫助WordPress發(fā)展,那么我們鼓勵你為WordPress 的錯誤打上補丁。如下是打補丁的步驟: | |||
#閱讀 [[#WordPress:Finding Bugs to Fix|找到錯誤修正(上面)]], 然后在[http://trac.wordpress.org Trac]中找到錯誤并修正 | |||
#使用你[http://wordpress.org/support/register.php 注冊]的用戶名和密碼連接到[http://wordpress.org/download/svn/ WordPress Subversion (SVN) Repository],閱讀 [[WordPress:Using Subversion|使用子版本]],如果你對SVN不熟悉的話。所有的補丁都會被提交的SVN,而不考慮最新的代碼。 | |||
# 找出如何通過修改WordPress核心文件修正錯誤。你可能想在結(jié)束之前在[[WordPress:Mailing_Lists#Hackers|wp-hackers 郵件列表]]上討論你的解決方案。 | |||
# 測試你的修改,驗證錯誤已經(jīng)被修正,而且在此過程中沒有其他的WordPress內(nèi)的東西被破壞。 | |||
# 創(chuàng)建一個包含你的修改的''補丁文件''。這完全與修正文件和SVN中的源文件''不同''。參見[http://asymptomatic.net/2005/12/03/586/how-to-patch-wordpress 如何為WordPress打補丁 by Owen Winkler]獲得詳細說明。有Linux/Mac 的說明,[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''到關鍵詞中。如果補丁需要測試,你可以把''needs-testing''也添加上,或者其他的Trac 關鍵詞; 參見 [[#WordPress:Trac Keywords|Trac 關鍵詞 (下面)]] 獲得更多信息。 | |||
=== Trac 關鍵詞 === | |||
有很多有固定意思的關鍵詞經(jīng)常在[http://trac.wordpress.org Trac]中使用; 一些可以通過[http://trac.wordpress.org/report Trac Reports]搜索。 | |||
;reporter-feedback : 提交人的回復是必需的。深入的調(diào)查如果沒有經(jīng)歷過問題本身的人的回復的話是靠不住的。 | |||
; | ;has-patch : 已經(jīng)附上ticket的解決方法,準備好再次檢查或者是提交。 | ||
; | ;needs-testing : 某人需要測試這個解決方案 | ||
; | ;2nd-opinion : 需要另外一個人來傳遞一個關于問題或者解決方案的觀點 | ||
; | ;dev-feedback : 需要開發(fā)人員的回復 (不常用) | ||
; | ;tested : 補丁測試過了. 當添加這個標簽時請加入測試的文件名字,補丁如何測試的,和使用了哪個WordPress版本(包括SVN版本號,如果不是官方發(fā)布的版本的話). | ||
; | ;commit : 補丁已經(jīng)被某個開發(fā)團體中可以信任的人檢查過,測試過; 這樣這個補丁就已經(jīng)準備添加到WordPress核心文件中了. | ||
; | ;needs-patch : ticket已經(jīng)被檢查過,發(fā)現(xiàn)描述為解決,但是標記為特別需要一個補丁,或者提交的補丁不能使用需要重新做 | ||
;needs- | ;needs-unit-tests : ticket已經(jīng)通過檢查,發(fā)現(xiàn)描述為解決,我們希望一個聯(lián)合測試,來測試功能性,因為提交前各種補丁的存在造成導致其他問題的風險很高。 | ||
;needs- | ;needs-doc : 需要代碼的內(nèi)嵌文檔。這可以是在它們被提交之前保存ticket單獨文件或者是帶有新函數(shù)補丁需要的文檔資料。 | ||
=== 錯誤解決方案=== | |||
Trac 中的ticket 在''open''狀態(tài)下開始,最終到''closed''。當一個ticket關閉后,它會被以下某個狀態(tài)之一標記: | |||
* 如果你的錯誤已經(jīng)提交到別的地方,它將以''duplicate''結(jié)束. | |||
* 如果錯誤在最新的版本代碼中已經(jīng)修正(可能不是你在運行的版本除非你有一個本地測試的blog),標記為''fixed''. | |||
* 如果確定你的錯誤事實上不是錯誤,而是你故意的行為,會標記為''invalid''. | |||
* 如果沒有其他人可以重現(xiàn)你所描述的現(xiàn)象,會以''worksforme''結(jié)束。 | |||
* 如果你的錯誤是一個功能請求,而開發(fā)人員不想讓它出現(xiàn)在核心代碼中,標記為 ''wontfix''. | |||
請驗證你的錯誤在提交時不屬于其中任何一種。 | |||
== | == 注 == | ||
* | * 你的錯誤的處理過程可能需要你的參與,希望你自愿并準備好幫助開發(fā)人員解決問題。 | ||
* | * 如果你的問題被解決為"Not a bug" 或者 "Won't fix"時不要生氣,看起來對你是錯誤的東西很可能是一種"功能". 這些解決方法只是意味這"現(xiàn)在不能解決", 可能將來會被解決的. | ||
* | * 感謝為WordPress做出的貢獻! | ||
# 點擊Trac中 '''[http://trac.wordpress.org/newticket New Ticket]''' 打開錯誤提交頁面。 | |||
# 在ticket頁面的如下區(qū)域填寫: | |||
# 簡短概要:使概要簡短的但是很具有信息化和準確性,象這個是在搜索結(jié)果中將被展示的ticket標題 | |||
# 全部描述:填寫 |
2008年5月27日 (二) 10:59的最新版本
導航: 上一級 | WordPress | 首頁 | WordPress中文論壇 | WordPress主機 | CMS程序 | 論壇程序 | ECShop | ShopNC | PowerEasy
每種軟件都有錯誤 – 只要是人寫代碼,軟件中就會有錯誤,有些錯誤是微不足道的,但是有些是非常嚴重的。開源項目如 WordPress 需要使用者的參與來找出軟件中的錯誤,同樣也包括新功能的開發(fā)。 所有類型的反饋— 不管是真正的錯誤還是有用的請求— 都在WordPress 中用同樣的方法提交。閱讀WordPress關于如何提交錯誤和問題的信息... 你可能會想要閱讀為WordPress做貢獻來找出如何為文檔資料和WordPress其他方面做貢獻。
提交安全問題[ ]
當我們試著防止出現(xiàn)安全問題時,我們不能認為它們不會出現(xiàn)。如果你相信你在WordPress某個版本中找到了安全問題,發(fā)郵件到WordPress.org上的security 區(qū)域,我們將盡力盡快解決。
通知賣主(這里是指WordPress開發(fā)人員)是在發(fā)布之前的安全問題的標準練習,這樣可以準備好修正版本,這造成的損失可以降低到最小。
提交插件和主題中的錯誤[ ]
如果你在使用時插件或者主題中發(fā)現(xiàn)了錯誤,不要 使用本文中的方法進行提交! 本文提供的方法只適用于WordPress核心文件的錯誤,不適合于插件和主題中的錯誤。
WordPress插件庫中的插件有一個來自 WordPress 核心的單獨的錯誤跟蹤系統(tǒng)。有一個如何使用這個系統(tǒng)的 單獨的說明。
對于不在官方庫中的插件和主題,查看其附帶的文檔資料作為關于如何提交錯誤的說明。如果沒有錯誤提交信息,你需要直接聯(lián)系作者。
錯誤提交和解決總覽[ ]
提交和解決WordPress錯誤的過程有幾步,這里是一個總的概括,下面可以找到更多細節(jié)。
- 用戶發(fā)現(xiàn)了錯誤,出現(xiàn)在WordPress核心文件中 (不在主題或者插件中).
- 用戶嘗試著確認這確實是一個錯誤。參見 提交錯誤之前(下面).
- 如果確定它是一個錯誤,用戶提交錯誤報告到Trac,叫做ticket,WordPress錯誤跟蹤系統(tǒng)。參見提交錯誤 (下面).
- WordPress 開發(fā)人員 (可能也是象你一樣的志愿者) 確認錯誤的確存在,然后它應該被修正。然后象在票上做記號那樣標記出來。參見Trac 關鍵詞列表(下面) 和 錯誤解決方案(下面).
- WordPress 開發(fā)人員 (可能是你)決定修復這個錯誤。開發(fā)者可能選擇通過點擊ticket底部附近的 Accept ticket操作來負責這個錯誤,盡管這不是必須的。然后開發(fā)人員指出如何修復這個錯誤,創(chuàng)建一個或者多個補丁,上傳到Trac. 參見 錯誤補丁(下面)。同樣的,如果你想要幫助修復錯誤,但是不知道需要修復哪個錯誤,參見找到錯誤并修復 (下面).
- WordPress開發(fā)小組成員(包括志愿者)測試補丁,查看是否錯誤被修復了而沒有影響到其他東西。它們添加評論和關鍵詞到ticket,顯示出它們的結(jié)果。參見 Trac 關鍵詞列表(下面).
- WordPress 開發(fā)員中的一個擁有修改官方WordPress源代碼權(quán)限的人(Matt Mullenweg, Ryan Boren, Mark Jaquith or Peter Westwood) 提交 補丁給SVN庫中的核心代碼。如果錯誤和補丁被他們所信任的某人驗證過后,他們會這樣做的。
- 最后,提交補丁的這個人設定ticket狀態(tài)為closed,結(jié)論是fixed。參見 錯誤結(jié)論(下面).
錯誤報告和解決方案的詳細內(nèi)容[ ]
下面的部分給上述的提綱添加了詳細內(nèi)容。
報告錯誤之前[ ]
如WordPress這么大的項目,如此多的使用者提交錯誤報告,很有可能你的錯誤已經(jīng)被提交過了,正因為這樣,檢查并確定系統(tǒng)中它還沒有被提交過是很重要的。如果你剛開始在WordPress中使用提交錯誤,在提交之前和有經(jīng)驗的開發(fā)人員討論這個問題是個好辦法。請按照下面的步驟。
- 在Trac中通過使用搜索或者是查詢來查找你的錯誤或者是功能請求。
- 如果你的問題已經(jīng)被提交過了,請不要重復提交。如果你有更深入的信息,登陸并添加信息記錄到已存在的錯誤中。
- 如果你的問題相似,但是不完全和另一個問題相同,你可以決定是否添加一個記錄到相似問題中,或者是重新提交。很難決定是否你的問題可以作為一個新的問題提交,但是通常情況下,如果你只是有更多信息來提交的話,打開問題,簡單的添加一個記錄就可以了。 如果你有個完全不同的問題,或者如果你正經(jīng)歷了一個重復的以前解決過的問題,可以提交一個新錯誤。
- 如果你的問題最近提交了也關閉了,但是你不同意這樣的解決方法,你可以重新打開ticket添加注釋,寫明你的理由。
- 想在Trac上在提交之前討論一個錯誤, (如判斷它是否是一個WordPress核心的而不是插件或者主題的錯誤),你可以在WordPress 支持論壇上發(fā)個帖子,在#wordpress IRC 頻道 討論你的問題,或者在檢測器 或Hackers郵件列表上參與郵件討論。
提交錯誤[ ]
Trac是官方WordPress錯誤跟蹤器的名字。它使用開發(fā)源碼跟蹤軟件Trac,它是 Edgewall Software的產(chǎn)品。安裝下面的步驟在Trac建立一個好的錯誤報告:
- 閱讀 [[WordPress:#Before You Report a Bug|提交錯誤之前(上面)]], 然后驗證你有一個新的可以提交的錯誤。
- 閱讀如何有效的提交錯誤這個文章,和Trac Ticket 文檔.
- 使用你的 using your 支持論壇的用戶名和密碼登陸WordPress Trac。如果你沒有帳戶, 注冊 一個這樣才可以登陸Trac。這隊伍你錯誤的交流是必需的。因為開發(fā)人員可能需要更多的信息(而你不能創(chuàng)建ticket 如果不登陸的話).
在新的ticket頁面上填寫如下信息:
- 簡單摘要
- 讓摘要簡短但是要包含信息并且準確,因為這是ticket的標題,將會顯示在搜索結(jié)果中。
- 完整的描述
- 填寫你的錯誤或者是功能要求的完整的描述。包括一個問題的描述,別人可以重復這個問題的步驟,也可以是一個錯誤的運轉(zhuǎn)的例子 (如 URL), 或者是一個為什么問題值得更正的描述。同樣包括關于你的平臺的信息,如操作系統(tǒng),網(wǎng)絡服務器軟件,PHP 版本, MySQL 版本, WordPress 版本。你描述的越好,解決錯誤的可能性就越大。
- Ticket 屬性
-
- 優(yōu)先級
- 你需要確定這個問題的優(yōu)先權(quán) – 這個錯誤有多緊急。除非它是一個致命的錯誤,最好是讓它保持默認狀態(tài),因為開發(fā)人員通常都是按照錯誤優(yōu)先級的排序來的。
- 組件
- 選擇發(fā)現(xiàn)問題所在的WordPress組件
- 嚴重
- 這個問題的重要性。選擇一個severity基于你認為這個問題有多嚴重,如果有疑問,就保持默認的Normal.
- 分配
- 如果你知道有負責存在錯誤的代碼的開發(fā)人員,把他們的Trac用戶名放在這里。你也可以自己為這個錯誤負責,把你自己的Trac用戶名放在這里就可以了。這是可以選擇的,這可以讓開發(fā)人員更快的注意到這個錯誤。
- 里程表
- 最遲在哪個版本這個問題會被解決。不要更改它。這是WordPress 開發(fā)人員設置的。
- 版本
- 錯誤發(fā)現(xiàn)的WordPress 版本。你可以在管理面板的頁腳找到WordPress版本號。
- 關鍵詞
- 關鍵詞讓開發(fā)人員更容易的找到錯誤所在,確定它的影響范圍。例如'posting', 一個涉及到WordPress發(fā)表文章機制的錯誤的關鍵詞。同樣,有標準關鍵詞用來標記你的錯誤的狀態(tài)(參見 [[WordPress:#Trac Keywords|Trac 關鍵詞]] 下面).
- CC
- 錯誤信息和更新信息發(fā)送的對象。如果你想保持可以被通知到,把你自己的Trac名字寫上。 當這個報告有任何更改的時候,你將會被郵件通知。不要忽視這些郵件; 做出任何改動后,確定查看一下報告更新。開發(fā)人員可能需要從你這里獲得更多的信息,這是他們與你聯(lián)系的唯一的方法。 注意: 你需要進入Trac 設置頁面來設置你的email地址。把他放到你的支持論壇個人資料里并不能讓你的資料進入Trac以達到接收CC信息的目的。
- 點擊 提交Ticket (預覽之后). 然后返回。
找到錯誤修正[ ]
如果你想修正WordPress核心部分的錯誤,但是不知道修正哪個,這里是一些關于如何找到修正的錯誤的建議:
- 仔細閱讀 需要關于Trac的補丁報告 (列出了沒有標出"has_patch"關鍵詞的錯誤), 缺乏關于Trac的附件報告 (列出了沒有補丁文件的錯誤),或者是其他對于看起來比較有趣的錯誤的 Trac 報告.
- 發(fā)送郵件信息到wp-hackers 郵件列表 詢問你能幫什么忙.
- 有時也有一些錯誤幫助在 #wordpress-dev IRC 頻道。
- 偶然在#wordpress-bugs上有錯誤日。你可以在錯誤搜尋上閱讀關于什么錯誤日發(fā)生了什么,并且預定wp-hackers或者是 wp-testers 郵件列表來找出它們是什么時候出現(xiàn)的。
- 考慮加入wp-trac 郵件列表 來參與關于每個Trac Ticket的討論。
打補丁[ ]
如果你熟悉PHP和 MySQL,并且想幫助WordPress發(fā)展,那么我們鼓勵你為WordPress 的錯誤打上補丁。如下是打補丁的步驟:
- 閱讀 找到錯誤修正(上面), 然后在Trac中找到錯誤并修正
- 使用你注冊的用戶名和密碼連接到WordPress Subversion (SVN) Repository,閱讀 使用子版本,如果你對SVN不熟悉的話。所有的補丁都會被提交的SVN,而不考慮最新的代碼。
- 找出如何通過修改WordPress核心文件修正錯誤。你可能想在結(jié)束之前在wp-hackers 郵件列表上討論你的解決方案。
- 測試你的修改,驗證錯誤已經(jīng)被修正,而且在此過程中沒有其他的WordPress內(nèi)的東西被破壞。
- 創(chuàng)建一個包含你的修改的補丁文件。這完全與修正文件和SVN中的源文件不同。參見如何為WordPress打補丁 by Owen Winkler獲得詳細說明。有Linux/Mac 的說明,Mark Jaquith 的工具書中的命令行使用者,和Westi的Blog中Windows Tortoise SVN 的使用者.
- 使用Trac的 Attach file 按鈕上傳到ticket,添加 has-patch到關鍵詞中。如果補丁需要測試,你可以把needs-testing也添加上,或者其他的Trac 關鍵詞; 參見 Trac 關鍵詞 (下面) 獲得更多信息。
Trac 關鍵詞[ ]
有很多有固定意思的關鍵詞經(jīng)常在Trac中使用; 一些可以通過Trac Reports搜索。
- reporter-feedback
- 提交人的回復是必需的。深入的調(diào)查如果沒有經(jīng)歷過問題本身的人的回復的話是靠不住的。
- has-patch
- 已經(jīng)附上ticket的解決方法,準備好再次檢查或者是提交。
- needs-testing
- 某人需要測試這個解決方案
- 2nd-opinion
- 需要另外一個人來傳遞一個關于問題或者解決方案的觀點
- dev-feedback
- 需要開發(fā)人員的回復 (不常用)
- tested
- 補丁測試過了. 當添加這個標簽時請加入測試的文件名字,補丁如何測試的,和使用了哪個WordPress版本(包括SVN版本號,如果不是官方發(fā)布的版本的話).
- commit
- 補丁已經(jīng)被某個開發(fā)團體中可以信任的人檢查過,測試過; 這樣這個補丁就已經(jīng)準備添加到WordPress核心文件中了.
- needs-patch
- ticket已經(jīng)被檢查過,發(fā)現(xiàn)描述為解決,但是標記為特別需要一個補丁,或者提交的補丁不能使用需要重新做
- needs-unit-tests
- ticket已經(jīng)通過檢查,發(fā)現(xiàn)描述為解決,我們希望一個聯(lián)合測試,來測試功能性,因為提交前各種補丁的存在造成導致其他問題的風險很高。
- needs-doc
- 需要代碼的內(nèi)嵌文檔。這可以是在它們被提交之前保存ticket單獨文件或者是帶有新函數(shù)補丁需要的文檔資料。
錯誤解決方案[ ]
Trac 中的ticket 在open狀態(tài)下開始,最終到closed。當一個ticket關閉后,它會被以下某個狀態(tài)之一標記:
- 如果你的錯誤已經(jīng)提交到別的地方,它將以duplicate結(jié)束.
- 如果錯誤在最新的版本代碼中已經(jīng)修正(可能不是你在運行的版本除非你有一個本地測試的blog),標記為fixed.
- 如果確定你的錯誤事實上不是錯誤,而是你故意的行為,會標記為invalid.
- 如果沒有其他人可以重現(xiàn)你所描述的現(xiàn)象,會以worksforme結(jié)束。
- 如果你的錯誤是一個功能請求,而開發(fā)人員不想讓它出現(xiàn)在核心代碼中,標記為 wontfix.
請驗證你的錯誤在提交時不屬于其中任何一種。
注[ ]
- 你的錯誤的處理過程可能需要你的參與,希望你自愿并準備好幫助開發(fā)人員解決問題。
- 如果你的問題被解決為"Not a bug" 或者 "Won't fix"時不要生氣,看起來對你是錯誤的東西很可能是一種"功能". 這些解決方法只是意味這"現(xiàn)在不能解決", 可能將來會被解決的.
- 感謝為WordPress做出的貢獻!
- 點擊Trac中 New Ticket 打開錯誤提交頁面。
- 在ticket頁面的如下區(qū)域填寫:
- 簡短概要:使概要簡短的但是很具有信息化和準確性,象這個是在搜索結(jié)果中將被展示的ticket標題
- 全部描述:填寫