doc/book/en/tutorials/base/index.rst
branchstable
changeset 6835 87e2641d75f7
parent 5262 ebd90d2a5639
child 6837 7562418985ef
equal deleted inserted replaced
6834:b4befa12bbcc 6835:87e2641d75f7
     1 .. -*- coding: utf-8 -*-
     1 .. -*- coding: utf-8 -*-
     2 
     2 
     3 .. _Tutorial:
     3 .. _TutosBase:
     4 
     4 
     5 .. _tuto_blog:
     5 Building a simple blog with |cubicweb|
       
     6 ======================================
     6 
     7 
     7 Building a simple blog
     8 |cubicweb| is a semantic web application framework that favors reuse and
     8 ======================
       
     9 
       
    10 *CubicWeb* is a semantic web application framework that favors reuse and
       
    11 object-oriented design.
     9 object-oriented design.
    12 
    10 
    13 A `cube` is a component that includes a model defining the data types and a set of
       
    14 views to display the data. A cube can be built by assembling other cubes.
       
    15 
    11 
    16 An `instance` is a specific installation of a cube and includes configuration
    12 This tutorial is designed to help in your very first steps to start with
    17 files.
    13 |cubicweb|. We will glance through basic concepts such as:
       
    14 
       
    15 * having an application running by using existing components
       
    16 * discovering the default user interface
       
    17 * basically extending and customizing the look and feel of that application
       
    18 
       
    19 More advanced concepts will covered in :ref:`advanced_tutorial`.
    18 
    20 
    19 
    21 
    20 This tutorial will show how to create a `cube` and how to use it as an
    22 .. _TutosBaseVocab:
    21 application to run an `instance`.
    23 
       
    24 Some vocabulary
       
    25 ---------------
       
    26 
       
    27 |cubicweb| comes with a few words of vocabulary that you should know to
       
    28 understand what we're talking about. To follow this tutorial, you should at least
       
    29 know that:
       
    30 
       
    31 * a `cube` is a component that usually includes a model defining some data types
       
    32   and a set of views to display them. A cube can be built by assembling other
       
    33   cubes;
       
    34 
       
    35 * an `instance` is a specific installation of one more more cubes and includes
       
    36   configuration files, a web server and a database.
       
    37 
       
    38 Reading :ref:`Concepts` for more vocabulary will be a must do at some point.
       
    39 
       
    40 Now, let's start the hot stuff!
    22 
    41 
    23 .. toctree::
    42 .. toctree::
    24    :maxdepth: 2
    43    :maxdepth: 2
    25 
    44 
    26    blog-in-five-minutes
    45    blog-in-five-minutes
    27    create-cube
    46    discovering-the-ui
    28    components
    47    customizing-the-application
    29    maintemplate
       
    30    conclusion
    48    conclusion