Guida al plugin Obsidian (Beta)

Analogamente all'estensione per VS Code, il nostro plugin per Obsidian offre un OCR sensibile al contesto, consentendo prestazioni più accurate grazie a un'integrazione perfetta tra l'app WriteTex e Obsidian.

ATTENZIONE: IL PLUGIN È IN FASE DI SVILUPPO INTENSIVO E NON OFFRE ALCUNA GARANZIA. L'USO È A PROPRIO RISCHIO. VEDI LA LICENZA. Attualmente è necessario disporre di una configurazione API funzionante di un fornitore di terze parti (ad esempio, OpenAI) per utilizzare il plugin.

Funzionalità

• Compagno per l'app WriteTex: Connette perfettamente l'app mobile WriteTex al tuo editor Obsidian desktop.
• Sensibilità al contesto: Invia automaticamente all'IA il testo circostante al cursore, migliorando la precisione grazie alla comprensione dello stile e delle variabili del documento corrente.
• Inserimento diretto: Il codice generato viene inserito immediatamente nella posizione del cursore.

Installazione

1. Scarica l'ultima versione dalla nostra repository GitHub.
2. Inserisci main.js e manifest.json nella directory dei plugin del tuo vault: <VAULT>/.obsidian/plugins/writetex-obsidian/.
3. Apri le impostazioni di Obsidian -> Plugin della community (Community Plugins) e abilita WriteTex.

Non è necessario installare la versione desktop di WriteTex per utilizzare il plugin Obsidian. È richiesta solo l'app mobile sul tuo iPad/tablet.

Configurazione

Questa parte è simile alla configurazione delle altre piattaforme. Di seguito è riportato un semplice esempio:

Impostazione	Valore
Endpoint API	https://api.openai.com/v1
Modello	gpt-5
Chiave API	sk-...

Istruzioni personalizzate (Custom Instructions)
Alcuni prompt aggiuntivi per guidare il modello IA. Ad esempio, puoi aggiungere "Usa \mathbb{i} per l'unità immaginaria".

Utilizzo

1. Avvia il server:

   • Il server si avvia automaticamente al caricamento di Obsidian.
   • Controlla la barra di stato in basso a destra: dovrebbe esserci scritto "WriteTex: On".
   • Se c'è scritto "Off", apri la Tavolozza dei comandi (Cmd/Ctrl + P) ed esegui "WriteTex: Start Server".

2. Connetti il client (es. app iOS):

   • Apri l'app WriteTex sul tuo telefono.
   • Assicurati che il telefono e il computer siano sulla stessa rete Wi-Fi.
   • L'app dovrebbe scoprire automaticamente "WriteTex Obsidian @ [TuoHostname]".
   • Se la scoperta automatica fallisce, inserisci manualmente l'indirizzo IP del tuo computer.

Per le altre piattaforme (Windows, Android, MacOS), segui la guida in VS Code.

3. Inserisci una formula scritta a mano con WriteTex:
   • Posiziona il cursore in una nota di Obsidian dove desideri che appaia il codice.
   • Usa l'app mobile per scrivere una formula matematica.
   • Il plugin riceverà l'immagine, la analizzerà con il contesto della tua nota attuale e inserirà il risultato LaTeX/Markdown direttamente nel tuo editor.

Risoluzione dei problemi

• Il server non si avvia: Controlla se la porta 50905 è utilizzata da un'altra applicazione. Se hai abilitato il server WriteTex nell'estensione per VS Code, disabilitalo prima di avviare Obsidian.
• L'app mobile non riesce a connettersi:
  • Assicurati che entrambi i dispositivi siano sullo stesso Wi-Fi.
  • Controlla le impostazioni del firewall del tuo computer per consentire le connessioni in entrata sulla porta 50905.
  • Alcune reti scolastiche o aziendali potrebbero bloccare le connessioni tra dispositivi. In questo caso, puoi provare a usare una VPN o un hotspot.
• Errore "Unauthorized": Assicurati che l'app client invii la chiave API writetex.