Skip to content

Commit 5ac9ee1

Browse files
Merge pull request #9 from estepankevich/remove_folder_title_and_add_blog_posts
Remove folder title and add blog posts
2 parents b7cdb9b + ed8d8d9 commit 5ac9ee1

File tree

6 files changed

+89
-10
lines changed

6 files changed

+89
-10
lines changed
277 KB
Loading

content/index.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,11 @@ This site is a living project and is always evolving. Here's how it's organized:
2020
- [🌐 Topics](/🌐-Topics) - Pages that organize my notes by subject
2121
- [📂 Areas](/📂-Areas) - Explorations of things I'm working on, these may vary in structure and detail, and may be in French or Russian
2222
- [📚 Resources](/📚-Resources) - A collection of the sources that inspire and inform me
23-
- [🔖 Tags](/🔖-Tags) - A way to browse my notes and writings by keywords
23+
- [🔖 Tags](/🔖-Tags) - A way to browse my notes and writings by keywords
24+
25+
Other useful links:
26+
- [📖 My Reading List](/📚-Resources/📖-Reading-List)
27+
- [❓ About this site](/🌍-Blog/About-this-site)
2428

2529
<h2>Contact</h2>
2630
Feel free to get in touch using the links in the footer. I'd love to hear from you!

content/🌍 Blog/About obsidian and how I use it.md

