🎨 rc-render.sh

Script Path: bones/scripts/rc-render.sh

Purpose

• Convert all Markdown documentation into HTML pages.
• Support custom templates, parallel execution, verbose logging, and dry-run previews.
• Emit detailed logs for ritual auditing.

CLI Interface

rc-render.sh [--dry-run] [--verbose] [--help]

Supported options: - --help, -h Show usage information and exit. - --dry-run, -n Preview actions without writing output. - --verbose, -v Show detailed logs.

Workflow Steps

1. Check Dependencies
   • Ensure pandoc, find, xargs, and date are available.
2. Initialize Logging
   • Write to bones/logs/rc-render.log. All stdout and stderr are captured.
3. Discover Markdown Files
   • Recursively locate *.md pages to render.
4. Render Files
   • Process each Markdown file sequentially using Pandoc.
5. Log Results
   • Record successes and failures with timestamps.
6. Cleanup
   • Remove temporary files on exit.

Exit Codes

• 0 — All pages rendered successfully.
• 1 — Missing dependencies or invalid flags.
• 2 — One or more render failures.

Errors and render failures are logged to bones/logs/rc-render.log.

Examples

# Default render
./bones/scripts/rc-render.sh

# Verbose output
./bones/scripts/rc-render.sh -v

🛣️ Navigation

• Scripts Index
• Render Reference
• Bones Home