--- a/.hgignore	Thu Apr 12 01:27:16 2018 +0200
+++ b/.hgignore	Wed Apr 11 12:19:47 2018 +0200
@@ -26,3 +26,4 @@
 ^src/MANIFEST.in$
 ^dev/hdalab/dist
 ^dev/out
+^doc/build

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/Makefile	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = HDALab
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
\ No newline at end of file

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/make.bat	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,36 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+set SPHINXPROJ=HDALab
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd

Binary file doc/source/_static/img/logo_iri.png has changed

Binary file doc/source/_static/img/pages/accueil_hdalab.png has changed

Binary file doc/source/_static/img/pages/admin_django_hdalab.png has changed

Binary file doc/source/_static/img/pages/administrer_renkan.png has changed

Binary file doc/source/_static/img/pages/apropos_hdalab.png has changed

Binary file doc/source/_static/img/pages/artistic_domains_hdalab.png has changed

Binary file doc/source/_static/img/pages/contact_hdalab.png has changed

Binary file doc/source/_static/img/pages/credits_hdalab.png has changed

Binary file doc/source/_static/img/pages/detail_notice.png has changed

Binary file doc/source/_static/img/pages/editorialisation_hdalab.png has changed

Binary file doc/source/_static/img/pages/facettes_hdalab.png has changed

Binary file doc/source/_static/img/pages/mentions_legales_hdalab.png has changed

Binary file doc/source/_static/img/pages/renkan_base_list.png has changed

Binary file doc/source/_static/img/pages/renkan_edit.png has changed

Binary file doc/source/_static/img/pages/renkan_favorite.png has changed

Binary file doc/source/_static/img/pages/renkan_public.png has changed

Binary file doc/source/_static/img/pages/renkan_view.png has changed

Binary file doc/source/_static/img/pages/renkan_view_full.png has changed

Binary file doc/source/_static/img/pages/thematic_folder_hdalab.png has changed

Binary file doc/source/_static/img/pages/tree_search_hdalab.png has changed

Binary file doc/source/_static/img/pages/user_info_hdalab.png has changed

Binary file doc/source/_static/img/pages/user_profile_hdalab.png has changed

Binary file doc/source/_static/img/renkan/renkan_bin_plus_ressources.png has changed

Binary file doc/source/_static/img/renkan/renkan_bin_resources.png has changed

Binary file doc/source/_static/img/renkan/renkan_edition.png has changed

Binary file doc/source/_static/img/renkan/renkan_recherche_contenus.png has changed

