Aller au contenu principal

Options Fava

Le comportement de Fava peut être personnalisé à l'aide de directives custom "fava-option" dans vos fichiers de grand livre Beancount. Ces directives vous permettent de contrôler les paramètres d'affichage, la navigation, la gestion des fichiers et bien plus encore, le tout sans quitter votre flux de travail de comptabilité en texte brut.

Syntaxe

Chaque option Fava est définie par une directive Beancount custom :

AAAA-MM-JJ custom "fava-option" "nom-de-l-option" "valeur"

La date est requise par la syntaxe de Beancount mais elle est ignorée par Fava — vous pouvez utiliser n'importe quelle date valide. Par exemple :

2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"

Affichage et Localisation

language

Définit la langue de l'interface de Fava. Si elle n'est pas définie, Fava utilise la langue préférée du navigateur.

  • Par défaut : null (détection automatique par le navigateur)
  • Valeurs : Tout code de langue valide (par exemple, "en", "zh", "de", "fr", "es", "pt", "ru", "nl")
2000-01-01 custom "fava-option" "language" "en"

locale

Définit les paramètres régionaux utilisés pour le formatage des nombres (séparateurs de milliers, points décimaux). Si elle n'est pas définie, utilise le paramètre de langue ou les paramètres régionaux du navigateur.

  • Par défaut : null (utilise le paramètre language ou les paramètres régionaux du navigateur)
  • Valeurs : Toute chaîne de paramètres régionaux valide (par exemple, "en_US", "de_DE", "zh_CN")
2000-01-01 custom "fava-option" "locale" "en_US"

default-page

La page que Fava affiche lorsque vous accédez à un grand livre sans spécifier de chemin.

  • Par défaut : "income_statement/"
  • Valeurs : Tout chemin de page Fava valide
2000-01-01 custom "fava-option" "default-page" "balance_sheet/"

Les chemins de page courants incluent : "income_statement/" (compte de résultat), "balance_sheet/" (bilan), "trial_balance/" (balance de vérification), "journal/", "holdings/" (titres), "commodities/" (matières premières), "editor/" (éditeur).

fiscal-year-end

Définit la date de fin de votre exercice fiscal. Cela affecte la façon dont Fava regroupe les données par période fiscale plutôt que par année civile.

  • Par défaut : 12-31 (31 décembre, année civile)
  • Format : "MM-DD"
2000-01-01 custom "fava-option" "fiscal-year-end" "03-31"

Cet exemple définit la fin de l'exercice fiscal au 31 mars, ce qui est courant pour les entreprises au Royaume-Uni, en Inde et au Japon.

indent

Le nombre d'espaces utilisés pour l'indentation lors du formatage automatique des entrées.

  • Par défaut : 2
  • Valeurs : Tout entier positif
2000-01-01 custom "fava-option" "indent" "4"

currency-column

La colonne sur laquelle les montants en devises sont alignés dans l'éditeur.

  • Par défaut : 61
  • Valeurs : Tout entier positif
2000-01-01 custom "fava-option" "currency-column" "80"

Visibilité du contenu

show-closed-accounts

Définit s'il faut afficher les comptes qui ont été fermés avec une directive close.

  • Par défaut : false
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "show-closed-accounts" "true"

show-accounts-with-zero-transactions

Définit s'il faut afficher les comptes qui n'ont aucune transaction.

  • Par défaut : true
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "show-accounts-with-zero-transactions" "false"

show-accounts-with-zero-balance

Définit s'il faut afficher les comptes ayant un solde nul dans les rapports.

  • Par défaut : true
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"

collapse-pattern

