Aller au contenu

FAQ

Questions générales

Quelle est la différence entre vLaTeX et pandoc ?

vLaTeX est un convertisseur Obsidian → LaTeX spécialisé. Il gère :

  • Les wikilinks [[Page]]
  • Les embeds ![[Note]]
  • Les callouts Obsidian > [!note]
  • Les citations @key avec navigation bidirectionnelle
  • Les tableaux pipe avec formatage avancé
  • Les diagrammes Mermaid
  • Le frontmatter YAML

Pandoc est un convertisseur universel mais ne connaît pas la syntaxe Obsidian.

vLaTeX peut-il tourner sans Podman/Oui.

Pour la conversion markdown → LaTeX, aucun outil externe n'est nécessaire.

Pour la compilation PDF/DOCX, Podman ou Docker est requis. Vous pouvez aussi installer TeX Live et pandoc directement.

vLaTeX est-il compatible avec tous les vaults Obsidian ?

Oui. vLaTeX lit les fichiers .md directement depuis le filesystem. Il résout les embeds ![[Note]] en cherchant les fichiers dans le vault.

Le WASM tourne-t-il sans serveur ?

Oui. Le WASM est compilé en module autonome. Il peut être servit depuis n'importe quel static host (GitHub Pages, Netlify, etc.).

Installation

"command not found: vlatex"

Le binaire n'est pas dans le PATH. Vérifiez :

which vlatex
ls -la /usr/local/bin/vlatex

"podman: command not found"

Installez Podman :

# Linux
sudo apt install podman

# macOS
brew install podman

"vlatex-env: image not found"

Construisez l'image :

podman build -t vlatex-env -f Dockerfile.vlatex .

Comment mettre à jour vLaTeX ?

Téléchargez la dernière release et remplacez le binaire :

# Linux
wget https://github.com/dvrch/vlatex/releases/latest/download/vlatex-linux-amd64 -O vlatex
chmod +x vlatex
sudo mv vlatex /usr/local/bin/

Conversion

Les embeds ![[Note]] ne fonctionnent pas

Vérifiez que :

  1. Le vault_root est correctement configuré
  2. Le fichier .md référencé existe dans le vault
  3. L'extension est .md ou .markdown

Les citations ne sont pas rendues

Vérifiez que :

  1. Le fichier .bib existe
  2. Le bibliography_path est correct dans la config
  3. Les clés dans le markdown correspondent aux clés du .bib

Les images ne s'affichent pas

vLaTeX cherche les images dans cet ordre :

  1. Chemin relatif au fichier markdown
  2. Chemin relatif au vault root
  3. URL HTTP (téléchargement)

Le PDF ne se compile pas

Vérifiez que :

  1. Podman est installé et fonctionnel
  2. L'image vlatex-env existe
  3. Le vault est accessible depuis le conteneur :
podman run --rm -v /path/to/vault:/vault vlatex-env ls /vault

Le DOCX est mal formaté

Le DOCX utilise pandoc. Certaines fonctionnalités LaTeX avancées peuvent ne pas être supportées. Essayez :

  1. Simplifiez les tableaux
  2. Réduisez les environnements LaTeX complexes
  3. Utilisez --mathml pour les mathématiques

GUI

La GUI ne démarre pas

Vérifiez que le binaire a été compilé avec la feature gui :

vlatex --version
# Si "gui" n'apparaît pas, recompilez avec --features gui

Pas de fenêtre sur Wayland

egui utilise winit qui supporte X11 et Wayland. Si vous êtes sur Wayland, essayez :

# Forcer X11
GDK_BACKEND=x11 vlatex --gui

Performance

La conversion est lente

Le premier lancement peut être lent à cause du chargement des polices et de l'initialisation de l'env logger. Les conversions suivantes sont plus rapides.

Le PDF met longtemps à compiler

La compilation PDF utilise 3 passes pdflatex + biber. C'est normal. Pour des documents complexes, cela peut prendre 30-60 secondes.

Développement

Comment contribuer ?

Voir Développement.

Comment ajouter une nouvelle syntaxe ?

  1. Identifier l'étape dans le pipeline (converter.rs)
  2. Ajouter la logique de conversion
  3. Ajouter des tests
  4. Mettre à jour le WASM

Comment lancer en mode debug ?

RUST_LOG=debug vlatex document.md
RUST_LOG=trace vlatex --gui  # Très verbeux