cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From d...@cocoon.apache.org
Subject [Cocoon Wiki] Updated: CocoonWebsiteUpdate
Date Tue, 23 Nov 2004 03:36:08 GMT
   Date: 2004-11-22T19:36:08
   Editor: DavidCrossley <crossley@apache.org>
   Wiki: Cocoon Wiki
   Page: CocoonWebsiteUpdate
   URL: http://wiki.apache.org/cocoon/CocoonWebsiteUpdate

   CVS => SVN

Change Log:

------------------------------------------------------------------------------
@@ -1,5 +1,4 @@
-This info is for Cocoon committers who need to update Cocoon's site (Originally written by
[wiki:VadimGritsenko Vadim] in CocoonReleaseHowTo).
-
+This info is for Cocoon committers who need to update Cocoon's site.
 
 ==  See also ==
 
@@ -8,40 +7,40 @@
 = HOW TO UPDATE AN APACHE COCOON WEBSITE =
 
 Here are the steps to do this:
-==  A) Checkout Cocoon CVS ==
-Checkout one of the Cocoon CVS modules:
+==  A) Checkout Cocoon SVN ==
+Checkout one of the Cocoon SVN modules:
  *  cocoon-1
  *  cocoon-2.0
- *  cocoon-2.1
+ *  cocoon-2_1_X
  *  ...
 If you have checkout already, just update it.
 
-==  B) Checkout Cocoon Site CVS ==
-Checkout cocoon-site CVS module. If you have checkout already, just update it.
+==  B) Checkout Cocoon Site SVN ==
+Checkout cocoon/site SVN module. If you have checkout already, just update it.
 
 Note: cocoon-site is more than 60 Mb. You can checkout only part of it, say, for Cocoon 2.1,
cocoon-site/site/2.1 (35Mb)
 
 ==  C) Generate site ==
-This is done simply by issuing 'build site' command in the shell in Cocoon CVS root directory.
After generation is complete, site should be ready at ../cocoon-site/x.y/
+This is done simply by issuing 'build docs' command in the shell in Cocoon root directory.
After generation is complete, site should be ready at ../cocoon-site/x.y/
 ===  Forrest notes ===
  1. Use Forrest-0.5.1 (available from the [http://forrest.apache.org/mirrors.cgi#archive
Download Archive].
  1. Do not use Forrest-0.6 (the recent release) as this still needs some changes for Cocoon's
Forrest config files.
- 1. Cocoon's 'build site' command will call Forrest internally. Forrest's location is determined
by the 'forrest.home' property in default.properties, and defaults to '../xml-forrest/build/dist/shbat/'
+ 1. Cocoon's 'build docs' command will call Forrest internally. Forrest's location is determined
by the $FOREST_HOME environment variable and defaults to '../xml-forrest/build/dist/shbat/'
  1. Out the box, Forrest will not render PNG images in PDFs. To do this, you need to
  *  Download Jimi from [http://java.sun.com/products/jimi/ Sun]
  *  Copy the !JimiProClasses.zip file to $FORREST_HOME/lib/core/jimi-1.0.jar
- *  Rebuild Forrest
+ *  Rebuild Forrest (cd xml-forrest; ./build.sh clean; ./build.sh)
 We should soon have the [http://forrestbot.cocoondev.org Forrestbot] facility running, which
should make all of this vastly simpler.
 
-==  D) Upload site into CVS ==
-Sync up generated directory contents with CVS: remove removed files, add added files, etc.
Then, commit results into cocoon-site.
+==  D) Upload site into SVN ==
+Ensure that your cocoon-site is up-to-date (svn update). Copy the generated files from ./build/site/*
to the relevant directory under cocoon-site/site/), remove removed files, add added files,
svn propset, etc. Then, commit results into cocoon-site.
 
 ==  E) Update site on the server ==
 Steps are:
  *  ssh into www.apache.org (or cvs.apache.org - same machine)
  *  Check your environment: make sure your umask is set to 0002 ('umask 0002' in ~/.profile,
or use the "umask" command)
  *  cd /www/cocoon.apache.org/x.y/
- *  cvs update -Pd
+ *  svn update
  *  Double-check that all files you left over there are g+w so others can work from where
you finished.
 
 == Done! ==
@@ -50,9 +49,6 @@
 Other notes:[[BR]]
  *  There is a .htaccess file to redirect the old URLs from xml.apache.org/cocoon/* to the
current distribution, e.g. /2.1/ ... so when v2.2 comes you need to edit cvs xml-site/targets/cocoon/.htaccess
and manually at /www/xml.apache.org/cocoon/.htaccess
 
- *  The files that create the dist/cocoon/ directory are not all under CVS, so edit those
files in place at /www/www.apache.org/dist/cocoon/*.html (don't forget the .htaccess files).
Other files like "mirror.html" are under CVS control, so edit them in the cocoon-site module,
then 'ssh cvs.apache.org; cd /www/cocoon.apache.org/; cvs update mirror.html'.
-
- * All those instructions should be updated to reflect the changes from "CVS" to "SVN".
-
+ *  The files that create the dist/cocoon/ directory are not all under source control (ToDo:
they should be), so edit those files in place at /www/www.apache.org/dist/cocoon/*.html (don't
forget the .htaccess files). Other files like "mirror.html" are under source control, so edit
them in the cocoon-site module, then 'ssh cvs.apache.org; cd /www/cocoon.apache.org/; svn
update mirror.html'.
 
 

Mime
View raw message