Digital Garden

Official Documents, Overview

How it works

if dg-publish then Plug-In -> GitHub -> Cloudflare -> three-blue-daisies.pages.dev

pages to be published must have property "dg-publish=true" (to set a page as the home page, use dg-home=true)
Plug-in sends selected pages to GitHub. Cloudflare pulls changes from GitHub automatically and publishes to three-blue-daisies.pages.dev.

Updates automatically, just submit in Obsidian

Adjusting the Code

Styles

Example I Like:
https://hermitage.utsob.me/

Solid:
Minimal

OK:
Obsidian You, Light
Vintage Theme
Wikipedia

Not:
Sparkling Night, Light

Initial Setup

Official Set-up Guide

It's a bit of work to set this all up, but when you're done you'll have a digital garden in which you are in control of every part of it, and can customize it as you see fit. Which is what makes digital gardens so delightful.
Lets get started:

  1. Create GitHub account

  2. Start by going to the digitalgarden repo and clicking the Use This Template > Create a new repository. CleanShot 2023-05-23 at 22.43.25@2x.png
    You should then be able to create an account with your hosting provider of choice and connect it to your newly created repository. If the setups asks for an install command, output directory or build command, use those that are visible in the picture from Vercel above. via Hosting Alternatives

  3. Give it a fitting name like 'my-digital-garden'. Follow the steps to publish your site to the internet.

    • (named it "digital-garden")
  4. Now you need to create an access token so that the plugin can add new notes to the repo on your behalf. Go to this page while logged in to GitHub. The correct settings should already be applied. If you don't want to generate this every few months, choose the "No expiration" option. Click the "Generate token" button, and copy the token you are presented with on the next page.

    • set exp to 90 days, The token will expire on Wed, Dec 27 2023
  5. In Obsidian open the setting menu and find the settings for "Digital Garden". The top three settings here is required for the plugin to work.
    Fill in your GitHub username, the name of the repo with your notes which you created in step 3. Lastly paste the token you created in step 4. The other options are optional. You can leave them as is.

  6. Now, let's publish your first note! Create a new note in Obsidian. And add the following to the top of your file

---
dg-home: true
dg-publish: true
---

This does two things:

  1. Open your command palette by pressing CTRL+P on Windows/Linux (CMD+P on Mac) and find the "Digital Garden: Publish Single Note" command. Press enter.
  2. Go to your site's URL which you should find on Vercel. If nothing shows up yet, wait a minute and refresh. Your note should now appear.

Congratulations, you now have your own digital garden, hosted free of charge!
You can now start adding links as you usually would in Obisidan, with double square brackets like this: Some Other Note, to the note that you just published. You can also link to a specific header by using the syntax Some Other Note > A Header. Remember to also publish the notes your are linking to as this will not happen automatically. This is by design. You are always in control of what notes you actually want to publish. If you did not publish a linked note, the link will simply lead to a site telling the user that this note does not exist.