Aller au contenu

Plugin Obsidian

Installation du plugin

Manuel

  1. Copiez les fichiers dans le dossier .obsidian/plugins/vlatex/ de votre vault :
.obsidian/plugins/vlatex/
├── main.js
├── manifest.json
└── vlatex_bg.wasm
  1. Activez le plugin dans Obsidian : Paramètres → Plugins → vlatex

Via le dossier plugin_distribution

cp -r plugin_distribution/* /chemin/vers/vault/.obsidian/plugins/vlatex/

Utilisation

Dans Obsidian, utilisez la commande :

  • Ctrl+P → "vlatex: Convert to LaTeX"
  • Ctrl+P → "vlatex: Compile to PDF"
  • Ctrl+P → "vlatex: Compile to DOCX"

Paramètres du plugin

Paramètre Description
Vault root Racine du vault
Profile Profil de conversion
Document title Titre par défaut
Author name Auteur par défaut
LaTeX engine pdflatex/xelatex/lualatex
Bibliography path Chemin .bib
CSL path Style de citation
Preamble path Preamble personnalisé
Keep nav arrows Flèches navigation
Default table width Largeur tableaux
TOC Table des matières
LOT Liste des tableaux
LOF Liste des figures
Header/Footer En-tête/pied de page
DOCX numbering Numérotation DOCX

Différences avec vLaTeX Desktop

Fonctionnalité Plugin Obsidian vLaTeX Desktop
Wikilink embeds Via API Obsidian Via filesystem
Dataview inline Via API Obsidian Non supporté
Mermaid Via mmdc CLI Via mmdc CLI
Images web Via requestUrl Via ureq
Compilation Via conteneur Via conteneur
GUI Interface Obsidian Interface native
CLI Non disponible Disponible
Hors-ligne Non (Obsidian requis) Oui

Développement du plugin

Structure

obsidian-plugin/
├── main.js              # Plugin principal (compilé)
├── package.json         # Configuration npm
├── vlatex_bg.wasm       # Module WASM
├── vlatex.js            # Glue JS
└── vlatex.d.ts          # Types TypeScript

Compilation du WASM

# depuis rust-vlatex/
wasm-pack build --target web --out-dir obsidian-plugin

Build du plugin

cd obsidian-plugin
npm install
npm run build

Test

  1. Copiez les fichiers dans .obsidian/plugins/vlatex/
  2. Redémarrez Obsidian
  3. Activez le plugin