Publish free

I’ve always thought about developing my own website to record my work and share it with the community. Why not? My requirements were simple: Free and simple.

Like many others, I started with GitHub. But then, guess what? I love GitHub, but I wanted a little more than just the typical GitHub setup. While doing some research, I came across Digital Garden Docs. So, here, I want to cover a bit more about how I did it and how easy it can be.

1. Requirements

Sign up, Sign up, and Download.

  1. Github account
    https://github.com/
  2. Vercel account
    https://vercel.com/
  3. Obisidian
    https://obsidian.md/

2. Time to Deploy

https://github.com/oleeskild/digitalgarden
Visit this GitHub repository and click the deploy button. You will need to select your scope and give it a name.

Once that’s done, Vercel will handle the deployment.

Hooray! Once it's complete, you can add a domain and make additional customization.

Under Project tab, Production Deployment will indicate your page. Obviously there is nothing there yet.

3. Create a personal access token from github.

Follow link here : https://github.com/settings/personal-access-tokens/new
Adjust Token Expiration date and fill in the following details.
Token Name: YYYY-Digital Garden
Description: Publishing content to the digital garden.
Resource owner: yourself

Select Only select repositories.

Only select repositories: Select your garden repo
Permissions:
Contents: Access: Read and write
Pull requests: Access: Read and write

You don't wanna generate a Golden key. (Sorry for AD metaphor)

4. Get your Digital Garden Plugin!!

In Obsidian app, click the gear box on the bottom left corner. Then, click Community Plugins and search for Digital Garden.

Once Digital Garden Plugin is installed, enter your information under the Digital Garden Tab.

If you upload images a lot, the imgur plugin is a good option.

5. Let's publish your first note!

Create a page and add the following at the top of the note.
dg-home indicates the page is the index page.
dg-publish indicates the page will be published.

Homepage

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

This will look like this

For other pages

---
dg-publish: true
---

This will look like this

Once you do that, press CTRL+P and select the option you want.

I am a lazy person, hence I normally go for Publish Multiple Notes.

6. If you want obsidian looking theme...

Copy and paste *.scss files under /src/site/styles/user.
You will need to create the user folder.

7. Resources

All resources I used are here. ../Digital Garden Resources

Huge thanks to #oleeskild and the community for making this so easy!!

8. Overcoming issues

https://github.com/oleeskild/obsidian-digital-garden/issues/320

#Obsidian #Vercel #github #digitalgarden #makeyourownwebsiteforfree