--- a/doc/book/en/admin/gae.rst Fri Jun 19 09:19:27 2009 +0200
+++ b/doc/book/en/admin/gae.rst Fri Jun 19 20:38:32 2009 +0200
@@ -9,7 +9,7 @@
`Google AppEngine`_ is provided with a partial port of the `Django`
framework, but Google stated at Google IO 2008 that it would not
support a specific Python web framework and that all
-community-supported frameworks would be more than welcome [1]_.
+community-supported frameworks would be more than welcome [1]_.
Therefore `Logilab`_ ported `CubicWeb` to run on top of `Google AppEngine`'s
datastore.
@@ -26,7 +26,7 @@
Please follow instructions on how to install `CubicWeb` framework
-(:ref:`CubicWebInstallation`).
+(:ref:`CubicWebInstallation`).
Installation
------------
@@ -37,7 +37,7 @@
cubicweb-ctl newgapp <myapp>
This will create a directory containing ::
-
+
`-- myapp/
|-- app.conf
|-- app.yaml
@@ -73,17 +73,17 @@
|-- yams/
`-- yapps/
-
+
This skeleton directory is a working `AppEngine` application. You will
recognize the files ``app.yaml`` and ``main.py``. All the rest is the
-`CubicWeb` framework and its third-party libraries. You will notice that
+`CubicWeb` framework and its third-party libraries. You will notice that
the directory ``cubes`` is a library of reusable cubes.
The main directories that you should know about are:
- - ``cubes`` : this is a library of reusable yams cubes. To use
- those cubes you will list them in the variable
- `included-yams-cubes` of ``app.conf``. See also :ref:`cubes`.
+ - ``cubes`` : this is a library of reusable yams cubes. To use
+ those cubes you will list them in the variable
+ `included-yams-cubes` of ``app.conf``. See also :ref:`cubes`.
- [WHICH OTHER ONES SHOULD BE LISTED HERE?]
Dependencies
@@ -91,7 +91,7 @@
Before starting anything, please make sure the following packages are installed:
- yaml : by default google appengine is providing yaml; make sure you can
- import it. We recommend you create a symbolic link yaml instead of installing
+ import it. We recommend you create a symbolic link yaml instead of installing
and using python-yaml:
yaml -> full/path/to/google_appengine/lib/yaml/lib/yaml/
- gettext
@@ -99,12 +99,12 @@
Setup
~~~~~
-Once you executed ``cubicweb-ctl newgapp <myapp>``, you can use that ``myapp/``
+Once you executed ``cubicweb-ctl newgapp <myapp>``, you can use that ``myapp/``
as an application directory and do as follows.
This installation directory provides a configuration for an instance of `CubicWeb`
-ported for Google App Engine. It is installed with its own command ``laxctl``
-which is a port of the command tool ``cubicweb-ctl`` originally developped for
+ported for Google App Engine. It is installed with its own command ``laxctl``
+which is a port of the command tool ``cubicweb-ctl`` originally developped for
`CubicWeb`.
You can have the details of available commands by running ::
@@ -119,7 +119,7 @@
``myapp/i18n``. To compile the translation files, use the `gettext` tools
or the ``laxctl`` command ::
- $ python myapp/bin/laxctl i18ncube
+ $ python myapp/bin/laxctl i18ncube
$ python myapp/bin/laxctl i18ninstance
Ignore the errors that print "No translation file found for domain
@@ -132,7 +132,7 @@
You will never need to add new entries in the translation catalog. Instead we would
recommand you to use ``self.req._("msgId")`` in your application code
to flag new message id to add to the catalog, where ``_`` refers to
-xgettext that is used to collect new strings to translate.
+xgettext that is used to collect new strings to translate.
While running ``laxctl i18ncube``, new string will be added to the catalogs.
Generating the data directory
@@ -165,7 +165,7 @@
# does this application rely on google authentication service or not.
use-google-auth=no
-
+
In ``app.yaml`` comment the `login: required` set by default in the handler::
- url: .*
@@ -187,8 +187,8 @@
$ python /path/to/google_appengine/dev_appserver.py /path/to/myapp/
-Once the local server is started, visit `http://MYAPP_URL/_load <http://localhost:8080/_load>`_ and sign in as administrator.
-This will initialize the repository and enable you to log in into
+Once the local server is started, visit `http://MYAPP_URL/_load <http://localhost:8080/_load>`_ and sign in as administrator.
+This will initialize the repository and enable you to log in into
the application and continue the installation.
You should be redirected to a page displaying a message `content initialized`.
@@ -197,7 +197,7 @@
~~~~~~~~~~~~~~~~~~~~~~~~
You, then, want to visit `http://MYAPP_URL/?vid=authinfo <http://localhost:8080/?vid=authinfo>`_ .
-If you selected not to use google authentication, you will be prompted to a
+If you selected not to use google authentication, you will be prompted to a
login form where you should initialize the administrator login (recommended
to use admin/admin at first). You will then be redirected to a page providing
you the value to provide to ``./bin/laxctl --cookie``.
@@ -212,21 +212,21 @@
:alt: displaying the detailed view of the cookie values returned
-.. note:: In case you are not redirected to a page providing the
- option --cookie value, please visit one more time
+.. note:: In case you are not redirected to a page providing the
+ option --cookie value, please visit one more time
`http://MYAPP_URL/?vid=authinfo <http://localhost:8080/?vid=authinfo>`_ .
Once, you have this value, then return to the shell and execute ::
-
+
$ python myapp/bin/laxctl db-init --cookie='dev_appserver_login=test@example.com:True; __session=7bbe973a6705bc5773a640f8cf4326cc' localhost:8080
.. note:: In the case you are not using google authentication, the value returned
- by `http://MYAPP_URL/?vid=authinfo <http://localhost:8080/?vid=authinfo>`_
+ by `http://MYAPP_URL/?vid=authinfo <http://localhost:8080/?vid=authinfo>`_
will look like :
--cookie='__session=2b45d1a9c36c03d2a30cedb04bc37b6d'
Log out by clicking in the menu at the top right corner
-and restart browsing from `http://MYAPP_URL/ <http://localhost:8080>`_
+and restart browsing from `http://MYAPP_URL/ <http://localhost:8080>`_
as a normal user.
Unless you did something to change it, http://MYAPP_URL should be