Documentation tutorial¶

2020-4-30

Anne Gentle <annegentle@gmail.com>
à:   write-the-docs@googlegroups.com
date:        7 août 2013 16:50
objet:       Re: Resources for writing good documentation

Hey all,

Looks like I am going to be giving a beginners presentation about writing
docs at the PDX Python user group.
I am adding a resource section that will list good places to go to look for
information about writing docs. My current list contains:

* http://producingoss.com/en/getting-started.html
* http://docs.writethedocs.org/

What are some other good documentation resources that I might be missing ?
I hope to add all of the content from this talk back into docs.writethedocs.org,
so that it will live on.

- :ref:`github_fork_and_edit_button`
- https://github.com/blog/844-forking-with-the-edit-button
- https://confluence.atlassian.com/display/BITBUCKET/Fork+a+Repo,+Compare+Code,+and+Create+a+Pull+Request

johnKitchin07 <johnrkitchin@gmail.com>
répondre à  sphinx-dev@googlegroups.com
à   sphinx-dev <sphinx-dev@googlegroups.com>
date    17 mars 2011 14:11
objet   [sphinx-dev] Re: Wiki based on Sphinx
liste de diffusion  <sphinx-dev.googlegroups.com> Filtrer les messages de cette liste de diffusion

language = "es"

language = "ca"

# Add file patterns to exclude from build
exclude_patterns = []

# Add file patterns to exclude from build
exclude_patterns = ["drafts/*"]

