summaryrefslogtreecommitdiff
path: root/docs/en/upgrade.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/en/upgrade.rst')
-rw-r--r--docs/en/upgrade.rst37
1 files changed, 31 insertions, 6 deletions
diff --git a/docs/en/upgrade.rst b/docs/en/upgrade.rst
index d44ae02..d0eaa4c 100644
--- a/docs/en/upgrade.rst
+++ b/docs/en/upgrade.rst
@@ -5,7 +5,7 @@ Upgrade
=======
:Author: Étienne Loks
-:date: 2012-10-08
+:date: 2013-02-01
:Copyright: CC-BY 3.0
This document presents the upgrade of Chimère.
@@ -146,13 +146,16 @@ Version 1.2 -> 2.0
Project template
................
-Create a new project template:
+A default project can be found on `Gitorious
+<https://gitorious.org/chimere-example-project/chimere-example-project>`_. Get
+it and start a new project with it (or get another project based on Chimère)::
.. code-block:: bash
cd $CHIMERE_PATH
- cp -ra $CHIMERE_PATH/example_project $CHIMERE_LOCALNAME
- CHIMERE_APP_PATH=$CHIMERE_PATH/$CHIMERE_LOCALNAME
+ git clone git://gitorious.org/chimere-example-project/chimere-example-project.git
+ django-admin startproject --template=chimere-example-project mychimere_project
+ rm -rf chimere-example-project
local_settings
..............
@@ -195,6 +198,15 @@ Move old static files to the new static directory:
cp -ra $CHIMERE_PATH/chimere/static/* $CHIMERE_APP_PATH/static/
cp -ra $CHIMERE_PATH/chimere/static/icons/* $CHIMERE_APP_PATH/media/icons/
cp -ra $CHIMERE_PATH/chimere/static/upload $CHIMERE_APP_PATH/media/
+ rm -rf $CHIMERE_PATH/chimere/static/icons
+ rm -rf $CHIMERE_PATH/chimere/static/upload
+
+Update permissions for media directory:
+
+.. code-block:: bash
+
+ chown www-data -R $CHIMERE_APP_PATH/media/
+
Webserver configuration
.......................
@@ -251,7 +263,7 @@ Django South is now used to manage database migrations.
.. code-block:: bash
cd $CHIMERE_APP_PATH
- ./manage.py syncdb
+ ./manage.py syncdb --noinput
./manage.py migrate chimere 0001 --fake # fake the database initialisation
./manage.py migrate chimere
@@ -292,6 +304,7 @@ Version 1.2 -> 2.0 -> master
cd $CHIMERE_PATH/chimere
django-admin compilemessages
+
Forcing the refresh of visitor's web browser cache
--------------------------------------------------
@@ -304,8 +317,20 @@ that edit your local_settings.py and change::
to::
- STATIC_URL = '/static/v2.0.0/'
+ STATIC_URL = '/static-v2.0.0/'
Then change the webserver directive to point to your new path.
Restart the web server to apply this changes.
+Configuring the Sites framework
+-------------------------------
+
+Version 1.2 -> 2.0
+******************
+
+*Sites* framework allow you to serve the same content on different domains.
+Most of you will probably use only one domain but this unique domain has to
+be configured. This is done in the web administration interface in *Sites > Sites*.
+You only need to change *example.com* by your domain name. If you forget to
+do that, some functionalities such as RSS feeds will not work properly.
+