GitHub/quartz
1
0
Fork 2
mirror of https://github.com/jackyzha0/quartz.git synced 2025-12-28 07:14:05 -06:00
Code Issues Actions Packages Projects Releases Wiki Activity

Quartz sync: Sep 2, 2023, 2:36 PM

Browse Source
This commit is contained in:
bfahrenfort 2023-09-02 14:36:50 -05:00
parent e194dcd70e
commit f0df33e1bd
2 changed files with 12 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
content/Projects/Obsidian/digital-garden.md
View File

@ -8,12 +8,20 @@ tags:
...It's this website.
This isn’t my first web project. I’ve created homepages for open source projects, and I started hosting [[Projects/memos|Memos]] long before I found Obsidian. However, it’s the one I expect to have the longest life.
## About Quartz
Quartz is a publishing system that allows you to take Markdown in a variety of different flavors and host it as a website! One of those flavors is Obsidian markdown, which means it's a choice for publishing your Obsidian notes. All of these webpages are edited right inside Obsidian (either on my laptop or my phone, thanks [[Projects/Obsidian/livesync|LiveSync]]), and then I can tell Quartz to throw my changes on GitHub for them to be deployed automatically.
I'll elaborate at some point.
As for why I chose Quartz over the conventional [Obsidian Publish](https://obsidian.md/publish) route, The primary reason was cost at first: I could run this for free on my own hosting. However, it turns out that the community around extending and improving Quartz is absolutely HUGE! New features are being merged almost every day, and I'm happy to say that I've contributed to a few features and bugfixes.
Many people will run Quartz out of the root of their Obsidian notes, but I run the site out of a subdirectory of my main [Obsidian Vault](https://help.obsidian.md/Getting+started/Create+a+vault). This is because I don't want to publicly expose all of my notes. This subdirectory is symlinked as the `content` folder in my repository that the site runs out of.
- Sidebar: this makes link autocomplete weird.
- My subfolder is called Garden, and I can't autocomplete an internal reference such as `[[Essays/productivity|Increase your Productivity]]` because if I hit tab, it'll turn into `[[Garden/Essays/productivity|Increase your Productivity]]`.
- Since `Garden` doesn't exist as a folder in the install, and Quartz looks at links as shortest-path, that link will 404 until I catch that I made an error.
- Not a big deal but it's worth mentioning.
I could have self-hosted the site, but I opted to use Quartz's built-in functionality for automatically deploying to GitHub Pages and just proxying through to it from my domain. It's simpler, even though it does result in Microsoft having their grubby mitts on my work.
### Hiccups
This was a time and a half to set up RSS for. It used some bastardized form of Atom but with RSS syntax and so neither spec could parse it.
On the bright side, [one PR later](https://github.com/jackyzha0/quartz/pull/407) and Quartz is the only project in the Obsidian ecosystem with an RSS feed.
- On the bright side, [one PR later](https://github.com/jackyzha0/quartz/pull/407) and Quartz is the only project in the Obsidian ecosystem with an RSS feed.
[[Projects/Obsidian/quartz-comments|Adding comments to the site]] was enough of a hassle that I consider it a separate project. Work in progress.

1
content/Projects/Obsidian/livesync.md
View File

@ -3,4 +3,5 @@ title: "Obsidian: LiveSync"
tags:
- cloud
- difficulty-advanced
- incomplete
---