Binary file doc/source/_static/img/renkan/renkan_recherche_resultats.png has changed

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,182 @@
+################
+URL d'API HDALAB
+################
+
+Ces URL n'ont pas de sortie HTML. Elle sont utilisée en particulier par les composants javascript HDALab.
+
+Recherche fulltext dans les fiches
+==================================
+
+Ce point d'API est utilisé pour faire des recherches fulltext dans les fiches.
+Il est utilisé aux endroits suivants:
+
+    - :ref:`pages_recherche_facette`
+
++----------+---------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/hdabo/searchajax/ |
++----------+---------------------------------------------------------+
+| view     | :class:`hdabo.views.SearchDatasheet`                    |
++----------+---------------------------------------------------------+
+
+.. autoclass:: hdabo.views.SearchDatasheet
+  :noindex:
+
+
+
+Recherche dans les catégories Wikipedia
+=======================================
+
+Ce point d'API est utilisé pour faire des recherches dans les catégories Wikipedia.
+Il est utilisé aux endroits suivants:
+
+    - :ref:`pages_explorer_domaines_artistiques`
+
++----------+---------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/a/catsearch |
++----------+---------------------------------------------------+
+| view     | :func:`hdalab.views.ajax.catsearch`               |
++----------+---------------------------------------------------+
+
+.. autofunction:: hdalab.views.ajax.catsearch
+  :noindex:
+
+
+.. _api_arbre_categories:
+
+Arbre de catégories
+===================
+
+Ce point d'API est utilisé pour construire un arbre de catégorie Wikipedia à partir d'un label.
+Il est utilisé aux endroits suivants:
+
+    - :ref:`pages_explorer_domaines_artistiques`
+
+
++----------+-------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/a/cattree |
++----------+-------------------------------------------------+
+| view     | :func:`hdalab.views.ajax.cattree`               |
++----------+-------------------------------------------------+
+
+
+.. autofunction:: hdalab.views.ajax.cattree
+  :noindex:
+
+
+Remplissage d'arbre
+===================
+
+Ce point d'API est utilisé pour ajouter des fiches à un arbre de catégorie, comme par exemple produit par l'api :ref:`api_arbre_categories`.
+
+Il est utilisé dans les pages suivantes:
+
+    - :ref:`pages_explorer_domaines_artistiques`
+    - :ref:`pages_recherche_arbre`
+
+
++----------+--------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/a/filltree |
++----------+--------------------------------------------------+
+| view     | :func:`hdalab.views.ajax.filltree`               |
++----------+--------------------------------------------------+
+
+
+.. autofunction:: hdalab.views.ajax.filltree
+  :noindex:
+
+
+Filtrage par facette
+====================
+
+Ce point d'API est utilisé pour réaliser le filtrage par facette des fiches HDA.
+Il est utilisé aux endroits suivants:
+
+    - :ref:`pages_recherche_facette`
+
+
++----------+------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/a/filter |
++----------+------------------------------------------------+
+| view     | :func:`hdalab.views.ajax.filter`               |
++----------+------------------------------------------------+
+
+
+.. autofunction:: hdalab.views.ajax.filter
+  :noindex:
+
+
+Recherche de tag
+================
+
+Ce point d'API est utilisé pour faire des recherche dans les tags.
+Il est utilisé aux endroits suivants:
+
+    - :ref:`pages_recherche_facette`
+    - :ref:`renkan_boite_recherche_contenus`
+
++----------+----------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/a/tagsearch        |
++----------+----------------------------------------------------------+
+| view     | :func:`hdalab.views.ajax.tagsearch`                      |
++----------+----------------------------------------------------------+
+
+.. autofunction:: hdalab.views.ajax.tagsearch
+  :noindex:
+
+
+login ajax
+==========
+
+Ce point d'API permet la gestion de la connexion à partir d'un éditeur Renkan.
+Il est utilisé aux endroits suivants :
+
+    - :ref:`pages_recherche_facette`
+
+
++----------+---------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/ajaxlogin/  |
++----------+---------------------------------------------------+
+| view     | :func:`hdalab.views.profile.ajax_login`           |
++----------+---------------------------------------------------+
+
+.. autofunction:: hdalab.views.profile.ajax_login
+  :noindex:
+
+Chargement et sauvegarde de renkan
+==================================
+
+Ce point d'API permet le chargement et la sauvegarde des renkan. Il est appelé par le client javascript renkan.
+
+Il est utilisé aux endroits suivants :
+
+    - :ref:`pages_edition_renkan`
+    - :ref:`affichage-d-un-renkan-en-lecture-seule`
+    - :ref:`affichage-d-un-renkan-en-plein-ecran`
+
+
++-----------+------------------------------------------------------+
+| url       | http://hdalab.iri-research.org/hdalab/renkan/getput/ |
++-----------+------------------------------------------------------+
+| view      | :class:`hdalab.views.profile.HdalabRenkanGetPut`     |
++-----------+------------------------------------------------------+
+| view GET  | :meth:`hdalab.views.profile.HdalabRenkanGetPut.get`  |
++-----------+------------------------------------------------------+
+| view POST | :meth:`hdalab.views.profile.HdalabRenkanGetPut.post` |
++-----------+------------------------------------------------------+
+
+A noter que l'appel de l'URL en GET ou POST mème à des vue différentes.
+
+
+Appel en HTTP GET:
+------------------
+
+.. automethod:: hdalab.views.profile.HdalabRenkanGetPut.get
+  :noindex:
+
+Appel en HTTP POST:
+-------------------
+
+.. automethod:: hdalab.views.profile.HdalabRenkanGetPut.post
+  :noindex:
+
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.management.commands.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,70 @@
+hdabo.management.commands package
+=================================
+
+Submodules
+----------
+
+hdabo.management.commands.clean\_tags module
+--------------------------------------------
+
+.. automodule:: hdabo.management.commands.clean_tags
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.management.commands.diff\_csv module
+------------------------------------------
+
+.. automodule:: hdabo.management.commands.diff_csv
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.management.commands.import\_csv module
+--------------------------------------------
+
+.. automodule:: hdabo.management.commands.import_csv
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.management.commands.import\_rdf module
+--------------------------------------------
+
+.. automodule:: hdabo.management.commands.import_rdf
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.management.commands.import\_tag\_popularity module
+--------------------------------------------------------
+
+.. automodule:: hdabo.management.commands.import_tag_popularity
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.management.commands.order\_tags module
+--------------------------------------------
+
+.. automodule:: hdabo.management.commands.order_tags
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.management.commands.query\_wikipedia module
+-------------------------------------------------
+
+.. automodule:: hdabo.management.commands.query_wikipedia
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo.management.commands
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.management.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,22 @@
+hdabo.management package
+========================
+
+Submodules
+----------
+
+hdabo.management.utils module
+-----------------------------
+
+.. automodule:: hdabo.management.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo.management
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.migrations.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,30 @@
+hdabo.migrations package
+========================
+
+Submodules
+----------
+
+hdabo.migrations.0001\_initial module
+-------------------------------------
+
+.. automodule:: hdabo.migrations.0001_initial
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.migrations.0002\_alter\_user\_fields\_after\_1\_8 module
+--------------------------------------------------------------
+
+.. automodule:: hdabo.migrations.0002_alter_user_fields_after_1_8
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo.migrations
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,101 @@
+hdabo package
+=============
+
+Subpackages
+-----------
+
+.. toctree::
+
+    hdabo.tests
+
+Submodules
+----------
+
+hdabo.admin module
+------------------
+
+.. automodule:: hdabo.admin
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.context\_processors module
+--------------------------------
+
+.. automodule:: hdabo.context_processors
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.django\_wsgi module
+-------------------------
+
+.. automodule:: hdabo.django_wsgi
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.forms module
+------------------
+
+.. automodule:: hdabo.forms
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.models module
+-------------------
+
+.. automodule:: hdabo.models
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.search\_indexes module
+----------------------------
+
+.. automodule:: hdabo.search_indexes
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.urls module
+-----------------
+
+.. automodule:: hdabo.urls
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.utils module
+------------------
+
+.. automodule:: hdabo.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.views module
+------------------
+
+.. automodule:: hdabo.views
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdabo.wp\_utils module
+----------------------
+
+.. automodule:: hdabo.wp_utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.search.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,22 @@
+hdabo.search package
+====================
+
+Submodules
+----------
+
+hdabo.search.french\_whoosh\_backend module
+-------------------------------------------
+
+.. automodule:: hdabo.search.french_whoosh_backend
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo.search
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.templatetags.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,22 @@
+hdabo.templatetags package
+==========================
+
+Submodules
+----------
+
+hdabo.templatetags.hdabo\_tags module
+-------------------------------------
+
+.. automodule:: hdabo.templatetags.hdabo_tags
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo.templatetags
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdabo.tests.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,22 @@
+hdabo.tests package
+===================
+
+Submodules
+----------
+
+hdabo.tests.test\_models module
+-------------------------------
+
+.. automodule:: hdabo.tests.test_models
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdabo.tests
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.management.commands.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,118 @@
+hdalab.management.commands package
+==================================
+
+Submodules
+----------
+
+hdalab.management.commands.calculate\_preview module
+----------------------------------------------------
+
+.. automodule:: hdalab.management.commands.calculate_preview
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.export\_tags\_csv module
+---------------------------------------------------
+
+.. automodule:: hdalab.management.commands.export_tags_csv
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.export\_wpcategory\_csv module
+---------------------------------------------------------
+
+.. automodule:: hdalab.management.commands.export_wpcategory_csv
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.fill\_tag\_years module
+--------------------------------------------------
+
+.. automodule:: hdalab.management.commands.fill_tag_years
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.geojson\_transform module
+----------------------------------------------------
+
+.. automodule:: hdalab.management.commands.geojson_transform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.import\_hda\_insee\_csv module
+---------------------------------------------------------
+
+.. automodule:: hdalab.management.commands.import_hda_insee_csv
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.import\_hdabo\_db module
+---------------------------------------------------
+
+.. automodule:: hdalab.management.commands.import_hdabo_db
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.import\_insee\_csv module
+----------------------------------------------------
+
+.. automodule:: hdalab.management.commands.import_insee_csv
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.query\_category\_inclusion module
+------------------------------------------------------------
+
+.. automodule:: hdalab.management.commands.query_category_inclusion
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.query\_dbpedia module
+------------------------------------------------
+
+.. automodule:: hdalab.management.commands.query_dbpedia
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.query\_geo\_inclusion module
+-------------------------------------------------------
+
+.. automodule:: hdalab.management.commands.query_geo_inclusion
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.query\_wikipedia\_category module
+------------------------------------------------------------
+
+.. automodule:: hdalab.management.commands.query_wikipedia_category
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.management.commands.send\_moderation\_mail module
+--------------------------------------------------------
+
+.. automodule:: hdalab.management.commands.send_moderation_mail
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab.management.commands
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.management.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,22 @@
+hdalab.management package
+=========================
+
+Submodules
+----------
+
+hdalab.management.utils module
+------------------------------
+
+.. automodule:: hdalab.management.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab.management
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.migrations.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,38 @@
+hdalab.migrations package
+=========================
+
+Submodules
+----------
+
+hdalab.migrations.0001\_initial module
+--------------------------------------
+
+.. automodule:: hdalab.migrations.0001_initial
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.migrations.0002\_alter\_tagyears\_tag\_one2one module
+------------------------------------------------------------
+
+.. automodule:: hdalab.migrations.0002_alter_tagyears_tag_one2one
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.migrations.0003\_default\_site module
+--------------------------------------------
+
+.. automodule:: hdalab.migrations.0003_default_site
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab.migrations
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.models.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,38 @@
+hdalab.models package
+=====================
+
+Submodules
+----------
+
+hdalab.models.categories module
+-------------------------------
+
+.. automodule:: hdalab.models.categories
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.models.dataviz module
+----------------------------
+
+.. automodule:: hdalab.models.dataviz
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.models.renkan module
+---------------------------
+
+.. automodule:: hdalab.models.renkan
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab.models
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,126 @@
+hdalab package
+==============
+
+Subpackages
+-----------
+
+.. toctree::
+
+    hdalab.models
+    hdalab.views
+
+Submodules
+----------
+
+hdalab.apps module
+------------------
+
+.. automodule:: hdalab.apps
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.celery module
+--------------------
+
+.. automodule:: hdalab.celery
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.config module
+--------------------
+
+.. automodule:: hdalab.config
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.context\_processors module
+---------------------------------
+
+.. automodule:: hdalab.context_processors
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.fields module
+--------------------
+
+.. automodule:: hdalab.fields
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.forms module
+-------------------
+
+.. automodule:: hdalab.forms
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.services module
+----------------------
+
+.. automodule:: hdalab.services
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.settings module
+----------------------
+
+.. automodule:: hdalab.settings
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.signals module
+---------------------
+
+.. automodule:: hdalab.signals
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.tasks module
+-------------------
+
+.. automodule:: hdalab.tasks
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.urls module
+------------------
+
+.. automodule:: hdalab.urls
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.utils module
+-------------------
+
+.. automodule:: hdalab.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.wsgi module
+------------------
+
+.. automodule:: hdalab.wsgi
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.templatetags.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,30 @@
+hdalab.templatetags package
+===========================
+
+Submodules
+----------
+
+hdalab.templatetags.analytics module
+------------------------------------
+
+.. automodule:: hdalab.templatetags.analytics
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.templatetags.hdalab\_tags module
+---------------------------------------
+
+.. automodule:: hdalab.templatetags.hdalab_tags
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab.templatetags
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/hdalab.views.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,46 @@
+hdalab.views package
+====================
+
+Submodules
+----------
+
+hdalab.views.ajax module
+------------------------
+
+.. automodule:: hdalab.views.ajax
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.views.editorial module
+-----------------------------
+
+.. automodule:: hdalab.views.editorial
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.views.pages module
+-------------------------
+
+.. automodule:: hdalab.views.pages
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+hdalab.views.profile module
+---------------------------
+
+.. automodule:: hdalab.views.profile
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: hdalab.views
+    :members:
+    :undoc-members:
+    :show-inheritance:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/api/modules.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,8 @@
+src
+===
+
+.. toctree::
+   :maxdepth: 4
+
+   hdabo
+   hdalab

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/commandes.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,226 @@
+#######################################
+Commandes d'administration HDABo/HDALab
+#######################################
+
+Le projet HDA fournis un ensemble de commande d'administration permettant de maintenir l'état de l'application.
+Ces commandes utilise le `système d'administration en ligne de commande de Django <https://docs.djangoproject.com/en/1.8/howto/custom-management-commands/>`_.
+L'usage des commande est en général le suivant:
+
+```
+django-admin <subcommand> [options] [arguments...]
+```
+
+Chaque commande implémente ses options et arguments.
+Toutes les commandes du projet accèptent les options suivante:
+
+  - *\-\-version* : montre le numeero de version et quitte.
+  - *\-h, \-\-help* : montre le message d'aide et quitte.
+  - *\-v VERBOSITY, \-\-verbosity=VERBOSITY* : Niveau de verbosité; 0=minimal, 1=normal, 2=verbeux, 3=très verbeux
+  - *\-\-settings=SETTINGS* : Le chemin Python vers un module de `settings`. Si il n'est pas fourni, la variable d'environement DJANGO_SETTINGS_MODULE sera utilisée.
+  - *\-\-pythonpath=PYTHONPATH* : un répertoire à ajouter au chemins Python (`Python path <https://docs.python.org/2/using/cmdline.html#envvar-PYTHONPATH>`_)
+  - *\-\-traceback* : Lève des exceptions `CommandError`.
+  - *\-\-no-color* : Ne colorise pas la sortie de la commande.
+
+Les options spécifiques sont doumentées pour chaque commande.
+
+
+Voici la liste des commandes hdalab:
+
+    - :ref:`commands-hdalab-calculate-preview`
+    - :ref:`commands-hdalab-export-tags-csv`
+    - :ref:`commands-hdalab-export-wpcategory-csv`
+    - :ref:`commands-hdalab-fill-tag-years`
+    - :ref:`commands-hdalab-geojson-transform`
+    - :ref:`commands-hdalab-import-hda-insee-csv`
+    - :ref:`commands-hdalab-import-hdabo-db`
+    - :ref:`commands-hdalab-import-insee-csv`
+    - :ref:`commands-hdalab-query-category-inclusion`
+    - :ref:`commands-hdalab-query-dbpedia`
+    - :ref:`commands-hdalab-query-geo-inclusion`
+    - :ref:`commands-hdalab-query-wikipedia-category`
+    - :ref:`commands-hdalab-send-moderation-mail`
+
+et la liste des commandes hdabo:
+
+    - :ref:`commands-hdabo-clean-tags`
+    - :ref:`commands-hdabo-diff-csv`
+    - :ref:`commands-hdabo-import-csv`
+    - :ref:`commands-hdabo-import-rdf`
+    - :ref:`commands-hdabo-import-tag-popularity`
+    - :ref:`commands-hdabo-order-tags`
+    - :ref:`commands-hdabo-query-wikipedia`
+
+Il est à noter que ce dans cette dernière liste seule la commande :ref:`commands-hdabo-import-rdf` est utilisée régulièrement pour importer les données HDA dans HDALab.
+
+
+Commandes hdabo
+===============
+
+.. _commands-hdabo-clean-tags:
+
+clean\_tags
+-----------
+
+.. automodule:: hdabo.management.commands.clean_tags
+
+
+.. _commands-hdabo-diff-csv:
+
+diff\_csv
+---------
+
+.. automodule:: hdabo.management.commands.diff_csv
+
+
+
+.. _commands-hdabo-import-csv:
+
+import\_csv
+-----------
+
+.. automodule:: hdabo.management.commands.import_csv
+
+
+.. _commands-hdabo-import-rdf:
+
+import\_rdf
+-----------
+
+.. automodule:: hdabo.management.commands.import_rdf
+
+
+.. _commands-hdabo-import-tag-popularity:
+
+import\_tag\_popularity
+-----------------------
+
+.. automodule:: hdabo.management.commands.import_tag_popularity
+
+
+.. _commands-hdabo-order-tags:
+
+order\_tags
+-----------
+
+.. automodule:: hdabo.management.commands.order_tags
+
+
+
+.. _commands-hdabo-query-wikipedia:
+
+query\_wikipedia
+----------------
+
+.. automodule:: hdabo.management.commands.query_wikipedia
+
+
+
+Commandes hdalab
+================
+
+.. _commands-hdalab-calculate-preview:
+
+calculate\_preview
+------------------
+
+.. automodule:: hdalab.management.commands.calculate_preview
+
+
+.. _commands-hdalab-export-tags-csv:
+
+export\_tags\_csv
+-----------------
+
+.. automodule:: hdalab.management.commands.export_tags_csv
+
+
+.. _commands-hdalab-export-wpcategory-csv:
+
+export\_wpcategory\_csv
+-----------------------
+
+.. automodule:: hdalab.management.commands.export_wpcategory_csv
+
+
+.. _commands-hdalab-fill-tag-years:
+
+fill\_tag\_years
+----------------
+
+.. automodule:: hdalab.management.commands.fill_tag_years
+
+
+.. _commands-hdalab-geojson-transform:
+
+geojson\_transform
+------------------
+
+.. automodule:: hdalab.management.commands.geojson_transform
+
+
+
+.. _commands-hdalab-import-hda-insee-csv:
+
+import\_hda\_insee\_csv
+-----------------------
+
+.. automodule:: hdalab.management.commands.import_hda_insee_csv
+
+
+.. _commands-hdalab-import-hdabo-db:
+
+import\_hdabo\_db
+-----------------
+
+.. automodule:: hdalab.management.commands.import_hdabo_db
+
+
+.. _commands-hdalab-import-insee-csv:
+
+import\_insee\_csv
+------------------
+
+.. automodule:: hdalab.management.commands.import_insee_csv
+
+
+
+.. _commands-hdalab-query-category-inclusion:
+
+query\_category\_inclusion
+--------------------------
+
+.. automodule:: hdalab.management.commands.query_category_inclusion
+
+
+.. _commands-hdalab-query-dbpedia:
+
+query\_dbpedia
+--------------
+
+.. automodule:: hdalab.management.commands.query_dbpedia
+
+
+
+.. _commands-hdalab-query-geo-inclusion:
+
+query\_geo\_inclusion
+---------------------
+
+.. automodule:: hdalab.management.commands.query_geo_inclusion
+
+
+.. _commands-hdalab-query-wikipedia-category:
+
+query\_wikipedia\_category
+--------------------------
+
+.. automodule:: hdalab.management.commands.query_wikipedia_category
+
+
+
+.. _commands-hdalab-send-moderation-mail:
+
+send\_moderation\_mail
+----------------------
+
+.. automodule:: hdalab.management.commands.send_moderation_mail

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/conf.py	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+#
+# Configuration file for the Sphinx documentation builder.
+#
+# This file does only contain a selection of the most common options. For a
+# full list see the documentation:
+# http://www.sphinx-doc.org/en/stable/config
+
+# -- Path setup --------------------------------------------------------------
+
+# 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.
+#
+import os
+import sys
+
+import django
+
+sys.path.insert(0, os.path.abspath('../../src'))
+sys.setrecursionlimit(1500)
+
+os.environ['DJANGO_SETTINGS_MODULE'] = 'hdalab.settings'
+django.setup()
+
+# -- Project information -----------------------------------------------------
+
+project = u'HDALab'
+copyright = u'2018, IRI'
+author = u'Yves-Marie Haussonne'
+
+# The short X.Y version
+version = u''
+# The full version, including alpha/beta/rc tags
+release = u'3.2.1'
+
+
+# -- 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 = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.todo',
+    'sphinx.ext.viewcode',
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = u'fr'
+
+# 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 = []
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+
+# -- 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 = 'alabaster'
+
+# 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.
+#
+# html_theme_options = {}
+
+# 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']
+
+# Custom sidebar templates, must be a dictionary that maps document names
+# to template names.
+#
+# The default sidebars (for documents that don't match any pattern) are
+# defined by theme itself.  Builtin themes are using these templates by
+# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
+# 'searchbox.html']``.
+#
+# html_sidebars = {}
+
+
+# -- Options for HTMLHelp output ---------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'HDALabdoc'
+
+
+# -- Options for LaTeX output ------------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'HDALab.tex', u'HDALab Documentation',
+     u'ymh', 'manual'),
+]
+
+
+# -- Options for manual page output ------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, 'hdalab', u'HDALab Documentation',
+     [author], 1)
+]
+
+
+# -- Options for Texinfo output ----------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (master_doc, 'HDALab', u'HDALab Documentation',
+     author, 'HDALab', 'One line description of project.',
+     'Miscellaneous'),
+]
+
+
+# -- Extension configuration -------------------------------------------------
+
+# -- Options for todo extension ----------------------------------------------
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# True to prefix each section label with the name of the document it is in, followed by a colon.
+# For example, index:Introduction for a section called Introduction that appears in document index.rst.
+# Useful for avoiding ambiguity when the same section heading appears in different documents.
+
+autosectionlabel_prefix_document = True
+
+
+autodoc_mock_imports = ["haystack.backends.whoosh_backend.SearchBackend"]
+
+html_theme_options = {
+    'logo': 'img/logo_iri.png',
+}
+
+html_sidebars = {
+    '**': [
+        'about.html',
+        'localtoc.html',
+        'relations.html',
+        # 'sourcelink.html',
+        'searchbox.html'
+    ]
+}

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/dev.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,216 @@
+####################
+Images Docker HDALab
+####################
+
+
+L'application HDALab a été conteneurisée en 5 services dont 2 nécessite
+la construction d'une image. Les services sont orchestrés avec
+l'application ``docker-compose``. L'ensemble expose les ports suivant
+sur l'ordinateur hôte:
+
+  - port 8080 : l'interface web HDALab
+  - port 8025 : Accès à l'interface de consultation `mailhog <https://github.com/mailhog/MailHog>`__.
+  - port 5432 : port serveur postgresql
+
+Mise place des images conteneurs docker
+---------------------------------------
+
+Deux possibilités existent pour mettre en place les images docker :
+  - construire les images
+  - import des images
+
+Construction des images
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Les commandes suivantes permettent de construire les images. Ces
+commandes sont à lancer dans le même répertoire que le fichier
+``docker-compose.yml``.
+
+::
+
+    $ ./prepare_docker_build.sh
+    $ docker-compose -p hdalab build
+
+Import des images
+~~~~~~~~~~~~~~~~~
+
+Lancer cette commande pour charger les images du projet.
+
+::
+
+    $ docker load -i <chemin/vers/fichier/archives/images>
+
+Comment construire les container HDALab
+---------------------------------------
+
+Toutes les commandes suivantes sont à effectuer dans le répertoire
+contenant le fichier ``docker-compose.yml``.
+
+::
+
+    $ docker-compose -p hdalab up -d
+    $ docker-compose -p hdalab exec hdalab django-admin collectstatic --noinput
+    $ docker-compose -p hdalab exec hdalab django-admin migrate --noinput
+    $ docker-compose -p hdalab exec hdalab supervisorctl restart all
+
+Le site est consultable à l'adresse suivante : http://127.0.0.1:8080 Le
+système est fonctionnel mais avec une bases de donnée vide.
+
+Lancement d'une commande Django
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Lancer cette commande pour avoir accès à l'utilitaire de gestion Django
+(c.f.
+`django-admin <https://docs.djangoproject.com/en/1.8/ref/django-admin/>`__)
+
+::
+
+    $ docker-compose -p hdalab exec hdalab django-admin <command> [options]
+
+Pour obtenir la liste des commandes disponibles faire:
+
+::
+
+    $ docker-compose -p hdalab exec hdalab django-admin
+
+Création d'un "superuser"
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Cette commande permet la creation d'un utilisateur administeur de
+l'application.
+
+::
+
+    $ docker-compose -p hdalab exec hdalab django-admin createsuperuser
+
+Import des données issues de l'export HDA
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Cette commande importe les données RDF exportées à partir de
+l'application HDA. Attention cette commande peut être longue (plusieurs
+heures).
+
+::
+
+    $ docker-compose -p hdalab exec hdalab /usr/local/sbin/import_hda_rdf.sh /etc/hdalab/data /var/lib/hdalab http://data.culture.fr/entrepot/HDA/export.tgz
+
+Import d'un dump de l'application
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Import d'un dump de la base de donnée
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Le fichier de dump de base de données doit être décompressé.
+
+::
+
+    $ docker-compose -p hdalab stop hdalab
+    $ docker exec -i hdalab_pg_1 psql -U iri postgres < </chemin/du/fichier/dump/sql.bckp>
+    $ docker-compose -p hdalab start hdalab
+    $ docker-compose -p hdalab exec hdalab django-admin migrate --noinput
+    $ echo "from django.contrib.sites.models import Site; site=Site.objects.all()[0]; site.domain='127.0.0.1:8080'; site.name='HDALab'; site.save()" | docker exec -i hdalab_hdalab_1 django-admin shell
+    $ docker-compose -p hdalab exec hdalab django-admin changepassword admin
+    $ docker-compose -p hdalab exec hdalab django-admin rebuild_index --noinput
+
+Import des miniatures renkan
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Ces commandes supposent que le service ``hdalab`` est actif. L'archive
+comprenant l'export des miniatures doit être décompressé. Cette archive
+contient le répertoire ``media`` à la racine
+
+::
+
+    $ docker cp ./media/. hdalab_hdalab_1:/var/lib/hdalab/static/media
+
+Commandes utiles
+================
+
+liste des services
+------------------
+
+Les services suivants sont définis dans le fichier
+``docker-compose.yml``: - pg : La base de donnée postgresql - es :
+ElasticSearch - mail : Mailhog, fourni un serveur smtp de test - front :
+Le serveur web (nginx) - hdalab : application hdalab comprenant
+l'application web elle-même et les services associés (envoi de mail et
+calcul des preevisualisations Renkan)
+
+Démarrage des services
+----------------------
+
+Les services se contrôlent avec la commande ``docker-compose``. La ligne
+de commande typique est la suivante:
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab [COMMAND] [ARGS...]
+
+Il faut bien noter l'utilisation systématique de l'option ``-p hdalab``
+qui spécifie le nom du projet. Si la commande est lancée dans le même
+répertoire que celui du fichier ``docker-compose.yml`` l'option ``-f``
+peut être ignorée.
+
+Construction des images des conteneurs
+--------------------------------------
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab build [SERVICE...]
+
+création et lancement des services
+----------------------------------
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab up -d [SERVICE...]
+
+A noter l'option ``-d`` qui mettent les services en tache de fond.
+
+lancement des services
+----------------------
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab run SERVICE [COMMAND] [ARGS...]
+
+Cette commande lance un service.
+
+Execution d'une commande sur un service lancé
+---------------------------------------------
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab exec SERVICE COMMAND [ARGS...]
+
+arrêt des services
+------------------
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab stop [SERVICE...]
+
+consulter la sortie des containers
+----------------------------------
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab logs [-f] [SERVICE...]
+
+effacement et recréation de la base de donnée vide
+--------------------------------------------------
+
+Attention, toutes les données de la base seront définitivement
+supprimées.
+
+::
+
+    $ docker-compose [-f </path/to/docker-compose.yml>] -p hdalab stop hdalab
+    $ echo "drop database hdalab;\ncreate database hdalab owner iri encoding 'utf-8';" | docker exec -i hdalab_pg_1 psql -U iri postgres
+
+Accès à la base de donnée
+-------------------------
+
+Le port postgresql 5432 est ouvert sur l'ordinateur hôte. La base
+utilisée par l'application est ``hdalab``. L'utilisateur et mot de passe
+pour y accéder sont : - utilisateur: ``iri`` - mot de passe: ``iri``

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/index.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,27 @@
+.. HDALab documentation master file.
+
+####################
+Documentation HDALab
+####################
+
+Cette documentation couvre le site HDALab.
+
+Ce site est réalise en python et utilise le framework Django (version 1.8).
+
+Cette documentation n'entrera pas dans le détail des fonctionnalités Django et assume donc une connaissance générale de Django par le lecteur.
+Vous pouvez trouver la documentation de Django (version 1.8) à l'url suivante : https://docs.djangoproject.com/en/1.8/.
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contenu de cette documentation:
+
+   pages
+   api
+   renkan
+   commandes
+   taches
+   dev
+   Documentation API <api/modules>
+
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/pages.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,885 @@
+.. Description des pages
+
+############################
+Description des pages HDALab
+############################
+
+Ces pages constituent la navigation principale du site HDALab.
+
+
+Acceuil
+=======
+
+.. image:: _static/img/pages/accueil_hdalab.png
+
+Page d'acceuil d'HDALab.
+
+
++----------+----------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab  |
++----------+----------------------------------------+
+| view     | django.views.generic.TemplateView      |
++----------+----------------------------------------+
+| template | hdalab/templates/index.html            |
++----------+----------------------------------------+
+
+
+
+A propos
+========
+
+.. image:: _static/img/pages/apropos_hdalab.png
+
+Page décrivant le projet HDALab avec une vidéo de tutoriel Renkan.
+
+
++----------+---------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/hdalab/a_propos/  |
++----------+---------------------------------------------------------+
+| view     | :class:`hdalab.views.pages.HdalabAboutPage`             |
++----------+---------------------------------------------------------+
+| template | hdalab/templates/a_propos.html                          |
++----------+---------------------------------------------------------+
+
+
+
+Crédits
+=======
+
+.. image:: _static/img/pages/credits_hdalab.png
+
+Page de crédits du site.
+
+
++----------+--------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/hdalab/credits/  |
++----------+--------------------------------------------------------+
+| view     | django.views.generic.TemplateView                      |
++----------+--------------------------------------------------------+
+| template | hdalab/templates/credits.html                          |
++----------+--------------------------------------------------------+
+
+
+
+
+Mentions légales
+================
+
+.. image:: _static/img/pages/mentions_legales_hdalab.png
+
+Page des mentions légales.
+
++----------+----------------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/hdalab/mentions_legales/ |
++----------+----------------------------------------------------------------+
+| view     | django.views.generic.TemplateView                              |
++----------+----------------------------------------------------------------+
+| template | hdalab/templates/mentions_legales.html                         |
++----------+----------------------------------------------------------------+
+
+
+
+Contact
+=======
+
+.. image:: _static/img/pages/contact_hdalab.png
+
+Formulaire de contact pour poser une question à l'équipe HDALab.
+Cette partie de l'application s'appuie sur le module `django-envelope <https://github.com/zsiciarz/django-envelope>`_.
+
+
++----------+-------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/hdalab/contact/ |
++----------+-------------------------------------------------------+
+| view     | envelope.views.ContactView                            |
++----------+-------------------------------------------------------+
+| template | - hdalab/templates/envelope/contact.html              |
+|          | - hdalab/templates/envelope/email_body.html           |
+|          | - hdalab/templates/envelope/email_body.txt            |
++----------+-------------------------------------------------------+
+
+
+.. _pages_liste_renkan_publics:
+
+Liste des renkan publics
+========================
+
+.. image:: _static/img/pages/renkan_public.png
+
+Page listant l'ensemble des renkan publiés (et modéré).
+
++----------+------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/renkan/public/ |
++----------+------------------------------------------------------+
+| view     | :class:`hdalab.views.profile.RenkanPublicList`       |
++----------+------------------------------------------------------+
+| template | hdalab/templates/renkan_list.html                    |
++----------+------------------------------------------------------+
+
+Note : Les templates hdalab/templates/renkan_list.html et hdalab/templates/renkan_list_favorite.html sont presque les mêmes.
+
+
+.. _pages_liste_renkan_favoris:
+
+Liste des renkan favoris
+========================
+
+.. image:: _static/img/pages/renkan_favorite.png
+
+Page listant l'ensemble des renkan ayant été marqués comme favoris par l'équipe HDALab.
+
++----------+--------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/renkan/favorite/ |
++----------+--------------------------------------------------------+
+| view     | :class:`hdalab.views.profile.RenkanFavoriteList`       |
++----------+--------------------------------------------------------+
+| template | hdalab/templates/renkan_list_favorite.html             |
++----------+--------------------------------------------------------+
+
+Note : Les templates hdalab/templates/renkan_list.html et hdalab/templates/renkan_list_favorite.html sont presque les mêmes.
+
+
+
+.. _pages_recherche_facette:
+
+Recherche (facette)
+===================
+
+.. image:: _static/img/pages/facettes_hdalab.png
+
+Page de recherche par facette.
+Cette page est relativement complexe.
+Elle contient une application javascript permettant l'édition du filtre par facette et l'affichage des résultats.
+
++----------+-------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/facettes/ |
++----------+-------------------------------------------------+
+| view     | django.views.generic.base.TemplateView          |
++----------+-------------------------------------------------+
+| template | hdalab/templates/facettes.html                  |
++----------+-------------------------------------------------+
+
+Le code javascript se trouve dans le fichier `hdalab/static/hdalab/js/gomina.js`.
+Les données pour la page sont chargées par l'url http://hdalab.iri-research.org/hdalab/a/filter.
+L'auto-completion pour la saisie de mot-clef lance des requêtes à l'URL suivante : http://hdalab.iri-research.org/hdalab/a/tagsearch.
+
+Les liens d'édition des renkan sont http://hdalab.iri-research.org/hdalab/renkan/edit/.
+
+
+Détail d'une fiche
+==================
+
+.. image:: _static/img/pages/detail_notice.png
+
+
+cette page affiche le détail d'une notice.
+Elle est contituée des éléments suivant disposés en trois colonnes :
+
+  - Le détail de la notice
+  - La liste des mots-clef de la notice
+  - La liste des notices liées
+
+Lorsqu'on clique sur un mot-clef, la liste dest notices liées est filtrée et n'affiche plus que les notices concernées par le mot-clef.
+
+
++----------+----------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/notice/{notice_id} |
++----------+----------------------------------------------------------+
+| view     | :func:`hdalab.views.pages.datasheet`                     |
++----------+----------------------------------------------------------+
+| template | hdalab/templates/notice.html                             |
++----------+----------------------------------------------------------+
+
+
+.. _pages_edition_renkan:
+
+Édition d'un renkan
+===================
+
+.. image:: _static/img/pages/renkan_edit.png
+
+Page d'édition et de création d'un renkan.
+Cette page instancie un éditeur de renkan.
+
++----------+----------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/renkan/edit/ |
++----------+----------------------------------------------------+
+| view     | :class:`hdalab.views.profile.RenkanEdit`           |
++----------+----------------------------------------------------+
+| template | hdalab/templates/renkan_edit.html                  |
++----------+----------------------------------------------------+
+
+
+L'éditeur de renkan fait alors appel à l'url suivante pour charger et sauvegarder un projet renkan :
+http://hdalab.iri-research.org/hdalab/renkan/getput/
+
+
+
+.. _affichage-d-un-renkan-en-lecture-seule:
+
+Affichage d'un renkan en lecture seule
+======================================
+
+.. image:: _static/img/pages/renkan_view.png
+
+Page d'affichage d'un renkan en lecture seule.
+
++----------+----------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/renkan/view/ |
++----------+----------------------------------------------------+
+| view     | django.views.generic.base.TemplateView             |
++----------+----------------------------------------------------+
+| template | hdalab/templates/renkan_view.html                  |
++----------+----------------------------------------------------+
+
+Cette page instancie un composant renkan en lecture seule.
+Le projet renkan est chargé par appel (GET) à l'URL http://hdalab.iri-research.org/hdalab/renkan/getput/.
+
+Les arguments d'affichage (par exemple l'identifiant du renkan) sont passés en javascript grâce à la propriété `window.location.search <https://developer.mozilla.org/en-US/docs/Web/API/HTMLHyperlinkElementUtils/search>`_ (La partie de l'URL qui suit le symbole « ? », avec ce symbole inclus.)
+
+
+
+.. _affichage-d-un-renkan-en-plein-ecran:
+
+Affichage d'un renkan en plein-écran
+====================================
+
+.. image:: _static/img/pages/renkan_view_full.png
+
+Page d'affichage d'un renkan en lecture seule et en plein écran.
+
++----------+----------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/renkan/full/ |
++----------+----------------------------------------------------+
+| view     | django.views.generic.base.TemplateView             |
++----------+----------------------------------------------------+
+| template | hdalab/templates/renkan_view_full.html             |
++----------+----------------------------------------------------+
+
+cette page permet l'affichage d'un renkan en plein-écran, sans les en-tête, pied de page, barre de navigation,...
+Cette page est utilisée pour la création des miniature de prévisualisation des renkan.
+
+Sur le fonctionnement elle est identique à la page ":ref:`affichage-d-un-renkan-en-lecture-seule`, en particulier sur la façon dont les arguments sont passés.
+
+
+
+.. _pages_explorer_domaines_artistiques:
+
+Explorer les domaines artistiques
+=================================
+
+.. image:: _static/img/pages/artistic_domains_hdalab.png
+
+Cette page permet d'explorer les fiches HDA par le biais des domaines artistiques.
+
++----------+----------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/categories/  |
++----------+----------------------------------------------------+
+| view     | django.views.generic.base.TemplateView             |
++----------+----------------------------------------------------+
+| template | hdalab/templates/categories.html                   |
++----------+----------------------------------------------------+
+
+Cette page contient une application javascript s'occupant du chargement de de l'affichage des données.
+Les données sont chargées à l'url suivante : http://hdalab.iri-research.org/hdalab/a/cattree
+Le code javascript de cette page se trouve dans les fichiers `hdalab/static/hdalab/js/trees.js` et `hdalab/static/hdalab/js/cattree.js`.
+
+
+
+.. _pages_recherche_arbre:
+
+Recherche par arbre
+===================
+
+.. image:: _static/img/pages/tree_search_hdalab.png
+
+Cette page permet de comparer deux extraits de thesaurus utilisés par le MCC.
+
++----------+----------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/thesaurus/   |
++----------+----------------------------------------------------+
+| view     | django.views.generic.base.TemplateView             |
++----------+----------------------------------------------------+
+| template | hdalab/templates/thesaurus.html                    |
++----------+----------------------------------------------------+
+
+Cette page contient une application javascript s'occupant du chargement et de l'afficahge des données.
+Les données sont chargées à l'url suivante : http://hdalab.iri-research.org/hdalab/a/filltree
+Le code javascript de cette page se trouve dans les fichiers `hdalab/static/hdalab/js/trees.js` et `hdalab/static/hdalab/js/thesaurus.js`.
+
+
+.. _pages-d-administration-django-hdalab-hdabo:
+
+Pages d'administration Django hdalab/hdabo
+==========================================
+
+.. image:: _static/img/pages/admin_django_hdalab.png
+
+
+Ce sont toutes les pages dont l'URL commence par http://hdalab.iri-research.org/hdalab/hdabo/admin/ .
+Elles nécessitent toute une authentification.
+L'ensemble de ces pages est fournis par l'application d'administration Django fourni d'origine par le framework.
+Le lien suivant en donne une documentation : https://docs.djangoproject.com/en/1.8/ref/contrib/admin/.
+
+Les objets suivant sont configurés pour être administrables:
+
+  - :class:`hdabo.models.Author`
+  - :class:`hdabo.models.Datasheet`
+  - :class:`hdabo.models.DocumentFormat`
+  - :class:`hdabo.models.Domain`
+  - :class:`hdabo.models.Organisation`
+  - :class:`hdabo.models.Tag`
+  - :class:`hdabo.models.TagCategory`
+  - :class:`hdabo.models.TaggedSheet`
+  - :class:`hdabo.models.TimePeriod`
+  - :class:`hdabo.models.User`
+  - `registration.models.RegistrationProfile`
+  - `django.contrib.sites.models import Site`
+
+
+.. _pages_page_profil_utilisateur:
+
+Page profil utilisateur
+=======================
+
+.. image:: _static/img/pages/user_profile_hdalab.png
+
+
+Page de gestion du profile utilisateur.
+Elle permet l'accès à la gestion de ses renkan et de son profile utilisateur.
+Cette page nécessite d'être authentifié.
+
++----------+----------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/profile/     |
++----------+----------------------------------------------------+
+| view     | :class:`hdalab.views.profile.ProfileHome`          |
++----------+----------------------------------------------------+
+| template | hdalab/templates/profile_home.html                 |
++----------+----------------------------------------------------+
+
+Entre outre des fonction de gestion des renkan, cette page donne accès aux liens suivants:
+
+  - http://hdalab.iri-research.org/hdalab/hdabo/accounts/password/change/ : modification du mot de passe.
+  - http://hdalab.iri-research.org/hdalab/profile/update/ : modification des informations utilisateur (c.f. :ref:`changement-information-utilisateur`)
+
+Si l'utilisateur est identifié comme `staff <https://docs.djangoproject.com/en/1.8/ref/contrib/auth/#django.contrib.auth.models.User.is_staff>`_, il a accès aux line supplémentaires:
+
+  - http://hdalab.iri-research.org/hdalab/edito/manage/
+  - http://hdalab.iri-research.org/hdalab/edito/ :
+  - http://hdalab.iri-research.org/hdalab/hdabo/admin/ : :ref:`pages-d-administration-django-hdalab-hdabo`
+  - http://hdalab.iri-research.org/hdalab/hdabo/ : **obsolète**
+
+
+
+
+.. _changement-information-utilisateur:
+
+Changement information utilisateur
+==================================
+
+.. image:: _static/img/pages/user_info_hdalab.png
+
+Page permettant de modifier les information du profile utilisateur. Dans le cas d'HDALab, cela se limite à la modification de l'email de contact.
+Cette page nécessite d'être authentifié.
+
++----------+----------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/profile/update     |
++----------+----------------------------------------------------------+
+| view     | :class:`hdalab.views.profile.UserProfileUpdate`          |
++----------+----------------------------------------------------------+
+| template | hdalab/templates/hdabo/user_update_form.html             |
++----------+----------------------------------------------------------+
+
+
+Éditorialisation
+================
+
+.. image:: _static/img/pages/editorialisation_hdalab.png
+
+
+Page donnant accès aux fonction de gestion de l'éditorialisation.
+
++----------+----------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/edito/             |
++----------+----------------------------------------------------------+
+| view     | django.views.generic.base.TemplateView                   |
++----------+----------------------------------------------------------+
+| template | hdalab/templates/editorial/edito_home.html               |
++----------+----------------------------------------------------------+
+
+
+Cette page propose les 2 liens suivants:
+
+  - http://hdalab.iri-research.org/hdalab/edito/folders/ : :ref:`gestion-des-dossiers-thematiques`
+  - http://hdalab.iri-research.org/hdalab/edito/manage/ : :ref:`gestion-des-renkan-moderation`
+
+
+
+
+.. _gestion-des-dossiers-thematiques:
+
+Gestion des dossiers thématiques
+================================
+
+.. image:: _static/img/pages/thematic_folder_hdalab.png
+
+
+Cette page donne accès au tableau des dossiers thématiques.
+
+
++----------+----------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/edito/folders/     |
++----------+----------------------------------------------------------+
+| view     | :class:`hdalab.views.editorial.HdalabFolders`            |
++----------+----------------------------------------------------------+
+| template | hdalab/templates/editorial/folders.html                  |
++----------+----------------------------------------------------------+
+
+
+
+.. _gestion-des-renkan-moderation:
+
+Gestion des renkan (modération)
+===============================
+
+
+.. image:: _static/img/pages/administrer_renkan.png
+
+Page de modération des renkans.
+
+
++----------+----------------------------------------------------------+
+| url      | http://hdalab.iri-research.org/hdalab/edito/manage/      |
++----------+----------------------------------------------------------+
+| view     | :class:`hdalab.views.editorial.ManageRenkans`            |
++----------+----------------------------------------------------------+
+| template | hdalab/templates/editorial/manage_renkans.html           |
++----------+----------------------------------------------------------+
+
+
+
+.. _pages_liste_renkan:
+
+Pages de liste des Renkan
+=========================
+
+.. image:: _static/img/pages/renkan_base_list.png
+
+Ce sont les pages dont la vue hérite de :class:`hdalab.views.profile.BaseRenkanList`.
+Ces vues permettent de gérer une liste de Renkan avec un système de filtre et de pagination.
+Les actions suivantes sont disponibles :
+
+  - copie : :ref:`pages_copier_renkan`
+  - affichage : :ref:`affichage-d-un-renkan-en-lecture-seule`
+  - modération (si l'utilisateur est autorisé) : :ref:`pages_moderation_renkan`
+  - édition (si l'utilisateur est autorisé) : :ref:`pages_edition_renkan`
+  - effacement (si l'utilisateur est autorisé) : :ref:`pages_effacer_renkan`
+  - favori (si l'utilisateur est autorisé) :  :ref:`pages_favori_renkan`
+  - création d'un nouveau renkan vide : :ref:`pages_nouveau_renkan`
+
+.. autoclass:: hdalab.views.profile.BaseRenkanList
+  :noindex:
+
+Voici la liste des pages héritant de :class:`hdalab.views.profile.BaseRenkanList` :
+
+  - :ref:`gestion-des-renkan-moderation`
+  - :ref:`pages_liste_renkan_publics`
+  - :ref:`pages_liste_renkan_favoris`
+  - :ref:`pages_page_profil_utilisateur`
+
+
+Pages de commande de Renkan
+===========================
+
+Ces pages sont appelées à partir des pages listant les renkan, en particulier celle dont la vue hérite de :class:`hdalab.views.profile.BaseRenkanList`
+
+
+.. _pages_copier_renkan:
+
+Copier un renkan
+----------------
+
+Copie un renkan dont l'id est donné dans l'url.
+L'utilisateur est redirigé vers la page de liste des Renkan.
+
++-------------+-----------------------------------------------------------+
+| url         | http://hdalab.iri-research.org/hdalab/renkan/copy/<rk_id> |
++-------------+-----------------------------------------------------------+
+| view        | :class:`hdalab.views.profile.HdalabRenkanCopy`            |
++-------------+-----------------------------------------------------------+
+| méthode     | POST                                                      |
++-------------+-----------------------------------------------------------+
+| redirection | Page de liste des renkan.                                 |
++-------------+-----------------------------------------------------------+
+
+
+.. automethod:: hdalab.views.profile.HdalabRenkanCopy.post
+  :noindex:
+
+.. _pages_effacer_renkan:
+
+Effacer un renkan
+-----------------
+
+Effacer un renkan dont l'id est donné dans l'URL.
+
++-------------+-------------------------------------------------------------+
+| url         | http://hdalab.iri-research.org/hdalab/renkan/delete/<rk_id> |
++-------------+-------------------------------------------------------------+
+| view        | :class:`hdalab.views.profile.HdalabRenkanDelete`            |
++-------------+-------------------------------------------------------------+
+| méthode     | POST                                                        |
++-------------+-------------------------------------------------------------+
+| redirection | Page de liste des renkan.                                   |
++-------------+-------------------------------------------------------------+
+
+
+.. automethod:: hdalab.views.profile.HdalabRenkanDelete.post
+  :noindex:
+
+
+.. _pages_favori_renkan:
+
+Marquer un renkan comme favori
+------------------------------
+
+Marque comme favori le renkan dont l'id est donné dans l'URL.
+
++-------------+---------------------------------------------------------------+
+| url         | http://hdalab.iri-research.org/hdalab/renkan/favorite/<rk_id> |
++-------------+---------------------------------------------------------------+
+| view        | :class:`hdalab.views.profile.HdalabRenkanFavorite`            |
++-------------+---------------------------------------------------------------+
+| méthode     | POST                                                          |
++-------------+---------------------------------------------------------------+
+| redirection | Page de liste des renkan.                                     |
++-------------+---------------------------------------------------------------+
+
+
+.. automethod:: hdalab.views.profile.HdalabRenkanFavorite.post
+  :noindex:
+
+
+
+.. _pages_moderation_renkan:
+
+Modération d'un renkan
+----------------------
+
+Cette action change l'état d'un Renkan dont l'id est donné dans l'URL.
+
++-------------+---------------------------------------------------------------+
+| url         | http://hdalab.iri-research.org/hdalab/renkan/moderate/<rk_id> |
++-------------+---------------------------------------------------------------+
+| view        | :class:`hdalab.views.profile.HdalabRenkanModerate`            |
++-------------+---------------------------------------------------------------+
+| méthode     | POST                                                          |
++-------------+---------------------------------------------------------------+
+| redirection | Page de liste des renkan.                                     |
++-------------+---------------------------------------------------------------+
+
+
+.. automethod:: hdalab.views.profile.HdalabRenkanModerate.post
+  :noindex:
+
+.. _pages_nouveau_renkan:
+
+Création d'un nouveau renkan
+----------------------------
+
+Crée un nouveau renkan vide. L'utilisateur est redirigé vers la page d'édition du renkan (:ref:`pages_edition_renkan`)
+
++-------------+--------------------------------------------------+
+| url         | http://hdalab.iri-research.org/hdalab/renkan/new |
++-------------+--------------------------------------------------+
+| view        | :class:`hdalab.views.profile.RenkanNew`          |
++-------------+--------------------------------------------------+
+| méthode     | POST                                             |
++-------------+--------------------------------------------------+
+| redirection | :ref:`pages_edition_renkan`                      |
++-------------+--------------------------------------------------+
+
+
+.. automethod:: hdalab.views.profile.RenkanNew.post
+  :noindex:
+
+
+Pages de gestion des comptes utilisateurs
+=========================================
+
+Ce sont toutes les pages dont l'URL commence par http://hdalab.iri-research.org/hdalab/hdabo/accounts/ .
+Ces URL sont fournies par des librariries externe :
+
+
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| base d'URL                                                      | librairie / lien de documentation                                              |
++=================================================================+================================================================================+
+| http://hdalab.iri-research.org/hdalab/hdabo/accounts/activate/  | `django-registration-redux <https://github.com/macropin/django-registration>`_ |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| http://hdalab.iri-research.org/hdalab/hdabo/accounts/register/  | `django-registration-redux <https://github.com/macropin/django-registration>`_ |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| http://hdalab.iri-research.org/hdalab/login                     | `django.contrib.auth <https://docs.djangoproject.com/en/1.8/topics/auth/>`_    |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| http://hdalab.iri-research.org/hdalab/logout                    | `django.contrib.auth <https://docs.djangoproject.com/en/1.8/topics/auth/>`_    |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| http://hdalab.iri-research.org/hdalab/password                  | `django.contrib.auth <https://docs.djangoproject.com/en/1.8/topics/auth/>`_    |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| http://hdalab.iri-research.org/hdalab/password_change           | `django.contrib.auth <https://docs.djangoproject.com/en/1.8/topics/auth/>`_    |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+| http://hdalab.iri-research.org/hdalab/password_reset            | `django.contrib.auth <https://docs.djangoproject.com/en/1.8/topics/auth/>`_    |
++-----------------------------------------------------------------+--------------------------------------------------------------------------------+
+
+
+La librairie `django-registration-redux <https://github.com/macropin/django-registration>`_ offre en particulier la fonctionalité d'inscription sur le site et la vérification de l'email.
+
+En outre les 2 URL suivantes sont disponibles afin de faciliter l'authentification à partir de la page d'édition d'un renkan et d'éviter un rechargement de page.
+
+
+  - +----------+----------------------------------------------------------+
+    | url      | http://hdalab.iri-research.org/hdalab/ajaxlogin/         |
+    +----------+----------------------------------------------------------+
+    | view     | :func:`hdalab.views.profile.ajax_login`                  |
+    +----------+----------------------------------------------------------+
+
+  - +----------+----------------------------------------------------------+
+    | url      | http://hdalab.iri-research.org/hdalab/edito/manage/      |
+    +----------+----------------------------------------------------------+
+    | view     | django.views.generic.base.TemplateView                   |
+    +----------+----------------------------------------------------------+
+    | template | hdalab/templates/ajax_identification/ajax_login_ok.html  |
+    +----------+----------------------------------------------------------+
+
+
+
+Pages hdabo
+===========
+
+Ce sont toute les pages dont l'URL commence par `http://hdalab.iri-research.org/hdalab/hdabo/` et qui ne sont pas dans la liste d'excption donnée ci-dessous.
+
+Ces pages sont aujourd'hui obsolètes.
+Elles ont été inclues dans le plan d'url HDALab pour référence, mais ne sont plus utiles.
+
+Elles ont permit le premier traitement sémantique des données HDA pour le projet HDALab.
+Cette fonctionnalité est aujourd'hui directement intégré au portail HDA par l'intermédiaire du module symfony `WikiTagBundle <https://github.com/IRI-Research/WikiTagBundle>`_.
+
+Les données HDA sont régulièrement importées dans HDALab par la commande :class:`hdalab.management.commands.import_hdabo_db`.
+
+Liste d'exception des pages hdabo non obsolètes :
+    - http://hdalab.iri-research.org/hdalab/hdabo/searchajax/
+    - http://hdalab.iri-research.org/hdalab/hdabo/admin/*
+    - http://hdalab.iri-research.org/hdalab/hdabo/account/*
+
+
+
+..
+    /i18n/setlang/	django.views.i18n.set_language	set_language
+    /jsi18n/	django.views.i18n.javascript_catalog	jsi18n.all
+    /jsi18n/<packages>/	django.views.i18n.javascript_catalog	jsi18n
+
+
+    /renkan/copy/<rk_id>	hdalab.views.profile.HdalabRenkanCopy	renkan_copy	login_required
+    /renkan/delete/<rk_id>	hdalab.views.profile.HdalabRenkanDelete	renkan_delete	login_required
+    /renkan/favorite/<rk_id>	hdalab.views.profile.HdalabRenkanFavorite	renkan_favorite	login_required
+    /renkan/moderate/<rk_id>	hdalab.views.profile.HdalabRenkanModerate	renkan_moderate	login_required
+
+    /renkan/new/	hdalab.views.profile.RenkanNew	renkan_new	login_required
+
+
+
+    Fait:
+
+    /renkan/edit/	hdalab.views.profile.RenkanEdit	renkan_edit
+    /renkan/getput/	hdalab.views.profile.HdalabRenkanGetPut	renkan_get_put
+
+    /profile/	hdalab.views.profile.ProfileHome	profile_home	login_required
+    /profile/update/	hdalab.views.profile.UserProfileUpdate	profile_update	login_required
+
+    /notice/<hda_id>	hdalab.views.pages.datasheet	notice
+
+    /a/catsearch	hdalab.views.ajax.catsearch	cat_search
+    /a/cattree	hdalab.views.ajax.cattree	cat_tree
+    /a/filltree	hdalab.views.ajax.filltree	fill_tree
+    /a/filter	hdalab.views.ajax.filter	filter
+    /a/tagsearch	hdalab.views.ajax.tagsearch	tag_search
+
+
+    /edito/deletefolder/<folder_pk>	hdalab.views.editorial.HdalabDeleteFolder	hdalab_delete_folder	login_required
+    /edito/folder/	hdalab.views.editorial.HdalabAddOrUpdateFolder	hdalab_add_or_update_folder	login_required
+    /edito/folder/<folder_pk>	hdalab.views.editorial.HdalabAddOrUpdateFolder	hdalab_add_or_update_folder	login_required
+    /edito/folders/	hdalab.views.editorial.HdalabFolders	hdalab_folders	login_required
+    /edito/manage/	hdalab.views.editorial.ManageRenkans	manage_renkans	login_required
+
+    /facettes/	django.views.generic.base.TemplateView	facettes
+
+
+    /hdalab/a_propos/	hdalab.views.pages.HdalabAboutPage	a_propos
+    /hdalab/contact/	envelope.views.ContactView	envelope-contact
+    /hdalab/credits/	django.views.generic.base.TemplateView	credits
+    /hdalab/mentions_legales/	django.views.generic.base.TemplateView	mentions_legales
+    /thesaurus/	django.views.generic.base.TemplateView	thesaurus
+
+
+    /hdabo/admin/	django.contrib.admin.sites.index	admin:index
+    /hdabo/admin/<app_label>/	django.contrib.admin.sites.app_index	admin:app_list
+    /hdabo/admin/auth/group/	django.contrib.admin.options.changelist_view	admin:auth_group_changelist
+    /hdabo/admin/auth/group/<var>/	django.contrib.admin.options.change_view	admin:auth_group_change
+    /hdabo/admin/auth/group/<var>/delete/	django.contrib.admin.options.delete_view	admin:auth_group_delete
+    /hdabo/admin/auth/group/<var>/history/	django.contrib.admin.options.history_view	admin:auth_group_history
+    /hdabo/admin/auth/group/add/	django.contrib.admin.options.add_view	admin:auth_group_add
+    /hdabo/admin/hdabo/author/	django.contrib.admin.options.changelist_view	admin:hdabo_author_changelist
+    /hdabo/admin/hdabo/author/<var>/	django.contrib.admin.options.change_view	admin:hdabo_author_change
+    /hdabo/admin/hdabo/author/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_author_delete
+    /hdabo/admin/hdabo/author/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_author_history
+    /hdabo/admin/hdabo/author/add/	django.contrib.admin.options.add_view	admin:hdabo_author_add
+    /hdabo/admin/hdabo/datasheet/	django.contrib.admin.options.changelist_view	admin:hdabo_datasheet_changelist
+    /hdabo/admin/hdabo/datasheet/<var>/	django.contrib.admin.options.change_view	admin:hdabo_datasheet_change
+    /hdabo/admin/hdabo/datasheet/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_datasheet_delete
+    /hdabo/admin/hdabo/datasheet/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_datasheet_history
+    /hdabo/admin/hdabo/datasheet/add/	django.contrib.admin.options.add_view	admin:hdabo_datasheet_add
+    /hdabo/admin/hdabo/documentformat/	django.contrib.admin.options.changelist_view	admin:hdabo_documentformat_changelist
+    /hdabo/admin/hdabo/documentformat/<var>/	django.contrib.admin.options.change_view	admin:hdabo_documentformat_change
+    /hdabo/admin/hdabo/documentformat/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_documentformat_delete
+    /hdabo/admin/hdabo/documentformat/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_documentformat_history
+    /hdabo/admin/hdabo/documentformat/add/	django.contrib.admin.options.add_view	admin:hdabo_documentformat_add
+    /hdabo/admin/hdabo/domain/	django.contrib.admin.options.changelist_view	admin:hdabo_domain_changelist
+    /hdabo/admin/hdabo/domain/<var>/	django.contrib.admin.options.change_view	admin:hdabo_domain_change
+    /hdabo/admin/hdabo/domain/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_domain_delete
+    /hdabo/admin/hdabo/domain/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_domain_history
+    /hdabo/admin/hdabo/domain/add/	django.contrib.admin.options.add_view	admin:hdabo_domain_add
+    /hdabo/admin/hdabo/organisation/	django.contrib.admin.options.changelist_view	admin:hdabo_organisation_changelist
+    /hdabo/admin/hdabo/organisation/<var>/	django.contrib.admin.options.change_view	admin:hdabo_organisation_change
+    /hdabo/admin/hdabo/organisation/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_organisation_delete
+    /hdabo/admin/hdabo/organisation/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_organisation_history
+    /hdabo/admin/hdabo/organisation/add/	django.contrib.admin.options.add_view	admin:hdabo_organisation_add
+    /hdabo/admin/hdabo/tag/	django.contrib.admin.options.changelist_view	admin:hdabo_tag_changelist
+    /hdabo/admin/hdabo/tag/<var>/	django.contrib.admin.options.change_view	admin:hdabo_tag_change
+    /hdabo/admin/hdabo/tag/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_tag_delete
+    /hdabo/admin/hdabo/tag/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_tag_history
+    /hdabo/admin/hdabo/tag/add/	django.contrib.admin.options.add_view	admin:hdabo_tag_add
+    /hdabo/admin/hdabo/tagcategory/	django.contrib.admin.options.changelist_view	admin:hdabo_tagcategory_changelist
+    /hdabo/admin/hdabo/tagcategory/<var>/	django.contrib.admin.options.change_view	admin:hdabo_tagcategory_change
+    /hdabo/admin/hdabo/tagcategory/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_tagcategory_delete
+    /hdabo/admin/hdabo/tagcategory/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_tagcategory_history
+    /hdabo/admin/hdabo/tagcategory/add/	django.contrib.admin.options.add_view	admin:hdabo_tagcategory_add
+    /hdabo/admin/hdabo/taggedsheet/	django.contrib.admin.options.changelist_view	admin:hdabo_taggedsheet_changelist
+    /hdabo/admin/hdabo/taggedsheet/<var>/	django.contrib.admin.options.change_view	admin:hdabo_taggedsheet_change
+    /hdabo/admin/hdabo/taggedsheet/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_taggedsheet_delete
+    /hdabo/admin/hdabo/taggedsheet/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_taggedsheet_history
+    /hdabo/admin/hdabo/taggedsheet/add/	django.contrib.admin.options.add_view	admin:hdabo_taggedsheet_add
+    /hdabo/admin/hdabo/timeperiod/	django.contrib.admin.options.changelist_view	admin:hdabo_timeperiod_changelist
+    /hdabo/admin/hdabo/timeperiod/<var>/	django.contrib.admin.options.change_view	admin:hdabo_timeperiod_change
+    /hdabo/admin/hdabo/timeperiod/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_timeperiod_delete
+    /hdabo/admin/hdabo/timeperiod/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_timeperiod_history
+    /hdabo/admin/hdabo/timeperiod/add/	django.contrib.admin.options.add_view	admin:hdabo_timeperiod_add
+    /hdabo/admin/hdabo/user/	django.contrib.admin.options.changelist_view	admin:hdabo_user_changelist
+    /hdabo/admin/hdabo/user/<var>/	django.contrib.admin.options.change_view	admin:hdabo_user_change
+    /hdabo/admin/hdabo/user/<var>/delete/	django.contrib.admin.options.delete_view	admin:hdabo_user_delete
+    /hdabo/admin/hdabo/user/<var>/history/	django.contrib.admin.options.history_view	admin:hdabo_user_history
+    /hdabo/admin/hdabo/user/<var>/password/	django.contrib.auth.admin.user_change_password	admin:auth_user_password_change
+    /hdabo/admin/hdabo/user/add/	django.contrib.auth.admin.add_view	admin:hdabo_user_add
+    /hdabo/admin/jsi18n/	django.contrib.admin.sites.i18n_javascript	admin:jsi18n
+    /hdabo/admin/login/	django.contrib.admin.sites.login	admin:login
+    /hdabo/admin/logout/	django.contrib.admin.sites.logout	admin:logout
+    /hdabo/admin/password_change/	django.contrib.admin.sites.password_change	admin:password_change
+    /hdabo/admin/password_change/done/	django.contrib.admin.sites.password_change_done	admin:password_change_done
+    /hdabo/admin/r/<content_type_id>/<object_id>/	django.contrib.contenttypes.views.shortcut	admin:view_on_site
+    /hdabo/admin/registration/registrationprofile/	django.contrib.admin.options.changelist_view	admin:registration_registrationprofile_changelist
+    /hdabo/admin/registration/registrationprofile/<var>/	django.contrib.admin.options.change_view	admin:registration_registrationprofile_change
+    /hdabo/admin/registration/registrationprofile/<var>/delete/	django.contrib.admin.options.delete_view	admin:registration_registrationprofile_delete
+    /hdabo/admin/registration/registrationprofile/<var>/history/	django.contrib.admin.options.history_view	admin:registration_registrationprofile_history
+    /hdabo/admin/registration/registrationprofile/add/	django.contrib.admin.options.add_view	admin:registration_registrationprofile_add
+    /hdabo/admin/sites/site/	django.contrib.admin.options.changelist_view	admin:sites_site_changelist
+    /hdabo/admin/sites/site/<var>/	django.contrib.admin.options.change_view	admin:sites_site_change
+    /hdabo/admin/sites/site/<var>/delete/	django.contrib.admin.options.delete_view	admin:sites_site_delete
+    /hdabo/admin/sites/site/<var>/history/	django.contrib.admin.options.history_view	admin:sites_site_history
+    /hdabo/admin/sites/site/add/	django.contrib.admin.options.add_view	admin:sites_site_add
+
+    /hdabo/accounts/activate/<activation_key>/	registration.backends.default.views.ActivationView	registration_activate
+    /hdabo/accounts/activate/complete/	django.views.generic.base.TemplateView	registration_activation_complete
+    /hdabo/accounts/login/	django.contrib.auth.views.login	auth_login
+    /hdabo/accounts/login/	django.contrib.auth.views.login	login
+    /hdabo/accounts/logout/	django.contrib.auth.views.logout	auth_logout	login_required
+    /hdabo/accounts/logout/	django.contrib.auth.views.logout	logout	login_required
+    /hdabo/accounts/password/change/	django.contrib.auth.views.password_change	auth_password_change
+    /hdabo/accounts/password/change/done/	django.contrib.auth.views.password_change_done	auth_password_change_done	login_required
+    /hdabo/accounts/password/reset/	django.contrib.auth.views.password_reset	auth_password_reset
+    /hdabo/accounts/password/reset/complete/	django.contrib.auth.views.password_reset_complete	auth_password_reset_complete	login_required
+    /hdabo/accounts/password/reset/confirm/<uidb64>/<token>/	django.contrib.auth.views.password_reset_confirm	auth_password_reset_confirm
+    /hdabo/accounts/password/reset/confirm/<uidb64>/<token>/	django.contrib.auth.views.password_reset_confirm	auth_password_reset_confirm
+    /hdabo/accounts/password/reset/done/	django.contrib.auth.views.password_reset_done	auth_password_reset_done	login_required
+    /hdabo/accounts/password_change/	django.contrib.auth.views.password_change	password_change
+    /hdabo/accounts/password_change/done/	django.contrib.auth.views.password_change_done	password_change_done	login_required
+    /hdabo/accounts/password_reset/	django.contrib.auth.views.password_reset	password_reset
+    /hdabo/accounts/password_reset/done/	django.contrib.auth.views.password_reset_done	password_reset_done	login_required
+    /hdabo/accounts/register/	registration.backends.default.views.RegistrationView	registration_register
+    /hdabo/accounts/register/closed/	django.views.generic.base.TemplateView	registration_disallowed
+    /hdabo/accounts/register/complete/	django.views.generic.base.TemplateView	registration_complete
+    /hdabo/accounts/reset/<uidb64>/<token>/	django.contrib.auth.views.password_reset_confirm	password_reset_confirm
+    /hdabo/accounts/reset/done/	django.contrib.auth.views.password_reset_complete	password_reset_complete	login_required
+
+    /ajaxlogin/	hdalab.views.profile.ajax_login	ajax_login
+    /ajaxloginok/	django.views.generic.base.TemplateView	ajax_login_ok
+
+    /categories/	django.views.generic.base.TemplateView	categories
+
+
+    /static/media/<path>	django.views.static.serve
+
+
+    /renkan/favorite/	hdalab.views.profile.RenkanFavoriteList	renkan_favorite_list
+    /renkan/public/	hdalab.views.profile.RenkanPublicList	renkan_public_list
+    /renkan/view/	django.views.generic.base.TemplateView	renkan_view
+    /renkan/full/	django.views.generic.base.TemplateView	renkan_full
+
+
+    /edito/	django.views.generic.base.TemplateView	edito_home	login_required
+
+
+    /hdabo/	hdabo.views.home	hdabo_home	login_required
+
+    /hdabo/addtag	hdabo.views.add_tag		login_required
+
+    /hdabo/alltags/	hdabo.views.all_tags		login_required
+    /hdabo/alltags/<num_page>/	hdabo.views.all_tags		login_required
+    /hdabo/alltags/<num_page>/<nb_by_page>/	hdabo.views.all_tags		login_required
+    /hdabo/alltags/<num_page>/<nb_by_page>/<sort>/	hdabo.views.all_tags		login_required
+    /hdabo/alltags/<num_page>/<nb_by_page>/<sort>/<searched>/	hdabo.views.all_tags		login_required
+
+    /hdabo/data	hdabo.views.display_datasheet	display_datasheet	login_required
+    /hdabo/data/<ds_id>	hdabo.views.display_datasheet	display_datasheet	login_required
+
+    /hdabo/deletefolder/<folder_pk>	hdabo.views.DeleteFolder	delete_folder	login_required
+
+    /hdabo/folder/	hdabo.views.AddOrUpdateFolder	add_or_update_folder	login_required
+    /hdabo/folder/<folder_pk>	hdabo.views.AddOrUpdateFolder	add_or_update_folder	login_required
+    /hdabo/folders/	hdabo.views.Folders	folders	login_required
+
+    /hdabo/list/	hdabo.views.orga_list	orga_list	login_required
+    /hdabo/list/<orga_id>	hdabo.views.list_for_orga	list_for_orga	login_required
+    /hdabo/list/<orga_id>/<valid>/	hdabo.views.list_for_orga	list_for_orga	login_required
+    /hdabo/list/<orga_id>/<valid>/<start_index>/	hdabo.views.list_for_orga	list_for_orga	login_required
+    /hdabo/list/<orga_id>/<valid>/<start_index>/<length>/	hdabo.views.list_for_orga	list_for_orga	login_required
+
+    /hdabo/logout/	django.contrib.auth.views.logout_then_login		login_required
+
+    /hdabo/modifytag	hdabo.views.modify_tag		login_required
+    /hdabo/modifytagds	hdabo.views.modify_tag_datasheet		login_required
+
+    /hdabo/ordertagsdatasheet	hdabo.views.reorder_tag_datasheet		login_required
+
+    /hdabo/removetagfromlist	hdabo.views.remove_tag_from_list		login_required
+    /hdabo/removewplink	hdabo.views.remove_wp_link		login_required
+    /hdabo/resetwpinfo	hdabo.views.reset_wikipedia_info		login_required
+
+    /hdabo/search/	haystack.views.SearchView()	haystack_search
+    /hdabo/searchajax/	hdabo.views.SearchDatasheet()	searchajax
+
+    /hdabo/tagupdown	hdabo.views.tag_up_down		login_required
+
+    /hdabo/updatetagalias	hdabo.views.update_tag_alias		login_required
+    /hdabo/updatetagcategory	hdabo.views.update_tag_category		login_required
+
+    /hdabo/validatedatasheet	hdabo.views.validate_datasheet		login_required
+    /hdabo/validatedatasheet/<ds_id>	hdabo.views.validate_datasheet		login_required
+    /hdabo/validatedatasheet/<ds_id>/<valid>/	hdabo.views.validate_datasheet		login_required
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/renkan.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,199 @@
+.. description des renkan
+
+##############################
+Description de l'outils renkan
+##############################
+
+Introduction
+============
+
+Renkan est un outil d'édition et d'affichage de carte mentale.
+
+Il a été conçu de façon modulaire et avec une claire separation entre la partie cliente en javascript et la partie serveur.
+
+En particulier la partie du client en charge des communications avec le serveur (chargement des projets, gestion de la persistance) est totalement modulaire et configurable.
+Cela permet d'adapter facilement le client à l'api de sauvegarde du serveur.
+
+
+Modèle de donnée serveur (HDALab)
+=================================
+
+Le modèle de donnée du coté serveur est simple.
+En effet le serveur ne cherche pas à interpréter le contenu d'un renkan.
+Il se content de sauvegarder le contenu qui lui est transmis par le client et dans l'autre sens de transmettre directement au client le contenu sauvegardé en base.
+Toute l'interprétation du modèle se fait dans le client.
+
+Classe renkanmanager.models.Renkan
+----------------------------------
+
+*class* ``renkanmanager.models.``\ **Renkan** :
+
+    Classe de base d'un renkan.
+
+    Champs de l'objet:
+
+      - **owner** (`object`) : Le propriétaire (créateur) du renkan.
+      - **rk_id** (`str`) : id du renkan.
+      - **content** (`str`) : contenu du renkan (la chaine JSON brute).
+      - **title** (`str`) : titre du renkan.
+      - **image** (`str`) : chemin vers l'image miniature du renkan.
+      - **creation_date** (`datetime`) : date de création.
+      - **modification_date** (`datetime`) : date de modification.
+
+
+Classe hdalab.models.renkan.HdalabRenkan
+----------------------------------------
+
+.. autoclass:: hdalab.models.renkan.HdalabRenkan
+  :noindex:
+
+
+Format renkan
+=============
+
+Un renkan a le format suivant:
+
+  exemple ::
+
+    {
+        "id": "f4d002b7-d4fd-486c-8898-6c6ceebc3354",
+        "schema_version": 2, #version of schema, latest is 2.
+        "title": "Example of Renkan with movies",
+        "description": "A long description",
+        "created": "2013-03-18T11:32:40.253+01:00",
+        "updated": "2014-02-04T15:12:56.619+01:00",
+        "nodes": [
+            {
+                "id": "node-2013-05-08-72c911bafdf9932c-0001",
+                "title": "Une femme mène l'enquête",
+                "description": "La caméra suit la femme qui marche\nJeu avec la caméra qui se substitue au spectateur",
+                "uri": "http://ldt.iri.centrepompidou.fr/ldtplatform/ldt/front/player/lyceehulst_3extraits/c8a61ee4-b33c-11e2-802c-00145ea4a2be#id=s_DCA8D184-EFC2-314B-0F6B-84043E8F9984",
+                "style": { #optional
+                    "color": "#ff7f00", #line color, optional (null)
+                    "thickness": 1, #thickness of the line, optional (1)
+                    "dash": false, #dashed line, optional (false)
+                },
+                "position": {
+                    "x": -547.0499881440252,
+                    "y": -221.5401229374163
+                },
+                "image": "http://ldt.iri.centrepompidou.fr/static/site/ldt/css/imgs/video_sequence.png",
+                "size": 0,
+                "project_id": "f4d002b7-d4fd-486c-8898-6c6ceebc3354",
+                "created_by": "de68xf75y6hs5rgjhgghxbm217xk",
+                "type": "...",
+                "hidden": false,
+                "shape": "circle",
+            },
+            ...
+        ],
+        "edges": [
+            {
+                "id": "edge-2013-05-08-72c911bafdf9932c-0002",
+                "title": "",
+                "description": "",
+                "uri": "",
+                "style": { #optional
+                    "color": "#ff7f00", #line color, optional (null)
+                    "thickness": 1, #thickness of the line, optional (1)
+                    "dash": false, #dashed line, optional (false)
+                    "arrow": true,  #draw the arrow, optional (true)
+                },
+                "from": "node-2013-04-30-a81adec6694db5f4-0032",
+                "to": "node-2013-05-08-72c911bafdf9932c-0001",
+                "project_id": "f4d002b7-d4fd-486c-8898-6c6ceebc3354",
+                "created_by": "de68xf75y6hs5rgjhgghxbm217xk"
+            },
+            ...
+        ],
+        "users": [ #optional
+            {
+                "userId": "user-2015-05-05-72c911bafdf9932c-0001",
+                "color": "#cc9866",
+                "username": "user1",
+                "anonymous": true
+            },
+        ...
+        ],
+        "space_id": "17f968e4-2640-4319-aa61-b5b8b527ebb4", #Optional
+        "views": [ #Optional
+            {
+                "zoom_level": 0.8275032552816195,
+                "offset_x": 832.0104075533723,
+                "offset_y": 402.8917139487223
+            }
+        ]
+    }
+
+Système de chutier
+==================
+
+Renkan propose un système de "chutier". C'est un système de liste d'élément ouvert à gauche d'un renkan en édition.
+
+On le voit à gauche sur l'image suivante :
+
+.. image:: _static/img/renkan/renkan_edition.png
+
+Ce système permet d'ajouter rapidement des resources fiches ou tag par "glisser/déposer".
+Techniquement, ces fonctionalités de chutiers propres à HDALab sont définies dans le fichier `hdalab/static/hdalab/js/hdalab-renkan-bins.js`.
+
+
+.. _renkan_boite_recherche_contenus:
+
+Boite de recherche de contenus
+------------------------------
+
+.. image:: _static/img/renkan/renkan_recherche_contenus.png
+
+
+Cette boite de recherche permet de lancer une requête sur 3 types de ressources:
+  - recherche de tag
+  - recherche de fiches
+  - recherche d'article wikipedia
+
+  +--------------------+----------------------------------------------------------+--------------------------------------+
+  | type               | url de requête                                           | Vue                                  |
+  +====================+==========================================================+======================================+
+  | tags               | http://hdalab.iri-research.org/hdalab/a/tagsearch?       | :func:`hdalab.views.ajax.tagsearch`  |
+  +--------------------+----------------------------------------------------------+--------------------------------------+
+  | fiches             | http://hdalab.iri-research.org/hdalab/hdabo/searchajax/? | :class:`hdabo.views.SearchDatasheet` |
+  +--------------------+----------------------------------------------------------+--------------------------------------+
+  | articles wikipedia | https://fr.wikipedia.org/w/api.php?action=query...       |                                      |
+  +--------------------+----------------------------------------------------------+--------------------------------------+
+
+Le resultat de la recherche est affiché dans un nouvel onglet listant les ressources.
+
+
+Boite de recherche sur les résultats
+------------------------------------
+
+.. image:: _static/img/renkan/renkan_recherche_resultats.png
+
+Cette boite de recherche permet de rechercher et de filtrer des résultats déjà présent dans les onglets. La recherche est uniquement locale et ne lance fait pas de requête http.
+
+
+Liste de ressource
+------------------
+
+.. image:: _static/img/renkan/renkan_bin_resources.png
+
+Cet onglet liste des ressources statiques qui peuvent être utiles à l'édition du renkan.
+
+
+Liste de ressource supplémentaire
+---------------------------------
+
+.. image:: _static/img/renkan/renkan_bin_plus_ressources.png
+
+Cet onglet liste des ressources "supplémentaires".
+Un renkan est souvent créé à partir du résultat d'une recherche sur la page de `recherche par facette <pages_recherche_facette>`.
+Pour éviter d'avoir trop de noeuds ressources, les 8 premiers résultats de la recherche sont utilisés dans le renkan et les 10 suivants sont utilisés dans ce chutier.
+(ce comportement est défini dans la méthode :func:`hdalab.views.profile.HdalabRenkanGetPut.get`).
+
+
+Sauvegarde des renkan
+=====================
+
+la sauvegarde des renkan est définie dans le fichier `hdalab/static/hdalab/js/renkan-manual-save.js`.
+La sauvegarde est déclenchée par une action de l'utilisateur.
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/source/taches.rst	Wed Apr 11 12:19:47 2018 +0200
@@ -0,0 +1,34 @@
+####################
+Taches Celery HDALab
+####################
+
+Ces tâches longues sont lancées de façon asynchrone par `Celery <http://www.celeryproject.org/>`_.
+
+Liste des tâches asynchrones:
+
+  - :ref:`taches-hdalab-tasks-capture_preview`
+  - :ref:`taches-djcelery_email_send_multiple`
+
+
+.. _taches-hdalab-tasks-capture_preview:
+
+hdalab.tasks.capture_preview
+----------------------------
+
+Crée un snapshot d'un renkan.
+La tache est un simple wrapper qui appelle :func:`hdalab.services.renkan_capture_preview`.
+
+.. autofunction:: hdalab.services.renkan_capture_preview
+  :noindex:
+
+.. _taches-djcelery_email_send_multiple:
+
+djcelery_email_send_multiple
+----------------------------
+
+Envoi asynchrone d'email.
+Cette tâche est fournie par la librairie `django-celery-email <https://github.com/pmclanahan/django-celery-email>`_.
+C'est un backend Django qui utilise une queue `Celery`_ pour envoyer les messages de façon asynchrone, libérant ainsi le thread de traitement de requête.
+
+
+

--- a/src/hdabo/management/commands/clean_tags.py	Thu Apr 12 01:27:16 2018 +0200
+++ b/src/hdabo/management/commands/clean_tags.py	Wed Apr 11 12:19:47 2018 +0200
@@ -1,8 +1,9 @@
 # -*- coding: utf-8 -*-
 '''
-Created on Jun 20, 2012
+Retire les tags orphelins et fusionne les tags dupliqués (la clef étant l'URI DBPedia).
 
-@author: ymh
+**Usage**: ``django-admin clean_tags [options]``
+
 '''
 from django.core.management.base import NoArgsCommand
 from django.core.management.color import no_style
@@ -17,7 +18,7 @@
 
 class Command(NoArgsCommand):
     '''
-    remove orphan tags and merge duplicates (the key is the dbpedia uri) 
+    remove orphan tags and merge duplicates (the key is the dbpedia uri)
     '''
 
 
@@ -29,7 +30,7 @@
         # merge duplicate tags
         cursor = connection.cursor()
         cursor.execute("select label, dbpedia_uri from hdabo_tag group by label,dbpedia_uri having count(label) > 1")
-        
+
         for label,_ in cursor:
             qs = Tag.objects.filter(label=label).annotate(num_ds=Count('datasheet')).order_by('-num_ds')
             ref_tag = None
@@ -43,14 +44,13 @@
                         print("changing tag %d to %d" %(ts.tag.id, ref_tag.id) )
                         ts.tag = ref_tag
                         ts.save()
-        
+
         # remove ophans tags
-        
+
         orphans_tags = Tag.objects.annotate(num_ds=Count('datasheet')).filter(num_ds=0)
-        
+
         print("nb Orphans : %d" % orphans_tags.count())
-                
+
         #delete
         orphans_tags.delete()
 
-        
\ No newline at end of file

--- a/src/hdabo/management/commands/diff_csv.py	Thu Apr 12 01:27:16 2018 +0200
+++ b/src/hdabo/management/commands/diff_csv.py	Wed Apr 11 12:19:47 2018 +0200
@@ -1,8 +1,17 @@
 # -*- coding: utf-8 -*-
 '''
-Created on May 25, 2011
+Permet d'afficher (et optionellement d'effacer) les fiches se trouvant dans la base de données et pas dans le fichiers CSV.
+
+**Usage**: ``django-admin diff_csv [options] <path_to_csv_file path_to_csv_file ...>``
+
+**Options spécifiques:**
 
-@author: ymh
+    - *\-\-encoding=ENCODING* : encodage des fichiers CSV (défaut ``latin-1``)
+    - *\-\-delimiter=DELIMITER* : Séparateur des fichiers CSV
+    - *\-\-dialect=DIALECT* : Dialecte fichier CSV (c.f. `Dialectes Python CSV <https://docs.python.org/2/library/csv.html#csv-fmt-params>`_)
+    - *\-\-fieldnames=FIELDNAMES* : liste des noms de champ à traiter (séparateur : ``,``)
+    - *\-\-do\-delete* : efface les fiches se trouvant dans la base mais pas dans le fichier CSV.
+
 '''
 #Auteur,Chemin,Comment,Controle,Datcre,Datmaj,Desc,Domaine,Format,ID,Insee,Org,Org_Home,OrgID,Periode1,Periode2,Periode3,Satut,Sousdom,Tag,Theme2,Theme3,Titre,Url,Vignette,Ville
 #"Auteur","Chemin","Comment","Controle","Datcre","Datmaj","Desc","Domaine","Format","ID","Insee","Org","Org_Home","OrgID","Periode1","Periode2","Periode3","Satut","Sousdom","Tag","Theme2","Theme3","Titre","Url","Vignette","Ville",
@@ -17,11 +26,11 @@
 
 class Command(BaseCommand):
     '''
-    Command to diff datasheets content from csv content 
+    Command to diff datasheets content from csv content
     '''
     args = '<path_to_csv_file path_to_csv_file ...>'
     options = '[--do-delete] [--encoding] [--delimiter] [--dialect]'
-    help = """Import of a csv file for hdabo
+    help = """Command to diff datasheets content from csv content
 Options:
     --do-delete : ignore existing datasheets
     --encoding : files encoding. default to latin-1
@@ -29,7 +38,7 @@
     --dialect : csv dialect
     --fieldnames : csv columns
     """
-    
+
     option_list = BaseCommand.option_list + (
         make_option('--encoding',
             action='store',
@@ -60,30 +69,30 @@
             dest='do_delete',
             default=False,
             help='delete datasheets'),
-        
+
         )
-    
+
     def show_progress(self, current_line, total_line, width):
 
         percent = (float(current_line) / float(total_line)) * 100.0
 
         marks = math.floor(width * (percent / 100.0))
         spaces = math.floor(width - marks)
-    
+
         loader = '[' + ('=' * int(marks)) + (' ' * int(spaces)) + ']'
-    
+
         sys.stdout.write("%s %d%% %d/%d\r" % (loader, percent, current_line - 1, total_line - 1)) #takes the header into account
         if percent >= 100:
             sys.stdout.write("\n")
         sys.stdout.flush()
 
-            
+
 
     def handle(self, *args, **options):
-        
+
         if len(args) == 0:
             raise CommandError("Gives at lat one csv file to import")
-        
+
         self.encoding = options.get('encoding', "latin-1")
         self.do_delete = options.get('do_delete', False)
         fieldnames = options.get('fieldnames', None)
@@ -91,30 +100,30 @@
         for csv_path in args:
             print "Processing %s " % (csv_path)
             with open(csv_path, 'rU') as csv_file:
-                
+
                 # get the number of lines if necessary
                 for i, l in enumerate(csv_file): #@UnusedVariable
-                    pass                        
+                    pass
                 total_line = i + 1
                 if fieldnames:
                     total_line = total_line + 1
                 csv_file.seek(0)
-                
+
                 delimiter = options.get('delimiter', ";")
                 if delimiter == "TAB" or delimiter == "\\t":
                     delimiter = '\t'
-    
+
                 dr_kwargs = {'delimiter':delimiter}
                 if  fieldnames is not None:
                     dr_kwargs['fieldnames'] = [f.strip() for f in fieldnames.split(",")]
                 dialect = options.get('dialect', "excel")
                 if dialect is not None:
                     dr_kwargs['dialect'] = dialect
-                   
+
                 reader = csv.DictReader(csv_file, **dr_kwargs)
-                
+
                 ids = []
-    
+
                 for row in reader:
                     line_num = reader.line_num if fieldnames is None else reader.line_num + 1
                     self.show_progress(line_num, total_line, 60)
@@ -123,24 +132,24 @@
                             return val.decode(encoding)
                         else:
                             return val
-                                                
+
                     row = dict([(safe_decode(key, self.encoding), safe_decode(value, self.encoding)) for key, value in row.items()])
-                    
+
                     ids.append(row['ID'])
-                
+
                 qs = Datasheet.objects.exclude(hda_id__in = ids).order_by("hda_id")
-                
+
                 qs_count = qs.count()
-                
+
                 if qs_count == 0:
                     print("No datasheet to delete : exit")
                     return
-                    
+
                 print("The following datasheets are in the database and not in the csv file")
                 for i,ds in enumerate(qs):
                     print("%*d- %4s : %s" % (len(str(qs_count+1)), i+1, ds.hda_id, ds.title.strip() if ds.title is not None else ""))
-                    
-                
+
+
                 if self.do_delete:
                     print("deleting datasheets")
                     qs.delete()

--- a/src/hdabo/management/commands/import_csv.py	Thu Apr 12 01:27:16 2018 +0200
+++ b/src/hdabo/management/commands/import_csv.py	Wed Apr 11 12:19:47 2018 +0200
@@ -1,8 +1,19 @@
 # -*- coding: utf-8 -*-
 '''
-Created on May 25, 2011
+Importe un (ou pusieurs) fichiers CSV issus d'un export de la base HDA.
+Cette commande se contente d'importer les données contenues dans les fichiers CSV.
+
+**Usage**: ``django-admin import_csv [options] <path_to_csv_file path_to_csv_file ...>``
+
+**Options spécifiques:**
 
-@author: ymh
+    - *\-\-encoding=ENCODING* : encodage des fichiers CSV (défaut ``latin-1``)
+    - *\-\-delimiter=DELIMITER* : Séparateur des fichiers CSV
+    - *\-\-dialect=DIALECT* : Dialecte fichier CSV (c.f. `Dialectes Python CSV <https://docs.python.org/2/library/csv.html#csv-fmt-params>`_)
+    - *\-\-fieldnames=FIELDNAMES* : liste des noms de champ à traiter (séparateur : ``,``)
+    - *\-\-lines=LINES* : Nombre de ligne de ficheirs CSV à lire ( 0 : toutes, défaut 0)
+    - *\-\-ignore-existing* : écrase les fiches qui existent déjà dans la base
+
 '''
 #Auteur,Chemin,Comment,Controle,Datcre,Datmaj,Desc,Domaine,Format,ID,Insee,Org,Org_Home,OrgID,Periode1,Periode2,Periode3,Satut,Sousdom,Tag,Theme2,Theme3,Titre,Url,Vignette,Ville
 #"Auteur","Chemin","Comment","Controle","Datcre","Datmaj","Desc","Domaine","Format","ID","Insee","Org","Org_Home","OrgID","Periode1","Periode2","Periode3","Satut","Sousdom","Tag","Theme2","Theme3","Titre","Url","Vignette","Ville",
@@ -29,7 +40,7 @@
     --ignore-existing : ignore existing datasheets
     --lines : max number of lines to load (for each file). 0 means all.
     --encoding : files encoding. default to latin-1"""
-    
+
     option_list = BaseCommand.option_list + (
         make_option('--encoding',
             action='store',
@@ -66,24 +77,24 @@
             dest='ignore_existing',
             default=False,
             help='force insertion'),
-        
+
         )
-    
+
     def show_progress(self, current_line, total_line, width):
 
         percent = (float(current_line) / float(total_line)) * 100.0
 
         marks = math.floor(width * (percent / 100.0))
         spaces = math.floor(width - marks)
-    
+
         loader = '[' + ('=' * int(marks)) + (' ' * int(spaces)) + ']'
-    
+
         sys.stdout.write("%s %d%% %d/%d\r" % (loader, percent, current_line - 1, total_line - 1)) #takes the header into account
         if percent >= 100:
             sys.stdout.write("\n")
         sys.stdout.flush()
 
-    
+
     def create_domain_period(self, row_value, klass, school_period):
         res_list = []
         if not row_value:
@@ -93,12 +104,12 @@
                 res_obj, created = klass.objects.get_or_create(label=label_str, school_period=school_period, defaults={"label":label_str, "school_period":school_period}) #@UnusedVariable
                 res_list.append(res_obj)
         return res_list
-    
+
     def create_datasheet(self, row):
-        
+
         if self.ignore_existing and Datasheet.objects.filter(hda_id=row[u"ID"]).count() > 0:
             return
-        
+
         author_str = row[u'Auteur']
         if author_str:
             author_array = author_str.split(" ")
@@ -111,12 +122,12 @@
             elif len(author_array) == 2:
                 firstname = author_array[0]
                 lastname = author_array[1]
-                
+
             author, created = Author.objects.get_or_create(hda_id=author_str, defaults={"firstname":firstname, "lastname":lastname}) #@UnusedVariable
         else:
             author = None
-        
-        org_str = row[u"Org"]    
+
+        org_str = row[u"Org"]
         if org_str:
             url_str = row[u'Org_Home']
             if url_str is not None:
@@ -124,36 +135,36 @@
             org, created = Organisation.objects.get_or_create(hda_id=org_str, defaults={"name":org_str, "website" : url_str}) #@UnusedVariable
         else:
             org = None
-            
+
         town_str = row[u"Ville"]
         if town_str:
             insee_str = row[u'Insee'].strip() if row[u'Insee'] else row[u'Insee']
             if len(insee_str) > 5:
-                insee_str = "" 
+                insee_str = ""
             loc, created = Location.objects.get_or_create(insee=insee_str, defaults={"name": town_str, "insee": insee_str}) #@UnusedVariable
         else:
             loc = None
-            
+
         format_str = row[u"Format"]
         if format_str:
             format, created = DocumentFormat.objects.get_or_create(label=format_str, defaults={"label": format_str}) #@UnusedVariable
         else:
             format = None
-        
+
         domains = self.create_domain_period(row[u"Domaine"], Domain, Domain.DOMAIN_PERIOD_DICT[u'Global'])
-                                        
+
         primary_periods = self.create_domain_period(row[u"Periode1"], TimePeriod, TimePeriod.TIME_PERIOD_DICT[u'Primaire'])
         college_periods = self.create_domain_period(row[u"Periode2"], TimePeriod, TimePeriod.TIME_PERIOD_DICT[u'Collège'])
         highschool_periods = self.create_domain_period(row[u"Periode3"], TimePeriod, TimePeriod.TIME_PERIOD_DICT[u'Lycée'])
-                    
+
         primary_themes = self.create_domain_period(row[u"Sousdom"], Domain, Domain.DOMAIN_PERIOD_DICT[u'Primaire'])
         college_themes = self.create_domain_period(row[u"Theme2"], Domain, Domain.DOMAIN_PERIOD_DICT[u'Collège'])
         highschool_themes = self.create_domain_period(row[u"Theme3"], Domain, Domain.DOMAIN_PERIOD_DICT[u'Lycée'])
-        
+
         url = row[u"Url"]
         if url is not None:
             url = url.strip()
-        
+
         datasheet = Datasheet.objects.create(
             hda_id=row[u"ID"],
             author=author,
@@ -165,11 +176,11 @@
             format=format,
             original_creation_date=datetime.datetime.strptime(row[u"Datcre"], "%d/%m/%Y").date(),
             original_modification_date=datetime.datetime.strptime(row[u"Datmaj"], "%d/%m/%Y").date(),
-            validated=False                                          
+            validated=False
         )
-        
+
         datasheet.save()
-        
+
         datasheet.set_domains(domains)
         datasheet.set_primary_periods(primary_periods)
         datasheet.set_college_periods(college_periods)
@@ -178,7 +189,7 @@
         datasheet.set_college_themes(college_themes)
         datasheet.set_highschool_themes(highschool_themes)
 
-        
+
         if row[u'Tag']:
             for i, tag in enumerate([t.strip() for t in row[u'Tag'].split(u";")]):
                 if len(tag) == 0:
@@ -190,20 +201,20 @@
                         tag_obj = t
                         if tag_obj.url_status != Tag.TAG_URL_STATUS_DICT['null_result']:
                             break
- 
+
                 if tag_obj is None:
                     tag_obj = Tag(label=tag_label, original_label=tag)
                     tag_obj.save()
 
                 tagged_ds = TaggedSheet(datasheet=datasheet, tag=tag_obj, original_order=i + 1, order=i + 1)
                 tagged_ds.save()
-        
+
 
     def handle(self, *args, **options):
-        
+
         if len(args) == 0:
             raise CommandError("Gives at lat one csv file to import")
-        
+
         self.encoding = options.get('encoding', "latin-1")
         lines = options.get('lines', 0)
         self.ignore_existing = options.get('ignore_existing', False)
@@ -218,18 +229,18 @@
                 try:
                     print "Processing %s " % (csv_path)
                     with open(csv_path, 'rU') as csv_file:
-                        
+
                         # get the number of lines if necessary
                         if not lines:
                             for i, l in enumerate(csv_file): #@UnusedVariable
-                                pass                        
+                                pass
                             total_line = i + 1
                             if fieldnames:
                                 total_line = total_line + 1
                             csv_file.seek(0)
                         else:
                             total_line = lines + 1
-                        
+
                         delimiter = options.get('delimiter', ";")
                         if delimiter == "TAB" or delimiter == "\\t":
                             delimiter = '\t'
@@ -240,9 +251,9 @@
                         dialect = options.get('dialect', "excel")
                         if dialect is not None:
                             dr_kwargs['dialect'] = dialect
-                           
+
                         reader = csv.DictReader(csv_file, **dr_kwargs)
-        
+
                         for j, row in enumerate(reader):
                             if lines and j >= lines:
                                 break
@@ -253,14 +264,14 @@
                                     return val.decode(encoding)
                                 else:
                                     return val
-                                                        
+
                             row = dict([(safe_decode(key, self.encoding), safe_decode(value, self.encoding)) for key, value in row.items()])
                             self.create_datasheet(row)
-                            
+
                             transaction.commit()
                 except Exception:
                     transaction.rollback()
-                    raise 
+                    raise
                 finally:
                     print('')
         finally:

--- a/src/hdabo/management/commands/import_rdf.py	Thu Apr 12 01:27:16 2018 +0200
+++ b/src/hdabo/management/commands/import_rdf.py	Wed Apr 11 12:19:47 2018 +0200
@@ -1,10 +1,29 @@
 # -*- coding: utf-8 -*-
 '''
-Created on May 25, 2011
+Importe un fichiers RDF issus d'un export de la base HDA.
+Cette commande remplace le contenu de la base existante.
 
-- after `import_rdf` call commands `import_hdabo_db -c` then `rebuild_index`
+La liste des types d'objets importés est la suivante :
+    - `Categorie`,
+    - `Tag`,
+    - `Site`,
+    - `Ville`,
+    - `Institution`,
+    - `Theme`,
+    - `Domaine`,
+    - `SousDomaine`,
+    - `Periode`,
+    - `Notice`
 
-@author: ymh
+A noter que cette commande est actuellement utilisée pour transférer le contenu de la base de donnée du site HDA vers HDALab. les commandes suivantes sont ensuite lancée:
+    #. :class:`import_hdabo_db -c <hdalab.management.commands.import_hdabo_db>`
+    #. `rebuild_index <http://django-haystack.readthedocs.io/en/master/management_commands.html#rebuild-index>`_
+
+**Usage**: ``django-admin import_rdf [options] <path_to_rdf_file>``
+
+**Options spécifiques:**
+
+    - *\-t, \-\-type=TYPE* : type d'objet à importer. Cette option peut être ajoutée plusieurs fois.
 '''
 
 import base64
@@ -33,8 +52,8 @@
 logger = logging.getLogger(__name__)
 
 RDF_EXT_MAP = {
-    '.xml': 'rdfxm',
-    '.rdf': 'rdfxm',
+    '.xml': 'rdfxml',
+    '.rdf': 'rdfxml',
     '.ttl': 'turtle',
     '.nt': 'ntriples'
 }
@@ -804,7 +823,7 @@
 
 class Command(BaseCommand):
     '''
-    Command to import csvfile
+    Command to import rdf file
     '''
     args = '<path_to_rdf_file>'
     options = '[--type TYPE]'
@@ -835,7 +854,7 @@
         self.types_list = options.get('types', TYPES_LIST) or TYPES_LIST
 
         if any([t not in TYPES_LIST for t in self.types_list]):
-            raise CommandError("Types is %r : all types mus be in %r" % (self.types_list, TYPES_LIST))
+            raise CommandError("Types is %r : all types must be in %r" % (self.types_list, TYPES_LIST))
 
         with transaction.atomic():
             connection = connections[DEFAULT_DB_ALIAS]

--- a/src/hdabo/management/commands/import_tag_popularity.py	Thu Apr 12 01:27:16 2018 +0200
+++ b/src/hdabo/management/commands/import_tag_popularity.py	Wed Apr 11 12:19:47 2018 +0200
@@ -1,10 +1,18 @@
 # -*- coding: utf-8 -*-
 '''
-Created on Jun 17, 2011
+Importe les informations de popularité des tags. (c.f. champ `popularity` de l'objet :class:`hdabo.models.Tag`.).
+
+**Usage**: ``django-admin import_tag_popularity [options] <path_to_csv_file path_to_csv_file ...>``
+
+**Options spécifiques:**
 
-@author: ymh
-
-command to import tag popularity
+    - *\-\-all* : Capture les miniatures pours tous les renkan publié. Remplace les miniatures existantes.
+    - *\-\-encoding=ENCODING* : encodage des fichiers CSV (défaut ``latin-1``)
+    - *\-\-delimiter=DELIMITER* : Séparateur des fichiers CSV
+    - *\-\-dialect=DIALECT* : Dialecte fichier CSV (c.f. `Dialectes Python CSV <https://docs.python.org/2/library/csv.html#csv-fmt-params>`_)
+    - *\-\-fieldnames=FIELDNAMES* : liste des noms de champ à traiter (séparateur : ``,``)
+    - *\-\-lines=LINES* : Nombre de ligne de ficheirs CSV à lire ( 0 : toutes, défaut 0)
+    - *\-\-preserve* : Ne met pas à jour les informations de popularité existante.
 
 '''
 
@@ -19,7 +27,7 @@
 
 class Command(BaseCommand):
     '''
-    Command to import csvfile
+    Command to import tag popularity.
     '''
     args = '<path_to_csv_file path_to_csv_file ...>'
     options = '[--ignore-existing] [--lines] [--encoding]'
@@ -28,7 +36,7 @@
     --ignore-existing : ignore existing datasheets
     --lines : max number of lines to load (for each file). 0 means all.
     --encoding : files encoding. default to latin-1"""
-    
+
     option_list = BaseCommand.option_list + (
         make_option('--encoding',
             action='store',
@@ -65,44 +73,44 @@
             dest='preserve',
             default=False,
             help='preserve'),
-                                             
-        
+
+
         )
-    
+
     def show_progress(self, current_line, total_line, width):
 
         percent = (float(current_line) / float(total_line)) * 100.0
 
         marks = math.floor(width * (percent / 100.0))
         spaces = math.floor(width - marks)
-    
+
         loader = '[' + ('=' * int(marks)) + (' ' * int(spaces)) + ']'
-    
+
         sys.stdout.write("%s %d%% %d/%d\r" % (loader, percent, current_line - 1, total_line - 1)) #takes the header into account
         if percent >= 100:
             sys.stdout.write("\n")
         sys.stdout.flush()
 
     def handle(self, *args, **options):
-        
+
         if len(args) == 0:
             raise CommandError("Give one csv file to import")
         elif len(args) > 1:
             raise CommandError("Only one file can be imported")
-        
+
         self.encoding = options.get('encoding', "latin-1")
         lines = options.get('lines', 0)
         fieldnames = options.get('fieldnames', "label,popularity")
 
         csv_path = args[0]
-        
+
         print("Processing %s " % (csv_path))
-        
+
         with open(csv_path, 'rU') as csv_file:
             # get the number of lines if necessary
             if not lines:
                 for i, l in enumerate(csv_file): #@UnusedVariable
-                    pass                        
+                    pass
                 total_line = i + 1
                 if fieldnames:
                     total_line = total_line + 1
@@ -119,10 +127,10 @@
             dialect = options.get('dialect', "excel")
             if dialect is not None:
                 dr_kwargs['dialect'] = dialect
-               
+
             if not options.get('preserve',False):
                 Tag.objects.update(popularity=0)
-                
+
             reader = csv.DictReader(csv_file, **dr_kwargs)
 
             for j, row in enumerate(reader):
@@ -135,16 +143,16 @@
                         return val.decode(encoding)
                     else:
                         return val
-                                            
+
                 row = dict([(safe_decode(key, self.encoding), safe_decode(value, self.encoding)) for key, value in row.items()])
-                
+
                 label = normalize(row['label'].strip())
                 popularity_str = row['popularity']
-                
+
                 if not label or not popularity_str:
                     continue
-                
-                
+
+
                 for tag in Tag.objects.filter(normalized_label=label):
                     tag.popularity = tag.popularity + int(row['popularity'])
                     tag.save()