0xrsydn/research
1
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Finalize vault: fix Bases syntax, add Quartz fields, improve template

Browse source 
Changes from Codex review:
- Bases: rename .md -> .base, fix filter to file.name == 'index.md',
  fix formula to now() (not date(now)), add proper views section with
  table view and column order, add displayName for properties
- Frontmatter: add 'description' (SEO/link previews) and 'draft' (publishing
  control) fields for Quartz compatibility
- Template: add '## Scope' section, add '## Related Research' section for
  explicit wikilinks between topics, use path-qualified wikilinks in detail
  files section to avoid ambiguous basenames across topics
- README: fix cross-vault wikilink claim (separate vaults can't resolve
  cross-vault links; Quartz can't publish outside its content tree),
  document draft field, clarify that tags don't create graph edges
This commit is contained in:
hermes 2026-07-29 11:28:38 +00:00
commit 681d926797
4 changed files with 61 additions and 52 deletions
Download patch file Download diff file Expand all files Collapse all files

16
README.md
View file

@ -25,7 +25,7 @@ Each research topic is a **directory** at the vault root with an `index.md` entr
```
- **Small topics**: just `index.md` alone in the directory.
- **Big topics**: split into detail files as they grow. Link them from `index.md` with `[[wikilinks]]`.
- **Big topics**: split into detail files as they grow. Link them from `index.md` with path-qualified wikilinks (e.g. `[[topic-slug/sources|Sources]]`) to avoid ambiguous basenames across topics.
- Detail file names are up to you — `sources`, `analysis`, `methodology`, `notes`, `summary`, `next-steps` are common patterns.
### Frontmatter (in `index.md`)
@ -33,15 +33,21 @@ Each research topic is a **directory** at the vault root with an `index.md` entr
```yaml
---
title: One-line summary
description: Short description for search results and link previews
status: exploring | active | concluded | shelved
category: market | technical | competitive | legal | scientific | exploratory
tags: []
draft: true
created: YYYY-MM-DD
updated: YYYY-MM-DD
origin: buzz://<channel-uuid>/<event-id>
---
```
- `description` — improves search results, link previews, RSS, and SEO when published via Quartz.
- `draft: true` — excludes the topic from the published site. Set `draft: false` when ready to publish.
- `created` / `updated` — Quartz recognizes these for date display and sorting.
### Categories
Categories are in frontmatter, not folders — every topic lives at the vault root.
@ -69,11 +75,13 @@ exploring → active → concluded
## Bases
Open `Research Base` (in `bases/research-base.md`) to see all topics as a filterable, sortable table — by status, category, tags, or date. Only `index.md` files appear; detail files are excluded via the `file.name.is("index")` filter.
Open `Research Base` (in `bases/research-base.base`) to see all topics as a filterable, sortable table — by status, category, tags, or date. Only `index.md` files appear; detail files are excluded via the `file.name == "index.md"` filter.
## Graph View
Wikilinks between detail files within a topic, and between topics via shared tags, create a knowledge graph visible in Obsidian's graph view. Cross-links to [[index|Idea Dump]] entries (e.g., research that feeds a product idea) work natively since both vaults live under the same Obsidian vault.
Wikilinks between detail files within a topic, and between topics, create a knowledge graph visible in Obsidian's graph view. Use path-qualified links (`[[topic-slug/sources|Sources]]`) to avoid ambiguous basenames. Tags make topics discoverable and filterable but do not themselves create graph edges — only links do.
Note: cross-vault wikilinks (e.g. to idea-dump entries) only work if both vaults are directories within the same Obsidian vault. If publishing via Quartz, links can only resolve within the same content tree — use public URLs for cross-site references.
## Publishing (Future)
@ -82,4 +90,4 @@ The vault is structured for eventual publication as a public knowledge base:
- **Quartz** (recommended) — free static site generator for Obsidian vaults. Preserves wikilinks, backlinks, graph view, and full-text search. Self-hostable via NixOS.
- **Obsidian Publish** — paid, simplest, but not self-hosted.
The `index.md` + wikilink structure means the published site will render as a connected knowledge graph, not a flat list of documents.
The `index.md` + wikilink structure means the published site will render as a connected knowledge graph, not a flat list of documents. The `draft` frontmatter field controls which topics are published.