Updated installation notice
authorThierry Florac <thierry.florac@onf.fr>
Wed, 07 Jun 2017 10:46:30 +0200
changeset 85 e2b79f699cf2
parent 84 26d427cd976a
child 86 da68d40a1a49
Updated installation notice
docs/source/install.rst
--- a/docs/source/install.rst	Thu Jun 01 15:23:21 2017 +0200
+++ b/docs/source/install.rst	Wed Jun 07 10:46:30 2017 +0200
@@ -32,66 +32,26 @@
 
 PyAMS provides a new Pyramid scaffold, called *pyams*, provided by the *pyams_base* package.
 
-A simple option to install PyAMS is to create a buildout environment including *Pyramid* and *PyAMS_base* packages:
+A simple option to install PyAMS is to create a buildout environment including *Pyramid* and all *PyAMS* packages:
 
 .. code-block:: bash
 
-    # mkdir /var/local/env/
+    # mkdir /var/local/
     # pip3 install virtualenv
-    # virtualenv --python=python3.5 pyams
-    # cd pyams
+    # virtualenv --python=python3.5 env
+    # cd env
     # . bin/activate
-    (pyams) # pip3.5 install zc.buildout
-    (pyams) # buildout init
-
-Then update your Buildout configuration file *buildout.cfg* as follow:
-
-.. code-block:: ini
+    (pyams) # pip3.5 install cookiecutter
+    (pyams) # cookiecutter hg+http://hg.ztfy.org/pyams/scaffolds/pyams
 
-    [buildout]
-    find-links = http://download.ztfy.org/eggs
-    extends = http://download.ztfy.org/pyams/pyams-0.1.0.cfg
-    socket-timeout = 3
-    show-picked-versions = true
-    newest = false
-    allow-hosts =
-        *.python.org
-        *.sourceforge.net
-        github.com
-        bitbucket.org
-    versions = versions
-    eggs-directory = eggs
-    parts = pyramid
-
-    [pyramid]
-    recipe = zc.recipe.egg
-    dependent-scripts = true
-    eggs =
-        pyramid
-        pyams_base
-    interpreter = py3.4
-
-Then launch the buildout initialization:
-
-.. code-block:: bash
-
-    (pyams) # ./bin/buildout
-    (pyams) # ./bin/pcreate -l
-    Available scaffolds:
-      alchemy:        Pyramid project using SQLAlchemy, SQLite, URL dispatch, and
-      pyams:          Pyramid project using all PyAMS packages
-      pyams_asyncio:  Pyramid AsyncIO project using websockets for PyAMS notifications
-      starter:        Pyramid starter project using URL dispatch and Chameleon
-      zodb:           Pyramid project using ZODB, traversal, and Chameleon
-    (pyams) # ./bin/pcreate -t pyams myapp
-    (pyams) # cd myapp
+CookieCutter will ask for for a small set of input variables that you can change or not.
 
 You can then check, and eventually update, the proposed Buildout configuration file *buildout.cfg*, to add or remove
 packages or update settings to your needs. Then finalize Bootstrap initialization:
 
 .. code-block:: bash
 
-    (pyams) # ../bin/buildout bootstrap
+    (pyams) # python3.5 bootstrap.py
     (pyams) # ./bin/buildout
 
 This last operation can be quite long, as many packages have to downloaded, compiled and installed in the virtual