3 .. _BlogFiveMinutes: |
3 .. _BlogFiveMinutes: |
4 |
4 |
5 Get a blog running in five minutes! |
5 Get a blog running in five minutes! |
6 ----------------------------------- |
6 ----------------------------------- |
7 |
7 |
8 For Debian or Ubuntu users, first install the following packages (:ref:`DebianInstallation`):: |
8 For Debian or Ubuntu users, first install the following packages |
|
9 (:ref:`DebianInstallation`):: |
9 |
10 |
10 cubicweb, cubicweb-dev, cubicweb-blog |
11 cubicweb, cubicweb-dev, cubicweb-blog |
11 |
12 |
12 For Windows or Mac OS X users, you must install cubicweb from source (see :ref:`SourceInstallation` and :ref:`WindowsInstallation`). |
13 For Windows or Mac OS X users, you must install |cubicweb| from source (see |
|
14 :ref:`SourceInstallation` and :ref:`WindowsInstallation`). |
13 |
15 |
14 Then create and initialize your instance:: |
16 Then create and initialize your instance:: |
15 |
17 |
16 cubicweb-ctl create blog myblog |
18 cubicweb-ctl create blog myblog |
17 |
19 |
18 And start it:: |
20 And start it:: |
19 |
21 |
20 cubicweb-ctl start -D myblog |
22 cubicweb-ctl start -D myblog |
21 |
23 |
22 The -D option is the debugging mode of cubicweb, removing it will lauch the instance in the background. |
24 The -D option is the debugging mode of |cubicweb|, removing it will lauch the |
|
25 instance in the background. |
23 |
26 |
24 Permission |
27 Permission |
25 ~~~~~~~~~~ |
28 ~~~~~~~~~~ |
26 |
29 |
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. |
30 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 |
31 |
29 Instance parameters |
32 Instance parameters |
30 ~~~~~~~~~~~~~~~~~~~ |
33 ~~~~~~~~~~~~~~~~~~~ |
31 |
34 |
32 If you would like to change some instance parameters, for example, the database host or the user name, edit the `source` file located in the /etc/cubicweb.d/myblog directory. |
35 If you would like to change some instance parameters, for example, the main |
|
36 database host or the user name, edit the `sources` file located in the |
|
37 :file:`/etc/cubicweb.d/myblog` directory. |
33 |
38 |
34 Then relaunch the database creation:: |
39 Then relaunch the database creation:: |
35 |
40 |
36 cubicweb-ctl db-create myblog |
41 cubicweb-ctl db-create myblog |
37 |
42 |
38 Other paramaters, like web server or emails parameters, can be modified in the `all-in-one.conf` file. |
43 Other paramaters, like web server or emails parameters, can be modified in the |
|
44 :file:`/etc/cubicweb.d/myblog/all-in-one.conf` file. |
39 |
45 |
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. |
46 This is it. Your blog is running. Visit http://localhost:8080 and enjoy it! This |
|
47 blog is fully functionnal. The next section section will present the way to |
|
48 develop new cubes and customizing the look of your instance. |
41 |
49 |
42 |
50 |