quartz build

This commit is contained in:
Ignacio Ballesteros
2026-02-14 18:00:32 +01:00
parent 23aa2f4dc4
commit 79e93c167e
15 changed files with 710 additions and 19 deletions

View File

@@ -0,0 +1,38 @@
#+title: Atomic Notes
#+date: 2024-01-11
#+filetags: :concept:writing:
An atomic note contains exactly one idea, fully expressed.
* Characteristics
- Self-contained
- Single focus
- Linkable
- Reusable
* Benefits
When notes are atomic:
- Easy to link from multiple contexts
- Simple to reorganize
- Clear to understand
- Quick to write
* Examples
Good atomic note titles:
- "Spaced repetition improves long-term retention"
- "Links create unexpected connections"
- "Writing clarifies thinking"
Bad titles:
- "Notes about learning"
- "Stuff I read"
* Connection to Other Concepts
Atomic notes are the foundation of [[file:zettelkasten.org][Zettelkasten]] and enable effective [[file:linking.org][Linking]].
This principle comes from software engineering - see cite:martin2008 on the Single Responsibility Principle.

View File

@@ -0,0 +1,26 @@
#+title: Knowledge Management
#+date: 2024-01-10
#+filetags: :concept:learning:
Knowledge management is the process of creating, sharing, using, and managing information.
* Core Principles
1. *Capture* - Record ideas as they come
2. *Organize* - Structure for retrieval
3. *Connect* - Link related concepts
4. *Review* - Revisit and refine
* Related Concepts
- [[file:zettelkasten.org][Zettelkasten]] - A specific method for knowledge management
- [[file:atomic-notes.org][Atomic Notes]] - The building blocks
- [[file:linking.org][Linking]] - How connections create value
* Tools
See [[file:../projects/website.org][Website Project]] for how to publish your knowledge base.
* References
The field draws from library science cite:weinberger2007 and cognitive psychology cite:ahrens2017.

View File

@@ -0,0 +1,43 @@
#+title: Linking
#+date: 2024-01-13
#+filetags: :concept:structure:
Links between notes create a network of knowledge.
* Types of Links
** Hierarchical
Parent-child relationships (folders, outlines)
** Associative
Related concepts ([[file:zettelkasten.org][Zettelkasten]] style)
** Sequential
Reading order, workflows
* Why Links Matter
#+begin_src text
[Note A] --- related to --- [Note B]
| |
+--- supports --- [Note C] -+
#+end_src
Links reveal:
- Hidden connections
- Knowledge gaps
- Entry points
* Backlinks
When [[file:atomic-notes.org][Atomic Notes]] links here, this page knows about it. Backlinks show:
- Who references this concept
- How the idea is used
- Related contexts
* Tools Supporting Links
See [[file:../projects/website.org][Website Project]] for publishing linked notes.
The web itself is built on links cite:bernerslee1999.

View File

@@ -0,0 +1,41 @@
#+title: Spaced Repetition
#+date: 2024-01-14
#+filetags: :concept:learning:memory:
Spaced repetition is a learning technique that involves reviewing material at increasing intervals.
* The Forgetting Curve
Without review, we forget:
- 50% within an hour
- 70% within 24 hours
- 90% within a week
* How Spacing Helps
Review schedule example:
| Review | Interval |
|--------|----------|
| 1st | 1 day |
| 2nd | 3 days |
| 3rd | 1 week |
| 4th | 2 weeks |
| 5th | 1 month |
* Software
- Anki
- Org-drill (Emacs)
- RemNote
* Connection to Note-Taking
[[file:zettelkasten.org][Zettelkasten]] provides natural spaced repetition through:
- Random encounters while linking
- Review during searches
- Connections triggering recall
* Research
Based on memory research cite:ebbinghaus1885 and modern applications cite:pimsleur1967.

View File

@@ -0,0 +1,38 @@
#+title: Zettelkasten
#+date: 2024-01-12
#+filetags: :concept:methodology:productivity:
The Zettelkasten (German for "slip box") is a note-taking method developed by sociologist Niklas Luhmann.
* Key Features
- Each note contains one idea ([[file:atomic-notes.org][Atomic Notes]])
- Notes link to each other extensively ([[file:linking.org][Linking]])
- No strict hierarchy - emergence through connections
* How It Works
#+begin_quote
"One cannot think without writing." - Niklas Luhmann
#+end_quote
1. Write fleeting notes
2. Convert to permanent notes
3. Add to the slip box with links
4. Review connections
* Implementation
| Analog | Digital |
|--------|---------|
| Index cards | Org-roam |
| Physical box | Obsidian |
| Manual links | Wiki links |
* Why It Works
The method leverages [[file:spaced-repetition.org][Spaced Repetition]] through organic review and builds on [[file:knowledge-management.org][Knowledge Management]] principles.
* Further Reading
See cite:ahrens2017 for the definitive guide.

View File

