貢獻至 Pygments

感謝您有興趣貢獻！請閱讀以下指南。

授權

此程式碼以 BSD 2 條款授權發布。提交 Pull Request 的貢獻者必須同意他們有能力且願意將其貢獻置於該授權之下。

一般貢獻檢查清單

• 請查看文件，了解如何撰寫新的詞法分析器、新的格式器、新的樣式或新的篩選器。如果新增詞法分析器，請務必閱讀常見的陷阱和最佳實務。

• 使用 tox 執行測試套件，並確保它通過。

• 請務必為您的新功能新增測試，並在適用的情況下撰寫文件。

• 使用標準的匯入慣例：from token import Punctuation

Pygments 的目標與非目標

Python 支援

Pygments 支援根據Python 開發者指南所列的所有受支援 Python 版本。此外，RHEL、Ubuntu LTS 和 Debian 最新穩定版本的預設 Python 版本也受到支援，即使它們已正式終止生命週期。支援其他終止生命週期的版本並非 Pygments 的目標。

驗證

Pygments 不會嘗試驗證輸入。如果可以簡化程式碼庫，且不會導致令人意外的行為，則接受對於給定語言來說不合法的程式碼是可以接受的。例如，在 C89 中，接受基於 // 的註解是可以的，因為事實上所有編譯器都支援它，而且為此設立單獨的詞法分析器是不值得的。

語言支援

雖然我們力求盡可能廣泛地支援語言，但我們無法支援地球上的每種程式語言。我們的最低門檻相當低，但為了避免個人專案和其他一次性的語言，我們希望任何提議納入的語言都能有相當規模的社群圍繞著它。如果您需要為您的內部程式語言或您啟動的全新語言專案提供語法醒目提示，請考慮撰寫外掛程式，直到它獲得足夠的普及度。