Configuration¶

Emplacement du fichier¶

OS	Chemin
Linux	`~/.config/vlatex-desktop/config.json`
macOS	`~/Library/Application Support/com.vlatex.vlatex-desktop/config.json`
Windows	`%APPDATA%\vlatex\vlatex-desktop\config.json`

Structure¶

{
  "profile": "default",
  "vault_root": "/chemin/vers/vault",
  "document_title": "",
  "author_name": "",
  "latex_engine": "pdflatex",
  "pandoc_path": "pandoc",
  "bibliography_path": "",
  "csl_path": "",
  "preamble_path": "",
  "keep_nav_arrows": true,
  "default_table_width": "0.95",
  "enable_docx_numbering": true,
  "header_content": "",
  "footer_content": "",
  "enable_header": false,
  "enable_footer": false,
  "toc": true,
  "lot": true,
  "lof": true,
  "geometry": "margin=2.5cm",
  "last_input_file": "",
  "last_output_dir": ""
}

Référence des champs¶

Identité du document¶

Champ	Type	Défaut	Description
`document_title`	string	`""`	Titre du document. Si vide, extrait du frontmatter YAML.
`author_name`	string	`""`	Nom de l'auteur. Si vide, extrait du frontmatter.
`profile`	string	`"default"`	Profil de conversion (non utilisé actuellement).

Chemins¶

Champ	Type	Défaut	Description
`vault_root`	string	`""`	Racine du vault Obsidian. Si vide, utilise le répertoire courant.
`bibliography_path`	string	`""`	Chemin vers le fichier `.bib`. Si vide, cherche automatiquement.
`csl_path`	string	`""`	Fichier CSL pour le style de citation pandoc.
`preamble_path`	string	`""`	Fichier `.tex` de remplacement du preamble.

Moteur LaTeX¶

Champ	Type	Défaut	Description
`latex_engine`	string	`"pdflatex"`	Moteur : `pdflatex`, `xelatex`, `lualatex`
`pandoc_path`	string	`"pandoc"`	Chemin vers pandoc (pour DOCX).

Mise en forme¶

Champ	Type	Défaut	Description
`geometry`	string	`"margin=2.5cm"`	Options de geometry pour LaTeX.
`toc`	bool	`true`	Table des matières.
`lot`	bool	`true`	Liste des tableaux.
`lof`	bool	`true`	Liste des figures.
`default_table_width`	string	`"0.95"`	Largeur par défaut des tableaux (0-1).
`keep_nav_arrows`	bool	`true`	Flèches ↑↓ pour la navigation des citations.

DOCX¶

Champ	Type	Défaut	Description
`enable_docx_numbering`	bool	`true`	Numérotation des sections dans DOCX.

En-tête / Pied de page (PDF)¶

Champ	Type	Défaut	Description
`enable_header`	bool	`false`	Activer l'en-tête.
`header_content`	string	`""`	Contenu LaTeX de l'en-tête.
`enable_footer`	bool	`false`	Activer le pied de page.
`footer_content`	string	`""`	Contenu LaTeX du pied de page.

Derniers fichiers¶

Champ	Type	Défaut	Description
`last_input_file`	string	`""`	Dernier fichier ouvert (GUI/TUI).
`last_output_dir`	string	`""`	Dernier répertoire de sortie.

Exemples de configuration¶

Configuration minimaliste¶

{
  "vault_root": "/home/user/mon-vault"
}

Configuration pour une thèse¶

{
  "vault_root": "/home/user/these",
  "document_title": "Ma Thèse de Doctorat",
  "author_name": "Jean Dupont",
  "latex_engine": "xelatex",
  "bibliography_path": "Writing/BIBTEX.bib",
  "geometry": "margin=3cm",
  "toc": true,
  "lot": true,
  "lof": true,
  "keep_nav_arrows": true,
  "enable_header": true,
  "header_content": "Thèse — \\thepage",
  "enable_footer": true,
  "footer_content": "Université de Paris — \\today"
}

Configuration pour un article¶

{
  "vault_root": "/home/user/papers",
  "document_title": "Mon Article",
  "author_name": "Jean Dupont",
  "latex_engine": "pdflatex",
  "geometry": "margin=2.5cm",
  "toc": false,
  "lot": false,
  "lof": false,
  "enable_docx_numbering": false
}

Variables du frontmatter YAML¶

Les champs du frontmatter priorisent sur la config :

---
title: Titre du document
author: Nom de l'auteur
cover_image: assets/cover.png
copyright: CC BY 4.0
---

Variable	Priorité	Description
`title`	Si config vide	Titre du document
`author`	Si config vide	Nom de l'auteur
`cover_image`	Toujours	Image de couverture
`copyright`	Toujours	Mention de copyright