Differences between revisions 2 and 8 (spanning 6 versions)
Revision 2 as of 2007-10-04 17:44:13
Size: 1242
Editor: nat
Comment:
Revision 8 as of 2008-06-16 03:12:43
Size: 1519
Comment: scp.user change
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from JythonDeveloperGuide/WebsiteBuilderSetup
Line 5: Line 6:
  1. 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. Download and install [http://docutils.sourceforge.net/ docutils]. Grab it from the site and go through the normal 'python setup.py install' deal. Note that a docutils egg will '''NOT''' work here (possibly pending some packaging changes to jysite).
Line 8: Line 9:
svn co https://svn.sourceforge.net/svnroot/jython/trunk/sandbox/wierzbicki/jysite svn co https://jython.svn.sourceforge.net/svnroot/jython/trunk/sandbox/wierzbicki/jysite
Line 11: Line 12:
  1. Checkout the actual website code from https://svn.sourceforge.net/svnroot/jython/trunk/website   1. Check out the actual website code from `https://jython.svn.sourceforge.net/svnroot/jython/trunk/website`
  1. Make sure a Jython trunk checkout is available as `jython` at the same level as `website`.
Line 13: Line 15:
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.
   
Now you can build the site using Ant. Change into your checkout directory and run `ant` to build the site. The reStructuredText files that comprise most of the site are in the `Project` directory.
Line 18: Line 19:
 1. Run ant copy2sf to build a tar.bz2 of the site and scp it to sourceforge
 1. ssh to sourceforge
 1. Edit `build.xml` to change the `scp.user` property (if your name isn't Frank Wierzbicki).
 1.
Run `ant copy2sf` to build a tar.bz2 of the site and scp it to sourceforge
 1. `ssh shell.sourceforge.net`

CharlieGroves, incept: 2006-08-27

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

  1. Download and install [http://docutils.sourceforge.net/ docutils]. Grab it from the site and go through the normal 'python setup.py install' deal. Note that a docutils egg will NOT work here (possibly pending some packaging changes to jysite).

  2. Grab the site builder out of svn and install it.
    • svn co https://jython.svn.sourceforge.net/svnroot/jython/trunk/sandbox/wierzbicki/jysite
      cd jysite
      python setup.py install
  3. Check out the actual website code from https://jython.svn.sourceforge.net/svnroot/jython/trunk/website

  4. Make sure a Jython trunk checkout is available as jython at the same level as website.

Now you can build the site using Ant. Change into your checkout directory and run ant to build the site. The reStructuredText files that comprise most of the site are in the Project directory.

To deploy the site:

  1. Edit build.xml to change the scp.user property (if your name isn't Frank Wierzbicki).

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

  3. ssh shell.sourceforge.net

  4. 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.

WebsiteBuilderSetup (last edited 2008-11-15 09:15:57 by localhost)