author | Sylvain Thénault <sylvain.thenault@logilab.fr> |
Mon, 17 Jan 2011 12:43:07 +0100 | |
branch | stable |
changeset 6835 | 87e2641d75f7 |
parent 6833 | 8fe4b003c1bc |
child 6837 | 7562418985ef |
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 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
3 |
.. _TutosBaseBlogFiveMinutes: |
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 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
20 |
You'll be asked a few questions, and you can keep the default answer for most of |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
21 |
them. The one question you'll have to think about is the database you'll want to |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
22 |
use for that instance. For a quick test, if you don't have `postgresql` installed |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
23 |
and configured (see :ref:`PostgresqlConfiguration`), it's higly recommended to |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
24 |
choose `sqlite` when asked for which database driber to use, since it has a much |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
25 |
simple setup (no database server needed). |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
26 |
|
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
27 |
One the process is completed (including database initialisation), you can start |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
28 |
your instance by using: :: |
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
|
29 |
|
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
|
30 |
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
|
31 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
32 |
The `-D` option activate the debugging mode, removing it will launch the instance |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
33 |
as a daemon in the background. |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
34 |
|
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
35 |
|
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
36 |
About file-system permissions |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
37 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
4143 | 38 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
39 |
Unless you installed from sources, above commands assumes that you have root |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
40 |
access to the :file:`/etc/` path. In order to initialize your instance as a |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
41 |
regulary user, within your home directory, you can use the :envvar:`CW_MODE` |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
42 |
environment variable: :: |
4143 | 43 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
44 |
export CW_MODE=user |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
45 |
|
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
46 |
then create a :file:`~/etc/cubicweb.d` directory that will hold your instances. |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
47 |
|
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
48 |
More information about how to configure your own environment in :ref:`ResourceMode`. |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
49 |
|
4143 | 50 |
|
51 |
Instance parameters |
|
52 |
~~~~~~~~~~~~~~~~~~~ |
|
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
|
53 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
54 |
If you would like to change database parameters such as the database host or the |
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
55 |
user name used to connect to the database, edit the `sources` file located in the |
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
56 |
:file:`/etc/cubicweb.d/myblog` directory. |
4143 | 57 |
|
5432
ee246e1813c6
[doc] various small improvements
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
5253
diff
changeset
|
58 |
Then relaunch the database creation:: |
4143 | 59 |
|
60 |
cubicweb-ctl db-create myblog |
|
61 |
||
6833
8fe4b003c1bc
[doc] some ReST syntax fixes
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5432
diff
changeset
|
62 |
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
|
63 |
:file:`/etc/cubicweb.d/myblog/all-in-one.conf` file. |
4143 | 64 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
65 |
You'll have to restart the instance after modification in one of those files. |
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
|
66 |
|
6835
87e2641d75f7
[doc] major rework of the simple blog tutorial
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6833
diff
changeset
|
67 |
This is it. Your blog is functionnal and running. Visit http://localhost:8080 and enjoy 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
|
68 |