7.8 KB · updated 2026-05-19 · md

obsidian.fr.md

docs/i18n/integrations/obsidian.fr.md

Obsidian — ouvrir le wiki compilé comme un vrai vault

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Deutsch

<!-- translations:end -->

L'export Obsidian de Tesserae transforme votre graphe typé compilé en un vrai vault Obsidian avec un parti pris assumé. Pas un simple dossier de markdown — un vault avec une configuration .obsidian/, des callouts sensibles au type, du frontmatter interrogeable via Dataview, un tableau de bord de vault, et un index des références wiki:// inter-vaults.

Prérequis

Compilez d'abord le projet :

cd /path/to/your-project
tesserae project setup
tesserae project compile

La compilation produit .tesserae/graph.json (la source de vérité) et une projection markdown brute dans .tesserae/markdown_projection/. L'export Obsidian est construit par-dessus cette projection mais ajoute sur chaque page des enrichissements natifs Obsidian.

1) Exporter le vault

tesserae project export-obsidian --vault ~/Documents/tesserae-vault

Le dossier est créé s'il n'existe pas. Une nouvelle exécution l'écrase de manière idempotente — la projection markdown est déterministe pour un même graphe.

Ce qui atterrit sur disque :

tesserae-vault/
  .obsidian/                  # Obsidian config (app.json, graph.json, plugins)
  README.md                   # Vault entry point
  index.md                    # All nodes grouped by section
  _bridges.md                 # Cross-vault wiki:// references, grouped by alias
  _meta/
    dashboard.md              # Dataview overview tables
  papers/                     # Paper / Repository / SourceDocument pages
  concepts/                   # Concept / Topic / Field / Method / Algorithm pages
  claims/                     # Claim / OpenQuestion / Evidence pages
  raw/                        # Optional raw-source attachments (created lazily)

2) Ouvrir le dossier dans Obsidian

File → Open vault... → Open folder as vault → ~/Documents/tesserae-vault.

Obsidian détectera .obsidian/, le reconnaîtra comme un vrai vault, et le chargera. La liste des plugins communautaires inclut Dataview, donc Obsidian proposera de l'activer (recommandé — sans lui, les blocs dataview s'affichent comme de simples blocs de code).

Settings → Community plugins → Browse → "Dataview" → Install → Enable.

3) Visite guidée du vault

Points d'entrée

  • README.md — ce qu'est ce vault et comment le rafraîchir
  • index.md — chaque nœud par section (papers, concepts, claims) avec des wikilinks
  • _meta/dashboard.md — vue d'ensemble dataview : pages récentes, papers, concepts/claims

Enrichissements par page

Chaque page de nœud est désormais livrée avec :

Callouts sensibles au type. Un callout sémantique en haut de chaque page rend le type du nœud visible en un coup d'œil :

> [!quote] Paper
> The paper triggered a wave of follow-on work: SuGaR aligns Gaussians...

> [!warning] Limitation
> No current method can achieve real-time display rates at 1080p...

> [!question] Open question
> How does dynamic-scene reconstruction scale...

Correspondance (extraits) : Paper → quote, Repository → info, Contribution → success, Performance → info, Limitation → warning, Causal → important, OpenQuestion → question, Evidence → example.

Arêtes interrogeables via Dataview. Le frontmatter porte désormais les arêtes typées sous forme de maps imbriquées :

edges_out:
  uses: [gaussian-splatting, volumetric-rendering]
  part_of: [3d-4d-vision-and-reconstruction]
  supports_claim: [performance-claim-..., comparison-...]
edges_in:
  mentioned_in: [project-pulse, topic-visual-slam]

Vous pouvez écrire des requêtes comme :

````markdown

LIST FROM "papers" WHERE contains(edges_out.uses, "nerf")
TABLE edges_out.supports_claim AS "Claims"
FROM "papers"
WHERE length(edges_out.supports_claim) > 3
SORT length(edges_out.supports_claim) DESC
LIMIT 10

````

Ponts inter-vaults. Toute URI wiki://<alias>/<kind>/<slug> mentionnée dans la description ou les métadonnées d'un nœud est exposée à la fois en tant que champ de frontmatter :

cross_vault: [wiki://research/concepts/rlhf, wiki://notes/papers/arxiv-2510-12323]

et sous la forme d'une section de corps Cross-vault references. L'index _bridges.md au niveau du vault agrège chaque référence sortante regroupée par alias de destination, vous permettant d'auditer les liens inter-vaults depuis une seule page.

Bloc Related (dataview). Chaque page se termine par une requête qui montre les pages renvoyant vers elle, peuplée automatiquement :

````markdown

LIST
FROM "papers" OR "concepts" OR "claims"
WHERE contains(file.outlinks, this.file.link) AND file.name != this.file.name
SORT file.name
LIMIT 25

````

Tableau de bord du vault

_meta/dashboard.md embarque des blocs dataview pour les vues agrégées les plus utiles : pages récemment mises à jour, tous les papers avec des colonnes de métadonnées, tous les concepts et claims triés par type. Modifiez-le librement — c'est un point de départ, pas un contrat figé.

Vue graphe du vault

La vue graphe intégrée d'Obsidian (Ctrl/Cmd+G) fonctionne déjà sur les wikilinks émis dans les sections ## Outgoing / ## Incoming. Le .obsidian/graph.json pré-livré colore les chemins papers/, concepts/, claims/ pour faciliter l'orientation. Vous pouvez superposer des vues filtrées par dataview pour obtenir des découpes plus riches.

Workflows inter-vaults

Enregistrez plusieurs vaults Tesserae afin que les URI wiki:// soient résolues à travers eux :

tesserae register-project /path/to/research --name research
tesserae register-project /path/to/notes    --name notes

Ré-exportez chaque vault après l'enregistrement. Le _bridges.md de chaque export affichera désormais des références résolvables entre vaults, regroupées par alias.

Obsidian lui-même ne suit pas nativement les URI wiki:// — elles s'affichent en texte brut — mais _bridges.md plus la section Cross-vault references par page vous offrent un index manuel en attendant qu'un plugin Obsidian dédié arrive.

Workflow de rafraîchissement

Le vault Obsidian est un export en lecture seule du graphe typé. Les modifications faites dans Obsidian ne remontent pas vers .tesserae/graph.json. Pour intégrer de nouvelles sources ou des corrections :

# Edit source files under your project's source dirs (NOT the vault), then:
tesserae project compile
tesserae project export-obsidian --vault ~/Documents/tesserae-vault

Obsidian rechargera à chaud les fichiers modifiés sur disque. Si vous avez ajouté dans le vault des notes markdown qui ne sont pas projetées depuis le graphe (par ex. vos propres annotations personnelles), elles survivent — l'export n'écrase que les fichiers qu'il possède sous papers/, concepts/, claims/, ainsi que index.md, _bridges.md, _meta/dashboard.md et README.md.

Quand l'utiliser vs. le site statique

Le site HTML compilé (tesserae project build-site → .tesserae/site/) est fait pour le partage — déployez-le sur GitHub Pages, S3, ou n'importe quel hébergeur statique. Le vault Obsidian est fait pour lire et interroger localement avec Dataview et la vue graphe d'Obsidian. Les deux projettent depuis le même graphe, ils ne dérivent donc jamais.