Documentation: update user doc

6 files changed, 171 insertions, 0 deletions

diff --git a/docs/fr/source/_static/ishtar-coins.png b/docs/fr/source/_static/ishtar-coins.png
new file mode 100644
index 000000000..fcf903f0b
--- /dev/null
+++ b/docs/fr/source/_static/ishtar-coins.png
diff --git a/docs/fr/source/_static/ishtar-dublincore.png b/docs/fr/source/_static/ishtar-dublincore.png
new file mode 100644
index 000000000..6407e2749
--- /dev/null
+++ b/docs/fr/source/_static/ishtar-dublincore.png
diff --git a/docs/fr/source/annexe-4-doc-normes.rst b/docs/fr/source/annexe-4-doc-normes.rst
new file mode 100644
index 000000000..97b83dcb9
--- /dev/null
+++ b/docs/fr/source/annexe-4-doc-normes.rst
@@ -0,0 +1,34 @@
+.. -*- coding: utf-8 -*-
+
+==================================================================
+Annexe 4 - Correspondance des champs Ishtar - Normes documentaires
+==================================================================
+
+:Auteur: Étienne Loks
+:Date: 2020-05-27
+:Copyright: CC-BY 3.0
+
+----------------------------------
+
+Ishtar - Dublin Core
+--------------------
+
+Issu d'un consensus international et multidisciplinaire, le
+`Dublin Core <https://fr.wikipedia.org/wiki/Dublin_Core>`_ a été
+développé pour décrire des documents de manière simple et standardisée.
+
+.. figure:: _static/ishtar-dublincore.png
+	:align: center
+
+Ishtar - COinS
+--------------
+
+Le `ContextObjects in Spans (COinS) <https://fr.wikipedia.org/wiki/ContextObjects_in_Spans>`_ est une
+méthode pour inclure des métadonnées bibliographiques dans le code HTML de
+pages web.
+
+L’utilisation de COinS permet à un logiciel de gestion bibliographique de
+récupérer les méta-données de l’ouvrage de référence.
+
+.. figure:: _static/ishtar-coins.png
+	:align: center
diff --git a/docs/fr/source/index.rst b/docs/fr/source/index.rst
index 73ec3bed5..8940b595d 100644
--- a/docs/fr/source/index.rst
+++ b/docs/fr/source/index.rst
@@ -18,5 +18,6 @@ Contents:
    annexe-1-rattachement
    annexe-2-permission-action
    annexe-3-ex-flux-ope
+   annexe-4-doc-normes
    annexe-tech-1-insee-communes
    annexe-tech-2-ign-communes
