Mozdev.org

This is a wiki version of the docs at http://www.mozdev.org/docs

Adding, Editing and Deleting Content

CVS is used to edit, update and add all source and content on mozdev.org, including a project's web pages. Web pages are contained in the www/ directory for each project, so to start making changes to your pages you first need to check out your project from CVS. Using a command line CVS client, you would do the following:

cvs -d :pserver:USERNAME@mozdev.org:/cvs login
cvs -d :pserver:USERNAME@mozdev.org:/cvs co PROJECTNAME

Note: The CVS commands above are for use with command line CVS clients. There are Windows and Macintosh CVS programs (such as WinCVS and TortoiseCVS for Windows and MacCVS and MacCVSClient for the Mac) that provide a graphical front end for CVS. For more information about CVS in general, there is an O'Reilly CVS Pocket Reference and a number of CVS help pages available. There is also a good cvs reference by John Haller "MozDev WinCVS Setup".

When the checkout is complete all of the project's contents will be on your computer and the web pages can be found at PROJECTNAME/www/. For all new projects there are already some Template Start Pages that have been included in this directory, although you are free to add whatever files or directories you want. After modifying files locally, you can commit these changes back to your project and they will show up on the site.

CVS is also used to take down a page from your site. Files removed in CVS are moved into an area called the Attic and are not deleted from the repository. This is done because CVS needs to keep a full history of all versions of all files in case an earlier version of a file needs to be brought back at some point.

Removed pages may not be linked to from your site anymore, but they will still be available online by browsing through your project's Attic using CVSweb. This means that a file removed from your site can still be found through a Google search, for instance.

Default Template Pages

All new projects come with some basic start pages in the PROJECTNAME/www/ directory. These include mostly html and css files that you can edit to get your project started quickly.
These templates are designed to use valid HTML and CSS and have been optimized to display best in standards-compliant browsers. HTML and CSS compliance is optional though and you are free to replace any of these files or edit them however you want.

The default templates include:

• project_nav.html: This file contains the project navigation that will be included on all pages for your project.

• head.txt: This file will allow you to make additions to the tag that is included by default in the site branding code.

• local.conf: This file allows you to set a number of different variables that will allow you to configure your project. Any $local_conf_ variable changes should be inside <?php and ?>

• bugs.html: This file adds a dynamically updated 'Latest bugs filed' list to the bottom of the page.

• source.html: This file adds a dynamically updated 'Today's CVS commits' list to the bottom of the page.

• members.html: This file lists each person who has CVS access to a project and what role they have been assigned.