Diff for "WebsiteBuilderSetup"

Differences between revisions 1 and 2

CharlieGroves, incept: 2006-08-27

Jython uses reStructuredText and a custom writer to build its site. This describes how to set it up.

Download and install [http://docutils.sourceforge.net/ docutils]. Either grab it from the site and go through the normal 'python setup.py install' deal or just run 'easy_install docutils' if you've already got [http://peak.telecommunity.com/DevCenter/EasyInstall EasyInstall].

Grab the site builder out of svn and install it.

svn co https://svn.sourceforge.net/svnroot/jython/trunk/sandbox/wierzbicki/jysite
cd jysite
python setup.py install

Checkout the actual website code from https://svn.sourceforge.net/svnroot/jython/trunk/website

Now you can build the site using ant. Change into your checkout directory and run ant with no target to build the site. The rst that comprises most of the site is in Project.

To deploy the site:

Run ant copy2sf to build a tar.bz2 of the site and scp it to sourceforge
ssh to sourceforge
Unpack the site

cd /home/groups/j/jy/jython/htdocs
tar xfj ../website.tar.bz2

You'll want to have umask 002 and newgrp jython in your .bash_login so the site is updatable by others as well.

-  ⇤ ← Revision 1 as of 2006-08-27 18:03:32 → 
  Size: 1031
  Editor: CharlieGroves
  Comment:
+   ← Revision 2 as of 2007-10-04 17:44:13 → ⇥
  Size: 1242
  Editor: nat
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 5:
-. Download and install [http://docutils.sourceforge.net/ docutils].  Either grab it from the site and go through the normal 'python setup.py install' deal or  just run 'easy_install docutils' if you've already got [http://peak.telecommunity.com/DevCenter/EasyInstall EasyInstall].
+. Download and install [http://docutils.sourceforge.net/ docutils].  Either grab it from the site and go through the normal 'python setup.py install' deal or  just run 'easy_install docutils' if you've already got [http://peak.telecommunity.com/DevCenter/EasyInstall EasyInstall].
  1. Grab the site builder out of svn and install it.
   {{{
svn co https://svn.sourceforge.net/svnroot/jython/trunk/sandbox/wierzbicki/jysite
cd jysite
python setup.py install}}}
  1. Checkout the actual website code from https://svn.sourceforge.net/svnroot/jython/trunk/website
-Line 7:
+Line 13:
-. Grab the site builder out of svn and install it.
   {{{
   svn co https://svn.sourceforge.net/svnroot/jython/trunk/sandbox/wierzbicki/jysite
   cd jysite
   python setup.py install}}}
+Now you can build the site using ant.  Change into your checkout directory and run ant with no target to build the site.  The rst that comprises most of the site is in Project.
-Line 13:
+Line 16:
-. Checkout the actual website code from https://svn.sourceforge.net/svnroot/jython/trunk/website
+To deploy the site:
-Line 15:
+Line 18:
-Now you can build the site using ant.  Change into your checkout directory and run ant with no target to build the site and a .tgz file with its contents for easy uploading.  For just making changes and looking at them I run 'ant clean generate'.  The rst that comprises most of the site is in Project.
+.  Run ant copy2sf to build a tar.bz2 of the site and scp it to sourceforge
 1.  ssh to sourceforge
 1.  Unpack the site
{{{
cd /home/groups/j/jy/jython/htdocs
tar xfj ../website.tar.bz2}}}

You'll want to have `umask 002` and `newgrp jython` in your .bash_login so the site is updatable by others as well.