Guide du plugin Obsidian (Bêta)

À l'instar de l'extension VS Code, notre plugin Obsidian propose une reconnaissance OCR contextuelle, permettant une performance plus précise grâce à une intégration fluide entre l'application WriteTex et Obsidian.

AVERTISSEMENT : LE PLUGIN EST EN COURS DE DÉVELOPPEMENT INTENSIF ET NE PRÉSENTE AUCUNE GARANTIE. UTILISEZ-LE À VOS PROPRES RISQUES. VOIR LA LICENCE. Actuellement, vous devez disposer d'une configuration API fonctionnelle d'un fournisseur tiers (par exemple, OpenAI) pour utiliser le plugin.

Fonctionnalités

• Compagnon pour l'application WriteTex : Connecte de manière fluide l'application mobile WriteTex à votre éditeur Obsidian sur ordinateur.
• Sensibilité au contexte : Envoie automatiquement le texte entourant votre curseur à l'IA, améliorant la précision en comprenant le style et les variables de votre document actuel.
• Insertion directe : Le code généré est inséré immédiatement au niveau de votre curseur.

Installation

1. Téléchargez la dernière version depuis notre dépôt GitHub.
2. Placez main.js et manifest.json dans le répertoire des plugins de votre coffre (vault) : <VAULT>/.obsidian/plugins/writetex-obsidian/.
3. Ouvrez les paramètres d'Obsidian -> Plugins de la communauté (Community Plugins) et activez WriteTex.

Vous n'avez pas besoin d'installer la version de bureau de WriteTex pour utiliser le plugin Obsidian. Seule l'application mobile sur votre iPad/tablette est requise.

Configuration

Cette partie est similaire à la configuration des autres plateformes. Un exemple simple est présenté ci-dessous :

Paramètre	Valeur
Point de terminaison API	https://api.openai.com/v1
Modèle	gpt-5
Clé API	sk-...

Instructions personnalisées (Custom Instructions)
Quelques invites supplémentaires pour guider le modèle d'IA. Par exemple, vous pouvez ajouter "Utiliser \mathbb{i} pour l'unité imaginaire."

Utilisation

1. Démarrer le serveur :

   • Le serveur démarre automatiquement au chargement d'Obsidian.
   • Vérifiez la barre d'état en bas à droite : elle doit indiquer "WriteTex: On".
   • S'il indique "Off", ouvrez la palette de commandes (Cmd/Ctrl + P) et lancez "WriteTex: Start Server".

2. Connecter le client (par exemple, application iOS) :

   • Ouvrez l'application WriteTex sur votre téléphone.
   • Assurez-vous que votre téléphone et votre ordinateur sont sur le même réseau Wi-Fi.
   • L'application devrait automatiquement découvrir "WriteTex Obsidian @ [VotreNomD'Hôte]".
   • Si la découverte automatique échoue, saisissez manuellement l'adresse IP de votre ordinateur.

Pour les autres plateformes (Windows, Android, MacOS), suivez le guide dans VS Code.

3. Insérer une formule manuscrite :
   • Placez votre curseur dans une note Obsidian là où vous souhaitez que le code apparaisse.
   • Utilisez l'application mobile pour écrire une formule mathématique.
   • Le plugin recevra l'image, l'analysera avec le contexte de votre note actuelle et insérera le résultat LaTeX/Markdown directement dans votre éditeur.

Dépannage

• Le serveur ne démarre pas : Vérifiez si le port 50905 est utilisé par une autre application. Si vous avez activé le serveur WriteTex dans l'extension VS Code, veuillez le désactiver avant de lancer Obsidian.
• L'application mobile ne peut pas se connecter :
  • Assurez-vous que les deux appareils sont sur le même Wi-Fi.
  • Vérifiez les paramètres du pare-feu de votre ordinateur pour autoriser les connexions entrantes sur le port 50905.
  • Certains réseaux scolaires ou d'entreprise peuvent bloquer les connexions entre appareils. Dans ce cas, vous pouvez essayer d'utiliser un VPN ou un point d'accès.
• Erreur "Unauthorized" : Assurez-vous que l'application cliente envoie la clé API writetex.