Tri des données pour le premier scénario de métadonnées (les articles de revue)

[RochDLY]

Ce ticket comporte les éléments nécessaires à la création d'un premier scénario de métadonnées pour la refonte de ce composant (tout ça doit être accessible depuis l'article Stylo).

Les métadonnées sont présentées comme suit : Nom courant (nom technique)(type)(obligatoire)

J'ai découpé les métadonnées en "groupes" pour plus de lisiblité et créé des objets pour éviter la redondances dans le ticket (par exemple, un traducteur ou un auteur appelle l'objet 'individu" qui contient les champs noms, prénoms, etc.).

---

Objet individu:

• Nom (surname)(str)
• Prénom (forename) (attention, actuellement la clé est forname, voir le ticket #1018)(str)
• ORCID (orcid)(str, exemple : '0000-0002-3519-4365')
• Biographie (biography)(str, plutôt long, entre 500 et 1000 signes)
• Affiliations (affiliations)(str, doit accepter plusieurs entrées, exemple : 'Université de Montréal' 'CRCEN' 'CRIHN')
• Email (email)(str)
• VIAL (viaf)(str)
• FOAF (foaf)(str)
• Wikidata (wikidata)(str)
• ISNI (isni)(str)

---

Groupe des personnes :

• Auteur.ice.s (authors)(individu)
• Traducteur.rice.s (translators)(individu)
• Directeur.ice.s de la revue (directors)(individu)
• Directeur.ice.s du dossier (issueDirectors)(individu)
• Réviseur.e.s (reviewers)(individu)
• Transcripteur.e.s (transcribers)(individu)

---

Groupe des données de l'article :

• Identifiant de l'article (id)(str)
• Titre de l'article (title_f)(str)(obligatoire)
• Titre traduit (translatedTitle:)
  • langue (lang)(select language)
  • titre (text_f)(str)
• Sous-titre de l'article (subtitle_f)(str)
• Date (date)(calendar)
• URL de l'article (url_article)(str)
• Nombre de pages de l'article (à calculer ?)
• Résumé (abstract:)
  • langue (lang)(select language)
  • texte (text_f)(str, plutôt un texte long entre 500 et 1000 caractères)
• Mot-clés contrôlés de l'article (controlledKeywords:)(select keywords)
  • idRameau: ''
  • label: ''
  • uriRameau: ''
• Mot-clés de l'article (keywords:)
  • langue (lang)(select language)
  • texte (list_f:)(list)
• Traduction de (translationOf:)
  • titre (title_f)(str)
  • url de l'original (url)(str)
  • langue (lang)(select lang)
• Licence (rights)(str) --> un menu déroulant ne serait-il pas plus adapté ?
• Langue (lang)(select lang)

*pour les articles de Sens Public, ajouter :

• Type de contenu: (typeArticle:) *ce sont des cases à cocher, on pourrait les mettre dans un menu déroulant elles aussi
  • [ ] Essai
  • [ ] Création
  • [ ] Lecture
  • [ ] Sommaire dossier
  • [ ] Entretien
  • [ ] Chronique

---

Groupe de données du dossier :

?(dossier:)

• Titre du numéro (title_f)(str)
• Identifiant du dossier (iddudossier)(str)
• Numéro du dossier (journal_issue)(str)

*On a pas ces données mais elles pourraient être utiles

• Titre traduit (translatedTitle:)
  • langue (lang)(select language)
  • titre (text_f)(str)
• Langue*
• Mot-clés contrôlés du numéro*
• Mot-clés du numéro*
  • langue*
  • texte*
• Nombre de pages du numéro*
• Sous-titre du numéro*

---

Groupe de données de la production :

• ISSN (issnnum)(str)
• Producteur (prod)(str)
• Prodnum (prodnum)(str)
• Diffnum (diffnum)(str)
• Funder (funder:)
  • Funder organisation (funder_name)(str)
  • Funder id (funder_id)(str)

---

• Les remerciements (acknowledgements)(str, plutôt long, ce n'est peut-être pas à mettre dans les métadonnées ?)

---

Groupe de données sur la revue :

• Nom de la revue (journal)(str)
• Éditeur (publisher)(str)
• URL de la revue* (à ajouter ?)

Questions

1. Dans le volet des métadonnées actuel il y a un mini gestionnaire de rendu des références bibliographiques avec les entrées citation link: yes or no et display : all citations or only used. Cette question est déjà référencée dans la #929 : ne devrait-ont pas déplacer ce paramétrage dans le gestionnaire de références bibliographiques plutôt que de le gestionnaire de métadonnées ? (en gros ce paramètre ajoute une clef nocite dans les métadonnées que Pandoc traite lors de la transformation, mais ce ne sont pas des données sur l'article; le deuxième paramètre ajout une clef link-citations pour la même raison)
2. Il y a plusieurs données qui font l'objet d'un *, ce sont soit des propositions d'ajout à discuter (et à vérifier si elles existent dans le schéma COMMONS, soit qu'elles ne concerne qu'une seule revue.

[maiwann]

Noms

Est-il nécessaire d'avoir 2 cases séparées pour les prénoms et noms ? Dans certaines cultures, la séparation n'est pas si nette : https://www.w3.org/International/questions/qa-personal-names.fr

Est-ce qu'avoir un champ unique ferait l'affaire ?

[maiwann]

Titres traduits

Dans la liste, il est indiqué :

• Titre de l'article (title_f)(str)(obligatoire)
• Titre traduit (translatedTitle:)
  • langue (lang)(select language)
  • titre (text_f)(str)

Est-ce qu'il serait pertinent de préciser la langue du "Titre de l'article" ? Et si oui, est-ce qu'une représentation pourrait être plutôt qu'il y a 1 ou plusieurs titres, avec à chaque fois associé à un titre une langue ?

Sous-titres

Les sous-titres doivent-ils être eux aussi associés à une langue ?

[maiwann]

Affiliations

Affiliations doit accepter plusieurs entrées, mais doivent-elles être dans des champs séparés ? (a priori je dirais non mais je préfère avoir confirmation)

[maiwann]

Mots-clés

Les mots clés sont ils associés à une langue ?

[RochDLY]

Noms

Est-il nécessaire d'avoir 2 cases séparées pour les prénoms et noms ? Dans certaines cultures, la séparation n'est pas si nette : https://www.w3.org/International/questions/qa-personal-names.fr

Est-ce qu'avoir un champ unique ferait l'affaire ?

À mon avis il est préférable de garder les deux séparés pour plusieurs raisons : 

• On utilise l'api d'isidore pour récupérer les données sur les auteurs (et isidore différencie les noms et les prénoms)
• selon les exports vers des revues, il peut être nécessaire de les séparer. C'est plus facile de concaténer nom et prénom ensemble plutôt que de les séparer.

[RochDLY]

Mots-clés

Les mots clés sont ils associés à une langue ?

Les mot-clés standards oui, on associe toujours les mot-clefs a une langue (on peut mettre plusieurs langues et plusieurs mot-clefs associés à chaque langue)

Les mot-clefs contrôlés sont alignés sur le vocabulaire RAMEAU, on a pas de sélecteur de langue dans Stylo parce que RAMEAU l'intègre directement dans son vocabulaire

[RochDLY]

Titres traduits

Dans la liste, il est indiqué :

• Titre de l'article (title_f)(str)(obligatoire)

• Titre traduit (translatedTitle:)

  • langue (lang)(select language)
  • titre (text_f)(str)

Est-ce qu'il serait pertinent de préciser la langue du "Titre de l'article" ? Et si oui, est-ce qu'une représentation pourrait être plutôt qu'il y a 1 ou plusieurs titres, avec à chaque fois associé à un titre une langue ?

Sous-titres

Les sous-titres doivent-ils être eux aussi associés à une langue ?

A priori je dirai que que la langue du titre de l'article est la même que la langue de l'article (cette info est déjà présente dans Stylo, je la rajoute dans le modèle au-dessus, j'ai dû la zapper)

[antoinentl]

Je me permets une précision à propos du titre en plusieurs langues : certaines revues ont besoin d'avoir le titre traduit dans plusieurs langues, comme c'est le cas pour les résumés. Donc oui il serait pertinent d'avoir une représentation avec plusieurs titres et la langue associée à chaque fois.

[ggrossetie]

Je me demande s'il ne serait pas intéressant de se donner la possibilité de revoir le nommage et la structure des métadonnées existantes. De ce que je comprends, il y aura de toute façon un travail "important" sur les templates.

Par exemple, pour les traductions on pourrait avoir structure comme suit :

{
  "title": {
    "default": "Titre principal du document",
    "translations": {
      "fr": "Titre en français",
      "en": "Title in English",
      "jp": "日本語のタイトル"
    }
  }
}

[RochDLY]

Ca me semble être une bonne idée, surtout si cela peut alléger un peu toute cette structure. Par contre est-ce que tu as une idée de comment gérer la rétrocompatibilité avec tous les articles existant ?

[ggrossetie]

Ca me semble être une bonne idée, surtout si cela peut alléger un peu toute cette structure. Par contre est-ce que tu as une idée de comment gérer la rétrocompatibilité avec tous les articles existant ?

Je pense qu'il faudra faire une migration du YAML existant vers la nouvelle structure :

title_f: "Titre principal du document"
translatedTitle:
  lang: "en"
  text_f: "Title in English"

{
  "title": {
    "default": "Titre principal du document",
    "translations": {
      "en": "Title in English"
    }
  }
}

Le nouveau composant des métadonnées s’appuiera sur cette nouvelle structure.

[ggrossetie]

Je pense que ça serait une bonne idée de clarifier la notion de title_f (formatted) et title. Est-ce qu'on distingue les champs texte (brute) des champs texte où on accepte de la syntaxe Markdown ? Est-ce qu'on supporte uniquement un sous-ensemble de la syntaxe Markdown ? Comment est-ce qu'on doit passer les informations au(x) template(s) ? Est-ce qu'il faut avoir une version texte brute (sans les balises Markdown) et une version avec les balisages ? est-ce qu'il faut fournir une version rendu du texte (au format HTML) ?

[marviro]

title_f envoie le texte tel quel il a été inséré par l'utilisateur (donc avec balises md s'il y en a). title envoie le texte brut après avoir retiré les balises - c'est la clé utilisée pour faire par ex les métadonnées en html dans la balise