为 Pygments 贡献

感谢您对贡献的兴趣！请阅读以下指南。

许可

代码是在 BSD 2 条款许可下发布的。贡献者提交 pull 请求必须同意他们能够并且愿意将他们的贡献放在该许可下。

一般贡献清单

• 查看文档以了解如何编写 新的词法分析器，新的格式化程序，新的样式 或 新的过滤器。如果添加词法分析器，请确保您已阅读 常见陷阱和最佳实践。

• 使用 tox 运行测试套件，并确保通过。

• 确保为您的新功能添加测试，并在适用时编写文档。

• 使用标准导入约定：from token import Punctuation

Pygments 的目标和非目标

Python 支持

Pygments 支持所有受支持的 Python 版本，如 Python 开发人员指南 所述。此外，还支持 RHEL、Ubuntu LTS 和 Debian 最新稳定版本的默认 Python 版本，即使它们正式已结束生命周期。支持其他已结束生命周期的版本不是 Pygments 的目标。

验证

Pygments 不会尝试验证输入。接受对给定语言而言不合法代码是可以接受的，如果这简化了代码库并且不会导致意外行为。例如，在 C89 中，接受 // 样式的注释是可以接受的，因为实际上所有编译器都支持它，并且为它创建单独的词法分析器不值得。

语言支持

虽然我们力求尽可能广泛地支持语言，但我们无法支持地球上每一种编程语言。我们的最低标准相当低，但为了避免宠物项目和其他一次性语言，我们期望任何提议包含的语言都应该有相当规模的社区。如果您需要为您的内部编程语言或您启动的全新语言项目编写语法高亮器，请考虑编写一个 插件，直到它获得足够的流行度。