内容

参与贡献

如果您想参与 Apache Tomcat® 的开发和支持,有许多不同的方式可以贡献。第一步是加入邮件列表。以下只是您可以提供帮助的几个领域

  • 回答发布到邮件列表的问题。
  • 常见问题维基做出贡献。
  • 贡献其他文档补丁,无论是用于网站还是 Apache Tomcat 用户文档。
  • 调查已报告的错误并在适当的时候提供补丁。
  • 帮助将 Apache Tomcat 中的消息和 Web 应用程序翻译成其他语言。
  • 帮助开发 Servlet 和 JSP 规范的下一个版本。
您还应该阅读Apache 如何运作

贡献更改

如果您想开始贡献更改,那么第一步是检出源代码并构建 Apache Tomcat。有关您想使用的 Apache Tomcat 版本的详细说明,请参阅文档区域中的“构建”页面。

在做出贡献时,请尽量减少不必要的或不相关的更改(例如格式)。Apache Tomcat 有许多贡献者,能够比较整个源代码历史中的更改非常重要。进行小的渐进式更改并遵循现有源代码的约定,将大大增加您的补丁被接受的可能性。

一旦 Apache Tomcat 启动并运行,Apache 贡献者技术指南是学习如何创建和提交补丁的好地方。

编码规范

Apache Tomcat 的编码规范定义得非常宽松,但以下指南会很有用
  • 使用空格而不是制表符进行缩进
  • Java 源代码行宽 120 字符,文档源代码(.txt、.xml)行宽 80 字符
  • Java 源代码:{ 在行尾,4 个空格缩进
  • XML 源代码:2 个空格缩进

翻译

Tomcat 项目使用 POEditor 管理翻译。

要为 Tomcat 的翻译做出贡献,您需要加入 POEditor 上的 Tomcat 翻译项目。任何人都可以加入 Tomcat 翻译项目。

加入项目后,您可以查看翻译并开始贡献您自己的翻译。如果您在未加入项目的情况下尝试查看,将会收到错误。

有关如何将翻译从 POEditor 导入到 Tomcat 的详细信息,请参阅维基