Lines changed: 0 additions & 5 deletions
This file was deleted.
Lines changed: 36 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,38 @@
11
---
2-
created: 2024-11-14 20:38
3-
updated: 2024-11-15 15:51
2+
created: 2024-11-12 20:38
3+
updated: 2024-11-19 16:55
44
---
5-
- [ ] #task ToDo
5+
# Welcome to My Notes
6+
This site is built using [Quartz 4](https://quartz.jzhao.xyz/) and is part of my [Obsidian](https://obsidian.md/) repository, showcasing the notes I’ve chosen to publish. The site is open source, and the code is [available on GitHub](https://github.com/estepankevich/stepankevich.com).
7+
8+
### Why I Decided to Publish My Notes
9+
- **Accessibility:** Making my notes and resources openly available allows anyone to benefit from them.
10+
- **Documentation:** I frequently use my notes as a personal reference. By sharing them, I hope they’ll serve as useful documentation for others too.
11+
- **Blogging & Writing:** I’ve always wanted to start a blog. A well-structured notes repository feels like the perfect stepping stone to achieve this goal.
12+
- **Sharing Knowledge:** I believe the insights and inspiration I’ve gathered can be valuable or interesting to others.
13+
- **Organizational Motivation:** Knowing my notes are publicly visible pushes me to organize them more clearly and thoughtfully.
14+
15+
### About Quartz 4 and the Customizations I Made
16+
Quartz 4 is an excellent open-source tool that I found intuitive to use and customize. It took me just two days to tailor it to my preferences before publishing the site. Here are the customizations I made:
17+
18+
- [Added links from properties to appear after the article title](https://github.com/estepankevich/stepankevich.com/pull/1)
19+
- [Integrated a links header element](https://github.com/estepankevich/stepankevich.com/pull/2)
20+
- [Adapted the design and applied custom styles](https://github.com/estepankevich/stepankevich.com/pull/3)
21+
- [Disabled SPA and popovers to improve the experience on mobile devices](https://github.com/jackyzha0/quartz/commit/362b01c2dc8e574d774d2fbdd597b9c11757e2af)
22+
23+
### Publishing Workflow: Automating the Process (Almost!)
24+
To streamline publishing, I attempted to automate note synchronization using Obsidian's [Enveloppe plugin](https://github.com/Enveloppe/obsidian-enveloppe). The main challenge was handling [Dataview](https://github.com/blacksmithgu/obsidian-dataview) queries, which are internal to Obsidian and not easily converted for external use. Although Enveloppe promised a solution by syncing notes directly to GitHub, I ran into issues with broken relative links when integrating with Quartz 4.
25+
26+
For now, I follow a semi-manual process:
27+
1. Use the Enveloppe plugin locally to expand Dataview queries into static Markdown files.
28+
2. Copy the updated files to the Quartz repository’s content folder.
29+
3. Review the changes locally for typos or sensitive information before committing.
30+
31+
This process takes about two minutes, which is manageable and gives me an opportunity to catch any errors or oversights.
32+
33+
### Why I Love Quartz 4
34+
Even as someone with no prior experience in TypeScript, I found Quartz 4 easy to understand and extend. I’ll be following its ongoing development and am excited to explore new features as they’re released.
35+
36+
37+
# Thank you for visiting my site!
38+
I hope you find these notes useful, inspiring, or at the very least, interesting. Feel free to explore and share your thoughts.
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
created: 2024-11-14
3+
updated: 2024-11-19
4+
---
5+
### What is [Obsidian](https://obsidian.md)?
6+
**Obsidian** is a powerful, flexible, and free note-taking application designed for building a personal knowledge base. It works offline, ensuring your data is always stored locally, and supports the universal Markdown (`.md`) format. Obsidian can be extended with thousands of plugins, making it a versatile tool capable of adapting to countless workflows. Whether you’re a student, writer, researcher, or professional, Obsidian can be molded to suit your needs.
7+
8+
### Why I Chose Obsidian
9+
My journey into digital note-taking started eight years ago with **Evernote**. Back then, it was a fantastic tool for organizing my thoughts and ideas, but eventually, the move to a paid subscription model made me reconsider. That’s when I switched to [**Joplin**](https://joplinapp.org/), an open-source, free application that also stored data locally.
10+
11+
While Joplin was a great tool, as my repository of notes grew, I struggled with maintaining structure and organization. Additionally, the repository format in Joplin is stored in a proprietary Joplin-specific format, making it difficult to navigate or export without using the Joplin app itself. This limitation added friction to my workflow and further motivated me to explore other solutions.
12+
13+
I eventually discovered Obsidian, and what immediately resonated with me was its philosophy of linking and connecting notes, which aligned perfectly with two powerful organizational methods
14+
15+
#### 1. [Zettelkasten](https://en.wikipedia.org/wiki/Zettelkasten)
16+
The **Zettelkasten method** is a system of note-taking designed to mimic how our brain connects ideas. Instead of storing information in isolated folders, Zettelkasten encourages creating "atomic" notes - small, self-contained pieces of information that link to each other. In Obsidian, this is seamless thanks to its bidirectional linking and graph view, allowing me to visually explore connections between ideas.
17+
18+
Key benefits of Zettelkasten in Obsidian:
19+
- **Connections, not hierarchies:** Obsidian makes it easy to link notes contextually instead of relying solely on folders.
20+
- **Atomic notes:** Each note contains a single idea, which can be referenced and reused in multiple contexts.
21+
- **Knowledge network:** Over time, your notes evolve into a web of interconnected insights.
22+
23+
#### 2. PARA Method
24+
Tiago Forte’s **PARA method** (Projects, Areas, Resources, Archives) is another game-changer. Unlike Zettelkasten, which focuses on knowledge connections, PARA is about organizing actionable information. Here’s how I use it in Obsidian:
25+
- **Projects**: Notes related to active projects I’m working on (e.g., articles, presentations, or tasks).
26+
- **Areas**: Notes on ongoing responsibilities or interests (e.g., health, personal finance, learning goals).
27+
- **Resources**: Reference material that may be useful later (e.g., articles, guides, or templates).
28+
- **Archives**: Notes from completed projects or inactive areas for long-term storage.
29+
30+
![[Pasted image 20241119161058.png]]
31+
Combining **Zettelkasten** for knowledge creation with **PARA** for organization has transformed how I manage my notes. My repository now feels intuitive and structured, no matter how much it grows.
32+
33+
### Pros of Obsidian
34+
- **Flexibility and extensibility**: With plugins, Obsidian can adapt to almost any workflow, whether you're using it for task management, journaling, or research.
35+
- **Community-driven development**: The Obsidian community is vibrant and continuously contributes plugins, themes, and ideas.
36+
- **Markdown format**: Your notes are plain text, ensuring portability and eliminating the risk of being locked into a proprietary format.
37+
- **Perfect for Zettelkasten**: Obsidian’s linking and graph view make it a natural fit for knowledge management.
38+
- **Fast and lightweight**: Even with large repositories, Obsidian remains quick and responsive.
39+
- **Customizable themes**: Obsidian’s appearance can be tailored to your taste with community-created themes.
40+
- **Offline-first**: No dependency on the cloud—your data is always accessible.
41+
42+
### Cons of Obsidian
43+
- **Steep learning curve**: For non-technical users, setting up and customizing Obsidian can feel overwhelming.
44+
- **Overwhelming options**: The many ways to organize your repository can lead to decision paralysis.
45+
- **Time-consuming setup**: Building a workflow that suits you takes time and experimentation.
46+
- **Limited attachment support**: While Obsidian supports PDF and text attachments, the experience can be inconsistent across platforms.
47+
- **Plugin dependency**: While plugins add incredible functionality, they can sometimes break with updates, requiring manual intervention.

quartz/plugins/emitters/folderPage.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ export const FolderPage: QuartzEmitterPlugin<Partial<FolderPageOptions>> = (user
9090
defaultProcessedContent({
9191
slug: joinSegments(folder, "index") as FullSlug,
9292
frontmatter: {
93-
title: `${i18n(cfg.locale).pages.folderContent.folder}: ${folder}`,
93+
title: `${folder}`,
9494
tags: [],
9595
},
9696
}),

0 commit comments

Comments
 (0)