入门与一个SourceForge项目
简介
这将简要地走过我的一些经验与主办的项目上工作，以及如何使用的各种工具，在SourceForge穿在您的处置，除了简要介绍了如何使用一些更常用的命令行工具。
SourceForge上提供免费的托管符合开源许可的任何项目（即GPL，LGPL，BSD的[]我最喜欢的，公共领域，艺术，麻省理工学院等）。要创建一个新的项目您只需一个新的项目要求。大多数项目都立即批准，并通常，你会收到一封电子邮件通知您〜24小时的批准（如果你上周末开始登记）。一旦你已经得到批准，它需要所有服务的另一6-12小时去"活"为您project.nbsp;
一旦你有你的项目，你现在有一个广泛的服务提供给您 - 这是使用SourceForge上很爽的一部分！在这些服务包括:CVS的托管网络hostingnbsp;通过MySQL数据库支持（每个项目允许一个单一的数据库，与尽可能多的表，因为他们想要）。Bug跟踪功能要求追踪任务跟踪跟踪和组织您要分发到市民的各种文件的文件版本的支持。一个文档管理农场建设替代编译器的源代码编译器的访问（如果这件事）项目shell访问
大部分是相当简单的使用，但是有些事情是需要一些技巧，如果你是基于Win32的系统工作。 SourceForge上，希望您使用的工具，许多传统的基于Unix / Linux命令行工具，因此可能会有点怪习惯。例如，SourceForge上壳和CVS仓库的所有访问通过使用完成后，再次FTP访问加密的替代品。得到这个工作在Win32平台上，可能需要调整位。ssh和scp
首先，在你做任何事情（假设你会做大部分，如果不是所有从Win32系统的工作），得到。这提供了一个非常有用的命令行工具，使SourceForge上轻松许多工作一大堆。此外，Cygwin的安装程序会自动配置正确的系统，并采取了很多苦差事设置了。 Cygwin提供的主要工具（从本文的角度看）:SSH使整个UNIX兼容的层，可以帮助使用其他基于UNIX的方案大大增强的命令行shell（称为bash，或者伯恩再次壳牌），简单的节拍与Windows.nbsp使用默认的CMD.EXE的裤子脱了;
将让你挑选它安装 - 我的建议是，现在只使用默认值，你可以随时再次运行它，并拿起额外的程序后。
一旦事情要注意 - 本文介绍使用命令行工具的技术。虽然可能有一些命令行工具的GUI工具当量（SSH），我的建议是只吸它，不打它，放松，并了解命令行！有很多很多的东西，你可以用它做，这是令人难以置信的强大，和你稍后，你会很高兴。首先，这可能是令人沮丧的，但是（恕我直言），这是非常值得的努力，特别是如果你的项目开始规模。此外，许多这些相同的工具/技术是用在其他的操作系统，除了Win32的，所以你会获得一些宝贵的经验。
一旦安装了Cygwin是，让我们确认您可以访问你的SourceForge项目的shell帐号。你需要能够做到这一点，开始添加网页内容。因此，开始通过启动GT的Cygwin的bash程序GT; Cygwin的GT; Cygwin的bash shell的。
然后键入（我们假设我们的SourceForge用户名是新的）:SSH - L新shell.sourceforge.net
如果这是您第一次，你会看到类似的信息:主机的真实性"shell.sourceforge.net（66.35.250.207）"不能成立。DSA密钥指纹是02:AB:7C:AA:49:ED:0B:A8:50:13:10:C2:3E:92:0 f:42。你确定要继续连接（是/否）吗？
键入yes，然后您会提示您输入密码。输入并回车。
你应该看到整个文本的旗帜滚动，最后一个提示，像这样:新@ SC8 - PR - shell1:〜$
，此时，您已登录！如果你没有达到这一点，那么你可能有网络问题，如放火墙不会让通过，etc.nbsp;
一旦你可以访问的东西你的主目录和工作，或者，你可以移动你的项目目录。项目组织（至少在目前，在SourceForge可能改变这种更高版本）下/家庭/团体/公升;项目namegt你的第一个字母; /公升;项目namegt的前两个字母; /公升;项目namegt;。例如，VCF项目下/家庭/团体/ V / VC / VCF。为您的网站的根目录是在项目的根目录下的htdocs（再次使用VCF的例子，VCF的网站是在/ home / / V / VC / VCF / htdocs中组）NBSP。
SSH是用于什么，你将不得不用telnet，和是多少，更安全。 ，另一方面，SCP的，是安全的FTP相当于。使用scp，你可以复制文件从另一个远程位置，使用相同的加密技术，SSH使用。因此，要复制一个文件到你的home目录，你会类型（再次，假设新是您的用户名）:
SCP some_file.txt neo@shell.sf.net:/ /用户/ N / NE /新/
敲回车，会提示您为您的密码，输入你的文件将被复制。
同样复制一个文件从远程位置，从项目的网站上说，到当前目录:SCP neo@shell.sf.net:/首页/团体/ V / VC / VCF / htdocs中/ index.html的/
如果你有很多文件要上传，可以考虑使用创建一个压缩归档，使用scp上传档案，然后，使用ssh，解压缩和提取在项目中的shell帐号的存档。例如，可以说，我们要抢我们的当前目录中的所有HTML文件:焦油比照myhtmlfiles.tar *. HTMLGZIP myhtmlfiles.tarSCP myhtmlfiles.tar.gz neo@shell.sf.net:/ home.groups / V / VC / VCF / htdocs目录
这创造了一个tar文件，用gzip压缩，然后复制它到我们的网站directory.ssh - L新shell.sf.net{正常输入密码}CD /家庭/团体/ V / VC / VCF / htdocs目录焦油ZXF myhtmlfiles.tar.gzRM myhtmlfiles.tar.gz退出
登录到我们项目的外壳帐户，我们去的项目web目录，并提取我们以前上传的所有HTML文件。然后，我们去掉了myhtmlfiles.tar.gz文件，然后注销（exit命令）。CVS
确定，所以我们围绕我们的SourceForge项目下载/上传文件的基础。现在，我们需要得到一个跟踪我们的源代码的感觉。为此，我们使用CVS，这是SourceForge上提供的版本控制系统。传统上来说，CVS一直是一个命令行工具。最近，出现了一批项目，为它提供像Windows平台上的某种GUI的。然而，由于SourceForge上加密访问CVS服务器使用SSH，一些CVS GUI工具，不能很好地工作（至少在我的经验事实，如果有人知道更好，我很高兴听到它），所以你最好还是简单地学习命令行工具，它坦率地说并不难。
在我们开始之前，尽管我们必须确保CVS懂得如何使用SSH连接。确保您有以下环境变量设置（注意，我通常将它们设置在用户变量，但是他们应该工作equyally以及系统变量）。
可变价值CVS_RSHSSHCVSROOT:分机:LT; usernamegt cvs.lt;项目namegt; sf.net:/ cvsrootlt namegt项目;
LT; usernamegt;是你的SourceForge的用户名和LT;项目namegt;是该项目的UNIX名称 - 你指定当您注册SourceForge.nbsp项目;作为一个例子，让我们说，作为致力于注册"agent_smith"和我们的项目名称是"魁梧男子"，和我们的UNIX名称是"burlyman"。我们的CVSROOT需要阅读:
:分机:agent_smith@cvs.burlyman.sf.net:/ CVSROOT / burlyman
获得这项权利是至关重要的，能够连接与您的项目的CVS资源库的读/写访问。这也节省了您不必键入出每个cvs命令使用命令行的这一切。
在一般使用CVS的是不是太困难。最常见的事情，你要签出文件，检查，更新文件，或者检查它们的状态。您还可以做一个伟大的NBSP的东西像合并，标签等。
一旦你有你的初始源文件准备你有一个选择:你可以手动添加它们，或使用cvs import命令导入整个目录（和任何子目录）中的一杆。只需添加文件/目录，为您提供了更大的控制权，但进口简单。不过，如果你将得到添加到进口，请注意，它会试图把一切入到源代码控制 - 所以，如果你刚才编译你的代码，你有.obj / .lib / .pdb等各种，躺在围绕这些资源库，以及所有源代码！因此，在使用进口（如果您选择使用它）要小心清理任何文件的子目录，你不想签入，也有些人认为您的目录布局和命名。大多数CVS服务器上运行的Unix / Linux操作系统和他们的文件系统是大小写敏感的。显然，在Win32平台上，这是不是这样的，所以很容易得到不小心意外有一个目录名称为"foo"你的意思是名称为"foo"。这将导致一些shell脚本失败神秘因为脚本可能期望小写的目录（"foo"的）时，它实际上是大写（"富"）。尽管CVS的说，你可以删除目录，在现实中，它不似乎工作。所以，如果你导入/添加一个错误的名称的目录，你需要打开与SourceForge上的事件，并要求管理员为您重命名的目录（这通常需要2-3天发生，至少在我的经验）。
让我们看一些例子（注意，CVS的使用总是CVS LT; commandgt; [选项] [文件名]）
导入:
CVS进口- M"一些messagequot; foobar的主要启动
- M是使用这个初始导入的消息，foobar的是将CVS存储库中创建的（注意，这是可以完全不同的目录比你目前在顶级目录的名称）主要供应商的标签（它可以是任何），并开始释放标签（它可以是任何东西，看到更多信息）。一旦你点击进入，你会被提示输入密码，然后CVS将在当前目录开始，简单地导入到repository.nbsp找到一个文件和子目录;
添加文件:CVS添加foobar.h foobar.cpp
添加foobar.h和foobar.cpp - 注意，同样，这也是区分大小写 ！
添加目录:CVS添加小部件/CD小部件CVS添加*. h *. CPP
这增加了Widget的目录，然后CD的部件目录，并添加所有。cpp和h的文件。据我所知，也没有办法添加一个目录，并在一个步骤中所有的文件。
添加二进制文件:使用cvs add - kb的FooAppIcon.bmp FooDocIcon.png
这将增加FooAppIcon.bmp和FooDocIcon.png文件，并告诉cvs服务器，它们是二进制文件。这是非常重要的，因为CVS默认情况下，假定一切是文本文件andnbsp; cannbsp;合并。告诉CVS处理二进制文件（KB的选项），它不会试图合并文件，也将尝试执行的CR / LF翻译。
检查CVS CI foo.h的文件:
这将检查文件中foo.h. CVS会自动尝试打开一个。一旦您将更改保存到六中打开文件，CVS将继续它的检查过程中。注意:如果您没有在VI消息文件的变化，CVS会提示您，警告您输入的任何消息都希望重试和编辑的消息，继续或中止检查英寸
目录中的检查:CVS CI的src / include /
这将在Src检查，包括目录（和任何子目录）them.nbsp的所有文件;
如果您在为您的项目的顶层目录，您可以检查一切都已经改变一次:CVS CI
这将检查所有在当前目录和任何子目录。
更新你的代码:cvs更新
这将更新现有的文件，如果可能的情况下，合并的变化。如果已添加新的文件，那么更新将创建新的文件。它不会产生任何新的目录！
更新你的代码（添加新的目录）:执行cvs update - D
这将更新现有的文件，如果可能的情况下，合并的变化。如果已添加新的文件，那么更新将创建新的文件，如果已添加新的目录将作为well.nbsp创建;
这是非常重要的，因为如果有人检查一个新的目录（顶级目录），说巴兹和两个新文件，说巴兹/ Bar.h和baz / Bar.cpp，你简单的使用cvs更新，您不会得到巴兹/ Bar.h和baz / Bar.cpp新的文件。相反，你需要使用cvs update - D的。
这是CVS的基础知识。有关详细信息，尤其是关于标签和合并/分支看到现场。Bug跟踪
SourceForge上提供了免费的bug跟踪系统，它允许你很容易地跟踪与您的项目问题。作为管理员，您可以创建类别的清单，以及修改中list.nbsp的任何错误的状态，虽然它不象有一些bug跟踪详细，当然比什么都没有，或试图一起凑齐东西自己。作为管理员，您可以自定义"提交新的"页面位，不远远不如想，但，再次，它总比没有好。任何人都可以进入错误（除非你关闭匿名发布），所以也比较容易让用户在这里提交错误，而不强迫他们成为SourceForge上的成员，。盈富
部分相关的bug跟踪系统，，是在一般的跟踪，这是它允许你创建/监控，如臭虫，支持请求，NBSP的东西;修补程序和功能要求的发动机。每个部分允许你添加新的类别，调整用户权限，添加新组（我从来没有用过这个）和更新一般偏好（如电子邮件通知时，发送一些改变或添加）。一般情况下，它是非常有用的使用，但我注意到可能的项目似乎并不比Bug跟踪部分使用。任务
的任务部分允许您跟踪谁在做什么时。我真的很喜欢这个想法，但我希望它有更先进的功能（如图表，例如）。然而，再次，它总比没有好，我感到惊讶，这一切都是免费的！
您整理成"子项目"，然后你就可以浏览和/或编辑或任务添加到您的任务。当你添加一个任务，您可以控制哪些用户是分配给它，当它应该做的，什么是它的百分比，票据上的任务，和任务的依赖。
我认为这是非常值得一用，并配合，如果你在与你的CVS任务ID，核对笔录，它可以更容易一些追查什么在您的项目（尤其是如果你有一个大项目）。文件版本
SourceForge上提供了一个非常简单的使用文件发布管理器，它允许您提供简单的链接到各个项目的文件，如安装程序，补丁程序，资源，文件，等SourceForge上，您的项目不把太多的限制你可以把多少数据或你保持多久。有些项目文件发布3年以上的历史，并有几百个几百个兆的数据作为一个result.nbsp;
作为一个项目管理员，您可以去您的项目管理部分，并从那里得到releases.nbsp文件管理界面;发布分为两个主要部分，包和释放自己。软件包是一个简单的一系列发布的文件的逻辑分组，可以命名为任何你想要的。文件版本只是一个名称，然后获取相关的发行说明你所提供的，以及实际发布文件的链接。每个版本可以有0或多个与它相关的的文件。
一旦你已经准备发布的文件（或文件），您使用在SourceForge文件发布接口准备为它，然后通过FTP上传文件到SF的临时上传网站。从那里，你会选择在文件版本界面的文件，填写一些信息（如什么类型的文件，一个Win32 exe文件，压缩的源文件，等集合），然后在SourceForge会照顾rest.nbsp;
你可以上传的文件通过FTP匿名在传入directory.nbsp upload.sourceforge.net;文档
SourceForge上提供了一个文件管理器，但几乎没有人使用它（其他SourceForge上）。不幸的是，你可以用它管理的一些相当严重的限制。我已经尝试了几个不同的东西，目前已落户我的目的。我会极力推荐给他人。 DocBook的可以让你有一个单一的文件源，然后使用XSLT，它可以转换成各种输出格式，如PDF，HTML，HTML帮助（完整的项目，源，索引和搜索的文件准备好了），TEX，和其他人。希望我能够写一篇文章对如何使用在不久的将来再次与倾斜，对获得它的工作在Win32系统）的DocBook（。 DocBook的转型期间，各种事情自动处理，如自动索引的东西，自动缩进的各个部分，让你交叉参考的东西，etc.nbsp;
杂项技巧更新的文件，或者抚摸自己... ...
触摸是一个小的实用工具，您可以使用更新文件的时间戳到当前的时间。一个可能，如果你需要强制一个文件是最新得到一个makefile来接它up.nbsp;触摸了foo.h
另一个用途是创建一个新文件。例如，运行触摸Blah.cpp将创建文件Blah.cpp，如果没有已经存在。修补和diff
一旦您的项目运行起来，你会发现人们会发送给你一个补丁。代码补丁在OSS世界（或至少我已经看到了相当数量及其用法）是相当常见的，但与其说是在Win32世界（再次，在我的经验）NBSP。
该方案将输出2一个标准的文本格式的文件（相同的格式，是由CVS合并和存储变化）之间的差异。例如，让我们创建一个名为foo.h的文件看起来像这样:类Foo { foo（）的; &#
160;无效doit（）{ INT X = 0;
60; 诠释y = X * SIN（0.456）; }};
现在可以修改它像这样，并保存为foo.h.1类Foo { FOO（）; &
#160;无效doit（）{ INT X = 0; &#
160; 诠释y = X * SIN（0.456）; }};
我们所做的是增加的资本Foo的构造。现在运行差异，看到了两者之间的files.nbsp的差异;差异- U foo.h的foo.h.1--- foo.h的2003-06-30 16:50:19.000000000 -0400 foo.h.1 2003-06-30 16:33:35.000000000 -0400@ @ -1,5 1,5 @ @ 类Foo { - 美孚（）; &#
160; FOO（）; 无效doit（）{
60; INT X = 0;
0; 诠释y = X * SIN（0.456）;
你看到的是diff程序的输出。使用- u参数改变输出格式，使得diff使用统一的输出格式，这是什么其他的工具的使用以及。我们可以转储，像这样的文件:foo.h的差异- U foo.h.1 GT; foo.h.diff
我们现在已经在文件中存储的差异。这使我们来修补... ...
补丁允许你采取一个补丁文件，并将其应用到源文件。因此，我们可以采取我们foo.h.diff，将它应用到我们原来的了foo.h，和应用的变化，在这种情况下的foo（）构造函数修复。要应用更改，只需usepatch foo.h的foo.h.diff
这一切的一点是，你现在可以使用从其他开发人员发送的补丁。例如，该项目允许外部开发者（谁通常不具备CVS写访问）提交的补丁，这也是需要以及需要用gzip压缩，GTK开发团队就可以申请在以后的日子，如果被接受的补丁。如果你对此感兴趣，您可以在您的项目中使用类似的系统。 获得进一步的帮助命令行程序
在一些点，在使用这些程序的一些，你会希望得到进一步的informationnbsp;关于如何使用它们，以及它们是如何工作的。传统上，这样做是键入男子LT;方案namegt;，这反过来又会显示，被称为手册页的文本文件存储为文本的帮助。然而，男子的网页是老男人！有一个新的帮助工具，所谓的信息，让您导航的帮助，甚至允许你超过一定的"三通"的光标位置，并采取引用的部分。最重要的是，如果不是所有的Cygwin的命令行文件，是通过信息。所以，如果你有一个问题:如何使用diff工具，只需键入信息差异
紧接你是这样的:文件:diff.info，节点:调用的差异，下一步:调用diff3，上一页:调用彗星\MP，UP:热门调用'差异'***************
60;运行'差异'命令的格式是: 差异比较选项...文件... 在最简单的情况下，两个源文件到文件的文件名，'差异'源文件到文件的内容进行比较。一
文件名` - "代表从标准输入读取的文本。作为一个特殊情况下，`差异 - - "比较的标准输入到自身的副本。 &#
160;如果一个文件是一个目录，另一种是不，`差异比较其名称的非目录，在目录中的文件。 "非目录文件不得' - '。 如果两个文件名都是目录，`差异"比较两个目录中的相应文件，以字母为了这个比较不是递归的，除非`- r'或者` - 递归"选项。 '差异'从来没有比较实际
从这里你可以使用箭头键导航，使用下一个主题为"N"键，"P"为主题，和"U"导航到父主题。有其他键以及工作，但是这将让你开始。
信息在大多数系统上工作，我认为，任何现代的Linux发行版安装了它，和可能的Solaris以及。所以，如果你登录到SourceForge上壳，不知道如何使用命令尝试帮助信息。结论
的大部分信息是分散在各个地方周围的SourceForge网站，并希望它会帮助你，如果你决定使用天星小轮服务。如果有一些事情让人觉得缺少更详细解释，只是后在底部的评论，我会尽力，并纳入更新时间允许的文章的要求。
VI是一个命令行的文本编辑器。这是有点不可思议的习惯，而有些人喜欢它，我不。然而，它是重要的，你至少能够在它的编辑做一点点，因为某些应用程序，编辑短信（CVS）的使用，并有可能是系统上的时候，它是唯一的运作编辑器（不寒而栗...).
第六工程模式 - 有一个插入模式和命令模式（缺乏一个更好的词）。它开始在命令模式。如果打开AA文件（比如VI foo.h的），您可以退出，假设没有作出任何改变，击打":"键，然后键入"Q"（你应该看到你在较低的左上角的文本显示终端窗口作为"Q"），按回车键和VI应该退出。我对你所做的更改，"QW"退出和写入的变化。要退出而不保存使用":Q!"。 为了确保你在命令模式下打出了"Esc"键（一些版本的Vi也切换到命令模式，以及使用箭头键）前打字。
输入一些vi文本，你需要进入插入模式。使用箭头键导航到您要开始打字，然后打不是"A"（追加到文本）或"我"插入文本。通常情况下，一个新的文件，你会打"A"。现在开始输入正常输入文字。请注意，一些版本/系统打箭头键将带你插入模式，在命令模式下（你会没有，因为没有文字将被搬上银幕了进入），所以要小心。事实上，使用VI是有点像试图使用核动力电锯钟表修理 - 一个非常强大和钝刃工具 - 你被警告。
要退出输入文字打的"Esc"键。删除文本，去到命令模式，使用箭头键导航到的字符，并打"X"。要删除一整行，使用"DD"。这几乎是我的知识的程度，因此有乐趣！
！
- 