Update the user guide.

controllers/wizards.py

@@ -21,7 +21,7 @@ from plugin_dbui import (CALLBACK_ERRORS,
 
 MODE_DRY_RUN = T(DRY_RUN)
 MSG_NO_AUTHORS = "<br><br>Removing affiliation failed.<br>"\
-    "Use INSPIRES instead with the tool 'insert MARCXML'"
+    "Use INSPIRES instead with the tool 'insert RECJSON'"
 
 MSG_EXISTING_KEY = "Keys already exist!"
 MSG_NO_AFFILIATION = "Affiliation is not defined for the selected author."

docs/user/csv/marc_json.csv

+field,subfield
+FIXME_OAI (inspire),id
+abstract,
+accelerator_experiment,
+agency_code (cds),
+authors,INSPIRE_number
+,affiliation
+,control_number
+,first_name
+,full_name
+,last_name
+,relator_name (phd director)
+base (cds),
+collection,
+comment,
+copyright_status (cds),
+corporate_name,collaboration
+creation_date,
+dissertation_note,defense_date
+,diploma
+,university
+doi,
+email_message (cds),
+filenames,
+files,comment
+,description
+,eformat
+,full_name
+,full_path
+,magic
+,name
+,path
+,size
+,status
+,subformat
+,superformat
+,type
+,url
+,version
+filetypes,
+imprint,
+keywords,
+language (cds),
+license,
+meeting_name,closing_date (cds)
+,coference_code
+,country
+,date
+,location
+,opening_date (cds)
+,year
+number_of_authors,
+number_of_citations,
+number_of_comments,
+number_of_reviews,
+oai (cds),value
+other_report_number (cds),
+persistent_identifiers_keys,
+physical_description,
+prepublication,date
+,publisher_name
+,place
+primary_report_number,
+publication_info,pagination
+,title
+,volume
+,year
+recid,
+reference (inspire),
+report_number (cds),internal
+,report_number
+source_of_acquisition (inspire),
+status_week (cds),
+subject,
+system_control_number,institute
+,value
+,canceled
+thesaurus_terms,
+title, title
+title_additional (inspire),
+url (cds),description
+,url
+version_id,

docs/user/harvesters.rst

@@ -27,7 +27,7 @@ pour un projet (collaboration), pour une année.
 
 Dans la pratique cette requête est transmise à l'entrepôt en utilisant le
 protocole HTTP_. L'entrepôt retourne l'ensemble des notices correspondant
-à la requête au format XML_.
+à la requête au format JSON_.
 
     .. _fig-harvester:
 
@@ -286,38 +286,54 @@ Démarrer l'action :
 Remplir les champs du *selector*, montrés sur la
 :numref:`fig-selector-edit-insert` et appuyer sur le bouton ``Go``.
 
-Insérer MARCXML
+Insérer RECJSON
 ^^^^^^^^^^^^^^^
 Certains enregistrements sont protégés par un mot de passe. Pour des utilisateurs
 ayant les droits d'accès, il est possible d'insérer des enregistrements dans
 la base de données en utilisant l'action :
 
     .. index::
-        pair: Assistants; insérer MARCXML
+        pair: Assistants; insérer RECJSON
 
     .. line-block::
 
-        ``Assistants > insérer MARCXML``
+        ``Assistants > insérer RECJSON``
 
-    .. _fig-selector-marcxml:
+    .. _fig-selector-recjson:
 
-    .. figure:: images/selector-marcxml.png
+    .. figure:: images/selector-recjson.png
        :align: center
        :width: 40%
 
-       Le *selector* de l'action *insérer MARCXML*.
+       Le *selector* de l'action *insérer RECJSON*.
 
-Le *selector*, montré sur la :numref:`fig-selector-marcxml`, apparaît.
-Il faut remplir tous les champs, notament le champ MARXML.
-Cette procédure est un peu fastidieuse mais simple avec les raccourcis clavier
-de firefox_ :
+Le *selector*, montré sur la :numref:`fig-selector-recjson`, apparaît.
+Il faut remplir tous les champs, notament le champ RECJSON.
+Cette procédure est un peu fastidieuse mais simple :
 
-    * Ouvrir la notice de la publication dans l'entrepôt, puis cliquer
-      sur l'hyperlien MARCXML, en bas à droite.
-    * Accéder aux sources de la page résultante (CTRL-U) et la copier dans le
-      presse-papier (CTRL-A puis CTLR-C)
-    * Dans le *selector* de l'action *insérer MARCXML* cliquer sur le champ
-      ``MARCXML`` et copier le contenu du presse-papier (CTLR-V)
+    * Dans firefox_, visualiser la publication format ``RECJSON``,
+      en tapant l'hyperlien::
+
+            http://xxx/record/yyy?of=recjson
+
+      dans lequel ``xxx`` est l'adresse de l'entrepôt et ``yyy`` l'identifiant
+      numérique de la publication.
+
+            .. _fig-notice-recjson:
+
+            .. figure:: images/notice-recjson.png
+               :align: center
+               :width: 100%
+
+               Un example d'une notice au format ``RECJSON`` decodé par firefox_.
+
+      Une publication au format ``RECJSON`` est montrée sur la
+      :numref:`fig-notice-recjson` pour l'enregistrement 2270937
+      de ``cds.cern.ch``.
+
+    * Copier la notice dans votre presse-papier en appuyant sur le bouton ``Copy``.
+    * Dans le *selector* de l'action *insérer RECJSON* cliquer sur le champ
+      ``RECJSON`` et copier le contenu du presse-papier (CTLR-V)
     * Remplir les autres champs du *selector*
     * Appuyer sur le bouton ``Go``
 
@@ -444,14 +460,14 @@ Les arcanes du format MARC
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
     .. index::
-        pair: Format; MARC12
+        pair: Format; MARC
 
 Les enregistrements retournés par un entrepôt sont au format MARC_ qui est
 un standard pour décrire des données bibliographique.
-Dans ce standard, les données sont structurées à travers un jeu de clé
-constitué d'un nombre et d'une lettre.
+Dans ce standard, les données sont structurées à travers un jeu de clé et de
+valeurs. Elles peuvent être encodées au format XML_ ou JSON_.
 
-Pour explorer une notice d'un entrepôt dans ce format, il suffit d'aller en
+Pour explorer une notice d'un entrepôt au format XML_, il suffit d'aller en
 bas de la page HTML et de cliquer sur un des hyperliens ``Exporter vers MARC``
 ou ``Exporter vers MARCXML``.
 
@@ -463,5 +479,19 @@ Par exemple :
     * les clés ``773c``, ``773p``, ``773v`` et ``773y`` correspondent
       aux références bibliographiques d'un article publié.
 
+Pour explorer une notice d'un entrepôt au format JSON_, il suffit de taper
+dans un navigateur web l'hyperlien suivant::
+
+            http://xxx/record/yyy?of=recjson
+
+dans lequel ``xxx`` est l'adresse de l'entrepôt et ``yyy`` l'identifiant
+numérique de la publication.
+
+Ce format est plus intuitif, par exemple :
+    * la clé ``authors`` contiens la liste de tous les auteurs avec
+      leurs affiliations.
+    * la clé ``publication_info`` contient les références bibliographiques
+      d'un article publié
+
     .. important::
-        Les :ref:`marc12_keys` sont donnés dans l'annexe.
+        Les :ref:`marc_keys` sont donnés dans l'annexe.

docs/user/hyperlinks.txt

@@ -17,6 +17,8 @@
 
 .. _ISO-4: http://www.issn.org/services/online-services/access-to-the-ltwa/
 
+.. _JSON: http://www.json.org/
+
 .. _LaTeX: http://www.latex-project.org/
 
 .. _LibreOffice: http://fr.libreoffice.org/

docs/user/index.rst

@@ -39,7 +39,7 @@ Annexe
     harvester_collection_cds
     harvester_collection_inspirehep
     harvester_collection_hal_hidden
-    marc12
+    marc
     schema
     dbfields
 

docs/user/marc.rst

+.. include:: hyperlinks.txt
+
+.. _marc_keys:
+
+Détails du format MARC
+----------------------
+
+Encodage XML
+^^^^^^^^^^^^
+The fields and subfields depends on the store and on the category of
+publication.
+
+    .. tabularcolumns:: p{6cm}p{3cm}p{3cm}
+
+    .. _tab-marcxml:
+
+    .. table:: Référence bibliographique au format MARCXML.
+
+        .. csv-table::
+           :file: csv/marc_xml.csv
+           :widths: 20, 10, 10
+
+
+Encodage JSON
+^^^^^^^^^^^^^
+The fields and subfields depends on the store and on the category of
+publication.
+
+    .. tabularcolumns:: p{6cm}p{3cm}
+
+    .. _tab-marcjson:
+
+    .. table:: Référence bibliographique au format RECJSON.
+
+        .. csv-table::
+           :file: csv/marc_json.csv
+           :widths: 20, 20

docs/user/marc12.rst

-.. include:: hyperlinks.txt
-
-.. _marc12_keys:
-
-Détails du format MARC12
-------------------------
-
-    .. tabularcolumns:: p{6cm}p{3cm}p{3cm}
-
-    .. _tab-marc:
-
-    .. table:: Référence bibliographique et format MARC.
-
-        .. csv-table::
-           :file: csv/marc.csv
-           :widths: 20, 10, 10

languages/fr-fr.py

@@ -319,7 +319,6 @@
 'Import/Export': 'Importer/Exporter',
 'In %s': 'En %s',
 'indéfini': 'indéfini',
-'insert MARCXML': 'insérer MARCXML',
 'insert new': 'insert new',
 'insert new %s': 'insert new %s',
 'insert RECJSON': 'insérer RECJSON',
@@ -387,7 +386,6 @@
 'Lost password?': 'Lost password?',
 'main authors': 'auteurs principaux',
 'Main layout': 'Main layout',
-'MARCXML': 'MARCXML',
 'Master field is not properly defined. Check this record.': "La valeur d'un champ est incorrecte. Vérifiez cet enregistrement.",
 'Message': 'Message',
 'Meta': 'Méta',