[doc] improve blog tutorial first steps and explain common errors 3.26
authorLaurent Peuch <cortex@worlddomination.be>
Tue, 12 Feb 2019 14:48:52 +0100
branch3.26
changeset 12436 d24f45087808
parent 12435 af93bf9723b4
child 12437 d8e36de16f24
[doc] improve blog tutorial first steps and explain common errors
doc/tutorials/base/blog-in-five-minutes.rst
--- a/doc/tutorials/base/blog-in-five-minutes.rst	Tue Feb 12 11:38:19 2019 +0100
+++ b/doc/tutorials/base/blog-in-five-minutes.rst	Tue Feb 12 14:48:52 2019 +0100
@@ -23,6 +23,14 @@
 
     cubicweb-ctl create blog myblog
 
+The `blog` argument is the cube on which you want to base your instance and
+`myblog` is the name of your instance.
+
+.. Note::
+
+   If you get an a permission error of this kind `OSError: [Errno 13]
+   Permission denied: '/etc/cubicweb.d/myblog'`, read the :ref:`next section`.
+
 You'll be asked a few questions, and you can keep the default answer for most of
 them. The one question you'll have to think about is the database you'll want to
 use for that instance. For a quick test, if you don't have `postgresql` installed
@@ -44,6 +52,7 @@
    If you get a traceback when going on the web interface make sure your
    version of twisted is **inferior** to 17.
 
+.. _AboutFileSystemPermissions:
 
 About file system permissions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -73,7 +82,7 @@
      cubicweb-ctl db-create myblog
 
 Other parameters, like web server or emails parameters, can be modified in the
-:file:`/etc/cubicweb.d/myblog/all-in-one.conf` file.
+:file:`/etc/cubicweb.d/myblog/all-in-one.conf` file (or :file:`~/etc/cubicweb.d/myblog/all-in-one.conf` depending on your configuration.)
 
 You'll have to restart the instance after modification in one of those files.