回報程式錯誤

在您提交新的錯誤報告之前...

  • 請確認您可以重現這個問題,並找到觸發問題的必要步驟

    如果可以的話,建議使用空白的檔案(可以在之後作為測試檔案),也試試在重設 Inkscape 偏好設定(如何重設)之後重現問題。這樣可以讓您確認,問題點與您預想的一樣,而非由特定的程式設定造成。如果您無法重現問題,可以在回報之前試著將問題獨立出來。

    有的時候只在特定檔案中才會出現的問題(但在新檔案中不會發生)會引起開發者的興趣。但如果您剛使用不久,建議您在提交錯誤報告之前先與熟悉 Inkscape 的使用者在論壇、郵遞清單或聊天室中討論這個問題。如果您遇到不知道是否為程式錯誤的狀況,也可以先與其他使用者討論。下方有更詳細的說明。

  • 搜尋 GitLab 上的問題追蹤管理系統(下方有連結與操作指南)。在回報之前請先試著確認該問題沒有被回報過。

    還有,可以檢查「已關閉」分頁,因為錯誤報告的關閉可能意味著下列三種情況之一:
    1. 錯誤已經被排除
    2. 錯誤已被確認並移動到開發者的問題追蹤系統,但還沒被排除
    3. 錯誤已經被回報過不是錯誤,或是因著某種原因是無效的。

    如果已經有人提交了錯誤報告,如果您有可能有用或是新的資訊,可以在既有的報告下面新增留言。如果您沒有其他資訊可以新增,但想表明這個問題對您來說很重要,可以按下問題敘述下方的大拇指按鈕來示意。(請避免留下「我也是」等留言,因為這會讓開發者更難找到技術相關的資訊)。

    如果您找到相關錯誤報告,可能可以協助開發者排除問題,您可以幫我們在錯誤報告中連結該報告。要是您提交了新的錯誤報告,請記得寫明這個問題跟其他報告中的問題有什麼不同。

每份錯誤報告都必須具備的資訊

  • 精準的問題敘述(精簡明瞭,但包含所有重要的細節),使用英文書寫,像是:

    • 重現問題的詳實步驟
    • 程式呈現的反應
    • 程式應該出現的反應

    如果您想學習如何撰寫「良好的」、對開發者有助益的錯誤報告,可以看看這篇見解深刻、由 PuTTY 的作者 Simon Tatham 著作的文章 How to Report Bugs Effectively (如何有效地回報問題)。

  • 關於您這份 Inkscape 安裝作業系統的資訊,可以透過開啟說明 > 關於 Inkscape 對話窗後,按下右下角的蟲子按鈕來複製。複製之後請貼上(Ctrl-V 或 Cmd-V)在回報表單的相關位置。如果您知道哪些版本 沒有 這個問題,也可以一併提出。

錯誤報告可以提供這些選擇性的資訊,有助於開發者瞭解問題

  • 測試用 SVG 檔案,只包含能展示問題的所有東西(minimal example / testcase)
  • 同樣的檔案,但用不同格式儲存,如果問題跟開啟、儲存、匯入或匯出 SVG 以外的檔案格式有關

  • 螢幕截圖、影片或動畫可以用來展示問題看起來如何,以免測試用檔案不合適、或是本身無法完全展現問題。也可以提供其他種類的問題展示,像是「之前/之後」截圖。
  • Inkscape 使用者介面與系統的語言(特別是當錯誤與翻譯或是檔案、檔名中的特殊字元等有關)。

  • 您的安裝方式安裝程式版本,如果問題跟安裝、更新或執行 Inkscape 有關

這些資訊哪裡重要?

因為開發者在開始排解問題之前,必須能夠重現它。在 Inkscape 中,錯誤可能只會發生在特定版本、特定作業系統、特定語言,或是以上這些的組合。雖然測試檔案視情況不一定有必要,但回報者可以盡量提供相關資料,讓開發者能更輕易幫助您。

要知道,所有 Inkscape 開發者都是志願者。他們使用閒時間開發 Inkscape,在他們的工作、玩樂、家庭與個人時間之後。任何回報者做的事情,只要能減輕他們負擔,都能增加錯誤被排解的機會。

回報者的其他責任

  • 在開發者需要更多資訊時保持聯絡。
    在有人張貼留言,或是更新錯誤報告的類別、排序、等第時,您會收到電子郵件通知。您可能會收到需要澄清一些事情,或是提供其他檔案、圖片或文件的要求。記得,任何您做的、可以幫助開發者的事情,都會增加成功排解問題的可能性。
  • 要有耐心,並抱持希望。
    當您回報問題,肯定希望問題可以被修復。我們也是!然而 Inkscape 是由志願者在休閒時間開發的,要有人處理您的報告需要一些時間(介於幾小時跟幾年之間)。無論如何,可以的話盡量對開發者們和善一點(就算他們有時候會有點無趣 ;) ),這樣能讓大家比較有動力繼續修復這個問題,解決的速度也會比較快。

提交錯誤報告,或是請求新功能

請回報任何您在目前 Inkscape 版本中發現的錯誤,到全新、使用者導向的 GitLab 錯誤追蹤管理系統

註:您需要先註冊 GitLab 帳號,才能在那裡張貼留言或建立新議題(問題)。

如果您是剛來 Inkscape、或是資歷不深的使用者,可以先詢問社群關於您目前遇到的問題,進行更直接的討論。其他志願者常能告訴您這是不是已知的問題,或者這是不是個錯誤。如果是已知的錯誤,可以在錯誤追蹤系統中查閱該錯誤報告,瞭解更多細節。也許在討論的過程中,可以學到一些替代辦法。

新功能請求或是願望清單也可以提交到錯誤追蹤系統上。但一樣,如果您是新的 Inkscape 使用者,建議先與社群談談您的想法、更深入地了解提議能用哪些方式融入開發者的願景,再提交您的報告/請求。