Fork me on GitHub
Phraseanet Documentation

Table Of Contents

You are currently viewing the version 4.1. View another version : 

Documentation Guidelines

This documentation is free ; you can edit, enhance and modify it as you want.

To start contribute, the simplest way is to start imitating documentation as it already exists.

You’ll find below some rules and the most common markup used in this documentation.

Rules

  • Lines do not exceed 80 characters
  • Text must be UTF-8 encoded
  • Documentation should not be optimized for PDF nor HTML
  • Documentation must be publishable as GPLv3

Memo

Structure

  • Lists

    * first
    * second
    * third
    
    • first
    • second
    • third
  • Titles and Sub-Titles

    H1 -- Titre
    ===========
    
    H2 -- Sub titre
    ---------------
    
    H3 -- Sub section
    ******************
    
    H4 -- Sub sub section
    ^^^^^^^^^^^^^^^^^^^^^
    
    H5
    ~~~~~~~~~~~~~~~~~~~~~~~
    
  • Images

    .. figure:: ../images/gplv3.png
      :align:  center
      :alt:    GPLv3 logo
    
      License GNU GPL v3
    
    GPLv3 logo

    Image Caption

Format

  • Bold / Italic

    **bold** et *italic*
    

    bold et italic

  • External link

    `example dot com`_
    
    .. _example dot com: http://www.example.com/
    

    example dot com

    Note

    You should reference links at the bottom of the page.

  • Internal link

    :doc:`These rules <DocumentationGuidelines>`
    

    These rules

  • Glossary link

    :term:`record`
    

    record

Meta Markups

  • Notes:

    .. note::
    
        A note
    

    Note

    A note

  • Warning:

    .. warning::
    
        Un warning
    

    Warning

    Un warning

  • Version added

    .. versionadded:: 3.5.0
    

    New in version 3.5.0.

  • Version changed

    .. versionchanged:: 3.5.0
    

    Changed in version 3.5.0.

  • References

    .. seealso::
    
        online documentation at https://www.sphinx-doc.org/en/master/
    

    See also

    online documentation at https://www.sphinx-doc.org/en/master/

  • Topic

    .. topic:: Topic Title (for example: The essential)
    

    Subsequent indented lines comprise the body of the topic, and are interpreted as body elements.

Topic Title (for example: The essential)

Subsequent indented lines comprise the body of the topic, and are interpreted as body elements.