Ticket #8326: jython_docs.diff

File jython_docs.diff, 4.4 KB (added by Leo Soto M., 14 years ago)
  • new file docs/install_jython.txt

    diff -r 9026852775e1 docs/install_jython.txt
    - +  
     1===============================
     2How to install Django on Jython
     3===============================
     4
     5This document will get you up and running with Django on top of Jython.
     6
     7Install Jython
     8==============
     9
     10Django works with Jython versions 2.5 and higher. The 2.5a2+ release will be be
     11the first in which Django will work out of the box. You can also grab the
     12development version from the subversion repository.
     13
     14Get the official releases from <http://www.jython.org>.
     15
     16Install a servlet container
     17===========================
     18
     19If you just want to experiment with Django, skip ahead to the next
     20section; Django includes a lightweight Web server you can use for
     21testing, so you won't need to set up anything else until you're ready to
     22deploy Django in production.
     23
     24If you want to use Django on a production site, use a Java servlet container,
     25such as `Apache Tomcat`_. Full JavaEE applications servers such as `GlassFish`_
     26or `JBoss`_ are also OK, if you need the extra features they include.
     27
     28.. _`Apache Tomcat`: http://tomcat.apache.org/
     29.. _GlassFish: https://glassfish.dev.java.net/
     30.. _JBoss: http://www.jboss.org/
     31
     32Remove any old versions of Django
     33=================================
     34
     35XXX: It's the same as documented on ../install, after the obvious
     36s/python/jython replacement. Should we link to that? Do some sort of include?
     37
     38Install the Django code
     39=======================
     40
     41XXX: Again, the same as documented on ../install.
     42
     43Install django-jython
     44=====================
     45
     46The `django-jython`_ project contains database backends and management commands
     47for Django/Jython development. Note that the builtin Django backends won't work
     48on top of Jython.
     49
     50.. _`django-jython`: http://code.google.com/p/django-jython/
     51
     52To install it, follow the `installation instructions`_ detailed on the project
     53website. Also chekc the `database backends`_ documentation there.
     54
     55.. _`installation instructions`: http://code.google.com/p/django-jython/wiki/Install
     56.. _`database backends`: http://code.google.com/p/django-jython/wiki/DatabaseBackends
     57
  • docs/tutorial01.txt

    diff -r 9026852775e1 docs/tutorial01.txt
    a b  
    1818installed.
    1919
    2020.. _`Django installed`: ../install/
     21
     22.. admonition:: Django on Jython
     23
     24    If you are trying Django with `Jython`_ (a Python implementation for the
     25    Java Virtual Machine), that's OK: The vast majority Django components work
     26    fine under Jython. In fact, you can follow all this tutorial using it. When
     27    doing *copy-and-paste*, don't forget to replace every ``python`` command with
     28    ``jython``, and the ``PYTHONPATH`` environment variable with ``JYTHONPATH``.
     29
     30    You will also find useful to grab the `django-jython`_ integration code. It
     31    includes management extensions and database backends for JDBC (Django
     32    builtin database backend won't work). For more information, look at the
     33    `Django on Jython installation`_ notes.
     34
     35    Make sure that you are using a Jython version of the 2.5 release series (svn
     36    revisions and alphas releases since 2.5a2+ should be OK). Django won't work
     37    with the Jython 2.2.x releases.
     38
     39.. _`Jython`: http://www.jython.org
     40.. _`django-jython`: http://code.google.com/p/django-jython
     41.. _`django on jython installation`. ../install_jython/
    2142
    2243.. admonition:: Where to get help:
    2344
     
    4263will create a ``mysite`` directory in your current directory.
    4364
    4465.. admonition:: Mac OS X permissions
    45    
     66
    4667   If you're using Mac OS X, you may see the message "permission
    4768   denied" when you try to run ``django-admin.py startproject``. This
    4869   is because, on Unix-based systems like OS X, a file must be marked
     
    146167    * ``DATABASE_ENGINE`` -- Either 'postgresql_psycopg2', 'mysql' or 'sqlite3'.
    147168      Other backends are `also available`_.
    148169    * ``DATABASE_NAME`` -- The name of your database, or the full (absolute)
    149       path to the database file if you're using SQLite. 
     170      path to the database file if you're using SQLite.
    150171    * ``DATABASE_USER`` -- Your database username (not used for SQLite).
    151172    * ``DATABASE_PASSWORD`` -- Your database password (not used for SQLite).
    152173    * ``DATABASE_HOST`` -- The host your database is on. Leave this as an
Back to Top