Docker-in-Docker (DinD) capabilities of public runners deactivated. More info

Commit 279a5a59 authored by LE GAC Renaud's avatar LE GAC Renaud
Browse files

Update the user guide.

parent 5668b350
......@@ -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."
......
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,
......@@ -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.
......@@ -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/images/harvester.png

50.4 KB | W: | H:

docs/user/images/harvester.png

111 KB | W: | H:

docs/user/images/harvester.png
docs/user/images/harvester.png
docs/user/images/harvester.png
docs/user/images/harvester.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -39,7 +39,7 @@ Annexe
harvester_collection_cds
harvester_collection_inspirehep
harvester_collection_hal_hidden
marc12
marc
schema
dbfields
......
.. 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
.. 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
......@@ -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',
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment