这是本文档旧的修订版!
如何贡献我的源代码
此文档介绍了Typecho团队的组成以及运转机制,您提交的代码将给Typecho项目带来什么好处,以及如何才能加入我们的行列.
获得SVN提交权限
Typecho目前使用SVN来控制程序版本,如果你想为Typecho贡献源代码,最好先弄明白SVN的使用方法。我们目前把项目托管在google code上,google code把开发人员分成项目所有者和项目成员两种身份,他们都可以向SVN提交代码。因此如果你想向Typecho的SVN提交代码必须具备以下条件
- 必要的职业技能水平,不一定是PHP,我们也需要前端工程师和设计师,以及文档撰写者。
- 在社区有一定的活跃度。这一点非常重要,我们需要了解你的想法,以及是否有精力与实力参与到我们之中。更重要的是我们是否志同道合。
- 热衷于开源软件事业
- 一个google的帐号:)
如果你觉得自己具备了这些条件,又迫不及待地想加入到我们之中,请立即向developer[at]magike[dot]net(请将[at]替换为“@”,将[dot]替换为“.”)提交你的请求,所有项目开发者将会看到你的请求,我们将尽快组织人员对你的请求给予答复。邮件请按以下格式撰写:
- 真实姓名
- 网上常用ID
- 常用电子邮件
- blog地址
- Google帐号
- 希望从事的工作
- 自我介绍
第三方包集成规则
在Typecho中,所有的程序文件以包(package)形式组织。我们亦集成了一些优秀的第三方开源包,向Typecho贡献包文件是最常见和容易的实现方式。我们对包文件的集成方式采用如下两种方案:
- 对于可以直接独立使用的包,我们会直接放在/var目录下,供程序直接使用。比如IXR包。
- 对于需要整合才能使用的包,我们会集成到/var/Typecho目录下,作为Typecho包的一个子集。比如Feed和I18n包,它们都是被我们扩展或修改后使用的。
不论是否会被我们修改,我们都将遵循第三方包的发行协议,并保留作者版权(如果有的话),我们将在文件头部声明出处。并尽可能得保留程序注释与代码风格。对于经过修改的包,我们会标注我们修改的地方。