Introduction:
We are using SourceForge as our project web host as
well as our cvs server. The web page is in the repository under the www
directory. However, updating the cvs version does not upload the
website to the project web page. In order to do that, you must login to
the sourceforge shell server. The shell server for sourceforge hosts
both ssh and sftp servers so you can use either to upload and
manipulate files on the server. There isn't a nice simple document on
SourceForge that tells you how to do this, so here are the steps you'll
need to know:
File Structure:
/
The main directory contains the main
page, index.html, the main page, the sidebar, the resources page, and
the client page.
/status
This directory contains the status logs
of each developer of the project, along with a status.html file that
links to each of them.
/documentation
This directory contains all the
documentation for the site, organized into three groups: formal,
developer, and user documentation.
/formal
This contains
formal documentation, such as requirements, meeting notes, use cases,
etc.. ie, anything meant for the client.
/developer
This contains documentation targeted for the
developer of the engine, or someone who wishes to extend the engine or
build it themselves. The doxygen generated docs are placed in a
subdirectory here as well.
/user
This contains documentation for someone who wishes
to use the engine to make games, and will include examples, resources,
tutorials, and references.
Instructions:
To upload files you need to log into the sftp server
shell.sf.net. For your username and password, use your SourceForge
username and password. Then, you will need to go to the group and
project directory to get to the website portion, as by default you will
be placed into your own SourceForge user folder. Then, you can use the
ftp command "put" to upload files from your working directory on your
computer to the server. Like so:
cd /local/folder/on/your/harddrive/greenengine/www/
(let's say you have a file called new_document.html you've added to this directory)
(REMEMBER TO IMPORT IT INTO CVS FIRST!!!!)
sftp username@shell.sf.net
(username is your SF username. you'll be asked for a password, send your SF password)
cd /home/groups/g/gr/greenengine/htdocs
(this is the project web directory)
put new_document.html
And that's all there is to it.