Project Web Site¶
Enabling this feature has major security consequences, as such the feature is disabled by default. It is strongly advised to leave it disabled.
Visiting a Web Site¶
When a new project is created on Tuleap a project specific Web Site is created as well. You can access a project Web site in 2 different ways:
By forming the following URL in your favorite Web browser (where projectname is your project short name):
Or, if your server is setup in secure mode:
Click on the “Home Page” link in the Project Main menu at the top of the Project Dashboard.
If the project team has not yet created its own Web pages, you’ll see the default project home page informing you that the site will come soon as well as a link back to the Tuleap site.
Web Site Creation¶
Directory Structure and Location¶
Each project has its own specific location where to store their collection of HTML pages along with the images or related data files and document that comes with it. The location of the directory where to store all these documents is:
If you use your Shell Account (see Shell Account) to log into the Tuleap server and place yourself in this directory with the Unix command “cd /home/groups/projectname” you’ll see 3 subdirectories:
htdocs: this is where you must place all your HTML pages including those with embedded PHP or SSI instructions (see below for more details). All the images, icons or documents used or referenced in your Web pages must also be stored in this directory (or in any sub-directory under htdocs). In the Apache jargon the directory
/home/groups/projectname/htdocsis the Document Root of your Web Site.
Apache is the HTTP server developed by the Apache Consortium. It is available under an Open Source license and is by far the most popular Web server in the world with more than 60% of the market share. For more information on Apache see https://httpd.apache.org
Apache expects your home page to have one of the following name:
index.html, index.htmfor pure HTML pages
index.shtmlfor pages using Apache SSI extensions
index.phpif you use embedded PHP scripts
If your own home page is called index.php then rename the default index.php file created by Tuleap into something else by using the following commands from your Shell Account:
cd /home/groups/projectname/htdocs mv index.php index_default.php
cgi-bin: this directory is where you must place all your CGI scripts. CGI scripts can be written in a number of languages like Perl, Python, Shell or even C.
log: this is a reserved directory. Do not put any of your files in it.
Web Site Scripting with PHP¶
Project members can build sophisticated project Web sites by using the PHP language. PHP, is becoming extremely popular as a server-side scripting language for the Web. PHP is easy to learn, optimized for the Web and interact nicely with SQL databases.
If you decide to embed PHP scripts in your Project Web pages, first make sure to use the “.php” extensions for all the files with PHP code in it. For pure HTML pages use the “htm” or “html” extensions as usual.
For security reasons,
your php scripts will only be allowed to access files located in the
document root of your project (e.g.
Web Site Publishing¶
You can use various methods to publish your Web pages on your Tuleap Web site:
- Remote editing with HTML capable editors like Netscape or Mozilla Composer, Microsoft FrontPage or Emacs with transparent ftp access
- Local editing on your machine and transfer of the files either via ftp or, even better, via scp
- Small changes to web pages can be made from the shell account on Tuleap, using emacs or vi, but substantial editing is discouraged.
Local Editing and Remote Transfer¶
For those of you who use an HTML editing tool that has no built-in export facility you can transfer your HTML files by other means.
FTP: this is the simplest method for transferring your Web pages to the Tuleap remote location. Use ftp to connect to
projectname.tuleap.example.comand use your Tuleap username and password to login. Once logged in issue the following command:
and finally use the put (or mput) command to transfer the modified files. Check with your Web browser that everything is ok. Mind your Web Browser page cache and force page reloading to be sure you see the latest version of your pages!
scp -r * login@SYS_SHELL_HOST:/home/groups/projectname/htdocs/
where login is your Tuleap login. The -r option stands for recursive copy and will copy all the files in the directory as well as all others in subdirectory while preserving your directory structure.