diff --git a/docs/fr/source/media-src/ishtar-coins.dot b/docs/fr/source/media-src/ishtar-coins.dot
new file mode 100644
index 000000000..8d41cc766
--- /dev/null
+++ b/docs/fr/source/media-src/ishtar-coins.dot
@@ -0,0 +1,65 @@
+digraph ishtar_dc {
+
+    rankdir="LR";
+    graph [fontname="cantarell" splines=false];
+    node [shape=box fontname="liberationsansnarrow" style="rounded"
+          color="#A4A4A4" fontcolor="#333333" margin="0.2,0.2"];
+    edge [fontname="cantarell" color="#432776"];
+
+    COINS_LANGUAGE [label="Langue (rtf.language)"];
+    COINS_RIGHTS [label="Droits (rtf.rights)"];
+    COINS_ISBN [label="ISBN (rtf.isbn)"];
+    COINS_ISSN [label="ISBN (rtf.issn)"];
+    COINS_SOURCE [label="Source (rtf.source)"];
+    COINS_DATE [label="Date (rtf.date)"];
+    COINS_PUBLISHER [label="Éditeur (rtf.publisher)"];
+    COINS_DESCRIPTION [label="Description (rtf.description)"];
+    COINS_GENRE [label="Genre (rft.genre)"];
+    COINS_TYPE [label="Type (rft.type)"];
+    COINS_AU [label="Auteur (rft.au)"];
+    COINS_TITLE [label="Titre (rft.title)"];
+
+    COinS [label="COinS" fontcolor="#ffffff" shape="folder"
+           color="#432776" fillcolor="#432776" style="filled"];
+
+    I_Rights [label="Droits/licences"];
+    I_Source1 [label="Source - Document parent"];
+    I_Source2 [label="Source - Saisie libre"];
+    I_ISBN [label="ISBN"];
+    I_ISSN [label="ISSN"];
+    I_Language [label="Langue"];
+
+    I_Date [label="Date"];
+    I_Publisher [label="Éditeur"];
+    I_Description [label="Description"];
+    I_Type [label="Type"];
+    I_Author [label="Auteurs"];
+    I_Title [label="Titre"];
+
+    Ishtar [label="Ishtar" fontcolor="#ffffff" shape="folder"
+            color="#432776" fillcolor="#432776" style="filled"];
+
+    Ishtar -> COinS [style=invis];
+    I_Title -> COINS_TITLE;
+    I_Author -> COINS_AU;
+    I_Type -> COINS_TYPE;
+    I_Type -> COINS_GENRE;
+    I_Description -> COINS_DESCRIPTION;
+    I_Publisher -> COINS_PUBLISHER;
+    I_Date -> COINS_DATE;
+    I_ISBN -> COINS_ISBN;
+    I_ISSN -> COINS_ISSN;
+    I_Source1 -> COINS_SOURCE;
+    I_Source2 -> COINS_SOURCE;
+    I_Rights -> COINS_RIGHTS;
+    I_Language -> COINS_LANGUAGE;
+
+
+    { rank = same; Ishtar; I_Title; I_Author;  I_Description }
+    { rank = same; COinS;
+      COINS_PUBLISHER ; COINS_DATE ;
+      COINS_AU ;
+      COINS_TYPE ; COINS_GENRE
+    }
+ ;
+}
diff --git a/docs/fr/source/media-src/ishtar-dublincore.dot b/docs/fr/source/media-src/ishtar-dublincore.dot
new file mode 100644
index 000000000..fa37b73b6
--- /dev/null
+++ b/docs/fr/source/media-src/ishtar-dublincore.dot
@@ -0,0 +1,71 @@
+digraph ishtar_dc {
+
+    rankdir="LR";
+    graph [fontname="cantarell" splines=false];
+    node [shape=box fontname="liberationsansnarrow" style="rounded"
+    color="#A4A4A4" fontcolor="#333333" margin="0.2,0.2"];
+    edge [fontname="cantarell" color="#432776"];
+
+    DC_Coverage [label="Couverture (Coverage)"];
+    DC_Relation [label="Relation"];
+    DC_Rights [label="Gestion des droits (Rights)"];
+    DC_Language [label="Langue (Language)"];
+    DC_Source [label="Source"];
+
+    DC_Identifier [label="Identifiant (Identifier)"];
+    DC_Format [label="Format"];
+    DC_Type [label="Type"];
+    DC_Date [label="Date"];
+    DC_Contributor [label="Contributeur (Contributor)"];
+    DC_Publisher [label="Éditeur (Publisher)"];
+    DC_Description [label="Description"];
+    DC_Subject [label="Sujet (Subject)"];
+    DC_Creator [label="Créateur (Creator)"];
+    DC_Title [label="Titre (Title)"];
+
+    DublinCore [label="Dublin Core" fontcolor="#ffffff" shape="folder"
+                color="#432776" fillcolor="#432776" style="filled"];
+
+    I_Rights [label="Droits/licences"];
+    I_Source1 [label="Source - Document parent"];
+    I_Source2 [label="Source - Saisie libre"];
+    I_ISBN [label="ISBN"];
+    I_ISSN [label="ISSN"];
+    I_Language [label="Langue"];
+    I_URL [label="Url"];
+    I_URL_Ishtar [label="Url Ishtar"];
+    I_Format [label="Format"];
+    I_Type [label="Type"];
+    I_Date [label="Date"];
+    I_Publisher [label="Éditeur"];
+    I_Description [label="Description"];
+    I_Tags [label="Étiquettes"];
+    I_Author [label="Auteurs"];
+    I_Title [label="Titre"];
+    
+    Ishtar [label="Ishtar" fontcolor="#ffffff" shape="folder"
+            color="#432776" fillcolor="#432776" style="filled"];
+
+    Ishtar -> DublinCore [style=invis];
+    I_Title -> DC_Title;
+    I_Author -> DC_Creator;
+    I_Author -> DC_Contributor;
+    I_Tags -> DC_Subject;
+    I_Description -> DC_Description;
+    I_Publisher -> DC_Publisher;
+    I_Date -> DC_Date;
+    I_Type -> DC_Type;
+    I_Format -> DC_Format;
+    I_URL_Ishtar -> DC_Identifier;
+    I_URL -> DC_Identifier;
+    I_ISBN -> DC_Identifier;
+    I_ISSN -> DC_Identifier;
+    I_Source1 -> DC_Source;
+    I_Source2 -> DC_Source;
+    I_Rights -> DC_Rights;
+    I_Language -> DC_Language;
+
+    { rank = same; Ishtar; I_Title; I_Author; I_Tags; I_Description }
+    { rank = same; DublinCore; DC_Publisher ; DC_Contributor ; DC_Date ; DC_Type ; DC_Format ; DC_Identifier ; DC_Source ; DC_Language ; DC_Relation ; DC_Coverage ; DC_Rights ; }
+ ;
+}