====== 如何贡献我的源代码 ====== 此文档介绍了Typecho团队的组成以及运转机制,您提交的代码将给Typecho项目带来什么好处,以及如何才能加入我们的行列. ===== 通过 Github 贡献代码 ===== Typecho 目前使用 [[http://git-scm.com/|Git]] 来控制程序版本,如果你想为 Typecho 贡献源代码,最好先弄明白 [[http://git-scm.com/book/zh|Git 的使用方法]]。我们目前把项目托管在 [[http://github.com/typecho/typecho|GitHub]] 上,任何 GitHub 用户都可以向我们贡献代码。 参与的方式很简单,【Fork】一份 Typecho 的代码到你的仓库中,修改后提交,并向我们发起【Pull Request】申请,我们会及你的申请并及时对代码进行审查。审查通过后,你的代码将被【Merge】进我们的仓库中,这样你就会自动出现在[[https://github.com/typecho/typecho/graphs/contributors|贡献者名单]]里了,非常方便。 **我们希望你贡献的代码符合:** - [[http://docs.typecho.org/phpcoding|Typecho 的编码规范]] - 适当的注释,能让其他人读懂 - 遵循 GPL v2 协议 ===== 第三方包集成规则 ===== 在Typecho中,所有的程序文件以包(package)形式组织。我们亦集成了一些优秀的第三方开源包,向Typecho贡献包文件是最常见和容易的实现方式。我们对包文件的集成方式采用如下两种方案: - 对于可以直接独立使用的包,我们会直接放在**/var**目录下,供程序直接使用。比如**IXR**包。 - 对于需要整合才能使用的包,我们会集成到**/var/Typecho**目录下,作为Typecho包的一个子集。比如**Feed**和**I18n**包,它们都是被我们扩展或修改后使用的。 不论是否会被我们修改,我们都将遵循第三方包的发行协议,并保留作者版权(如果有的话),我们将在文件头部声明出处。并尽可能得保留程序注释与代码风格。对于经过修改的包,我们会标注我们修改的地方。