From 83b1a739ae9f190cf9c9671e7ba729350dad2e4b Mon Sep 17 00:00:00 2001 From: John Bowdre Date: Sat, 28 Sep 2024 16:50:08 -0500 Subject: [PATCH] new draft: publish-silverbullet-notes-quartz --- .../index.md | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 content/posts/publish-silverbullet-notes-quartz/index.md diff --git a/content/posts/publish-silverbullet-notes-quartz/index.md b/content/posts/publish-silverbullet-notes-quartz/index.md new file mode 100644 index 0000000..224b99d --- /dev/null +++ b/content/posts/publish-silverbullet-notes-quartz/index.md @@ -0,0 +1,34 @@ +--- +title: "Publish Silverbullet Notes with Quartz" +date: 2024-09-28 +# lastmod: 2024-09-28 +draft: true +description: "This is a new post about..." +featured: false +toc: true +reply: true +categories: Self-Hosting +tags: + - api + - automation + - caddy + - cicd + - selfhosting + - tailscale +--- +It's been about two months since I [switched](https://srsbsns.lol/is-silverbullet-the-note-keeping-silver-bullet/) my note-keeping efforts from [Obsidian](https://obsidian.md) to [SilverBullet](https://silverbullet.md/), and I've been really enjoying it. Being able to access and write my notes from any device with a web browser has been super convenient, and SilverBullet is packed with useful features (and easily extensible to add new ones) without feeling slow, bloated, or otherwise cumbersome. The container-based setup is also [easy to deploy](/silverbullet-self-hosted-knowledge-management/). + +But one use case I hadn't yet migrated from Obsidian to SilverBullet was managing the notes I share publicly at [notes.runtimeterror.dev](https://notes.runtimeterror.dev) using [Quartz](https://quartz.jzhao.xyz/). I had set this up using a [public repo](https://github.com/jbowdre/notes/tree/867dde54f8a72d2d04bac140a4c54e64dd0f569b) containing the Quartz code with a dedicated (public) Obsidian vault folder [embedded within](https://github.com/jbowdre/notes/tree/867dde54f8a72d2d04bac140a4c54e64dd0f569b/content). Since the contents are just Markdown files I *could* simply edit them directly and cut out Obsidian altogether, but I could see myself struggling to keep up with the links between notes if I was editing them manually. I really wanted to find a way to use SilverBullet for my published notes too. + +I played a bit with SilverBullet's [publishing plugin](https://silverbullet.md/Plugs/Pub), which would let me selectively publish notes in certain folders or bearing certain tags, but the HTML it produces is a bit sparse. I didn't want to give up the Quartz niceties like the auto-generated navigation menu and built-in search. + +After a little experimentation I settled on an approach that I think works really well for my needs: +- SilverBullet syncs to a private repo via the [Git plug](https://silverbullet.md/Plugs/Git). +- Pushes to that private repo trigger a workflow run in my (public) Quartz repo. +- A workflow in the Quartz repo clones the private SilverBullet repo to `content/`. +- Quartz processes the Markdown files in the `content/` directory and renders HTML output to `public/`. +- The contents of `public/` are transferred to my server via Tailscale, and then served by Caddy. + +This post will describe the entire setup in detail. + +