9.8 KB · updated 2026-05-19 · md

obsidian.ru.md

docs/i18n/integrations/obsidian.ru.md

Obsidian — открытие скомпилированной wiki как настоящего vault

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Español · Français · Deutsch

<!-- translations:end -->

Экспорт Tesserae в Obsidian превращает ваш скомпилированный типизированный граф в настоящий, заранее продуманный vault Obsidian. Не каталог markdown-файлов — а vault с конфигом .obsidian/, типозависимыми callouts, frontmatter, запрашиваемым через Dataview, дашбордом vault и индексом межхранилищных ссылок wiki://.

Предварительные требования

Сначала скомпилируйте проект:

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

Компиляция создаёт .tesserae/graph.json (источник истины) и обычную markdown-проекцию в .tesserae/markdown_projection/. Экспорт Obsidian строится поверх этой проекции, но накладывает на каждую страницу нативные для Obsidian обогащения.

1) Экспортируйте vault

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

Каталог создаётся, если его нет. Повторный запуск идемпотентно перезаписывает его — markdown-проекция детерминирована при том же графе.

Что появляется на диске:

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) Откройте каталог в Obsidian

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

Obsidian обнаружит .obsidian/, распознает его как настоящий vault и загрузит. Список community-плагинов включает Dataview, поэтому Obsidian предложит его включить (рекомендуется — без него блоки dataview рендерятся как code fences).

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

3) Экскурсия по vault

Точки входа

  • README.md — что это за vault и как его обновлять
  • index.md — все узлы по секциям (papers, concepts, claims) с wikilinks
  • _meta/dashboard.md — обзор через dataview: свежие страницы, papers, concepts/claims

Обогащения на каждой странице

Каждая страница узла теперь содержит:

Типозависимые callouts. Семантический callout в верхней части каждой страницы делает тип узла видимым с первого взгляда:

> [!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...

Сопоставление (ключевое): Paper → quote, Repository → info, Contribution → success, Performance → info, Limitation → warning, Causal → important, OpenQuestion → question, Evidence → example.

Рёбра, запрашиваемые через Dataview. Frontmatter теперь содержит типизированные рёбра в виде вложенных map:

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]

Можно писать запросы вроде:

````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

````

Межхранилищные мосты. Любой URI wiki://<alias>/<kind>/<slug>, упомянутый в описании или метаданных узла, выводится и как поле frontmatter:

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

и как секция Cross-vault references в теле страницы. Индекс уровня vault _bridges.md агрегирует каждую исходящую ссылку, сгруппированную по алиасу назначения, чтобы вы могли аудировать межхранилищные ссылки с одной страницы.

Блок Related (dataview). Каждая страница заканчивается запросом, который автоматически показывает страницы, ссылающиеся на неё:

````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

````

Дашборд vault

_meta/dashboard.md содержит блоки dataview для наиболее полезных агрегированных представлений: недавно обновлённые страницы, все papers со столбцами метаданных, все concepts и claims, отсортированные по типу. Редактируйте его свободно — это отправная точка, а не фиксированный контракт.

Граф vault

Встроенный graph view Obsidian (Ctrl/Cmd+G) уже работает с wikilinks, выводимыми в секциях ## Outgoing / ## Incoming. Предпоставляемый .obsidian/graph.json подкрашивает пути papers/, concepts/, claims/ для ориентации. Поверх можно накладывать представления с dataview-фильтрами для более точных срезов.

Межхранилищные рабочие процессы

Зарегистрируйте несколько vault Tesserae, чтобы URI wiki:// разрешались между ними:

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

После регистрации заново экспортируйте каждый vault. _bridges.md в каждом экспорте теперь будет показывать разрешимые ссылки между vault, сгруппированные по алиасу.

Сам Obsidian не переходит по URI wiki:// нативно — они рендерятся как обычный текст — но _bridges.md плюс секция Cross-vault references на каждой странице дают вам ручной индекс до тех пор, пока не появится специализированный плагин Obsidian.

Рабочий процесс обновления

Vault Obsidian — это экспорт типизированного графа только для чтения. Правки в Obsidian не возвращаются обратно в .tesserae/graph.json. Чтобы включить новые источники или исправления:

# 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 горячо перезагрузит изменённые файлы на диске. Если вы добавили внутри vault markdown-заметки, не спроецированные из графа (например, ваши личные аннотации), они сохранятся — экспорт перезаписывает только файлы, которыми владеет, под papers/, concepts/, claims/, плюс index.md, _bridges.md, _meta/dashboard.md и README.md.

Когда использовать это, а когда статический сайт

Скомпилированный HTML-сайт (tesserae project build-site → .tesserae/site/) — для шеринга: публикуйте на GitHub Pages, S3, любой статический хост. Vault Obsidian — для чтения и запросов локально через Dataview и graph view Obsidian. Оба проецируются из одного графа, поэтому никогда не расходятся.