Gestion des balises
Qu'est-ce que le vocabulaire de balises ?
Le vocabulaire de balises est un système de balisage standardisé utilisé pour l'annotation cohérente de la littérature. Contrairement aux balises libres natives de Zotero, les balises d'un vocabulaire contrôlé suivent des conventions de dénomination unifiées, ce qui facilite les statistiques et la recherche.
Facettes
Chaque balise appartient à une facette (dimension). Les facettes suivantes sont actuellement prises en charge :
| Facette | Description | Exemple |
|---|---|---|
field | Domaine de recherche | field:natural_language_processing |
topic | Sujet de recherche | topic:transformer_architecture |
method | Méthode de recherche | method:reinforcement_learning |
model | Modèle utilisé | model:gpt-4 |
ai_task | Type de tâche IA | ai_task:text_summarization |
data | Jeu de données | data:imagenet |
tool | Outil | tool:python |
status | Tâche de workflow en attente | status:need-analysis |
Format des balises : ^[a-z_]+:[a-zA-Z0-9/_.-]+$, maximum 120 caractères.
Onglet Vocabulaire
Dans la page Synthesis Workbench → Balises → Vocabulaire, vous pouvez :
- Voir : Toutes les balises canoniques définies, affichant l'état, la facette, les alias et le compteur d'utilisation
- Ajouter : Créer de nouvelles balises canoniques
- Modifier : Modifier les métadonnées des balises
- Déprécier : Marquer une balise comme dépréciée, en spécifiant éventuellement une balise de remplacement
- Importer JSON : Importer un vocabulaire de balises depuis un fichier JSON (supporte l'aperçu avant confirmation)
- Exporter JSON : Exporter le vocabulaire actuel vers un fichier JSON
Les cinq statuts de workflow intégrés sont initialisés au démarrage du plugin. Leur tag, facette, source, état de dépréciation et remplacement ne peuvent être modifiés ni supprimés ; les notes restent éditables et les alias continuent d'utiliser le chemin de gouvernance normal. Les entrées status:* personnalisées conservent les mêmes contrôles de gestion que les autres entrées personnalisées du vocabulaire. Les importations peuvent mettre à jour les notes et alias intégrés, mais l'omission d'un intégré ou la modification de son identité protégée ne peut ni le supprimer ni le remplacer.
États des balises :
active: Activedeprecated: Dépréciée (a une balise de remplacement)warning: Avertissement (peut nécessiter une révision)
Onglet Staged (balises en attente)
Le skill tag-regulator analyse automatiquement les métadonnées littéraires et génère des suggestions de balises contrôlées, affichées dans la page Staged.
Flux de travail d'approbation
- Consultez la liste des balises suggérées
- Pour chaque balise, vous pouvez :
- Promouvoir : Ajouter la balise au vocabulaire canonique
- Ignorer : Rejeter la suggestion
- Vider Staged : Ignorer toutes les suggestions en lot
Format d'import/export
Le vocabulaire de balises supporte l'import/export au format JSON (format TagVocab), permettant :
- La migration des systèmes de balises entre bibliothèques
- Le partage en équipe des conventions de balisage
- La sauvegarde et le contrôle de version
Workflow associé
status représente les tâches de workflow en attente, et non la progression de lecture. Un élément peut avoir zéro ou plusieurs statuts. Les cinq définitions intégrées :
status:need-metadata-curationstatus:need-fulltextstatus:need-markdownstatus:need-analysisstatus:need-deep-reading
Il n'est pas nécessaire d'exécuter Tag Bootstrapper pour les créer. Tag Bootstrapper ajoute uniquement des entrées de vocabulaire personnalisées, tandis que Tag Regulator peut auditer les balises contrôlées ordinaires mais ne peut ni ajouter ni supprimer des statuts de workflow intégrés sur les éléments de littérature. Aucun des deux workflows ne peut inférer un statut intégré à partir du sujet, de la langue, des métadonnées ou du texte complet d'un article.
| Événement | Ajouter à l'élément | Retirer de l'élément |
|---|---|---|
| Search crée un élément | Markdown, analyse et deep reading ; métadonnées/fulltext lorsque le résultat les requiert | — |
| Search réutilise un élément | Uniquement les métadonnées/fulltext explicitement requis par ce résultat | — |
| Metadata Curator réussit ou vérifie qu'aucun changement n'est nécessaire | — | Metadata curation |
| MinerU écrit et attache le Markdown | — | Markdown et fulltext |
| Literature Analysis écrit des artefacts formels | — | Analyse |
| Literature Deep Reading écrit et attache le HTML | — | Deep reading |
Les exécutions échouées, ignorées, annulées ou non appliquées n'effacent pas le statut. Si un artefact réussit mais que le nettoyage du statut échoue, l'artefact est conservé et l'exécution signale un avertissement partiel. L'ajout manuel d'un PDF ne supprime pas automatiquement status:need-fulltext.