Fedora Websites CVS
Like much of the rest of the Fedora Project, the Fedora websites are available in their raw form. fedoraproject.org is a wiki, and so has no CVS repository. You can download fedora.redhat.com through anonymous CVS.
Being primarily a wiki, fedoraproject.org is not contained as a whole in public CVS. However, the theme 'kindofblue' is contained.
export CVSROOT=:ext:<username>@cvs.fedoraproject.org:/cvs/fedora cvs co kindofblue
For information on editing the wiki, see the WikiEditing page.
fedoraproject.org static pages
You can request write access by applying for membership in the
cvsfedora group in the Fedora Account System . Furthermore, you must be approved and added to the appropriate ACLs. Normally, write access is granted only to those who are known and have established a prior need to commit to one of the modules in this repository. As a measure to prove yourself, you can always send us patches created using anonymous read-only access. You can file bugs and submit patches against Fedora Websites using Bugzilla . More information can be found in the Bugs section of the Websites page.
CVS Checkout Instructions
To get access to a CVS tree for anonymous read-only access, you will need to do the following:
- Set your CVSROOT environment variable:
- Log into the CVS server using an empty password:
~-Just press 'Enter' when asked for a password.-~
- Checkout the '
cvs co web
Following these steps will check out the code for fedora.redhat.com into a directory named 'web' in the current directory.
If you do not have write access, you will have to submit patches to get your changes applied. You can create your patches using
cvs diff -u <filename> > <filename>-<name>.patch
<filename> should be replaced with the name of the file you have changed and
<name> should be replaced with your name or an appropriate name for the patch.-~
Using Write Access
Do you have write access? If so, you can follow the directions above to checkout the source, but make the following changes:
- Tell CVS to use SSH tunneling:
- Use your account over SSH rather than 'anonymous' with 'pserver' for the CVS root:
<youraccountname>' is replace with the name of your account in the Fedora Account System .
You can then commit your changes back to the CVS repository, assuming you have the necessary access.
After you are satisfied with the changes you have made and have used
cvs commit to store them in the repository, you must tag the changed files as 'LIVE' in order for them to be published in the next update cycle:
cvs tag -F LIVE <filename>
<filename>' is replaced by the names of the files that you have changed or added.
Generating Pages from DocBook HTML Source
If you are modifying any files that are generated from Doc
1. Make your changes to the original Doc
Book XML files
1. Generate the HTML from the Doc
Book XML files in the
docs module using the
make html command.
1. Copy the generated HTML files to the appropriate directory in
web/html/docs/. For example:
cp docs/documentation-guide/documentation-guide-en/*.html web/html/docs/documentation-guide/
Make sure the top level file you copy over is 'index.html' in order to generate a properly linked index.php. Change the top level file name to index.html, if you need to.
1. Copy any images and stylesheet images over in the appropriate paths.
1. Run the docbookhtml2php.py script to convert the generated HTML files to PHP. It is located in the
web module under the
../../../scripts/docbookhtml2php.py *html index.html converted to index.php ln-legalnotice.html converted to ln-legalnotice.php rv-revhistory.html converted to rv-revhistory.php sn-foo.html converted to sn-accounts.php sn-bar.html converted to sn-bar.php sn-baz.html converted to sn-baz.php
1. Clean-up and make sure that all new files are added to CVS:
rm *html cvs add *php
1. Commit the changes and tag them
LIVE. (See the
Using Write Access
cvs ci -m "Example log." ... cvs tag -F LIVE ./ ...
A web interface for browsing this repository is available:
CVS commits mailing list
All commits to the fedora.redhat.com CVS module are sent to the email@example.com mailing list.
Setting Up a Sandbox
In order to preview your CVS working directory in a live form, you will need to set up a local sandbox. These instructions assume you are working on a Fedora system with Apache (in the 'httpd' package) and PHP (in the 'php' package) installed and that you are working with root privileges.
- In your working directory, you will find '
config/httpd.conf' and '
config/php.ini'. Copy '
httpd.conf' to '
/etc/httpd/conf/httpd.conf' and '
php.ini' to '
/etc/php.ini', overwriting the original files.
- Create a symlink from '
/var/www/fedora.redhat.com/' to the '
html' directory of your working directory:
cd /var/www ln -s /path/to/web/html/ fedora.redhat.com
- Create a symlink from
'/var/www/include/' to the '
include' directory of your working directory:
ln -s /path/to/web/include .
- Start (or restart) the httpd service and you should be able to connect to http://localhost in your Internet browser:
service httpd start
- If you get a permission denied error, make sure the user 'apache' has read access to your working directory, and try again:
chmod -R o+r /path/to/web
- To report bugs, refer to the Websites page.