obsidian-plugin/mara-li_obsidian-my-thesaurus
1
0
Fork 0
mirror of https://github.com/mara-li/obsidian-my-thesaurus.git synced 2026-07-22 05:38:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mara-li_obsidian-my-thesaurus/README.fr.md
Mara-Li 04d40100e5 feat(settings): add excludeTermKey setting to filter tags in frontmatter 
- add settings to set the name for the frontmatter key (by default, `exclude_term`)
- add setting to allow auto-clean existing tag (so it will remove the tags if it was excluded)
- update function to add the filter
- refactor settings to be more readable (style)
- refactor function (moving to utils)
- prevent empty message if missing tags is empty
2025-02-24 13:15:00 +01:00

5.1 KiB
Raw Permalink Blame History

My Thesaurus

Ajoute automatiquement des tags en fonction d’un thésaurus au format CSV ou d'une table Markdown.

Le plugin cherche le mot ou la suite de mots dans l'entête (propriétés), dans le corps et le titre de la note. Le mot recherché le sera :

  • Strictement (sans troncature à droite ou gauche),
  • Insensible à la casse (majuscule ou minuscules)
  • Sensible aux accents (paramétrable)

Tip

jeu trouve JEU ou JEu jeu de carte trouve Jeu De Carte mais pas jeux de cartes jeu ne trouvera ni jeux, enjeu ou rajeunir rôle ne trouvera pas role role ne trouvera pas rôle

📚 Format du Thésaurus

Le thésaurus doit être un tableau avec au moins deux colonnes : une pour les termes et une pour les synonymes. La première ligne doit contenir les en-têtes de colonnes.

Tip

Le thésaurus peut être un fichier CSV comme ceci :

Terme,Synonyme
ordinateur,PC
ordinateur,machine
ordinateur,vélo

Ou en format Markdown :

| Terme      | Synonyme      |
|------------|---------------|
| ordinateur | PC            |
| ordinateur | machine       |
| ordinateur | processeur    |

Note

Si vous choisissez d'utiliser un fichier Markdown, la table Markdown doit être le seul contenu du fichier. Cependant, vous pouvez avoir un entête YAML (propriété) au début du fichier.

⚙️ Paramètres

  1. Thésaurus : Chemin du fichier contenant le thésaurus. Ce fichier doit être un CSV et être stocké dans votre coffre (vault). Vous pouvez cliquer sur le bouton save pour vérifier que le fichier est valide (chemin correct, fichier existant et bien formé).

Warning

Si, pour une raison quelconque, le fichier est déplacé, vous devrez mettre à jour son chemin dans les paramètres ! Il ne sera pas mis à jour automatiquement.

  1. Séparateur : Le séparateur utilisé dans le fichier CSV. Les séparateurs pris en charge sont ,, ;, | et tabulation.
  2. Colonne cible : Le titre de la colonne du fichier CSV contenant les tags :
    • Terme : Nom de la colonne contenant les tags à ajouter.
    • Synonymes : Nom de la colonne des mots à rechercher dans le fichier (contenu et titre).
  3. Chemins inclus : Les fichiers situés dans ces dossiers seront pris en compte lors de l'exécution de la commande My Thesaurus: Analyser tous les fichiers. Vous pouvez séparer les chemins par une virgule, un point-virgule ou un saut de ligne. De plus, les expressions régulières (regex) sont prises en charge.

Tip

Vous pouvez inclure tous les fichiers de votre coffre en utilisant .* comme chemin ! Cette valeur est utilisés par défaut.

  1. Exclure des termes : Permet d'exclure des termes en utilisant une clé de propriété.
    • Clé de propriété : La clé à rechercher dans les propriétés, par défaut exclude_term.
    • Auto-nettoyage : Si activé, le plugin nettoiera les tags déjà existants en supprimant les termes exclus.
  2. Supprimer les accents : Si activé, les accents seront supprimés lors de la reconnaissance de synonymes. Permet de faire correspondre rôle à role (et vice-versa).

📝 Utilisation

Le plugin propose deux commandes :

  1. My Thesaurus: Analyser tous les fichiers : Cette commande analysera tous les fichiers situés dans les chemins inclus et ajoutera les tags en fonction du thésaurus. À la fin, un message affichera les résultats, notamment :
    • Erreurs : Les fichiers ayant rencontré une erreur, ainsi que le message d’erreur correspondant.
    • Fichiers ignorés : Les fichiers qui ont été ignorés car aucun synonyme n'a été trouvé.
    • Succès : Les fichiers analysés avec succès, accompagnés des tags qui ont été ajoutés.
  2. My Thesaurus: Analyser le fichier actuel : Cette commande analysera uniquement le fichier en cours et ajoutera les tags en fonction du thésaurus.

📥 Installation

  • Depuis les plugins communautaires d'Obsidian
  • Avec BRAT via https://github.com/Mara-Li/
  • Depuis la page des versions :
    • Téléchargez la dernière version
    • Décompressez my-thesaurus.zip dans le dossier .obsidian/plugins/
    • Dans les paramètres d’Obsidian, rechargez les plugins
    • Activez le plugin

🎼 Langues

  • Anglais
  • Français

Pour ajouter une traduction :

  1. Forkez le dépôt
  2. Ajoutez la traduction dans le dossier src/i18n/locales sous le nom de la langue (ex : fr.json).
    • Vous pouvez récupérer le code de votre langue depuis Obsidian en utilisant obsidian translation ou via une commande (par exemple dans Templater) : <% tp.obsidian.moment.locale() %>
    • Copiez le contenu du fichier en.json dans le nouveau fichier
    • Traduisez le contenu
  3. Modifiez i18n/i18next.ts :
    • Ajoutez import * as <lang> from "./locales/<lang>.json";
    • Ajoutez <lang> : {translation: <lang>} dans la section ressource.