@@ -0,0 +1,25 @@
#+title: 2024-01-20
#+date: 2024-01-20
#+filetags: :daily:journal:
* Tasks
- [X] Review [[file:../concepts/zettelkasten.org][Zettelkasten]] notes
- [X] Update [[file:../projects/website.org][Website Project]] status
- [ ] Read more of cite:ahrens2017
* Notes
Realized that [[file:../concepts/atomic-notes.org][Atomic Notes]] principle applies beyond note-taking:
- Commit messages
- Documentation sections
- Email paragraphs
* Ideas
Could [[file:../concepts/spaced-repetition.org][Spaced Repetition]] work for code review? Flag old code for periodic review.
* References
- Discussed [[file:../concepts/knowledge-management.org][Knowledge Management]] with colleague
- Found new source on [[file:../concepts/linking.org][Linking]] theory

17
example-notes/index.org Normal file
View File

@@ -0,0 +1,17 @@
#+title: Welcome
#+date: 2024-01-15
#+filetags: :home:
This is a digital garden built from org-mode notes.
* Getting Started
Explore the different sections:
- [[file:concepts/knowledge-management.org][Knowledge Management]] - Core concepts
- [[file:projects/website.org][Website Project]] - An example project
- [[file:references/index.org][References]] - Books and papers
* Recent Updates
Check out [[file:concepts/zettelkasten.org][Zettelkasten]] for note-taking methodology.

View File

@@ -0,0 +1,34 @@
#+title: Learning System
#+date: 2024-01-18
#+filetags: :project:planning:
A personal system for continuous learning.
* Components
1. *Capture* - Quick notes, highlights, ideas
2. *Process* - Convert to [[file:../concepts/atomic-notes.org][Atomic Notes]]
3. *Connect* - Add [[file:../concepts/linking.org][Links]] to existing notes
4. *Review* - [[file:../concepts/spaced-repetition.org][Spaced Repetition]] for retention
* Daily Practice
| Time | Activity |
|------|----------|
| Morning | Review queue |
| Anytime | Capture ideas |
| Evening | Process inbox |
* Tools
- Org-mode for capture
- Org-roam for [[file:../concepts/zettelkasten.org][Zettelkasten]]
- Org-drill for review
* Inspiration
Based on [[file:../concepts/knowledge-management.org][Knowledge Management]] research and cite:forte2022 Building a Second Brain methodology.
* Status
Currently implementing the capture phase. See [[file:website.org][Website Project]] for publishing component.

View File

@@ -0,0 +1,40 @@
#+title: Website Project
#+date: 2024-01-20
#+filetags: :project:active:
Building a digital garden from org-mode notes.
* Overview
Transform [[file:../concepts/knowledge-management.org][Knowledge Management]] practices into a public website.
* Goals
- [X] Convert org files to markdown
- [X] Preserve [[file:../concepts/linking.org][Linking]] between notes
- [ ] Add search functionality
- [ ] Deploy to hosting
* Technical Stack
| Component | Tool |
|-----------|------|
| Source | Org-mode |
| Converter | org-to-quartz |
| Generator | Quartz |
| Hosting | TBD |
* Architecture
#+begin_src text
org files --> org-to-quartz --> markdown --> Quartz --> HTML
#+end_src
* Related
- [[file:../concepts/zettelkasten.org][Zettelkasten]] - The methodology behind the content
- [[file:../references/index.org][References]] - Sources cited throughout
* Notes
Using [[file:../concepts/atomic-notes.org][Atomic Notes]] makes each page focused and linkable.

View File

@@ -0,0 +1,32 @@
#+title: How to Take Smart Notes
#+date: 2024-01-05
#+filetags: :reference:book:
* Citation
Ahrens, S. (2017). /How to Take Smart Notes/. CreateSpace.
* Summary
A guide to the [[file:../concepts/zettelkasten.org][Zettelkasten]] method based on Niklas Luhmann's practice.
* Key Ideas
1. Writing is thinking
2. One idea per note ([[file:../concepts/atomic-notes.org][Atomic Notes]])
3. Links over folders ([[file:../concepts/linking.org][Linking]])
4. Bottom-up organization
* Quotes
#+begin_quote
"The slip-box is designed to present you with ideas you have already forgotten."
#+end_quote
#+begin_quote
"Every intellectual endeavour starts from an already existing preconception."
#+end_quote
* Application
This book directly influenced the [[file:../projects/learning-system.org][Learning System]] project.

View File

@@ -0,0 +1,31 @@
#+title: References
#+date: 2024-01-08
#+filetags: :reference:index:
Collection of books, papers, and resources.
* Books
** Knowledge Management
- cite:ahrens2017 - How to Take Smart Notes
- cite:forte2022 - Building a Second Brain
** Software & Writing
- cite:martin2008 - Clean Code
- cite:weinberger2007 - Everything Is Miscellaneous
* Papers
- cite:ebbinghaus1885 - Memory: A Contribution to Experimental Psychology
- cite:pimsleur1967 - A Memory Schedule
* Web Resources
- cite:bernerslee1999 - Weaving the Web
* How References Are Used
References connect to concepts:
- [[file:../concepts/zettelkasten.org][Zettelkasten]] cites cite:ahrens2017
- [[file:../concepts/spaced-repetition.org][Spaced Repetition]] cites cite:ebbinghaus1885
- [[file:../concepts/linking.org][Linking]] cites cite:bernerslee1999