假如你没有贡献免费源代码的想法,就不用继续读本文了。:)
如果读者的e文不错,作者建议你直接阅读sourceforge的howto文档,他们整理得非常周到详实。本文只是作者的使用经验,也许可以给与作者一样e文不好的人一点帮助吧。
1 为何申请sourceforge项目?
一切都从你有了贡献免费源代码的想法开始。(至于你是如何产生这个古怪的念头,估计没有人感兴趣。)你的项目才刚刚在冒出你的头脑,你希望与人合作开发;或者你已有了可以拿出来的东西,你希望很多人关注它。这时候,需要找到一个集中地,那里人气很高,挤满了寻找代码和散发代码的人们。Yes,soureforge就是这么个场所,一个没有money味道的地方,一个人人都希望别人从自己这里拿走东西的奇怪市场。这个乐园可以为奉献者们提供以下便利:
人气。它是知名度最大的免费代码仓库,许多著名的免费软件是在这里诞生的,你可能早已享受到它们带来的便利。
网络空间。一旦你的项目申请成功,你可以无限使用它的网络空间。(不要滥用这个权利,多数人都不会比这个网站的管理者聪明)
在线的项目管理资源。例如,专门用于你的项目的:宣传信息、访问统计信息、下载列表、主页、消息显示、错误报告列表、需求申请列表、补丁列表、公共论坛、文档管理、邮件列表、任务管理、CVS仓库等等。这是一个非常成熟的项目管理框架,你将随着项目一起成熟,并且体会到奉献的乐趣。
捐献。你可能得到捐献,同时也可能为其它项目捐献。
你应该了解:申请的sourceforge项目必须提供源代码,而可执行码可以不提供。
2 怎么申请sourceforge项目?
实施以下步骤,你可以申请sourceforge项目:
访问这个网址:https://sourceforge.net/
申请一个帐号。你将为自己的帐号指定一个邮箱地址,将来的确认、通知都将通过这个邮箱。
申请你的项目,应当明确知道每一步的含义。
你都将收到至少2个e-mail,一个是确认注册,一个告诉你是否批准。
当你的项目被批准时,你将收到相应的e-mail,告诉你与项目相关的信息,例如:
Project Descriptive Name: Software Engineering Environment
Project Unix Name: chong2see
CVS Server: cvs.sourceforge.net
Shell Server: shell.sourceforge.net
Web Server: chong2see.sourceforge.net
以及其它管理项目的信息。
3 管理你的sourceforge项目的主页
一旦你的项目被批准,你将拥有100M的网页空间,用于存放与此项目有关的资源。如果不够,你可以向管理员申请,如何理由合适,也许可以被批准。项目的可供下载资源(源码、可执行码、文档等)应该利用Sourceforge的文件发布系统,那里的空间可以无限制使用。
你的项目主页的地址是:"项目名.sourceforge.net"。你可以利用这个网址来宣传项目、提供项目信息等等。
网站页面的编写是你自己的事。你可以使用mysql和php。
应当在你的网页中加入sourceforge的图标和捐献的图标。它们的html连接文本在你的项目说明里有。
当你的网站编写完毕,需要上传文件到你的网站空间。sourceforge推荐下载putty套件,它也是免费项目,网址为:http://www.chiark.greenend.org.uk/~sgtatham/putty/ ,你至少要下载psftp.exe和putty.exe。
假设你的sourceforge帐号是"myaccount",你的项目名是“thisproject”,则利用putty套件上传网站文件的步骤如下:
将你的所有文件打成一个zip包(或者tar包),例如是“myweb.zip”,将它放在psftp.exe所在的目录下。
执行psftp.exe
输入你的shell地址:“open myaccount@shell.sourceforge.net”,回车输入你的帐号密码,回车。你将进入你的shell目录,即“/home/users/m/my/myaccount/”
进入你的网站目录,即:“cd /home/groups/t/th/thisproject/”
输入上传命令:“put myweb.zip”上传完毕后,解开zip包:“unzip myweb.zip”。
请注意,你的网站目录下有两个子目录,一个用于放静态页面,是"htdocs",一个用于存放cgi,是“cgi-bin”。你的网站文件应该具有这种目录结构。如果全是静态页面,就把zip包上传到htdocs子目录下解开。
putty.exe用来干什么呢?它是ssh客户端,登录后你可以执行命令。登录方法跟用psftp.exe一样。
4 发布你的sourceforge项目的版本
你应当用sourceforge的文件系统来发布项目的可供下载资源(源码、可执行码、文档等),那里的空间可以无限制使用。
发布版本有两个步骤:首先是上传你的文件,然后是定义新版本。
上传项目文件是匿名的!大家共用一个上传目录,不能删除已上传文件。如果在24小时内,文件没有被任何项目“认领”,则被自动删除。
ftp地址是upload.sourceforge.net,用户名是匿名,即“anonymous”,口令是你的邮箱地址。登录后,进入“incoming”子目录上传。你可以使用cuteftp之类的软件。
上传完毕后,你必须尽快定义新版本,来“认领”你的文件。
假设你的项目是“myproject”,则你的sourceforge项目管理页面为“https://sourceforge.net/projects/myproject/”。作为管理者,你可以使用所有项目管理功能。
发布文件版本的方法是:
点击项目管理页面上部的"Admin",然后点击"File Releases",则可进入文件发布系统
在页面底部,显示项目的包列表。项目缺省有一个包,名字就是项目名。如果你的项目可以分解成子项目,可以添加包名。
点击包名旁边的“add releases”,添加后再编辑它。你可以看到那个公共目录下当前所有未被“认领”的文件名,请选择你自己的文件。
这种上传机制相当有趣!相当科学!
这里先介绍这些。管理sourceforge项目还有很多内容,尤其对于多个成员参与的开源项目,cvs仓库和bug列表之类的设施都应由管理员认真配置。