mirror of
https://github.com/awalsh128/cache-apt-pkgs-action.git
synced 2026-01-21 10:39:16 +00:00
82 lines
2.7 KiB
Bash
Executable file
82 lines
2.7 KiB
Bash
Executable file
#!/bin/bash
|
|
|
|
#==============================================================================
|
|
# update_md_tocs.sh
|
|
#==============================================================================
|
|
#
|
|
# DESCRIPTION:
|
|
# Automatically updates table of contents in all markdown files that contain
|
|
# doctoc markers. The script handles installation of doctoc if not present
|
|
# and applies consistent formatting across all markdown files.
|
|
#
|
|
# USAGE:
|
|
# update_md_tocs.sh [OPTIONS]
|
|
#
|
|
# FEATURES:
|
|
# - Auto-detects markdown files with doctoc markers
|
|
# - Installs Node.js and npm automatically if not present (on Debian/Ubuntu
|
|
# systems)
|
|
# - Installs doctoc if not present (requires npm)
|
|
# - Applies consistent settings across all files:
|
|
# * Excludes document title
|
|
# * Includes headers up to level 4
|
|
# * Uses GitHub-compatible links
|
|
# - Provides clear progress and error feedback
|
|
#
|
|
# TO ADD TOC TO A NEW FILE:
|
|
# Add these markers to your markdown:
|
|
# <!-- START doctoc generated TOC please keep comment here to allow auto update -->
|
|
# <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
|
|
# <!-- doctoc --maxlevel 4 --no-title --notitle --github -->
|
|
#
|
|
# <!-- END doctoc -->
|
|
#
|
|
# DEPENDENCIES:
|
|
# - Node.js and npm (will be installed automatically if missing on
|
|
# Debian/Ubuntu systems)
|
|
# - doctoc (will be installed automatically if missing)
|
|
#
|
|
# EXIT CODES:
|
|
# 0 - Success
|
|
# 1 - Missing dependencies or installation failure
|
|
#
|
|
# NOTES:
|
|
# - Only processes files containing doctoc markers
|
|
# - Preserves existing markdown content
|
|
# - Safe to run multiple times
|
|
#==============================================================================
|
|
|
|
source "$(git rev-parse --show-toplevel)/scripts/dev/lib.sh"
|
|
|
|
# Install doctoc if not present
|
|
if ! command doctoc; then
|
|
log_info "doctoc not found. Installing..."
|
|
if ! command npm; then
|
|
log_info "npm not found. Installing Node.js and npm..."
|
|
if command apt-get; then
|
|
if ! sudo apt-get update && sudo apt-get install -y nodejs npm; then
|
|
fail "Failed to install Node.js and npm via apt-get"
|
|
fi
|
|
else
|
|
fail "Unable to install npm: apt-get not available. Please install Node.js and npm manually."
|
|
fi
|
|
fi
|
|
|
|
if ! npm_package_installed doctoc; then
|
|
if ! npm install -g doctoc; then
|
|
fail "Failed to install doctoc"
|
|
fi
|
|
fi
|
|
fi
|
|
|
|
print_status "Updating table of contents in markdown files..."
|
|
# Find all markdown files that contain doctoc markers
|
|
find . -type f -name "*.md" -exec grep -l "START doctoc" {} \; | while read -r file; do
|
|
log_info "Processing: ${file}"
|
|
if ! doctoc --maxlevel 4 --no-title --notitle --github "${file}"; then
|
|
log_error "Failed to update TOC in ${file}"
|
|
fi
|
|
done
|
|
|
|
print_success "Table of contents update complete!"
|