README.txt

File contents

CMFSubversionBrowser

  "Subversion":http://subversion.tigris.org

  Installation

   first of all you need to have subversion installed on the server
   along with the python bindings for python2.1. currently this is
   not as easy as one might wish. here are my notes.

     - download the latest tarball, download the bdb4.0.14, 
       swig1.3.17+, httpd2.0.44+, and additional dependencies
       as noted in the svn install file.
 
     - setup a sandbox for installing svn and its dependencies
       into. as an example here's how i configured httpd and svn
       for a sandbox in /opt/svn::

           ./configure --prefix=/opt/svn \
                       --with-ssl \
                       --enable-ssl=/usr/lib/ssl \
                       --enable-maintainer-mode \
                       --enable-dav \
                       --enable-so \
                       --with-dbm=db4 \
                       --with-berkeley-db=/opt/svn/BerkeleyDB.4.0 \
                       --enable-deflate \
                       --enable-proxy 

           ./configure --prefix=$HOME/Tools/svn \
                       --with-ssl \
                       --enable-ssl=/sw \
                       --enable-maintainer-mode \
                       --enable-dav \
                       --enable-so \
                       --with-dbm=db4 \
                       --with-berkeley-db=$HOME/Tools/svn \
                       --enable-deflate \
                       --enable-proxy 

           
           ./configure --with-apr=/opt/svn/ \
                       --prefix=/opt/svn \
                       --with-apr-util=/opt/svn/ \
                       --with-ssl \
                       --with-berkeley-db=/opt/svn/include:/opt/svn/lib \
                       --enable-maintainer-mode \
                       --with-apxs=/opt/svn/bin/apxs \
                       --with-swig=/opt/svn
       
           
           ./configure --with-apr=/Users/hazmat/Tools/svn/ \
                       --prefix=/Users/hazmat/Tools/svn \
                       --with-apr-util=/Users/hazmat/Tools/svn \
                       --with-ssl \
                       --with-berkeley-db=/Users/hazmat/Tools/svn/include:/Users/hazmat/Tools/svn/lib \
                       --enable-maintainer-mode \
                       --with-apxs=/Users/hazmat/Tools/svn/bin/apxs \
                       --with-swig=/Users/hazmat/Tools/svn/
                       
   after you have subversion installed, installing the cmf svn
   browser is easy ;-)

   first you have to have zope2.5+, python2.1.3, and CMF1.3 
   installed and an instance of a cmf portal site.

   after you do all of that you can verify that everything is working
   by adding the zope-install/lib/python to your PYTHONPATH 
   environment variable and running the svn_model_test.py script::
   
      python2.1 svn_model_test.py /path/to/svn/repository

   if it works than your ready to proceed, congratulations :-)
 
   go to the root of the portal site in zope management interface
   and add an external method with the following::
  
     Id: install_browser
     Module: CMFSubversion.Install
     Function: install

   then click on the test tab to finish the installation.   
   
   from within the content management interface you can now add 
   a cmf subversion browser. 

   after adding a browser, click on its edit action to configure it
   the subversion db path, should correspond to a repository location
   on the file system, the browser does not support remote browsing 
   at this time (its a horrible overhead anyways, imo). the repository
   path should correspond to a directory in the repository that you 
   want to set as the root of the browser.

  Todo

   - load testing, checking for leaks
    
   - consider write support (create dirs, add files, rename files, rename dirs)

   - can we do color output without forks? (enscript library?)

  Author

   kapil thangavelu <[email protected]>
 
   Copyright @2002 Kapil Thangavelu
  
  Credits

   many, many, thanks to the subversion team for creating
   an incredible product.
  
  License
   
   LGPL