Getting Started with Changelog Features
Quick Start: Today I Learned & Then I Learned
🚀 30-Second Setup
-
Add to your note’s front matter:
changelog_url: /changelogs/your-note-slug/ -
Create
_changelogs/your-note-slug.md: ```yaml — layout: changelog title: Changelog - Your Note Title note_title: Your Note Title note_url: /your-note-slug/ permalink: /changelogs/your-note-slug/ —
What Changed
Created: December 2, 2025 | Updated: December 2, 2025
<div style="margin-top: 1em;">
<div style="margin: 0.8em 0; padding: 0.8em; background: white; border-radius: 3px;">
<strong style="color: #8b88e6;">:</strong>
</div>
</div>
</div>
```
-
Done! Entries will now appear in:
-
/til- Today I Learned page (for today’s entries) -
/til-archive- Then I Learned calendar (all entries)
-
📍 Two Views
Today I Learned (/til)
- Shows entries from today only
- Simple bullet list format:
Note Title - Entry Title - Perfect for daily reflection
Then I Learned (/til-archive)
- Calendar view of current month
- Entries colored with light purple background
- Up to 3 entries per day in calendar
- Click “View More…” to see all entries for busy days
- Modal closes with X, Escape, or outside click
🎯 Key Requirements
Date Format
Must be: YYYY-MM-DD
- ✓
2025-12-02 - ✗
12-02-2025
Action Types
-
Added- New content/features -
Revised- Modified/improved content -
Deleted- Removed content
📚 Examples in Your Garden
Already set up and ready to explore:
- Your first seed - Note with changelog
- Example Note with Changelog - Another example
- Then I Learned - View the calendar to see entries
Visit /til today to see what’s been learned!
🔗 Full Documentation
⚙️ How It Works
A Jekyll plugin (changelog_entries_extractor.rb) automatically:
- Scans all changelog files
- Extracts entry titles and dates
- Groups by date
- Makes available to layouts
No manual configuration needed after initial setup!
This line appears after every note.
Notes mentioning this note
There are no notes linking to this note.