| author | Sylvain Thénault <sylvain.thenault@logilab.fr> |
| Mon, 17 Jan 2011 12:41:45 +0100 | |
| branch | stable |
| changeset 6833 | 8fe4b003c1bc |
| parent 5432 | ee246e1813c6 |
| child 6835 | 87e2641d75f7 |
| permissions | -rw-r--r-- |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
1 |
.. -*- coding: utf-8 -*- |
|
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
2 |
|
|
2175
16d3c37c5d28
[doc] improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2174
diff
changeset
|
3 |
.. _BlogFiveMinutes: |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
4 |
|
|
2175
16d3c37c5d28
[doc] improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2174
diff
changeset
|
5 |
Get a blog running in five minutes! |
|
16d3c37c5d28
[doc] improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2174
diff
changeset
|
6 |
----------------------------------- |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
7 |
|
|
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
8 |
For Debian or Ubuntu users, first install the following packages |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
9 |
(:ref:`DebianInstallation`):: |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
10 |
|
|
1441
8e7a99cbce3c
[doc] Short down the `blog running in less ten nimutes` section to remove duplicated content.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
1439
diff
changeset
|
11 |
cubicweb, cubicweb-dev, cubicweb-blog |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
12 |
|
|
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
13 |
For Windows or Mac OS X users, you must install |cubicweb| from source (see |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
14 |
:ref:`SourceInstallation` and :ref:`WindowsInstallation`). |
|
4431
e597e0ca67cd
Updated CW tutorial.
Adrien Chauve <adrien.chauve@logilab.fr>
parents:
4143
diff
changeset
|
15 |
|
|
2175
16d3c37c5d28
[doc] improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2174
diff
changeset
|
16 |
Then create and initialize your instance:: |
|
2172
cf8f9180e63e
delete-trailing-whitespace
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
1715
diff
changeset
|
17 |
|
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
18 |
cubicweb-ctl create blog myblog |
|
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
19 |
|
|
2175
16d3c37c5d28
[doc] improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
2174
diff
changeset
|
20 |
And start it:: |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
21 |
|
|
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
22 |
cubicweb-ctl start -D myblog |
|
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
23 |
|
|
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
24 |
The -D option is the debugging mode of |cubicweb|, removing it will lauch the |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
25 |
instance in the background. |
| 4143 | 26 |
|
27 |
Permission |
|
28 |
~~~~~~~~~~ |
|
29 |
||
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. |
|
31 |
||
32 |
Instance parameters |
|
33 |
~~~~~~~~~~~~~~~~~~~ |
|
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
34 |
|
|
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
35 |
If you would like to change some instance parameters, for example, the main |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
36 |
database host or the user name, edit the `sources` file located in the |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
37 |
:file:`/etc/cubicweb.d/myblog` directory. |
| 4143 | 38 |
|
|
5432
ee246e1813c6
[doc] various small improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5253
diff
changeset
|
39 |
Then relaunch the database creation:: |
| 4143 | 40 |
|
41 |
cubicweb-ctl db-create myblog |
|
42 |
||
|
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
43 |
Other paramaters, like web server or emails parameters, can be modified in the |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
44 |
:file:`/etc/cubicweb.d/myblog/all-in-one.conf` file. |
| 4143 | 45 |
|
|
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
46 |
This is it. Your blog is running. Visit http://localhost:8080 and enjoy it! This |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
47 |
blog is fully functionnal. The next section section will present the way to |
|
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
48 |
develop new cubes and customizing the look of your instance. |
|
1210
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
49 |
|
|
47a3eb4bbe66
[doc] Adds a short section on how to launch a blog based on the packages cubicweb and cubicweb-blog.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
diff
changeset
|
50 |