Project webpages

Each project hosted on Puszcza is assigned a web space available at the following URL:

http://www.gnu.org.ua/software/project.

In this example as well as in the discussion below, project stands for the actual UNIX name of your project.

To populate the webspace with the actual content, it must be checked in to the CVS repository cvs.gnu.org.ua/webcvs/project/project. The recommended way to do so, is described below.

For the initial check in, change to the directory containing the web content for your project and run the following command:

 CVS_RSH=/usr/bin/ssh cvs -d :ext:cvs.gnu.org.ua/webcvs/project import -m 'Initial import' project project start

The web space will be synchronized with the checked in files within 2 seconds after the import.

It might be a good idea to have the following statements added to your .profile:

 CVS_RSH=/usr/bin/ssh
 export CVS_RSH

That way you won't have to set CVS_RSH before each invocation of cvs. In the rest of this article we assume you already have these statements in your .profile.

After running initial import, remove or move away your working directory and check it out from the repository with the following command:

 cvs -d :ext:cvs.gnu.org.ua/webcvs/project co project

Another way to do initial import is to check out the empty repository first (using the command above), populate it with the files, run cvs add and commit the changes using cvs commit.

Whatever method you use for initial import, you will end up with your content available via http and a local copy of the working tree. If you wish to modify the content later, do the necessary changes to your local copy, schedule them for commit and run cvs commit. The changes will become available within 2 seconds after the commit finishes.

Notice that due to security reasons, any .htaccess files are removed during the synchronization. However, special provisions are made to allow you to control the way httpd handles your files.

The .checkoutrc file

To be continued...