if conf_product==’mini’:
        exclude_patterns = ['interface/*.rst',’dialogs/*.rst’]
elif conf_product==’main’:
        exclude_patterns = ['mini-indexes.rst]

:abbr:`LIFO (last-in, first-out)`.

For example, if the reference :doc:`command` occurs in the document inline/index,
then the link refers to :file:`inline/command`.

reference is :doc:`Index principal </index>` or :doc:`Index local <../index>`

reference is :doc:`/index` or :doc:`../index`

The name of an OS-level command, such as :command:`rm`.

See :download:`this example script <../example.py>`.

.. glossary::

   environment
      A structure where information about all documents under the root is
      saved, and used for cross-referencing.  The environment is pickled
      after the parsing stage, so that successive runs only need to read
      and parse new and changed documents.

   source directory
      The directory which, including its subdirectories, contains all
      source files for one Sphinx project.

.. glossary::

   term 1
   term 2
      Definition of both terms.

button :guilabel:`Start`

button :guilabel:`&Start`

:menuselection:`Start --> Programs`

:menuselection:`Start --> &Programs`

:program:`Geany.exe`

See :term:`Sphinx`

.. index::
   single: execution; context
   module: __main__
   module: sys
   triple: module; search; path

The execution context
---------------------

...

   .. index:: Python

and one page contains ::

   .. index:: ! Python

then the backlink to the latter page is emphasized among the three backlinks.

For index directives containing only "single" entries, there is a shorthand
notation::

   .. index:: BNF, grammar, syntax, notation

This creates four index entries.

.. versionchanged:: 1.1
   Added ``see`` and ``seealso`` types, as well as marking main entries.

.. only:: html and draft

# tags.add('student')
# tags.add('stagiaire')
tags.add('prof')

.. only prof

    Solution du problème

.. index::
   pair: sphinx ; pair
   pair: sphinx important; contents

.. contents::
   :local:

.. contents::
   :depth: 2

.. deprecated:: 3.1
   Use :func:`spam` instead.

.. hlist::
   :columns: 3

   * A list of
   * short items
   * that should be
   * displayed
   * horizontally

.. note::

   This function is not suitable for sending spam e-mails.

.. versionadded:: 2.5
   The *spam* parameter.

.. default-domain:: name

.. default-domain:: C

.. c:function:: PyObject* PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems)

.. c:member:: PyObject* PyTypeObject.tp_bases

.. rst:directive:: .. c:macro:: name

.. rst:directive:: .. c:type:: name

.. c:var:: PyObject* PyClass_Type

.. rst:role:: c:data

.. rst:role:: c:func

.. rst:role:: c:macro

.. rst:role:: c:type

.. cpp:function:: bool namespaced::theclass::method(int arg1, std::string arg2)

   Describes a method with parameters and types.

.. cpp:function:: bool namespaced::theclass::method(arg1, arg2)

   Describes a method without types.

.. cpp:function:: const T &array<T>::operator[]() const

   Describes the constant indexing operator of a templated array.

.. cpp:function:: operator bool() const

   Describe a casting operator here.

.. cpp:function:: constexpr void foo(std::string &bar[2]) noexcept

   Describe a constexpr function here.

.. cpp:member:: std::string theclass::name

.. cpp:member:: std::string theclass::name[N][M]

.. cpp:type:: theclass::const_iterator

.. literalinclude:: example.py

.. literalinclude:: example.rb
   :language: ruby
   :linenos:

15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# -*- coding: UTF-8 -*-
'''Returns a table of file names with the following informations

'''

__author__ = 'Patrick Vergain <pvergain@gmail.com>'


import hashlib
import logging
import zlib

from unipath import Path


log = logging.getLogger('get_table_hash')

class crc32(object):
    '''hashlib-compatible interface for CRC-32 support
    
    http://stackoverflow.com/questions/1742866/compute-crc-of-file-in-python
    '''
    name = 'crc32'
    digest_size = 4
    block_size = 1

    def __init__(self, arg=''):
        self.__digest = 0
        self.update(arg)

    def copy(self):
        copy = super(self.__class__, self).__new__(__class__)
        copy.__digest = self.__digest
        return copy

    def digest(self):
        return self.__digest

    def hexdigest(self):
        return '{:08x}'.format(self.__digest)

    def update(self, arg):
        self.__digest = zlib.crc32(arg, self.__digest) & 0xffffffff



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# -*- coding: UTF-8 -*-
'''Returns a table of file names with the following informations

'''

__author__ = 'Patrick Vergain <pvergain@gmail.com>'


import hashlib
import logging
import zlib

from unipath import Path


log = logging.getLogger('get_table_hash')

class crc32(object):
    '''hashlib-compatible interface for CRC-32 support
    
    http://stackoverflow.com/questions/1742866/compute-crc-of-file-in-python
    '''
    name = 'crc32'
    digest_size = 4
    block_size = 1

    def __init__(self, arg=''):
        self.__digest = 0
        self.update(arg)

    def copy(self):
        copy = super(self.__class__, self).__new__(__class__)
        copy.__digest = self.__digest
        return copy

    def digest(self):
        return self.__digest

    def hexdigest(self):
        return '{:08x}'.format(self.__digest)

    def update(self, arg):
        self.__digest = zlib.crc32(arg, self.__digest) & 0xffffffff



.. literalinclude:: example.py
   :diff: example.py.orig

--- /home/docs/checkouts/readthedocs.org/user_builds/devopstutodoc/checkouts/stable/documentation/doc_generators/sphinx/rest_sphinx/code/literalinclude/example.py.orig
+++ /home/docs/checkouts/readthedocs.org/user_builds/devopstutodoc/checkouts/stable/documentation/doc_generators/sphinx/rest_sphinx/code/literalinclude/example.py
@@ -7,16 +7,8 @@
 
 
 import hashlib
-
-# see http://petl.readthedocs.org/en/latest/ 
-# Extract, Transform and Load (Tables of Data)
-from petl import look
-import glob
-import os
-import argparse
 import logging
 import zlib
-import sys
 
 from unipath import Path
 

.. literalinclude:: example.py
   :linenos:
   :caption:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# -*- coding: UTF-8 -*-
'''Returns a table of file names with the following informations

'''

__author__ = 'Patrick Vergain <pvergain@gmail.com>'


import hashlib
import logging
import zlib

from unipath import Path


log = logging.getLogger('get_table_hash')

class crc32(object):
    '''hashlib-compatible interface for CRC-32 support
    
    http://stackoverflow.com/questions/1742866/compute-crc-of-file-in-python
    '''
    name = 'crc32'
    digest_size = 4
    block_size = 1

    def __init__(self, arg=''):
        self.__digest = 0
        self.update(arg)

    def copy(self):
        copy = super(self.__class__, self).__new__(__class__)
        copy.__digest = self.__digest
        return copy

    def digest(self):
        return self.__digest

    def hexdigest(self):
        return '{:08x}'.format(self.__digest)

    def update(self, arg):
        self.__digest = zlib.crc32(arg, self.__digest) & 0xffffffff



.. code-block:: python
   :emphasize-lines: 3,5

   def some_function():
       interesting = False
       print 'This line is highlighted.'
       print 'This one is not...'
       print '...but this one is.'

def some_function():
    interesting = False
    print 'This line is highlighted.'
    print 'This one is not...'
    print '...but this one is.'

.. literalinclude:: example.py
   :lines: 1,3,5-10,20-

.. literalinclude:: example.py
   :language: python
   :encoding: latin-1

.. literalinclude:: example.py
   :pyobject: Timer.start

.. c:function:: DWORD CR_RFID_VerifierPIN(ST_CODE_PIN *pCodePIN)

    Le code PIN permet d'autoriser l'utilisation des clés de chiffrement et de
    signature dans le lecteur RFID.

    :Paramètres:
        :entree:
            :pCodePIN: le code PIN à présenter au lecteur RFID.

    :Returns:
       :error:  :ref:`see the error codes <list_error_codes>`
       :success:  :ref:`COMMAND_SUCCESS <cr_success>`

de  Luc Saffre <luc.saffre@gmail.com>
heure de l'expéditeur   Envoyé à 14:26 (GMT+02:00). Heure locale : 17:00. ✆
répondre à  sphinx-dev@googlegroups.com
à   sphinx-dev <sphinx-dev@googlegroups.com>
date    18 février 2011 14:26
objet   [sphinx-dev] toctree glob ordering
liste de diffusion  <sphinx-dev.googlegroups.com> Filtrer les messages de cette liste de diffusion

.. toctree::
  :maxdepth: 1
  :glob:

  ?
  ??

.. image:: picture.png

.. image:: picture.jpeg
   :height: 100px
   :width: 200 px
   :scale: 50 %
   :alt: alternate text
   :align: right

.. image:: ../images/wiki_logo_openalea.png

.. image:: ../images/wiki_logo_openalea.png
    :width: 200px
    :align: center
    :height: 100px
    :alt: alternate text

.. figure:: ../images/wiki_logo_openalea.png
    :width: 200px
    :align: center
    :height: 100px
    :alt: alternate text
    :figclass: align-center

    figure are like images but with a caption

    and whatever else you wish to add

    .. code-block:: python

        import image

import image

.. tabularcolumns:: m{100pt} m{300pt}
.. cssclass:: toctableopencv
=============== ======================================================
 |MatBasicIma|  **Title:** :ref:`matTheBasicImageContainer`
                *Compatibility:* > OpenCV 2.0
                *Author:* |Author_BernatG|
                You will learn how to store images in the memory and how to print out their content to the console.
=============== ======================================================
.. |MatBasicIma| image:: images/matTheBasicImageStructure.jpg
                 :height: 90pt
                 :width:  90pt

.. figure:: pagelogo_geoserver.png
   :align: center

   *The GeoServer logo as shown on the homepage.*

.. kernel-figure::  svg_image.svg
   :alt:    simple SVG image

   SVG image example

.. kernel-figure::  hello.dot
   :alt:    hello world

   DOT's hello world example

.. kernel-render:: DOT
   :alt: foobar digraph
   :caption: Embedded **DOT** (Graphviz) code

   digraph foo {
    "bar" -> "baz";
   }

.. kernel-render:: SVG
   :caption: Embedded **SVG** markup
   :alt: so-nw-arrow

   <?xml version="1.0" encoding="UTF-8"?>
   <svg xmlns="http://www.w3.org/2000/svg"
       version="1.1" baseProfile="full" width="70px" height="40px" viewBox="0 0 700 400">
       <line x1="180" y1="370" x2="500" y2="50" stroke="black" stroke-width="15px"/>
       <polygon points="585 0 525 25 585 50" transform="rotate(135 525 25)"/>
   </svg>

.. |biohazard| image:: biohazard.png

The |biohazard| symbol must be used on containers used to dispose of medical waste.

.. |doctest| replace:: :mod:`doctest`

I really like |doctest|.

* This is a bulleted list.
* It has two items, the second
  item uses two lines.

1. This is a numbered list.
2. It has two items too.

#. This is a numbered list.
#. It has two items too.

A. First item
B. Second item

* this is
* a list

  * with a nested list
  * and some subitems

* and here the parent list continues

term (up to a line of text)
   Definition of the term, which must be indented

   and can even consist of multiple paragraphs

next term
   Description.

This is a normal text paragraph. The next paragraph is a code sample::

   It is not processed in any way, except
   that the indentation is removed.

   It can span multiple lines.

This is a normal text paragraph again.

.. include myfile.rst

.. code-block:: python

With two colons you start a code block using the default highlighter::

        # Some Python code here
        # The language defaults to Python, we don't need to set it
        if 1 == 2:
                pass

# Some Python code here
# The language defaults to Python, we don't need to set it
if 1 == 2:
    pass

.. code-block:: python

        if "foo" == "bar":
                # This is Python code
                pass

if "foo" == "bar":
    # This is Python code
    pass

.. code-block:: xml

        <somesnippet>Some XML</somesnippet>

<somesnippet>Some XML</somesnippet>

.. code-block:: console

   # A comment
   sh myscript.sh

# A comment
sh myscript.sh

.. code-block:: ini

   [some-part]
   # A random part in the buildout
   recipe = collective.recipe.foo
   option = value

[some-part]
# A random part in the buildout
recipe = collective.recipe.foo
option = value

.. code-block:: pycon

   >>> class Foo:
   ...     bar = 100
   ...
   >>> f = Foo()
   >>> f.bar
   100
   >>> f.bar / 0
   Traceback (most recent call last):
         File "<stdin>", line 1, in <module>
   ZeroDivisionError: integer division or modulo by zero

>>> class Foo:
...     bar = 100
...
>>> f = Foo()
>>> f.bar
100
>>> f.bar / 0
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ZeroDivisionError: integer division or modulo by zero

.. highlight:: console

some shell commands

.. csv-table:: Balance Sheet
   :header: Description,In,Out,Balance
   :widths: 20, 10, 10, 10
   :stub-columns: 1

   Travel,,230.00,-230.00
   Fees,,400.00,-630.00
   Grant,700.00,,70.00
   Train Fare,,70.00,**0.00**

+------------------------+------------+----------+----------+
| Header row, column 1   | Header 2   | Header 3 | Header 4 |
| (header rows optional) |            |          |          |
+========================+============+==========+==========+
| body row 1, column 1   | column 2   | column 3 | column 4 |
+------------------------+------------+----------+----------+
| body row 2             | ...        | ...      |          |
+------------------------+------------+----------+----------+

+---------------------------------+------------+
| Condition                       | Decision   |
+=================================+============+
| comparison score >= threshold   | Match      |
+---------------------------------+------------+
| comparison score < threshold    | Non-Match  |
+---------------------------------+------------+

.. list-table::
   :widths: 20 80
   :header-rows: 1

   * - Shapes
     - Description
   * - Square
     - Four sides of equal length, 90 degree angles
   * - Rectangle
     - Four sides, 90 degree angles

.. list-table::
   :widths: 33 33 33
   :header-rows: 1

   * -
     -
     -

   * - .. image:: image_selection/up_image1.png
     - .. image:: image_selection/up_image2.png
     - .. image:: image_selection/up_image3.png

   * - .. image:: image_selection/down_image4.png
     - .. image:: image_selection/down_image5.png
     - .. image:: image_selection/down_image6.png

.. list-table::
   :widths: 20 60 20
   :header-rows: 1

   * - Error type
     - Definition
     - Impact

   * - False Match
     - Comparison decision of “match” for a biometric probe and a biometric
       reference that are from different fingers
     - System security lack

   * - False Non-Match
     - Comparison decision of “non-match” for a biometric probe and a biometric
       reference that are from the same finger
     - User inconvenience

.. flat-table:: table title
   :header-rows: 2
   :stub-columns: 1
   :widths: 1 1 1 1 2

   * - :rspan:`1` head / stub
     - :cspan:`3` head 1.1-4

   * - head 2.1
     - head 2.2
     - head 2.3
     - head 2.4

   * .. row body 1 / this is a comment

     - row 1
     - :rspan:`2` cell 1-3.1
     - cell 1.2
     - cell 1.3
     - cell 1.4

   * .. Comments and targets are allowed on *table-row* stage.
     .. _`row body 2`:

     - row 2
     - cell 2.2
     - :rspan:`1` :cspan:`1`
       cell 2.3 with a span over

       * col 3-4 &
       * row 2-3

   * - row 3
     - cell 3.2

   * - row 4
     - cell 4.1
     - cell 4.2
     - cell 4.3
     - cell 4.4

   * - row 5
     - cell 5.1 with automatic span to rigth end

   * - row 6
     - cell 6.1
     - ..

=====  =====  =======
A      B      A and B
=====  =====  =======
False  False  False
True   False  False
False  True   False
True   True   True
=====  =====  =======

Example of external link:  `reST role <http://sphinx-doc.org/latest/markup/inline.html#role-ref>`_ .

Takayuki Shimizukawa shimizukawa@gmail.com
répondre à:  sphinx-dev@googlegroups.com
à:   sphinx-dev@googlegroups.com
date:    30 octobre 2012 05:22
objet:   Re: [sphinx-dev] Include HTML in generated Sphinx docs

Takayuki SHIMIZUKAWA
Sphinx-users.jp

extensions = ['sphinx.ext.intersphinx']

intersphinx_mapping = {
    'javaapi': ('http://api.example.com/', 'javaapi.inv'),
}

inventory_header = u'''\
# Sphinx inventory version 2
# Project: javaapi
# Version: 2.0
# The remainder of this file is compressed with zlib.
'''.encode('utf-8')

inventory_payload = u'''\
api1 std:label -1 api.html#api1 API 1
'''.encode('utf-8')

# inventory_payload lines spec:
#   name domainname:type priority uri dispname
#
# * `name`     -- fully qualified name
# * `dispname` -- name to display when searching/linking
# * `type`     -- object type, a key in ``self.object_types``
# * `docname`  -- the document where it is to be found
# * `anchor`   -- the anchor name for the object
# * `priority` -- how "important" the object is (determines placement in search results)
#
#   - 1: default priority (placed before full-text matches)
#   - 0: object is important (placed before default-priority objects)
#   - 2: object is unimportant (placed after full-text matches)
#   - -1: object should not show up in search at all
#

inventory = inventory_header + zlib.compress(inventory_payload)
open('javaapi.inv','wb').write(inventory)

<div class="section" id="example-link-to-outer-non-sphinx-by-using-intersphinx">
<h1>Example: Link to outer non-sphinx by using intersphinx<a class="headerlink" href="#example-link-to-outer-non-sphinx-by-using-intersphinx" title="Permalink to this headline">ﾂｶ</a></h1>
<p><a class="reference external" href="http://api.example.com/api.html#api1" title="(in javaapi v2.0)"><em class="xref std std-ref">Java API 1</em></a></p>
</div>

Example: Link to outer non-sphinx by using intersphinx
==========================================================================

:ref:`Java API 1 <javaapi:api1>`

:ref:`link to internal links <internal_links>`

=================
This is a heading
=================

.. function:: foo(x)
              foo(y, z)
   :bar: no

   Return a line of text input from the user.

Lorem ipsum [#]_ dolor sit amet ... [#]_

.. rubric:: Footnotes

.. [#] Text of the first footnote.
.. [#] Text of the second footnote.

.. function:: foo(x)
              foo(y, z)
   :bar: no

   Return a line of text input from the user.

Lorem ipsum [#]_ dolor sit amet ... [#]_

.. rubric:: Footnotes

.. [#] Text of the first footnote.
.. [#] Text of the second footnote.

.. sidebar:: Sidebar Title
        :subtitle: Optional Sidebar Subtitle

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

$ sphinx-autogen -o generated *.rst

sphinx.util.relative_uri
========================

.. autofunction:: sphinx.util.relative_uri

.. confval:: autosummary_generate

:param path: The path of the file to wrap
:type path: str
:param field_storage: The :class:`FileStorage` instance to wrap
:type field_storage: FileStorage
:param temporary: Whether or not to delete the file when the File
   instance is destructed
:type temporary: bool
:returns: A buffered writable file descriptor
:rtype: BufferedFileStorage

Args:
    path (str): The path of the file to wrap
    field_storage (FileStorage): The :class:`FileStorage` instance to wrap
    temporary (bool): Whether or not to delete the file when the File
       instance is destructed

Returns:
    BufferedFileStorage: A buffered writable file descriptor

# conf.py

# Add autodoc and napoleon to the extensions list
extensions = ['sphinx.ext.autodoc', 'sphinxcontrib.napoleon']

$ sphinx-apidoc -f -o docs/source projectdir

def func(arg1, arg2):
    """Summary line.

    Extended description of function.

    Args:
        arg1 (int): Description of arg1
        arg2 (str): Description of arg2

    Returns:
        bool: Description of return value

    """
    return True

def func(arg1, arg2):
    """Summary line.

    Extended description of function.

    Parameters
    ----------
    arg1 : int
        Description of arg1
    arg2 : str
        Description of arg2

    Returns
    -------
    bool
        Description of return value

    """
    return True

.. runblock:: pycon

    >>> for i in range(5):
    ...    print i

>>> for i in range(5):
...    print i
1
2
3
4
5

.. runblock:: console

    $ date

$ date
Thu  4 Mar 2010 22:56:49 EST

$ hg clone http://bitbucket.org/birkenfeld/sphinx-contrib/
$ cd sphinx-contrib/autorun
$ python setup.py install

extensions.append('sphinxcontrib.autorun')

.. blockdiag::

   {
      planners -> seq-mco -> seq-mco-planner-11;
      planners -> seq-mco -> seq-mco-planner-12;
      planners -> seq-mco -> "seq-mco-planner-1...";
      planners -> seq-opt -> seq-opt-planner-21;
      planners -> seq-opt -> seq-opt-planner-22;
      planners -> seq-opt -> "seq-mco-planner-2...";
      planners -> seq-sat -> seq-sat-planner-31;
      planners -> seq-sat -> seq-sat-planner-32;
      planners -> seq-sat -> "seq-mco-planner-3...";
      planners -> tempo-sat -> tempo-sat-planner-41;
      planners -> tempo-sat -> tempo-sat-planner-42;
      planners -> tempo-sat -> "seq-mco-planner-4...";
   }

cd /tmp/doxygen-1.7.2
./configure --prefix /opt/doxygen/1.7.2 --with-doxywizard
make

su - root
cd /opt/doxygen
ln -s 1.7.2 current

pip install sphinxcontrib-doxylink

hg clone http://bitbucket.org/birkenfeld/sphinx-contrib
cd sphinx-contrib/doxylink
python setup.py install

:doxy:`choleskyDecomposition`

python copytree_doxygen.py

pause

# -*- coding: utf-8 -*-
"""
Copie des données doxygen.

Les données générées par doxygen sont dans le répertoire doxygen/html

Il faut copier ces données dans le répertoire sphinx/_build/html/_downloads

Précondition: le répertoire destination doit être vide.

.. function:: copytree(src, dst[, symlinks=False[, ignore=None]])

   Recursively copy an entire directory tree rooted at *src*.  The destination
   directory, named by *dst*, must not already exist; it will be created as well
   as missing parent directories.  Permissions and times of directories are
   copied with :func:`copystat`, individual files are copied using
   :func:`copy2`.


.. function:: rmtree(path[, ignore_errors[, onerror]])

   .. index:: single: directory; deleting

   Delete an entire directory tree; *path* must point to a directory (but not a
   symbolic link to a directory).  If *ignore_errors* is true, errors resulting
   from failed removals will be ignored; if false or omitted, such errors are
   handled by calling a handler specified by *onerror* or, if that is omitted,
   they raise an exception.

"""

from shutil import copytree, rmtree


destination = '_build/html/_downloads'

# le répertoire destination doit être vide
rmtree(destination)

# copie vers le répertoire destination
copytree(src='../doxygen/html', dst=destination)

Le but de la bibliothèque logicielle est de proposer une API C permettant la
communication entre:

- l'application :term:`EUCLIDE`
- un ensemble de 40 :term:`boîtiers`
- un :term:`lecteur de cartes à puces` (RFID)
- une :term:`clé RF`


:download:`Télécharger  la documentation doxygen du projet CR_Euclide <../doxygen/html/index.html>`.

.. _doxygen_documentation:

=======================
Doxygen Documentation
=======================

:download:`Télécharger  la documentation doxygen du projet CR_Euclide <../../../doxygen/html/index.html>`.

+---doxygen
|   |   TagFile.xml
|   |
|   +---def
|   |       doxygen.def
|   |
|   \---html
|       |   annotated.html
|       |   bc_s.png
|       |   classes.html
|       |   class_ryb_eliot_1_1_antennas-members.html
|       |   _write_tag_form_8cs_source.html
|       |   _write_tag_form_8_designer_8cs.html
|       |   _write_tag_form_8_designer_8cs_source.html
|       |
|
\---sphinx
    |   index.rst
    |   make.bat
    |   Makefile
    |
    |
    +---_build
    |   \---html
    |       +---_downloads
    |       |   |   annotated.html
    |       |   |   bc_s.png
    |       |   |   classes.html
    |       |   |
    |       |   \---search
    |       |           all_5f.html
    |       |           all_61.html
    |
    +---_static
    \---_templates

python doxy.py –i  doxy_xml_dir –o rst_dir –t func

python doxy.py –i  doxy_xml_dir –o rst_dir –t typedef

python doxy.py –i  doxy_xml_dir –o rst_dir

python doxy.py –i  doxy_xml_dir –o rst_dir -t all

.. toctree::
    :maxdepth: 1

    refs/index.rst

sphinx-build source_dir build_dir

GENERATE_TAGFILE       = krb5doxy.tag
GENERATE_XML           = YES

extensions = ['sphinx.ext.autodoc', 'sphinxcontrib.doxylink']
doxylink = { ' krb5doxy' : ('/tmp/krb5doxy.tag, ' doxy_html_dir ') }

extensions = [
    'hieroglyph',
]

$ sphinx-build -b slides sourcedir outdir

pip install git+http://github.com/return42/linuxdoc.git

pip install --upgrade git+http://github.com/return42/linuxdoc.git

git clone https://github.com/return42/linuxdoc
cd linuxdoc
make install

extensions = [
  'linuxdoc.rstFlatTable'      # Implementation of the 'flat-table' reST-directive.
  , 'linuxdoc.rstKernelDoc'    # Implementation of the 'kernel-doc' reST-directive.
  , 'linuxdoc.kernel_include'  # Implementation of the 'kernel-include' reST-directive.
  , 'linuxdoc.manKernelDoc'    # Implementation of the 'kernel-doc-man' builder
  , 'linuxdoc.cdomain'         # Replacement for the sphinx c-domain.
  , 'linuxdoc.kfigure'         # Sphinx extension which implements scalable image handling.
]

npm install -g jsdoc

pip install sphinx-js

cd my-project
sphinx-quickstart

  > Root path for the documentation [.]: docs
  > Separate source and build directories (y/n) [n]:
  > Name prefix for templates and static dir [_]:
  > Project name: My Project
  > Author name(s): Fred Fredson
  > Project version []: 1.0
  > Project release [1.0]:
  > Project language [en]:
  > Source file suffix [.rst]:
  > Name of your master document (without suffix) [index]:
  > Do you want to use the epub builder (y/n) [n]:
  > autodoc: automatically insert docstrings from modules (y/n) [n]:
  > doctest: automatically test code snippets in doctest blocks (y/n) [n]:
  > intersphinx: link between Sphinx documentation of different projects (y/n) [n]:
  > todo: write "todo" entries that can be shown or hidden on build (y/n) [n]:
  > coverage: checks for documentation coverage (y/n) [n]:
  > imgmath: include math, rendered as PNG or SVG images (y/n) [n]:
  > mathjax: include math, rendered in the browser by MathJax (y/n) [n]:
  > ifconfig: conditional inclusion of content based on config values (y/n) [n]:
  > viewcode: include links to the source code of documented Python objects (y/n) [n]:
  > githubpages: create .nojekyll file to publish the document on GitHub pages (y/n) [n]:
  > Create Makefile? (y/n) [y]:
  > Create Windows command file? (y/n) [y]:

extensions = ['sphinx_js']

primary_domain = 'js'

.. uml::

   Alice -> Bob: Hi!
   Alice <- Bob: How are you?

pip install -e git+https://github.com/alendit/sphinx-pyreverse.git

.. uml::
        {{path to the module}}

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path .
exclude_patterns = [
        '_build',
        'Thumbs.db',
        '.DS_Store',
        # pipenv virtualenv with PIPENV_VENV_IN_PROJECT=1
        '.venv'
]

git clone http://github.com/rtfd/readthedocs.org.git

$ pip install Flask-Funnel

$ pip install Flask-Funnel==dev

$ git clone git://github.com/rehandalal/flask-funnel.git
$ mkvirtualenv flaskfunnel
$ python setup.py develop
$ pip install -r requirements.txt

$ python setup.py test

make develop
make documentation

Georg Brandl georg.brandl@gmail.com
répondre à:  sphinx-users@googlegroups.com
à:   sphinx-users@googlegroups.com
date:        5 mars 2014 07:50
objet:       Re: [sphinx-users] Another project using Sphinx: Ceph

<gsavix@gmail.com>
heure de l'expéditeur   Envoyé à 13:15 (GMT-02:00). Heure locale : 10:35. ✆
répondre à  sphinx-dev@googlegroups.com
à   sphinx-dev@googlegroups.com
date    18 février 2011 13:15
objet   Re: [sphinx-dev] GSoC and Breathe
liste de diffusion  <sphinx-dev.googlegroups.com> Filtrer les messages de cette liste de diffusion

    class Github(object):

        def __init__(self, username=None, api_token=None, requests_per_second=None,
                     access_token=None, cache=None, proxy_host=None,
                     proxy_port=8080):
            """
            An interface to GitHub's API:
            http://develop.github.com/

            .. versionadded:: 0.2.0
            The ``requests_per_second`` parameter
            .. versionadded:: 0.3.0
            The ``cache`` and ``access_token`` parameters
            .. versionadded:: 0.4.0
            The ``proxy_host`` and ``proxy_port`` parameters

            :param str username: your own GitHub username.
            :param str api_token: can be found at https://github.com/account
            (while logged in as that user):
            :param str access_token: can be used when no ``username`` and/or
            ``api_token`` is used. The ``access_token`` is the OAuth access
            token that is received after successful OAuth authentication.
            :param float requests_per_second: indicate the API rate limit you're
            operating under (1 per second per GitHub at the moment),
            or None to disable delays. The default is to disable delays (for
            backwards compatibility).
            :param str cache: a directory for caching GitHub responses.
            :param str proxy_host: the hostname for the HTTP proxy, if needed.
            :param str proxy_port: the hostname for the HTTP proxy, if needed (will
            default to 8080 if a proxy_host is set and no port is set).
            """

        self.request = GithubRequest(username=username, api_token=api_token,
                                     requests_per_second=requests_per_second,
                                     access_token=access_token, cache=cache,
                                     proxy_host=proxy_host,
                                     proxy_port=proxy_port)
        self.issues = Issues(self.request)
        self.users = Users(self.request)
        self.repos = Repositories(self.request)
        self.commits = Commits(self.request)
        self.organizations = Organizations(self.request)
        self.teams = Teams(self.request)
        self.pull_requests = PullRequests(self.request)


def get_network_meta(self, project):
    """Get Github metadata associated with a project

    :param str project: GitHub project
    """
     return self.request.raw_request("/".join([self.request.github_url,
                                              project,
                                              "network_meta"]), {})

def get_network_data(self, project, nethash, start=None, end=None):
    """Get chunk of Github network data

    :param str project: GitHub project
    :param str nethash: identifier provided by ``get_network_meta``
    :param int start: optional start point for data
    :param int stop: optional end point for data
    """
    data = {"nethash": nethash}
    if start:
        data["start"] = start
    if end:
        data["end"] = end

    return self.request.raw_request("/".join([self.request.github_url,
                                              project,
                                              "network_data_chunk"]),
                                              data)

def _handle_naive_datetimes(f):
    """Decorator to make datetime arguments use GitHub timezone

    :param func f: Function to wrap
    """
    def wrapper(datetime_):
        if not datetime_.tzinfo:
            datetime_ = datetime_.replace(tzinfo=GITHUB_TZ)
        else:
            datetime_ = datetime_.astimezone(GITHUB_TZ)
        return f(datetime_)
    wrapped = wrapper
    wrapped.__name__ = f.__name__
    wrapped.__doc__ = (
        f.__doc__
        + """\n    .. note:: Supports naive and timezone-aware datetimes"""
    )
    return wrapped


@_handle_naive_datetimes
def datetime_to_ghdate(datetime_):
    """Convert Python datetime to Github date string

    :param datetime datetime_: datetime object to convert
    """
    return datetime_.strftime(GITHUB_DATE_FORMAT)

>>> import macaron
>>> macaron.macaronage(dbfile="members.db")
>>> team = Team.create(name="Houkago Tea Time")
>>> team.members.append(name="Azusa", part="Gt2")
<Member object 1>
>>> macaron.bake()
>>> azu = Member.get("part=?", ["Gt2"])
>>> print azu
<Member 'Azusa : Gt2'>
>>> macaron.db_close()

Am 11.02.2014 09:36, schrieb manon.midy@enalean.com:
> Hi,
>
> I'm working at Enalean, the software provider of Tuleap Open ALM, the first 100%
> Open Source Enterprise ALM (GPL licence). Browing the page mentionning the
> projects using Sphinx http://sphinx-doc.org/examples.html, I realized Tuleap
> Open ALM is not included while the documentation of the project is managed
> thanks to Sphinx.Could you please add Tuleap Open ALM in the list of examples
> and the link to its doc: https://tuleap.net/doc/en/

Manon MIDY
manon.midy@enalean.com
Enalean
www.tuleap.org

> cd meta
> sphinx-quickstart

> make html

“Cheers for a great tool that actually makes programmers want to write documentation!”

#!/usr/bin/env python
#
# Copyright (C) 2012 Vinay Sajip. Licensed under the MIT license.
#
# Based on Roberto Alsina's 128-line web browser, see
#
# http://lateral.netmanagers.com.ar/weblog/posts/BB948.html
#
import json
import os
import subprocess
import sys
import tempfile
from urllib import pathname2url

import sip
sip.setapi("QString", 2)
sip.setapi("QVariant", 2)

from PyQt4 import QtGui,QtCore,QtWebKit, QtNetwork

settings = QtCore.QSettings("Vinay Sajip", "DocWatch")

class Watcher(QtCore.QThread):
        """
        A watcher which looks for source file changes, builds the documentation,
        and notifies the browser to refresh its contents
        """
        def run(self):
                self._stop = False
                watch_command = 'inotifywait -rq -e close_write --exclude \'"*.html"\' .'.split()
                make_command = 'make html'.split()
                while not self._stop:
                        # Perhaps should put notifier access in a mutex - not bothering yet
                        self.notifier = subprocess.Popen(watch_command)
                        self.notifier.wait()
                        if self._stop:
                                break
                        subprocess.call(make_command)
                        # Refresh the UI ...
                        self.parent().changed.emit()

        def stop(self):
                self._stop = True
                # Perhaps should put notifier access in a mutex - not bothering for now
                if self.notifier.poll() is None:    # not yet terminated ...
                        self.notifier.terminate()

class MainWindow(QtGui.QMainWindow):
        """
        A browser intended for viewing HTML documentation generated by Sphinx.
        """
        changed = QtCore.pyqtSignal()

        def __init__(self, url):
                QtGui.QMainWindow.__init__(self)
                self.sb=self.statusBar()

                self.pbar = QtGui.QProgressBar()
                self.pbar.setMaximumWidth(120)
                self.wb=QtWebKit.QWebView(loadProgress = self.pbar.setValue, loadFinished = self.pbar.hide, loadStarted = self.pbar.show, titleChanged = self.setWindowTitle)
                self.setCentralWidget(self.wb)

                self.tb=self.addToolBar("Main Toolbar")
                for a in (QtWebKit.QWebPage.Back, QtWebKit.QWebPage.Forward, QtWebKit.QWebPage.Reload):
                        self.tb.addAction(self.wb.pageAction(a))

                self.url = QtGui.QLineEdit(returnPressed = lambda:self.wb.setUrl(QtCore.QUrl.fromUserInput(self.url.text())))
                self.tb.addWidget(self.url)

                self.wb.urlChanged.connect(lambda u: self.url.setText(u.toString()))
                self.wb.urlChanged.connect(lambda: self.url.setCompleter(QtGui.QCompleter(QtCore.QStringList([QtCore.QString(i.url().toString()) for i in self.wb.history().items()]), caseSensitivity = QtCore.Qt.CaseInsensitive)))

                self.wb.statusBarMessage.connect(self.sb.showMessage)
                self.wb.page().linkHovered.connect(lambda l: self.sb.showMessage(l, 3000))

                self.search = QtGui.QLineEdit(returnPressed = lambda: self.wb.findText(self.search.text()))
                self.search.hide()
                self.showSearch = QtGui.QShortcut("Ctrl+F", self, activated = lambda: (self.search.show() , self.search.setFocus()))
                self.hideSearch = QtGui.QShortcut("Esc", self, activated = lambda: (self.search.hide(), self.wb.setFocus()))

                self.quit = QtGui.QShortcut("Ctrl+Q", self, activated = self.close)
                self.zoomIn = QtGui.QShortcut("Ctrl++", self, activated = lambda: self.wb.setZoomFactor(self.wb.zoomFactor()+.2))
                self.zoomOut = QtGui.QShortcut("Ctrl+-", self, activated = lambda: self.wb.setZoomFactor(self.wb.zoomFactor()-.2))
                self.zoomOne = QtGui.QShortcut("Ctrl+=", self, activated = lambda: self.wb.setZoomFactor(1))
                self.wb.settings().setAttribute(QtWebKit.QWebSettings.PluginsEnabled, True)

                self.sb.addPermanentWidget(self.search)
                self.sb.addPermanentWidget(self.pbar)

                self.load_settings()

                self.wb.load(url)
                self.watcher = Watcher(self)

                self.changed.connect(self.wb.reload)

                self.watcher.start()

        def load_settings(self):
                settings.beginGroup('mainwindow')
                pos = settings.value('pos')
                size = settings.value('size')
                if isinstance(pos, QtCore.QPoint):
                        self.move(pos)
                if isinstance(size, QtCore.QSize):
                        self.resize(size)
                settings.endGroup()

        def save_settings(self):
                settings.beginGroup('mainwindow')
                settings.setValue('pos', self.pos())
                settings.setValue('size', self.size())
                settings.endGroup()

        def closeEvent(self, event):
                self.save_settings()
                self.watcher.stop()

if __name__ == "__main__":
        if not os.path.isdir('_build'):
                # very simplistic sanity check. Works for me, as I generally use
                # sphinx-quickstart defaults
                print('You must run this application from a Sphinx directory containing _build')
                rc = 1
        else:
                app=QtGui.QApplication(sys.argv)
                path = os.path.join('_build', 'html', 'index.html')
                url = 'file:///' + pathname2url(os.path.abspath(path))
                url = QtCore.QUrl(url)
                wb=MainWindow(url)
                wb.show()
                rc = app.exec_()
        sys.exit(rc)

import clr
import os

from System.IO import FileSystemWatcher, NotifyFilters

stop = False

def on_change(source, e):
        global stop
        if not e.Name.endswith('.html'):
                stop = True
        print('%s: %s, stop = %s' % (e.FullPath, e.ChangeType, stop))

watcher = FileSystemWatcher(os.getcwd())
watcher.NotifyFilter = NotifyFilters.LastWrite | NotifyFilters.FileName
watcher.EnableRaisingEvents = True
watcher.IncludeSubdirectories = True
watcher.Changed += on_change
watcher.Created += on_change

while not stop:
        pass

#!/usr/bin/env python

import os

from fsevents import Observer, Stream

stop = False

def on_change(e):
        global stop
        path = e.name
        if os.path.isfile(path):
                if not path.endswith('.html'):
                        stop = True
        print('%s: %s, stop = %s' % (e.name, e.mask, stop))

observer = Observer()
observer.start()
stream = Stream(on_change, os.getcwd(), file_events=True)
observer.schedule(stream)
try:
        while not stop:
                pass
finally:
        observer.unschedule(stream)
        observer.stop()
        observer.join()

#!/bin/bash
## Automatically build Sphinx documentation upon file change
## Copyright (c) 2011 Samuele ~redShadow~ Santi - Under GPL

WORKDIR="$( dirname "$0" )"
while :; do
        ## Wait for changes
        inotifywait -e modify,create,delete -r "$WORKDIR"
        ## Make html documentation
        make -C "$WORKDIR" html
done

# Check for stylistic and formal issues in .rst and .py
# files included in the documentation.
#
# 01/2009, Georg Brandl

# TODO: - wrong versions in versionadded/changed
#       - wrong markup after versionchanged directive

$ pip install sphinxjp.themes.basicstrap

$ easy_install sphinxjp.themes.basicstrap

extensions = ['sphinxjp.themecore']
html_theme = 'basicstrap'

$ make html

pip install -U cloud_sptheme

Inline literal: ``literal text``.

External links are prefixed with an arrow: `<http://www.google.com>`_.

But email links are not prefixed: bob@example.com.

Issue tracker link: :issue:`5`.

extensions = [
    # http://pythonhosted.org/cloud_sptheme/index.html#extensions
    # https://bitbucket.org/ecollins/cloud_sptheme

    'cloud_sptheme.ext.issue_tracker',
]

# set path to issue tracker:
issue_tracker_url = "https://bitbucket.org/ecollins/cloud_sptheme/issue/{issue}"

.. note::
    This is a note.

.. warning::

    This is warning.

.. seealso::

    This is a "see also" message.

.. todo::

    This is a todo message.

    With some additional next on another line.

.. deprecated:: XXX This is a deprecation warning.

.. rst-class:: floater

.. note::
    This is a floating note.

extensions = [
    # http://pythonhosted.org/cloud_sptheme/index.html#extensions
    # https://bitbucket.org/ecollins/cloud_sptheme

    'cloud_sptheme.ext.table_styling',
]

.. table:: Normal Table

.. rst-class:: plain

.. table:: Plain Table (no row shading)

.. rst-class:: centered

.. table:: Centered Table

.. rst-class:: fullwidth

.. table:: Full Width Table

.. table:: Table Styling Extension
    :widths: 1 2 3
    :header-columns: 1
    :column-alignment: left center right
    :column-dividers: none single double single
    :column-wrapping: nnn

.. rst-class:: html-toggle

.. _toggle-test-link:

.. rst-class:: html-toggle expanded

.. rst-class:: emphasize-children

.. rst-class:: html-toggle

sphinx
cloud_sptheme

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
# -*- coding: utf-8 -*-
#
# Passlib documentation build configuration file, created by
# sphinx-quickstart on Mon Mar  2 14:12:06 2009.
#
# This file is execfile()d with the current directory set to its containing dir.
#
# Note that not all possible configuration values are present in this
# autogenerated file.
#
# All configuration values have a default; values that are commented out
# serve to show the default.

import sys, os

options = os.environ.get("PASSLIB_DOCS", "").split(",")

#make sure passlib in sys.path
doc_root = os.path.abspath(os.path.join(__file__,os.path.pardir))
source_root = os.path.abspath(os.path.join(doc_root,os.path.pardir))
sys.path.insert(0, source_root)

# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#sys.path.insert(0, os.path.abspath('.'))

#building the docs requires the Cloud sphinx theme & extensions
# https://bitbucket.org/ecollins/cloud_sptheme
#which contains some sphinx extensions used by passlib
import cloud_sptheme as csp

#hack to make autodoc generate documentation from the correct class...
import passlib.utils.md4 as md4_mod
md4_mod.md4 = md4_mod._builtin_md4

# -- General configuration -----------------------------------------------------

# If your documentation needs a minimal Sphinx version, state it here.
needs_sphinx = '1.0'

# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = [
    # standard sphinx extensions
    'sphinx.ext.autodoc',
    'sphinx.ext.todo',

    #add autdoc support for ReST sections in class/function docstrings
    'cloud_sptheme.ext.autodoc_sections',

    #adds extra ids & classes to genindex html, for additional styling
    'cloud_sptheme.ext.index_styling',

    #inserts toc into right hand nav bar (ala old style python docs)
    'cloud_sptheme.ext.relbar_toc',

    # add "issue" role
    'cloud_sptheme.ext.issue_tracker',
    ]

# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']

# The suffix of source filenames.
source_suffix = '.rst'

# The encoding of source files.
source_encoding = 'utf-8'

# The master toctree document.
master_doc = 'contents'
index_doc = 'index'

# General information about the project.
project = u'Passlib'
copyright = u'2008-2012, Assurance Technologies, LLC'

# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#

# version: The short X.Y version.
# release: The full version, including alpha/beta/rc tags.
from passlib import __version__ as release
version = csp.get_version(release)

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#language = None

# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:
#today = ''
# Else, today_fmt is used as the format for a strftime call.
#today_fmt = '%B %d, %Y'

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
exclude_patterns = [
    # disabling documentation of this until module is more mature.
    "lib/passlib.utils.compat.rst",

    # may remove this in future release
    "lib/passlib.utils.md4.rst",
]

# The reST default role (used for this markup: `text`) to use for all documents.
#default_role = None

# If true, '()' will be appended to :func: etc. cross-reference text.
add_function_parentheses = True

# If true, the current module name will be prepended to all description
# unit titles (such as .. function::).
#add_module_names = True

# If true, sectionauthor and moduleauthor directives will be shown in the
# output. They are ignored by default.
#show_authors = False

# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'

# A list of ignored prefixes for module index sorting.
modindex_common_prefix = [ "passlib." ]

# -- Options for all output ---------------------------------------------------
todo_include_todos = "hide-todos" not in options
keep_warnings = "hide-warnings" not in options
issue_tracker_url = "gc:passlib"

# -- Options for HTML output ---------------------------------------------------

# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
html_theme = 'redcloud'

# Theme options are theme-specific and customize the look and feel of a theme
# further.  For a list of options available for each theme, see the
# documentation.
if html_theme in ['cloud', 'redcloud']:
    html_theme_options = { "roottarget": index_doc, "collapsiblesidebar": True }
    if 'for-pypi' in options:
        html_theme_options['googleanalytics_id'] = 'UA-22302196-2'
        html_theme_options['googleanalytics_path'] = '/passlib/'
else:
    html_theme_options = {}
html_theme_options.update(issueicon=r'"\21D7"')

# Add any paths that contain custom themes here, relative to this directory.
html_theme_path = [csp.get_theme_dir()]

# The name for this set of Sphinx documents.  If None, it defaults to
# "<project> v<release> documentation".
html_title = project + " v" + release + " Documentation"

# A shorter title for the navigation bar.  Default is the same as html_title.
html_short_title = project + " " + version + " Documentation"

# The name of an image file (relative to this directory) to place at the top
# of the sidebar.
html_logo = os.path.join("_static", "masthead.png")

# The name of an image file (within the static path) to use as favicon of the
# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
# pixels large.
html_favicon = "logo.ico"

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']

# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
html_last_updated_fmt = '%b %d, %Y'

# If true, SmartyPants will be used to convert quotes and dashes to
# typographically correct entities.
html_use_smartypants = True

# Custom sidebar templates, maps document names to template names.
#html_sidebars = {}

# Additional templates that should be rendered to pages, maps page names to
# template names.
#html_additional_pages = {}

# If false, no module index is generated.
#html_domain_indices = True

# If false, no index is generated.
#html_use_index = True

# If true, the index is split into individual pages for each letter.
#html_split_index = False

# If true, links to the reST sources are added to the pages.
#html_show_sourcelink = True

# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
#html_show_sphinx = True

# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
#html_show_copyright = True

# If true, an OpenSearch description file will be output, and all pages will
# contain a <link> tag referring to it.  The value of this option must be the
# base URL from which the finished HTML is served.
#html_use_opensearch = ''

# This is the file name suffix for HTML files (e.g. ".xhtml").
#html_file_suffix = None

# Output file base name for HTML help builder.
htmlhelp_basename = project + 'Doc'


# -- Options for LaTeX output --------------------------------------------------

# The paper size ('letter' or 'a4').
#latex_paper_size = 'letter'

# The font size ('10pt', '11pt' or '12pt').
#latex_font_size = '10pt'

# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title, author, documentclass [howto/manual]).
latex_documents = [
  (index_doc, project + '.tex', project + u' Documentation',
   u'Assurance Technologies, LLC', 'manual'),
]

# The name of an image file (relative to this directory) to place at the top of
# the title page.
#latex_logo = None

# For "manual" documents, if this is true, then toplevel headings are parts,
# not chapters.
#latex_use_parts = False

# If true, show page references after internal links.
#latex_show_pagerefs = False

# If true, show URL addresses after external links.
#latex_show_urls = False

# Additional stuff for the LaTeX preamble.
#latex_preamble = ''

# Documents to append as an appendix to all manuals.
#latex_appendices = []

# If false, no module index is generated.
#latex_domain_indices = True


# -- Options for manual page output --------------------------------------------

# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
    (index_doc, project, project + u' Documentation',
     [u'Assurance Technologies, LLC'], 1)
]

Sujet:  Re: [sphinx-users] Where can I find a sphinx theme used in Python official documentation site?
Date :  Sat, 1 Feb 2014 04:52:34 -0800 (PST)
De :    Hiroki Watanabe <hwatanabe.japan@gmail.com>
Répondre à :    sphinx-users@googlegroups.com
Pour :  sphinx-users@googlegroups.com

sys.path.append(os.path.abspath('_themes'))
html_theme_path = ['_themes']
html_theme = 'pydoctheme'

html_theme_options = {
   'collapsiblesidebar': True,
   'sidebarbtncolor': '#eeeeee',
}

Hi,

I think this is the one:
http://hg.python.org/cpython/file/22e88355acd6/Doc/tools/sphinxext
<http://hg.python.org/cpython/file/22e88355acd6/Doc/tools/sphinxext>
However, I have not used it.

Regards,
--
Takayuki SHIMIZUKAWA
http://about.me/shimizukawa

[theme]
inherit = base theme
stylesheet = main CSS name
pygments_style = stylename

[options]
variable = default value

span.underlined {
    text-decoration: underline;
}

.. role:: underlined

:underlined:`test underlined`

From: Boris Kheyfets <kheyfboris@gmail.com>
Date: 2012/9/5
Subject: [sphinx-dev] Tip: vertical text
To: sphinx-dev@googlegroups.com

css:
span.vertical {
    writing-mode:tb-rl;
    -webkit-transform:rotate(270deg);
    -moz-transform:rotate(270deg);
    -o-transform: rotate(270deg);
    display:block;
    width:20px;
    height:20px;
}

rst:
.. role:: vertical

:vertical:`test`

I'm new to Sphinx, and I'd like to create a custom title page. I have
figured out how I can suppress the title page by adding 'maketitle': ' ',
in the conf.py file, but how do I replace it with a custom cover page?
And If I can, what format doe sit have to be in?

I'm using the "howto" sphinx template.

Georg Brandl <georg@python.org>
répondre à:  sphinx-users@googlegroups.com
à:   sphinx-users@googlegroups.com
date:    2 avril 2013 11:00
objet:   [sphinx-users] Re: Call for translation updates - Now on transifex

On 04/01/2013 12:26 PM, Georg Brandl wrote:
> Hi all,
>
> for the pending 1.2 release I'd like to update as many locales as possible.
> If you speak one of the languages that Sphinx supports and can spare the
> time, it would be great if you could look over the message catalog
> (sphinx.po) in your language at
> https://bitbucket.org/birkenfeld/sphinx/src/tip/sphinx/locale and open an
> issue/pull request with the necessary update or the new file.
>
> Thanks, Georg
>

///
/// <summary>
/// CR_RFID_DecouvrirLecteurs() Retourne la liste des lecteurs PS/SC de type
/// sous la forme d une liste de noms de la forme : "CodeRousseau RFID".
/// </summary>
/// <param name="ppListeNomsLecteursRFID"> [out] pointeur sur une liste de noms de lecteurs RFID.</param>.
/// <remarks>
/// </remarks>
/// <returns>
/// - COMMAND_SUCCESS: La commande s'est bien passee.
/// - COMMAND_FAILED: La commande a echoue.
/// </returns>
extern DWORD CR_RFID_DecouvrirLecteurs(ST_LIST_STRING **ppListeNomsLecteursRFID);

https://github.com/doxygen/doxygen

using System;

namespace IniParser
{
    /// <summary>
    /// Represents an error ococcurred while parsing data
    /// </summary>
    public class ParsingException : Exception
    {
        /// <summary>
        /// Initializes a new instance of the <see cref="ParsingException"/> class.
        /// </summary>
        public ParsingException(){ }

        /// <summary>
        /// Initializes a new instance of the <see cref="ParsingException"/> class.
        /// </summary>
        /// <param name="msg">The message describing the exception cause.</param>
        public ParsingException(string msg)
            : base(msg) { }

        /// <summary>
        /// Initializes a new instance of the <see cref="ParsingException"/> class.
        /// </summary>
        /// <param name="msg">The message describing the exception cause.</param>
        /// <param name="innerException">An inner exception.</param>
        public ParsingException(string msg, Exception innerException)
            : base(msg, innerException) { }
    }
}

using System;
using System.Collections;
using System.Collections.Generic;

namespace IniParser
{
    /// <summary>
    /// <para>Represents a collection of Keydata.</para>
    /// </summary>
    public class KeyDataCollection : ICloneable, IEnumerable<KeyData>
    {
        #region Initialization

        /// <summary>
        /// Initializes a new instance of the <see cref="KeyDataCollection"/> class.
        /// </summary>
        public KeyDataCollection()
        {
            _keyData = new Dictionary<string, KeyData>();
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="KeyDataCollection"/> class
        /// from a previous instance of <see cref="KeyDataCollection"/>.
        /// </summary>
        /// <remarks>
        /// Data is deeply copied
        /// </remarks>
        /// <param name="ori">
        /// The instance of the <see cref="KeyDataCollection"/> class
        /// used to create the new instance.</param>
        public KeyDataCollection(KeyDataCollection ori)
        {
            _keyData = new Dictionary<string, KeyData>();
            foreach ( string key in _keyData.Keys )
                _keyData.Add(key, (KeyData)ori._keyData[key].Clone() );
        }

        #endregion

        #region Properties

        /// <summary>
        /// Gets or sets the value of a concrete key.
        /// </summary>
        /// <remarks>
        /// If we try to assign the value of a key which doesn't exists,
        /// a new key is added with the name and the value is assigned to it.
        /// </remarks>
        /// <param name="keyName">Name of the key</param>
        /// <returns>
        /// The string with key's value or null
        /// if the key was not found.
        /// </returns>
        public string this[string keyName]
        {
            get
            {
                if (_keyData.ContainsKey(keyName))
                    return _keyData[keyName].Value;

                return null;
            }

            set
            {
                if (!_keyData.ContainsKey(keyName))
                    return;

                _keyData[keyName].Value = value;

            }
        }

        /// <summary>
        /// Return the number of keys in the collection
        /// </summary>
        /// <value>An integer with the number of keys in the collection.</value>
        public int Count
        {
            get { return _keyData.Count; }
        }

        #endregion

        #region Public Methods

        /// <summary>
        /// Adds a new key with the specified name and empty value and comments
        /// </summary>
        /// <remarks>
        /// A valid key name is a string with NO blank spaces.
        /// </remarks>
        /// <param name="keyName">New key to be added.</param>
        /// <returns>
        /// <c>true</c> if a new empty key was added
        /// <c>false</c> otherwise.
        /// </returns>
        /// <exception cref="ArgumentException">If the key name is not valid.</exception>
        public bool AddKey(string keyName)
        {
            //Checks valid key name
            //if ( !Assert.StringHasNoBlankSpaces(keyName) )
            //    throw new ArgumentException("Key name is not valid");

            if ( !_keyData.ContainsKey(keyName) )
            {
                _keyData.Add(keyName, new KeyData(keyName));
                return true;
            }

            return false;
        }

        /// <summary>
        /// Adds a new key with the specified name and value and comments
        /// </summary>
        /// <remarks>
        /// A valid key name is a string with NO blank spaces.
        /// </remarks>
        /// <param name="keyName">New key to be added.</param>
        /// <param name="keyData">KeyData instance.</param>
        /// <returns>
        /// <c>true</c> if a new empty key was added
        /// <c>false</c> otherwise.
        /// </returns>
        /// <exception cref="ArgumentException">If the key name is not valid.</exception>
        public bool AddKey(string keyName, KeyData keyData)
        {
            if (AddKey(keyName))
            {
                _keyData[keyName] = keyData;
                return true;
            }

            return false;

        }

        /// <summary>
        /// Adds a new key with the specified name and value and comments
        /// </summary>
        /// <remarks>
        /// A valid key name is a string with NO blank spaces.
        /// </remarks>
        /// <param name="keyName">New key to be added.</param>
        /// <param name="keyValue">Value associated to the kyy.</param>
        /// <returns>
        /// <c>true</c> if a new empty key was added
        /// <c>false</c> otherwise.
        /// </returns>
        /// <exception cref="ArgumentException">If the key name is not valid.</exception>
        public bool AddKey(string keyName, string keyValue)
        {
            if (AddKey(keyName))
            {
                _keyData[keyName].Value = keyValue;
                return true;
            }

            return false;

        }

        /// <summary>
        /// Retrieves the data for a specified key given its name
        /// </summary>
        /// <param name="keyName">Name of the key to retrieve.</param>
        /// <returns>
        /// A <see cref="KeyData"/> instance holding
        /// the key information or <c>null</c> if the key wasn't found.
        /// </returns>
        public KeyData GetKeyData(string keyName)
        {
            if (_keyData.ContainsKey(keyName))
                return _keyData[keyName];
            return null;
        }

        /// <summary>
        /// Sets the key data associated to a specified key.
        /// </summary>
        /// <param name="data">The new <see cref="KeyData"/> for the key.</param>
        public void SetKeyData(KeyData data)
        {
            if (data != null)
            {
                if (_keyData.ContainsKey(data.KeyName))
                    RemoveKey(data.KeyName);

                AddKey(data.KeyName, data);
            }
        }

        /// <summary>
        /// Gets if a specifyed key name exists in the collection.
        /// </summary>
        /// <param name="keyName">Key name to search</param>
        /// <returns><c>true</c> if a key with the specified name exists in the collectoin
        /// <c>false</c> otherwise</returns>
        public bool ContainsKey(string keyName)
        {
            return _keyData.ContainsKey(keyName);
        }

        /// <summary>
        /// Deletes a previously existing key, including its associated data.
        /// </summary>
        /// <param name="keyName">The key to be removed.</param>
        /// <returns>
        /// <c>true</c> if a key with the specified name was removed
        /// <c>false</c> otherwise.
        /// </returns>
        public bool RemoveKey(string keyName)
        {
            return _keyData.Remove(keyName);
        }

        #endregion

        #region IEnumerable<KeyData> Members

        /// <summary>
        /// Allows iteration througt the collection.
        /// </summary>
        /// <returns>A strong-typed IEnumerator </returns>
        public IEnumerator<KeyData> GetEnumerator()
        {
            foreach ( string key in _keyData.Keys )
                yield return _keyData[key];
        }

        #region IEnumerable Members

        /// <summary>
        /// Implementation needed
        /// </summary>
        /// <returns>A weak-typed IEnumerator.</returns>
        IEnumerator IEnumerable.GetEnumerator()
        {
            return _keyData.GetEnumerator();
        }

        #endregion

        #endregion

        #region ICloneable Members


        /// <summary>
        /// Creates a new object that is a copy of the current instance.
        /// </summary>
        /// <returns>
        /// A new object that is a copy of this instance.
        /// </returns>
        public object Clone()
        {
            return new KeyDataCollection(this);
        }

        #endregion

        #region Non-public Members

        /// <summary>
        /// Collection of KeyData for a given section
        /// </summary>
        private readonly Dictionary<string, KeyData> _keyData;

        #endregion

    }
}

GENERATE_DOCSET   = YES
DISABLE_INDEX     = YES
SEARCHENGINE      = NO
GENERATE_TREEVIEW = NO

git clone git://github.com/jgm/pandoc.git

git submodule update --init

#!/bin/sh
git submodule update --init

chmod +x .git/hooks/post-merge

rst2html.py -stg test.txt test.html

I've always pronounced LaTeX "lah-tech," but today I heard its developer
Leslie Lamport pronounce it "lay-tech.

hh -decompile dossier_cible nom_de_fichier.chm

"A universal convention supplies all of maintainability, clarity, consistency,
and a foundation for good programming habits too. What it doesn't do is
insist that you follow it against your will. That's Python !"

—Tim Peters on comp.lang.python, 2001-06-16

Sujet:  [Wikitech-l] Recycling wikitech-announce for tech contributors
Date :  Sat, 13 Apr 2013 12:23:21 -0700
De :    Quim Gil <qgil@wikimedia.org>
Répondre à :    Wikimedia developers <wikitech-l@lists.wikimedia.org>
Organisation :  Wikimedia Foundation
Pour :  Wikimedia developers <wikitech-l@lists.wikimedia.org>

--
Quim Gil
Technical Contributor Coordinator @ Wikimedia Foundation
http://www.mediawiki.org/wiki/User:Qgil

from wiki.urls import get_pattern as get_wiki_pattern
from django_notify.urls import get_pattern as get_notify_pattern
urlpatterns += patterns('',
    (r'^notify/', get_notify_pattern()),
    (r'', get_wiki_pattern())
)

perl -p -e 's/\/_ext\/_DOTDOT\/_DOTDOT//g' %1
perl -p -e 's/\/\${CND_PLATFORM}//g' %1

#!/usr/bin/sh

perl -pi -e 's/\/_ext\/_DOTDOT\/_DOTDOT//g' $1
perl -pi -e 's/\/\${CND_PLATFORM}//g' $1

find . -name "*.c" -exec grep -iHA5 -B5 "ioutil.h" {} \;

rename .c .cpp *.c

find . -name "*.h"  | wc -l

find . -name '*.c' -o -name '*.cpp' | wc -l

find . -name "*.h" -print | xargs wc -l

find . -name '*.c' -o -name '*.cpp' -print | xargs wc -l

find . -name '*.py' -print | xargs wc -l

convert image_1.png -crop 174x131+0+12 image_1_crop.png

find . -depth -name .svn -type d -exec rm -fr {} \;

sed '/<IfUser BLa>/,/<\/IfUser>/d'

find . -name "*.rst" -exec grep -iHA5 -B5 "string" {} \;
find . -name "*.rst" -exec grep -iH "string" {} \;
find . -name "*.rst" -exec grep "string" {} \;

rename 's/\.c/\.cpp/' *.c

rename 's/\.MOD/\.MPG/' *.MOD

find . -name "*.txt" | awk '{ newFile=gensub("txt$", "rst", 1); system("hg rename " $0 " " newFile) }'

rpl -Rs -x'.rst' '2010-2012' '2010-2013' .
rpl -Rs olstring  newstring  .

rpl -R -x'.rst' '2010-2012' '2010-2013' .
rpl -R olstring  newstring  .

grep -rl oldstring . | xargs sed -i -e 's/olstring/newstring/'

find . -name "*.rst" -print0 | xargs -0 sed -i 's/1.1.1/1.2.0/g'

usermod -g admin nicolargo

usermod -a -g networkadmin nicolargo

useradd -G networkadmin nicolargo

useradd -G networkadmin,systemadmin nicolargo

groups ritchy

ritchy: networkadmin systemadmin

mogrify -resize 800 *.JPG

cp *.JPG web
cd web
mogrify -resize 800 *.JPG
date; google picasa -d "2011-10-27" -n "Minou et Ali à Annecy le 27 octobre 2011" -t "Annecy, 27 octobre 2011" create "Annecy, 27 octobre 2011" *.JPG; date

ffmpeg -i input.flv -ar 44100 -ab 192k -ac 2 output.mp3

$ TEST=`pwd`/test_insert.txt
$ export TEST

python -c "print '[foo]\nbar = a\n b\n c \n  de\n fg \nbaz = bif cb \n'" >  $TEST

wget https://raw.github.com/nojhan/liquidprompt/master/liquidprompt
source liquidprompt

PS1="$_OLD_VIRTUAL_PS1"
_OLD_RPROMPT="$RPROMPT"
RPROMPT="%{${fg_bold[white]}%}(env: %{${fg[green]}%}`basename \"$VIRTUAL_ENV\"`%{${fg_bold[white]}%})%{${reset_color}%} $RPROMPT"

RPROMPT="$_OLD_RPROMPT"

export PIP_VIRTUALENV_BASE=$WORKON_HOME

export PIP_RESPECT_VIRTUALENV=true

proj_name=$(echo $VIRTUAL_ENV|awk -F'/' '{print $NF}')
mkdir $HOME/projects/$proj_name
add2virtualenv $HOME/projects/$proj_name
cd $HOME/projects/$proj_name

proj_name=$(echo $VIRTUAL_ENV|awk -F'/' '{print $NF}')
cd ~/projects/$proj_name

$ cat postmkvirtualenv
#!/usr/bin/env bash
curl -O http://python-distribute.org/distribute_setup.p... />python distribute_setup.py
rm distribute_setup.py
easy_install pip==dev
pip install Mercurial

$ cat developer_requirements.txt
ipdb
ipython
pastescript
nose
http://douglatornell.ca/software/python/Nosy-1.0.tar.gz
coverage
sphinx
grin
pyflakes
pep8

cd () {
    if (( $# == 0 ))
    then
        builtin cd $VIRTUAL_ENV
    else
        builtin cd "$@"
    fi
}

cd

C:\> cinst Console2

c:\> cinst ConsoleZ

# For every program on 32-bit-systems and for 64-bit-software on 64-bit systems
$programName = # name of the program
$installedVersion = (Get-ItemProperty HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\$programName).DisplayVersion

# For every program on 32-bit-systems and for 64-bit-software on 64-bit systems
$programUninstallEntryName = CCleaner # The value which contains the registry-key “DisplayName” of the affected program
$installedVersion = (Get-ItemProperty HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* | Select DisplayName, DisplayVersion | Where-Object {$_.DisplayName -eq "$programUninstallEntryName"}).DisplayVersion
# $installedVersion is the value of the registry-key “DisplayVersion” of the affected program

# For 32-bit-software on 64-bit systems
$programUninstallEntryName = CDBurnerXP
$installedVersion = (Get-ItemProperty HKLM:\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\* | Select DisplayName, DisplayVersion | Where-Object {$_.DisplayName -eq "$programUninstallEntryName"}).DisplayVersion

Here everything matches:
DisplayName: CDBurnerXP
DisplayVersion: 4.5.1.3868
Here the DisplayName-entry also contains the version:
DisplayName: LibreOffice 4.0.3.3
DisplayVersion: 4.0.3.3
Here nothing matches exactly with the package ID and the package version
DisplayName: Java 7 Update 21
DisplayVersion: 7.0.210

Check-InstalledProgramVersion $programUninstallEntryName $installedVersionMatch

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\Directory\shell\powershell]
@="Open PowerShell here"
"NoWorkingDirectory"=""
"Extended"=""

[HKEY_CLASSES_ROOT\Directory\shell\powershell\command]
@="C:\\Windows\\system32\\WindowsPowerShell\\v1.0\\powershell.exe -NoExit -Command Set-Location -LiteralPath ‘%L’"

C:\Python27\;C:\Python27\Scripts\

Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python27\;C:\Python27\Scripts\", "User")

wmic computersystem get domain, EnableDaylightSavingsTime, Manufacturer, Model, PartOfDomain, TotalPhysicalMemory, username

Domain  EnableDaylightSavingsTime  Manufacturer     Model PartOfDomain                            TotalPhysicalMemory  UserName
ID3GEN  TRUE                       Hewlett-Packard  HP Compaq dx2400 Microtower PC  TRUE          3479351296           ID3GEN\pvergain

wmic service get name, state

Z:\>wmic service get name, state
Name                            State
AdobeFlashPlayerUpdateSvc       Stopped
Alerter                         Stopped
ALG                             Running
AppMgmt                         Stopped
aspnet_state                    Stopped
AudioSrv                        Running
BITS                            Stopped
Browser                         Stopped
CiSvc                           Stopped
ClipSrv                         Stopped
clr_optimization_v2.0.50727_32  Stopped
clr_optimization_v4.0.30319_32  Stopped
COMSysApp                       Stopped
CryptSvc                        Running
DcomLaunch                      Running
Dhcp                            Running
DirMngr                         Stopped
dmadmin                         Stopped
dmserver                        Running
Dnscache                        Running
Dot3svc                         Stopped
EapHost                         Stopped
ERSvc                           Stopped
Eventlog                        Running
EventSystem                     Running
FastUserSwitchingCompatibility  Stopped
FontCache3.0.0.0                Stopped
Gallio.Ambience                 Stopped
gupdate                         Stopped
gupdatem                        Stopped
gusvc                           Stopped
helpsvc                         Stopped
HidServ                         Stopped
hkmsvc                          Stopped
HTTPFilter                      Stopped
IDaAuditMonitor                 Running
IDaSessionMonitor               Running
IDriverT                        Stopped
idsvc                           Stopped
ImapiService                    Stopped
JavaQuickStarterService         Running
lanmanserver                    Running
lanmanworkstation               Running
LightScribeService              Stopped
LmHosts                         Running
MDM                             Stopped
Messenger                       Running
mnmsrvc                         Stopped
MongoDB                         Stopped
MozillaMaintenance              Stopped
MSDTC                           Stopped
MSIServer                       Stopped
MSSQL$SQLEXPRESS                Stopped
MSSQLServerADHelper             Stopped
msvsmon90                       Stopped
napagent                        Stopped
Net Driver HPZ12                Running
NetDDE                          Stopped
NetDDEdsdm                      Stopped
Netlogon                        Running
Netman                          Running
NetTcpPortSharing               Stopped
Nla                             Running
NtLmSsp                         Stopped
NtmsSvc                         Running
ose                             Stopped
PhidgetWebservice21             Stopped
PlugPlay                        Running
Pml Driver HPZ12                Running
PolicyAgent                     Running
ProtectedStorage                Running
RasAuto                         Stopped
RasMan                          Running
RDSessMgr                       Stopped
RemoteAccess                    Stopped
RemoteRegistry                  Running
RpcLocator                      Stopped
RpcSs                           Running
RSVP                            Stopped
SamSs                           Running
SCardSvr                        Running
Schedule                        Running
seclogon                        Running
SENS                            Running
SharedAccess                    Running
ShellHWDetection                Running
Spooler                         Running
SQLBrowser                      Stopped
SQLWriter                       Running
srservice                       Running
SSDPSRV                         Running
stisvc                          Running
stllssvr                        Stopped
SwPrv                           Stopped
SysmonLog                       Stopped
SystemExplorerHelpService       Running
TapiSrv                         Running
TermService                     Running
Themes                          Stopped
TlntSvr                         Stopped
TrkWks                          Running
upnphost                        Stopped
UPS                             Stopped
VSS                             Stopped
W32Time                         Running
WebClient                       Stopped
winmgmt                         Running
WinRM                           Stopped
WmdmPmSN                        Stopped
Wmi                             Stopped
WmiApSrv                        Running
WMPNetworkSvc                   Stopped
WPFFontCache_v0400              Running
wscsvc                          Stopped
wuauserv                        Running
WudfSvc                         Stopped
WZCSVC                          Stopped
xmlprov                         Stopped

wmic service where (name="SCardSvr") call startservice

Z:\>wmic service where (name="SCardSvr") call startservice
Exécution (\\machine\ROOT\CIMV2:Win32_Service.Name="SCardSvr")->startservice()
Méthode exécutée.
Paramètres de sortie:
instance of __PARAMETERS
{
        ReturnValue = 10;
};

wmic service where (name="SCardSvr") call stopservice

Z:\>wmic service where (name="SCardSvr") call stopservice
Exécution (\\machine\ROOT\CIMV2:Win32_Service.Name="SCardSvr")->stopservice()
Méthode exécutée.
Paramètres de sortie:
instance of __PARAMETERS
{
        ReturnValue = 0;
};

wmic service where (name="SCardSvr") call state

Z:\>wmic service where (name="SCardSvr") get state
State
Stopped

wmic /node:<server_name> process list brief /every:2

$ google blogger post --title "foo" "command line posting"

$ google calendar add "Lunch with Jim at noon tomorrow"

$ google contacts list Bob name,email > the_bobs.csv

$ google docs edit "Shopping list"

$ google finance create-txn "Savings Portfolio" NASDAQ:GOOG Buy

$ google picasa create "Cat Photos" ~/photos/cats/*.jpg

$ google youtube post --category Education killer_robots.avi


Release:	0.3.0
Date:	2020-4-30
Authors:	Patrick Vergain
Target:	Tutorial about documentation

Value	Name	French Message
0x8130F001L	CR_E_FAILED	Une vérification de cohérence interne a échoué.
0x8130F002L	CR_E_TIMEOUT	Le délai a expiré.
0x8130F003L	CR_E_SEND_DATA_FAILED	L’envoi des données a échoué.
0x8130F004L	CR_E_OPEN_PORT_FAILED	L’ouverture du port COM a échoué.
0x8130F005L	CR_E_CLOSE_PORT_FAILED	La fermeture du port COM a échoué.
0x8130F006L	CR_E_BAD_SYNCHRO	Erreur de synchronisation avec la base.
0x8130F007L	CR_E_BAD_ADDRESS	Mauvaise adresse.
0x8130F008L	CR_E_BAD_SIZE	Taille incorrecte.
0x8130F009L	CR_E_BAD_CHANNEL	Mauvais canal.
0x8130F00AL	CR_E_BAD_STATUS	Mauvais statut retourné par la base.
0x8130F00BL	CR_E_OPEN_FILE_FAILED	Ouverture du fichier a échoué.

header-rows:	[int] count of header rows
stub-columns:	[int] count of stub columns
widths:	[[int] [int] … ] widths of columns
fill-cells:	instead of auto-span missing cells, insert missing cells

Header1	Header2	Header3
Row 1	Row 1	Row 1
Row 2	Row 2	Row 2
Row 3	Row 3	Row 3

Header1	Header2	Header3
Row 1	Row 1	Row 1
Row 2	Row 2	Row 2
Row 3	Row 3	Row 3

Description	In	Out	Balance
Travel		230.00	-230.00
Fees		400.00	-630.00
Grant	700.00		70.00
Train Fare		70.00	0.00

Header row, column 1 (header rows optional)	Header 2	Header 3	Header 4
body row 1, column 1	column 2	column 3	column 4
body row 2	…	…

Condition	Decision
comparison score >= threshold	Match
comparison score < threshold	Non-Match

Shapes	Description
Square	Four sides of equal length, 90 degree angles
Rectangle	Four sides, 90 degree angles

Error type	Definition	Impact
False Match	Comparison decision of “match” for a biometric probe and a biometric reference that are from different fingers	System security lack
False Non-Match	Comparison decision of “non-match” for a biometric probe and a biometric reference that are from the same finger	User inconvenience

cspan:	[int] additional columns (morecols)
rspan:	[int] additional rows (morerows)

Documentation tutorial¶

Documentation¶

Documentation news¶

Mindshare¶

Documentation generators¶

Sphinx¶

Sphinx development (Development Guide)¶

sphinx applications¶

reStructuredText Sphinx documentation¶

Sphinx extensions¶

Contributed sphinx extensions¶

Hébergeurs Sphinx¶

Sphinx i18n¶

Installation d’un projet sphinx¶

Sphinx people¶

Tools for building sphinx¶

Sphinx themes¶

Sphinx translations¶

Sphinx versions¶

Doxygen formats¶

Doxygen versions¶

Jekyll tools¶

JSDoc bootstrap themes¶

Pandoc Versions¶

Formats Documentation¶

Input formats¶

ReStructuredText format¶

Openalea Rest Documentation¶

ReStructuredText (reST) Sphinx doc¶

ReStructuredText tools¶

Input/output formats¶

Output formats¶

Dash format¶

EPUB format¶

Introduction¶

Documentation projects¶

Mozilla documentation¶

Documenting python projects¶

Documenting python projects with sphinx¶

sphinx¶

an example pypi project¶

Documentation tools¶