CR-2026-03-23: Antora.yml Enhancements — Implementation
Changes Implemented
Phase 1: AsciiDoc Features (Session 1)
| Attribute | Purpose | Value |
|---|---|---|
|
Enable Font Awesome icons |
|
|
Enable ]+btn:[, menu:[] macros |
|
|
Syntax highlighting for code blocks |
|
|
Cross-reference display format |
|
|
Custom admonition label |
|
|
Custom admonition label |
|
|
Custom admonition label |
|
|
Custom admonition label |
|
|
Custom admonition label |
|
Phase 2: Navigation & Accessibility (Session 2)
| Attribute | Purpose | Value |
|---|---|---|
|
Friendly name in UI version selector |
|
|
Clickable ¶ anchors on headings |
|
|
Make headings themselves clickable |
|
|
Hide https:// in displayed links |
|
|
Document language for accessibility |
|
|
Warn on undefined attribute references |
|
|
Sidebar TOC depth |
|
|
SEO keywords |
|
Phase 3: Skill & Progress Tracking
| Attribute | Purpose | Value |
|---|---|---|
|
Regex skill level |
|
|
CLI mastery level |
|
|
awk skill level |
|
|
Vim skill level |
|
|
Python skill level |
|
|
Rust skill level |
|
|
Spanish proficiency (CEFR) |
|
|
Latin proficiency (CEFR) |
|
Phase 4: Review Cycles & Carryover Tracking
| Attribute | Purpose | Value |
|---|---|---|
|
Last comprehensive review date |
|
|
Next scheduled review |
|
|
How often to audit carryover |
|
|
Carryover origin date |
|
|
Carryover origin date |
|
|
Carryover origin date |
|
|
Carryover origin date |
|
|
Carryover origin date |
|
Shell Helpers Added
Added to ~/.zshrc for carryover management:
# Days since a date (for carryover tracking)
days_since() {
echo $(( ($(date +%s) - $(date -d "$1" +%s)) / 86400 ))
}
# Days until a date (for deadline tracking)
days_until() {
echo $(( ($(date -d "$1" +%s) - $(date +%s)) / 86400 ))
}Usage:
days_since 2026-03-09 # → 14 (k3s NAT carryover)
days_until 2026-04-01 # → 8 (next quarterly review)New Capabilities Enabled
Keyboard Macros (experimental)
Press kbd:[Ctrl+Shift+T] to open terminal
Click btn:[Submit] to save
Navigate to menu:File[Export > PDF]Deep Linking (sectanchors)
Every heading now has a clickable ¶ anchor:
https://docs.domusdigitalis.dev/captures/page.html#_section_heading
Attribute Typo Detection (attribute-missing: warn)
Build output now warns on undefined attributes:
WARNING: skipping reference to missing attribute: typo-attribute
Files Modified
| File | Changes |
|---|---|
|
Added 30+ new attributes across 4 phases |
|
Added |