<?php# vim:et:ts=3:sts=3:sw=3:fdm=marker:// WebSVN - Subversion repository viewing via the web using PHP// Copyright © 2004-2006 Tim Armes, Matt Sicker//// This program is free software; you can redistribute it and/or modify// it under the terms of the GNU General Public License as published by// the Free Software Foundation; either version 2 of the License, or// (at your option) any later version.//// This program is distributed in the hope that it will be useful,// but WITHOUT ANY WARRANTY; without even the implied warranty of// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the// GNU General Public License for more details.//// You should have received a copy of the GNU General Public License// along with this program; if not, write to the Free Software// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA//// --//// config.inc//// Configuration parameters// --- FOLLOW THE INSTRUCTIONS BELOW TO CONFIGURE YOUR SETUP ---// {{{ PLATFORM CONFIGURATION ---// Uncomment the next line if your running a windows server//// $config->setServerIsWindows();// Configure these lines if your commands aren't on your path.//// $config->setSVNCommandPath('Path/to/svn and svnlook/ e.g. c:\\program files\\subversion\\bin');// $config->setDiffPath('Path/to/diff/command/');// For syntax colouring, if option enabled...// $config->setEnscriptPath('Path/to/enscript/command/');// $config->setSedPath('Path/to/sed/command/');// For delivered tarballs, if option enabled...// $config->setTarPath('Path/to/tar/command/');// For delivered GZIP'd files and tarballs, if option enabled...// $config->setGZipPath('Path/to/gzip/command/');// }}}// {{{ REPOSITORY SETUP ---// There are 2 methods for defining the repositiories available on the system. Either you list// them by hand, in which case you can give each one the name of your choice, or you use the// parent path function, in which case the name of the directory is used as the repository name.//// In all cases, you may optionally supply a group name to the repositories. This is useful in the// case that you need to separate your projects. Grouped Repositories are referred to using the// convention GroupName.RepositoryName//// Performance is much better on local repositories (e.g. accessed by file:///). However, you// can also provide an interface onto a remote repository. In this case you should supply the// username and password needed to access it.//// To configure the repositories by hand, copy the appropriate line below, uncomment it and// replace the name and URL of your repository.// Local repositories (without and with optional group)://// $config->addRepository('NameToDisplay', 'URL to repository (e.g. file:///c:/svn/proj)');// $config->addRepository('NameToDisplay', 'URL to repository (e.g. file:///c:/svn/proj)', 'group');$config->addRepository('MLAB', 'file:///home/MLAB');$config->addRepository('library', 'file:///home/library');//$config->addRepository('BlueGrey', 'file:///home/MLAB');//$config->addRepository('Standard', 'file:///home/MLAB');$config->addRepository('svnkaklik', 'file:///home/svnkaklik');$config->addRepository('svnkaklik', 'file:///home/MLAB_E');//// Remote repositories (without and with optional group)://// $config->addRepository('NameToDisplay', 'URL (e.g. http://path/to/rep)', NULL, 'username', 'password');// $config->addRepository('NameToDisplay', 'URL (e.g. http://path/to/rep)', 'group', 'username', 'password');//// To use the parent path method, uncomment the newt line and and replace the path with your one. You// can call the function several times if you have several parent paths. Note that in this case the// path is a filesystem path//// $config->parentPath('Path/to/parent (e.g. c:\\svn)');// }}}// {{{ LOOK AND FEEL ---//// Uncomment ONLY the template file that you want.// $config->setTemplatePath("$locwebsvnreal/templates/Standard/");// $config->setTemplatePath("$locwebsvnreal/templates/BlueGrey/");// $config->setTemplatePath("$locwebsvnreal/templates/Zinn/");// You may also specify a per repository template file by uncommenting and changing the following// line as necessary. Use the convention "groupname.myrep" if your repository is in a group.// $config->setTemplatePath('$locwebsvnreal/templates/Standard/', 'myrep'); // Access file for myrep$config->setTemplatePath("$locwebsvnreal/templates/MLAB/", "MLAB");$config->setTemplatePath("$locwebsvnreal/templates/MLAB/", "library");//$config->setTemplatePath("$locwebsvnreal/templates/BlueGrey/", "BlueGrey");$config->setTemplatePath("$locwebsvnreal/templates/Standard/", "svnkaklik");$config->setTemplatePath("$locwebsvnreal/templates/Standard/", "MLAB_E");// The index page containing the projects may either be displayed as a flat view (the default),// where grouped repositories are displayed as "GroupName.RepName" or as a tree view.// In the case of a tree view, you may choose whether the entire tree is open by default.// $config->useTreeIndex(false); // Tree index, closed by default// $config->useTreeIndex(true); // Tree index, open by default// By default, WebSVN displays a tree view onto the current directory. You can however// choose to display a flat view of the current directory only, which may make the display// load faster. Uncomment this line if you want that.// $config->useFlatView();// }}}// {{{ LANGUAGE SETUP ---// WebSVN uses the iconv module to convert messages from your system's character set to the// UTF-8 output encoding. If you find that your log messages aren't displayed correctly then// you'll need to change the value here.//// You may also specify the character encoding of the repository contents if different from// the system encoding. This is typically the case for windows users, whereby the command// line returns, for example, CP850 encoded strings, whereas the source files are encoded// as iso-8859-1 by Windows based text editors. When display text file, WebSVN will convert// them from the content encoding to the output encoding (UTF-8).//// WebSVN does its best to automate all this, so only use the following if it doesn't work// "out of the box". Uncomment and change one of the examples below.//// $config->setInputEncoding('CP850'); // Encoding of result returned by svn command line, etc.// $config->setContentEncoding('iso-8859-1'); // Content encoding of all your repositories // repositories// You may also specify a content encoding on a per repository basis. Uncomment and copy this// line as necessary.//// $config->setContentEncoding('iso-8859-1', 'MyEnc');// Note for Windows users: To enable iconv you'll need to enable the extension in your php.ini file// AND copy iconv.dll (not php_iconv.dll) to your Windows system folder. In most cases the correct// encoding is set when you call $config->setServerIsWindows();.// Note for *nix users. You'll need to have iconv compiled into your binary. The default input and// output encodings are taken from your locale informations. Override these if they aren't correct.// Uncomment the default language. If you want English then don't do anything here.//include 'languages/czech.inc';// include 'languages/catalan.inc';// include 'languages/danish.inc';// include 'languages/dutch.inc';// include 'languages/finnish.inc';// include 'languages/french.inc';// include 'languages/german.inc';// include 'languages/japanese.inc';// include 'languages/korean.inc';// include 'languages/norwegian.inc';// include 'languages/polish.inc';// include 'languages/portuguese.inc';// include 'languages/russian.inc';// include 'languages/schinese.inc';// include 'languages/slovenian.inc';// include 'languages/spanish.inc';// include 'languages/swedish.inc';// include 'languages/tchinese.inc';// include 'languages/turkish.inc';// }}}// {{{ MULTIVIEWS ---// Uncomment this line if you want to use MultiView to access the repository by, for example://// http://servername/wsvn/repname/path/in/repository//// Note: The websvn directory will need to have Multiviews turned on in Apache, and you'll need to configure// wsvn.php// $config->useMultiViews();// }}}// {{{ ACCESS RIGHTS ---// Uncomment this line if you want to use your Subversion access file to control access// rights via WebSVN. For this to work, you'll need to set up the same Apache based authentication// to the WebSVN (or wsvn) directory as you have for Subversion itself. More information can be// found in install.txt// $config->useAuthenticationFile('/path/to/accessfile'); // Global access file// You may also specify a per repository access file by uncommenting and copying the following// line as necessary. Use the convention 'groupname.myrep' if your repository is in a group.$config->useAuthenticationFile('/home/MLAB/conf/authz', 'MLAB'); // Access file for MLAB$config->useAuthenticationFile('/home/svnkaklik/conf/authz', 'svnkaklik'); // Access file for svnkaklik// }}}// {{{ FILE CONTENT ---//// You may wish certain file types to be GZIP'd and delieved to the user when clicked apon.// This is useful for binary files and the like that don't display well in a browser window!// Copy, uncomment and modify this line for each extension to which this rule should apply.// (Don't forget the . before the extension. You don't need an index between the []'s).// If you'd rather that the files were delivered uncompressed with the associated MIME type,// then read below.//// $zipped[] = '.dll';// Subversion controlled files have an svn:mime-type property that can// be set on a file indicating its mime type. By default binary files// are set to the generic appcliation/octet-stream, and other files// don't have it set at all. WebSVN also has a built-in list of// associations from file extension to MIME content type. (You can// view this list in setup.inc).//// Determining the content-type: By default, if the svn:mime-type// property exists and is different from application/octet-stream, it// is used. Otherwise, if the built-in list has a contentType entry// for the extension of the file, that is used. Otherwise, if the// svn:mime-type property exists has the generic binary value of// application/octet-stream, the file will be served as a binary// file. Otherwise, the file will be brought up as ASCII text in the// browser window (although this text may optionally be colourised.// See below).//// Uncomment this if you want to ignore any svn:mime-type property on your// files.//// $config->ignoreSvnMimeTypes();//// Uncomment this if you want skip WebSVN's custom mime-type handling//// $config->ignoreWebSVNContentTypes();//// Following the examples below, you can add new associations, modify// the default ones or even delete them entirely (to show them in// ASCII via WebSVN).// $contentType['.c'] = 'plain/text'; // Create a new association// $contentType['.doc'] = 'plain/text'; // Modify an existing one// unset($contentType['.m'] // Remove a default association// }}}// {{{ TARBALLS ---// You need tar and gzip installed on your system. Set the paths above if necessary//// Uncomment the line below to offer a tarball download option across all your// repositories.//$config->allowDownload();//// To change the global option for individual repositories, uncomment and replicate// the required line below (replacing 'myrep' for the name of the repository to be changed).// Use the convention 'groupname.myrep' if your repository is in a group.// $config->allowDownload('myrep'); // Specifically allow downloading for 'myrep'// $config->disallowDownload('myrep'); // Specifically disallow downloading for 'myrep'// You can also choose the minimum directory level from which you'll allow downloading.// A value of zero will allow downloading from the root. 1 will allow downloding of directories// in the root, etc.//// If your project is arranged with trunk, tags and branches at the root level, then a value of 2// would allow the downloading of directories within branches/tags while disallowing the download// of the entire branches or tags directories. This would also stop downloading of the trunk, but// see after for path exceptions.//// Change the line below to set the download level across all your repositories.$config->setMinDownloadLevel(2);// To change the level for individual repositories, uncomment and replicate// the required line below (replacing 'myrep' for the name of the repository to be changed).// Use the convention 'groupname.myrep' if your repository is in a group.// $config->setMinDownloadLevel(2, 'myrep');// Finally, you may add or remove certain directories (and their contents) either globally// or on a per repository basis. Uncomment and copy the following lines as necessary. Note// that the these are searched in the order than you give them until a match is made (with the// exception that all the per repository exceptions are tested before the global ones). This means// that you must disallow /a/b/c/ before you allow /a/b/ otherwise the allowed match on /a/b/ will// stop any further searching, thereby allowing downloads on /a/b/c/.// Global exceptions possibilties://// $config->addAllowedDownloadException('/path/to/allowed/directory/');// $config->addDisAllowedDownloadException('/path/to/disallowed/directory/');//// Per repository exception possibilties:// Use the convention 'groupname.myrep' if your repository is in a group.//// $config->addAllowedDownloadException('/path/to/allowed/directory/', 'myrep');// $config->addDisAllowedDownloadException('/path/to/disallowed/directory/', 'myrep');// }}}// {{{ COLOURISATION ---// Uncomment this line if you want to use Enscript to colourise your file listings//// You'll need Enscript version 1.6 or higher AND Sed installed to use this feature.// Set the path above.//// $config->useEnscript();// Enscript need to be told what the contents of a file are so that it can be colourised// correctly. WebSVN includes a predefined list of mappings from file extension to Enscript// file type (viewable in setup.inc).//// Here you should add and other extensions not already listed or redefine the default ones. eg://// $extEnscript['.pas'] = 'pascal';//// Note that extensions are case sensitive.// }}}// {{{ RSSFEED ---// Uncomment this line if you wish to hide the RSS feed links across all repositories//$config->hideRSS();//// To change the global option for individual repositories, uncomment and replicate// the required line below (replacing 'myrep' for the name of the repository to be changed).// Use the convention 'groupname.myrep' if your repository is in a group.// $config->hideRSS('myrep'); // Specifically hide RSS links for 'myrep'// $config->showRSS('myrep'); // Specifically show RSS links for 'myrep'// }}}// {{{ BUGTRAQ ---// Uncomment this line if you wish to use bugtraq: properties to show links to your BugTracker// from the log messages.//// $config->useBugtraqProperties();//// To change the global option for individual repositories, uncomment and replicate// the required line below (replacing 'myrep' for the name of the repository to be changed).// Use the convention 'groupname.myrep' if your repository is in a group.// $config->useBugtraqProperties('myrep'); // Specifically use bugtraq properties for 'myrep'// $config->ignoreBugtraqProperties('myrep'); // Specifically ignore bugtraq properties for 'myrep'// }}}// {{{ MISCELLANEOUS ---// Comment out this if you don't have the right to use it. Be warned that you may need it however!set_time_limit(0);// Comment this line to turn off caching of repo information. This will slow down your browsing.$config->setCachingOn();// Number of spaces to expand tabs to in diff/listing view across all repositories$config->expandTabsBy(8);// To change the global option for individual repositories, uncomment and replicate// the required line below (replacing 'myrep' for the name of the repository to be changed).// Use the convention 'groupname.myrep' if your repository is in a group.// $config->expandTabsBy(3, 'myrep'); // Expand Tabs by 3 for repository 'myrep'// For installations without PHP5, a copy of PEAR's PHP Compat library is included.// If you have your own version of Compat you wish to use, go ahead and specify here.// $config->setPHPCompatPath('/usr/share/php/PHP/');// }}}?>