src/source/index.rst
changeset 46 5fe8d5ffccde
parent 41 9379f4e44a5a
child 50 6ed429390935
equal deleted inserted replaced
28:a7332a53e6dc 46:5fe8d5ffccde
     4    contain the root `toctree` directive.
     4    contain the root `toctree` directive.
     5 
     5 
     6 .. _index:
     6 .. _index:
     7 
     7 
     8 
     8 
     9 **WARNING**: this is a "work-in-progress" documentation. All elements described here are not publicly available yet!!!
       
    10 
     9 
       
    10 Contents
       
    11 ---------
    11 
    12 
    12 Welcome to PyAMS's documentation!
       
    13 =================================
       
    14 
       
    15 At first, PyAMS was "Pyramid Application Management Skin". Actually, it's not only a simple skin but a whole "Suite" of
       
    16 applications and content management tools.
       
    17 
       
    18 PyAMS is built on top of MyAMS (My Application Management Skin), a small web client framework built on top of JQuery
       
    19 and Bootstrap, which was developed by the french national forestry office (ONF -- Office national des forêts --
       
    20 http://www.onf.fr) to build web applications in several languages (actually java, Python and PHP). The new ONF website
       
    21 is now completely handled with PyAMS framework.
       
    22 
       
    23 PyAMS is a multipurpose set of packages, providing tools including:
       
    24 
       
    25 * custom interfaces
       
    26 * custom registry annotations
       
    27 * custom security policy
       
    28 * local registry support
       
    29 * network protocols utilities (for HTTP and XML-RPC)
       
    30 * command line scripts
       
    31 * custom utilities.
       
    32 
       
    33 *PyAMS_content* is an important package providing content management features, which can be easily extended to manage
       
    34 your own content types. But PyAMS can also be used to manage any kind of application.
       
    35 
       
    36 If you just want to know how easy it is to create a PyAMS application instance, just read the :ref:`quickstart`!
       
    37 
       
    38 To know how PyAMS management interface looks like, look at :ref:`screenshots`!
       
    39 
    13 
    40 
    14 
    41 .. toctree::
    15 .. toctree::
    42    :maxdepth: 2
    16    :maxdepth: 2
       
    17    :caption: Getting started
    43 
    18 
    44    quickstart
    19    Introduction <introduction>
    45    architecture
    20    Application architecture <architecture>
    46    install
    21    Quickstart <quickstart>
    47    config
    22 
    48    manage
    23 .. toctree::
    49    extend
    24    :maxdepth: 2
       
    25    :caption: Tutorial
       
    26 
       
    27    User’s Guide <manage>
       
    28    screenshots
       
    29 
       
    30 .. toctree::
       
    31    :maxdepth: 2
       
    32    :caption: Custom install documentation
       
    33 
       
    34    ZODB Server <zodb>
       
    35    PyAMS Installation <install>
       
    36    PyAMS Configuration <config>
       
    37    site
       
    38    scripts
    50 
    39 
    51 
    40 
    52 PyAMS applications architecture
       
    53 -------------------------------
       
    54 
       
    55 PyAMS applications are built on a small set of prerequisites and external components which *can* or, for some of them,
       
    56 *must* be included. Some of them are:
       
    57 
       
    58 * a mandatory shared ZODB;
       
    59 
       
    60 * a Redis or Memcached server, to handle cache and sessions;
       
    61 
       
    62 * a websockets server, used to handle desktop notifications; you can find information about this component in the
       
    63   :ref:`pyams_notify` chapter;
       
    64 
       
    65 * an Elasticsearch index, used to handle quick and optimized searching.
       
    66 
       
    67 See :ref:`architecture` to get all architecture details.
       
    68 
    41 
    69 
    42 
    70 PyAMS external packages
    43 PyAMS external packages
    71 -----------------------
    44 -----------------------
    72 
    45 
    73 PyAMS is built on many external packages, and provides a whole set of extensions. Here is a list of them:
    46 PyAMS is built on many external packages, and provides a whole set of extensions. Here is a list of them:
    74 
    47 
    75 * pyams_template (:ref:`pyams_template`)
       
    76 
    48 
    77 * pyams_viewlet (:ref:`pyams_viewlet`)
    49 .. toctree::
       
    50    :maxdepth: 2
       
    51    :caption:  API documentation
    78 
    52 
    79 * pyams_pagelet (:ref:`pyams_pagelet`)
    53    extend
       
    54    packages
    80 
    55 
    81 * pyams_utils (:ref:`pyams_utils`)
       
    82 
       
    83 * pyams_skin (:ref:`pyams_skin`)
       
    84 
       
    85 * pyams_form (:ref:`pyams_form`)
       
    86 
       
    87 * pyams_file (:ref:`pyams_file`)
       
    88 
       
    89 * pyams_i18n (:ref:`pyams_i18n`)
       
    90 
       
    91 * pyams_security (:ref:`pyams_security`)
       
    92 
       
    93 * pyams_zmi (:ref:`pyams_zmi`)
       
    94 
       
    95 * pyams_zodbbrowser (:ref:`pyams_zodbbrowser`)
       
    96 
       
    97 * pyams_catalog (:ref:`pyams_catalog`)
       
    98 
       
    99 * pyams_mail (:ref:`pyams_mail`)
       
   100 
       
   101 * pyams_ldap (:ref:`pyams_ldap`)
       
   102 
       
   103 * pyams_cache (:ref:`pyams_cache`)
       
   104 
       
   105 * pyams_alchemy (:ref:`pyams_alchemy`)
       
   106 
       
   107 * pyams_zmq (:ref:`pyams_zmq`)
       
   108 
       
   109 * pyams_scheduler (:ref:`pyams_scheduler`)
       
   110 
       
   111 * pyams_workflow (:ref:`pyams_workflow`)
       
   112 
       
   113 * pyams_thesaurus (:ref:`pyams_thesaurus`)
       
   114 
       
   115 * pyams_sequence (:ref:`pyams_sequence`)
       
   116 
       
   117 * pyams_portal (:ref:`pyams_portal`)
       
   118 
       
   119 * pyams_media (:ref:`pyams_media`)
       
   120 
       
   121 * pyams_notify (:ref:`pyams_notify`)
       
   122 
       
   123 * pyams_gis (:ref:`pyams_gis`)
       
   124 
       
   125 * pyams_content (:ref:`pyams_content`)
       
   126 
       
   127 * pyams_content_es (:ref:`pyams_content_es`)
       
   128 
    56 
   129 
    57 
   130 Indices and tables
    58 Indices and tables
   131 ------------------
    59 ------------------
   132 
    60