CR-2026-03-23: Antora.yml Feature Enhancements

Change Summary

CR ID

CR-2026-03-23-001

Date

2026-03-23

Priority

P3

Type

Documentation Enhancement

Status

Implemented

Component

domus-captures

Objective

Enhance the domus-captures antora.yml with missing Antora/AsciiDoc features identified through comparison with official Antora documentation.

Justification

  1. Deep Linking - sectanchors enables direct linking to any heading

  2. Accessibility - lang: en improves screen reader support

  3. Error Detection - attribute-missing: warn catches typos in {attribute} references

  4. SEO - keywords improves search engine indexing

  5. UX - display_version shows friendly name in UI selector

  6. Skill Tracking - Level attributes enable progress documentation

Changes Implemented

Phase 1: AsciiDoc Features (Session 1)

Attribute Purpose Value

icons

Enable Font Awesome icons

font

experimental

Enable ]+btn:[, menu:[] macros

''

source-highlighter

Syntax highlighting for code blocks

highlight.js

xrefstyle

Cross-reference display format

short

tip-caption

Custom admonition label

💡 Tip

note-caption

Custom admonition label

📝 Note

warning-caption

Custom admonition label

⚠️ Warning

caution-caption

Custom admonition label

🔥 Caution

important-caption

Custom admonition label

❗ Important

Phase 2: Navigation & Accessibility (Session 2)

Attribute Purpose Value

display_version

Friendly name in UI version selector

Chronicles 2026

sectanchors

Clickable ¶ anchors on headings

''

sectlinks

Make headings themselves clickable

''

hide-uri-scheme

Hide https:// in displayed links

''

lang

Document language for accessibility

en

attribute-missing

Warn on undefined attribute references

warn

page-toclevels

Sidebar TOC depth

3

keywords

SEO keywords

worklog, engineering, infrastructure…​

Phase 3: Skill & Progress Tracking

Attribute Purpose Value

level-regex

Regex skill level

Intermediate

level-cli

CLI mastery level

Advanced

level-awk

awk skill level

Intermediate

level-vim

Vim skill level

Advanced

level-python

Python skill level

Intermediate

level-rust

Rust skill level

Beginner

level-spanish

Spanish proficiency (CEFR)

B2

level-latin

Latin proficiency (CEFR)

A2

Phase 4: Review Cycles & Carryover Tracking

Attribute Purpose Value

last-full-review

Last comprehensive review date

2026-03-01

next-quarterly-review

Next scheduled review

2026-04-01

carryover-audit-frequency

How often to audit carryover

weekly

origin-k3s-nat

Carryover origin date

2026-03-09

origin-monad

Carryover origin date

2026-03-11

origin-strongline

Carryover origin date

2026-03-16

origin-vocera

Carryover origin date

2026-03-12

origin-razer-eaptls

Carryover origin date

2026-03-11

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

Verification

# Build and check for warnings
cd ~/atelier/_bibliotheca/domus-captures
make 2>&1 | grep -E "WARN|ERROR"
# Expected: Build clean (no attribute warnings)

# Test new shell functions
source ~/.zshrc
days_since 2026-03-09
# Expected: 14

Files Modified

File Changes

docs/antora.yml

Added 30+ new attributes across 4 phases

~/.zshrc

Added days_since and days_until functions

Reference Documentation

Related