prepping

2026-08-22 18:09:02 -04:00
parent 9761fee1f7
commit c53f40e604
28 changed files with 1012 additions and 0 deletions
@@ -0,0 +1,65 @@
+---
+title: Conventions
+type: note
+status: draft
+draft: true
+---
+
+# Frontmatter
+
+| Field | Values | Notes |
+| --- | --- | --- |
+| `type` | `archive` \| `canvas` \| `note` | Required |
+| `source` | `twitter` \| `youtube` \| `odysee` \| `article` \| `original` \| `other` | Archive + media notes |
+| `source_url` | URL | Canonical original |
+| `author` | string | Original author, not you |
+| `date` | `YYYY-MM-DD` | Original publication date |
+| `archived` | `YYYY-MM-DD` | When you captured it |
+| `status` | `draft` \| `review` \| `published` | Human workflow |
+| `draft` | `true` \| `false` | Quartz omit-from-site flag |
+| `tags` | list | Prefer `archive`, `twitter`, `note`, topic slugs |
+| `description` | string | Search / OG preview |
+| `aliases` | list | Extra names |
+
+`draft: true` hides the page from the built site. It does **not** hide the file from a public GitHub repo. Truly private material goes in `private/` (gitignored).
+
+# Folders
+
+| Path | Published | Role |
+| --- | --- | --- |
+| `archive/` | yes | Primary sources |
+| `canvases/` | yes | `.canvas` maps |
+| `notes/` | yes | Authored writing |
+| `templates/` | no | Templater / core templates |
+| `meta/` | no | Vault rules, local attachments |
+| `private/` | no, gitignored | Never publish, never push |
+| `site/` | no, gitignored | Local Quartz clone (own remotes) |
+| `publish/` | no | Tracked Quartz overlay |
+
+# Images
+
+Always absolute HTTPS URLs on the image host. Do not commit local binaries for published notes.
+
+```md
+![](https://YOUR-IMAGE-HOST/archive/slug.png)
+```
+
+Scratch files may sit in `meta/attachments/` (gitignored).
+
+# Video
+
+YouTube / tweet (Quartz OFM):
+
+```md
+![](https://www.youtube.com/watch?v=VIDEO_ID)
+![](https://youtu.be/VIDEO_ID)
+![](https://x.com/user/status/ID)
+```
+
+Odysee (raw iframe; survives the static build):
+
+```html
+<iframe width="560" height="315" src="https://odysee.com/$/embed/SLUG/CLAIM" allowfullscreen></iframe>
+```
+
+Get the embed URL from Odysee share → embed. Do not use the watch URL as the iframe `src`.
@@ -0,0 +1,40 @@
+---
+title: Obsidian setup
+type: note
+status: draft
+draft: true
+---
+
+Open **`C:\\projects\\Threadwell`** as the vault (the repo root). `site/` is a local Quartz checkout and is hidden from the file explorer.
+
+# Core plugins
+
+Enable: Files, Search, Quick switcher, Graph, Backlinks, Canvas, Outgoing links, Tags, Page preview, Templates, Note composer, Command palette, Properties, Word count, File recovery.
+
+Templates folder: `templates`.
+
+# Community plugins
+
+| Plugin | Why |
+| --- | --- |
+| Templater | Date/title fill-in for the two starter templates |
+| Dataview | Local queries over `type`, `source`, `status` (not rendered by Quartz) |
+| Linter | YAML key order and tag consistency |
+| Media Extended | Better YouTube/timestamp playback inside Obsidian |
+| Advanced Canvas | Groups, presentation, nicer maps; Quartz still reads stock JSON Canvas |
+
+Install from Community Plugins using `.obsidian/community-plugins.json`.
+
+# Templater
+
+Template folder: `templates`. Enable "Trigger Templater on new file creation" if you want folder templates later.
+
+# Linter (suggested)
+
+- YAML: insert `date` as `YYYY-MM-DD`
+- Deduplicate and sort tags
+- Do not rewrite wikilinks to markdown links
+
+# Link settings
+
+Already set in `app.json`: wikilinks, shortest path, update links on rename.