1 .. -*- coding: utf-8 -*-

     2 

     3 .. _BlogFiveMinutes:

     4 

     5 Get a blog running in five minutes!

     6 -----------------------------------

     7 

     8 For Debian or Ubuntu users, first install the following packages (:ref:`DebianInstallation`)::

     9 

    10     cubicweb, cubicweb-dev, cubicweb-blog

    11 

    12 For Windows or Mac OS X users, you must install cubicweb from source (see :ref:`SourceInstallation` and  :ref:`WindowsInstallation`).

    13 

    14 Then create and initialize your instance::

    15 

    16     cubicweb-ctl create blog myblog

    17 

    18 And start it::

    19 

    20     cubicweb-ctl start -D myblog

    21 

    22 The -D option is the debugging mode of cubicweb, removing it will lauch the instance in the background.

    23 

    24 Permission

    25 ~~~~~~~~~~

    26 

    27 This command assumes that you have root access to the /etc/ path. In order to initialize your instance as a `user` (from scratch), please check your current PYTHONPATH then create the ~/etc/cubicweb.d directory.

    28 

    29 Instance parameters

    30 ~~~~~~~~~~~~~~~~~~~

    31 

    32 If the database installation failed, you'd like to change some instance parameters, for example, the database host or the user name. These informations can be edited in the `source` file located in the /etc/cubicweb.d/myblog directory.

    33 

    34 Then relaunch the database creation:

    35 

    36      cubicweb-ctl db-create myblog

    37 

    38 Other paramaters, like web server or emails parameters, can be modified in the `all-in-one.conf` file.

    39 

    40 This is it. Your blog is running. Visit http://localhost:8080 and enjoy it! This blog is fully functionnal. The next section section will present the way to develop new cubes and customizing the look of your instance.

    41 

    42