My Thesaurus

-> French README

Automagically adds tags based on a thesaurus CSV or a Markdown table.

The plugin searches for the word or series of words in the header (properties), body and title of the note. The word searched for will be :

Strictly (without right or left truncation),
Case-insensitive (upper or lower case)
Accent-sensitive (configurable)

Tip

game finds GAME or GamE. card game finds Card Game but not cards games game won't find games, gaming or gameplay cafe will not find café. café will not find cafe.

📚 Thesaurus Format

The thesaurus must be a table with two columns: one for the terms and one for the synonyms. The first row must contain the column headers.

Tip

The thesaurus can be a CSV file like this:

Tag,Synonym
computer,PC
computer,machine
computer,bike

Or in Markdown format:

| Tag       | Synonym   |
|-----------|-----------|
| computer  | PC        |
| computer  | machine   |
| computer  | processor |

Note

If you choose to use a markdown file, the Markdown table must be the only content in the file. But, you can have a frontmatter at the beginning of the file.

You can have as many synonyms as you want for a term, but you need to duplicate the term in the first column. Moreover, a synonym can be associated with multiple terms, and the synonym can equal to the term itself.

⚙️ Settings

Thesaurus: Path to the file containing the thesaurus. The file must be a CSV file and must be in your vault. You can click on the save button to ensure the file is valid (the path is correct, the file exists, and it's well-formed).
Separator: The separator used in the CSV file. Supported separators are ,, ;, |, tabulation and markdown. See the note above for the markdown separator.
Column title: The title of the column in the CSV file that contains the tags:
- Term: Name of the tag column to be added
- Synonyms: Name of the column of words to be searched in the file (contents and file title).

Caution

If, for some reason, the file is moved, you need to update the path in the settings! It won't be updated automatically.

Included paths: Files in these folders will be included when using the command My Thesaurus: Parse all files. You can separate the paths with a comma, semicolon, or newline. Moreover, regex is supported.

Tip

You can include all the files in your vault by using .* as the path!

Remove accents: If enabled, accents will be suppressed when searching for synonyms. Allows café to be recognized by cafe (and vice versa).

📝 Usage

The plugin has two commands:

My Thesaurus: Parse all files: This command will parse all the files in the included paths and add the tags based on the thesaurus. At the end, a message will be displayed with the results, including:
- Errors: The files that encountered an error and the specific error message.
- Skipped files: The files that have been skipped because no synonym was found.
- Success: The files that have been successfully parsed, along with the tags that have been added.
My Thesaurus: Parse current file: This command will parse the current file and add the tags based on the thesaurus.

📥 Installation

From Obsidian's community plugins
Using BRAT with https://github.com/Mara-Li/
From the release page:
- Download the latest release
- Unzip my-thesaurus.zip in .obsidian/plugins/ path
- In Obsidian settings, reload the plugin
- Enable the plugin

🎼 Languages

English
French

To add a translation:

Fork the repository
Add the translation in the src/i18n/locales folder with the name of the language (ex: fr.json).
- You can get your locale language from Obsidian using obsidian translation or using the commands (in templater for example) : <% tp.obsidian.moment.locale() %>
- Copy the content of the en.json file in the new file
- Translate the content
Edit i18n/i18next.ts :
- Add import * as <lang> from "./locales/<lang>.json";
- Edit the ressource part with adding : <lang> : {translation: <lang>}

Credits

Inspired by pmartinolli/MyThesaurus

4.5 KiB Raw Blame History