Un modèle d'expression régulière pour les noms de comptes qui devraient être réduits par défaut dans l'arborescence des comptes. Vous pouvez spécifier cette option plusieurs fois pour plusieurs modèles.

  • Par défaut : [] (aucun modèle, rien n'est réduit)
  • Valeurs : Une chaîne d'expression régulière
2000-01-01 custom "fava-option" "collapse-pattern" "Assets:Investments:.*"
2000-01-01 custom "fava-option" "collapse-pattern" "Expenses:Food:.*"

Le nombre de requêtes enregistrées à afficher dans la barre latérale. Réglez sur 0 pour masquer complètement les requêtes.

  • Par défaut : 5
  • Valeurs : Tout entier non négatif
2000-01-01 custom "fava-option" "sidebar-show-queries" "10"

Gestion des fichiers

default-file

Le fichier dans lequel les nouvelles écritures sont insérées lors de l'utilisation de l'éditeur. S'il n'est pas défini, Fava utilise le fichier de grand livre principal.

  • Par défaut : null (fichier de grand livre principal)
  • Valeurs : Chemin vers un fichier Beancount
2000-01-01 custom "fava-option" "default-file" "/chemin/vers/transactions.beancount"

insert-entry

Une expression régulière qui contrôle l'endroit où les nouvelles écritures sont insérées dans un fichier. Fava insérera les écritures avant la première ligne correspondant à ce modèle.

  • Par défaut : null
  • Valeurs : Une chaîne d'expression régulière
2000-01-01 custom "fava-option" "insert-entry" "^;; Fin des écritures"

auto-reload

Définit si Fava recharge automatiquement le grand livre lorsque des modifications sont détectées sur le disque.

  • Par défaut : false
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "auto-reload" "true"

use-external-editor

Définit s'il faut utiliser un éditeur externe au lieu de l'éditeur intégré de Fava. Lorsqu'il est activé, les liens vers les sources s'ouvrent dans l'éditeur par défaut du système.

  • Par défaut : false
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "use-external-editor" "true"

### `import-config`

Chemin vers le fichier de configuration d'importation Beancount pour la fonctionnalité d'importation.

- **Par défaut** : `null`
- **Valeurs** : Chemin vers un fichier de configuration d'importation

```bean
2000-01-01 custom "fava-option" "import-config" "/path/to/import-config.py"

import-dirs

Répertoires à parcourir pour trouver des fichiers à importer. Peut être spécifié plusieurs fois.

  • Par défaut : []
  • Valeurs : Chemin vers un répertoire
2000-01-01 custom "fava-option" "import-dirs" "/path/to/bank-downloads"

Affichage Financier

unrealized

Le sous-type de compte utilisé pour le rapport des gains et pertes non réalisés.

  • Par défaut : "Unrealized"
  • Valeurs : Tout composant de nom de compte valide
2000-01-01 custom "fava-option" "unrealized" "Unrealized"

Lorsqu'il est défini, Fava utilise des comptes comme Income:Unrealized et Expenses:Unrealized pour les gains/pertes non réalisés.

invert-income-liabilities-equity

Détermine s'il faut inverser le signe des comptes de Revenus, Passifs et Capitaux propres. Lorsqu'activé, les revenus sont affichés comme positifs et les dépenses comme négatives, ce qui correspond à l'attente courante.

  • Par défaut : false
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "true"

conversion-currencies

Devises à afficher comme options de conversion dans les rapports. Peut être spécifié plusieurs fois.

  • Par défaut : [] (utilise les devises d'exploitation)
  • Valeurs : Un code de devise
2000-01-01 custom "fava-option" "conversion-currencies" "USD"
2000-01-01 custom "fava-option" "conversion-currencies" "EUR"

account-journal-include-children

Détermine si les pages de journal de compte doivent inclure les transactions des comptes enfants.

  • Par défaut : true
  • Valeurs : "true" ou "false"
2000-01-01 custom "fava-option" "account-journal-include-children" "false"

Surveillance

uptodate-indicator-grey-lookback-days

Le nombre de jours à remonter pour déterminer si un compte est « à jour ». Les comptes n'ayant aucune transaction durant cette période afficheront un indicateur gris.

  • Par défaut : 60
  • Valeurs : Tout entier positif (nombre de jours)
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "90"

upcoming-events

Le nombre de jours dans le futur pour afficher les événements à venir.

  • Par défaut : 7
  • Valeurs : Tout entier non négatif (nombre de jours)
2000-01-01 custom "fava-option" "upcoming-events" "14"

Configuration Recommandée

Pour la plupart des utilisateurs, les options Fava suivantes constituent un bon point de départ :

; Paramètres d'affichage
2000-01-01 custom "fava-option" "language" "fr"
2000-01-01 custom "fava-option" "default-page" "income_statement/"

; Mise en page
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "currency-column" "61"

; Visibilité du contenu
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"

; Affichage financier
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"

; Surveillance
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"

Consulter Vos Options Actuelles

Vous pouvez consulter vos options Fava actuelles dans le Tableau de bord Beancount.io en accédant à la page Paramètres de votre grand livre. La section « Fava Options » affiche toutes les valeurs configurées, y compris les valeurs par défaut pour toutes les options que vous n'avez pas explicitement définies.

Voir Aussi