Setup the project website¶
In the sequel, all infomation and commands provided are assumed linked to the project myproject (replace it with your unix project name). In addition, when displaying command lines, $ stands for the prompt and is not part of the command.
As stated in Major features, each project comes with a directory on the Gforge @ uni.lu to store the source files of a website associated to the project. Note that we currently support only static pages i.e. only html files. In particular, dynamic pages in PHP are not supported. In all cases:
- The URL of the website is https://myproject.gforge.uni.lu
- The directory that store the website files on the Gforge @ uni.lu is
/home/groups/myproject/htdocs/. In particular, updating the file index.html will update the default page that comes with every new project.
- YOU ARE RESPONSIBLE FOR THE CONTENT OF THESE PAGES
- In particular: kindly ensure the general style of your pages follows the guidelines of UL websites. Contact the Communication department for more information.
Beware: even if the project is private, the project website is public.
As for any web server, you need to upload your local files that implement the web site on the server. On Gforge @ uni.lu, this transfer is only possible through SSH meaning you'll have to configure your SSH connexion to be able to transfer files (see Setup SSH).
Command-line transfer of files on the Gforge (Linux/BSD/Mac)¶
There exists two commands you can use for such transfer.
- scp for the full transfer of files and directories over SSH
- rsync, a software application which synchronizes files and directories from one location to another while minimizing data transfer as only the outdated or inexistent elements are transfered.
For instance, let's assume you want to transfer all the files and directories from your local machine (inside /path/to/website/files/) to the server.
Open a terminal and run the following commands to transfer all the files and directories on your local machine (inside /path/to/website/files/):
$ cd /path/to/website/files/ $ scp * firstname.lastname@example.org:/home/groups/myproject/htdocs/
In the last command, replace yourlogin by your login on Gforge @ uni.lu.
A clever altervative to scp is rsync. Here is how you can run it to update the web space of your project:
$ cd /path/to/website/files/ $ rsync --rsh=ssh --exclude=.svn --exclude=*~ -avz \ --delete . email@example.com:/home/groups/myproject/htdocs/.