fix

Author: sbryngelson

.github/toc-generator.yml

@@ -0,0 +1,10 @@
+# TOC Generator Configuration
+
+# TOC settings
+TOC_TITLE: "## Table of Contents"
+FOLDING: false
+MAX_HEADER_LEVEL: 4
+
+# Marker comment settings
+OPENING_COMMENT: "<!-- toc -->"
+CLOSING_COMMENT: "<!-- tocstop -->" 

.github/workflows/update-toc.yml

@@ -16,15 +16,15 @@ jobs:
   update-toc:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         with:
           fetch-depth: 0
-          token: ${{ secrets.TOC_TOKEN }}
+          token: ${{ github.token }}
 
       - name: Generate TOC
         uses: technote-space/toc-generator@v4
         with:
-          GITHUB_TOKEN: ${{ secrets.TOC_TOKEN }}
+          GITHUB_TOKEN: ${{ github.token }}
           TOC_TITLE: "## Table of Contents"
           TARGET_PATHS: "group-syllabus/*.md"
           FOLDING: false

scripts/README.md

@@ -0,0 +1,31 @@
+# Documentation Scripts
+
+This directory contains utility scripts for maintaining the group documentation.
+
+## Available Scripts
+
+### add-toc-markers.sh
+
+This script adds TOC markers to markdown files that have a "## Table of Contents" heading.
+
+#### Usage
+
+```bash
+./scripts/add-toc-markers.sh <file.md> [file2.md ...]
+```
+
+Example:
+```bash
+# Add TOC markers to a specific file
+./scripts/add-toc-markers.sh group-syllabus/formatting.md
+
+# Add TOC markers to all markdown files in group-syllabus
+./scripts/add-toc-markers.sh group-syllabus/*.md
+```
+
+The script will:
+1. Look for files with a "## Table of Contents" heading
+2. Add `<!-- toc -->` and `<!-- tocstop -->` markers around the TOC
+3. Skip files that already have TOC markers
+
+These markers are used by the GitHub Action workflow to automatically update the table of contents. 

scripts/add-toc-markers.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+
+# This script adds TOC markers to markdown files that have a "## Table of Contents" heading
+
+# Check if a file path is provided
+if [ "$#" -eq 0 ]; then
+  echo "Usage: $0 <file.md> [file2.md ...]"
+  echo "Example: $0 group-syllabus/*.md"
+  exit 1
+fi
+
+# Process each file provided as an argument
+for file in "$@"; do
+  # Check if file exists
+  if [ -f "$file" ]; then
+    echo "Processing $file..."
+    
+    # Check if the file already has TOC markers
+    if grep -q "<!-- toc -->" "$file"; then
+      echo "  TOC markers already exist in $file, skipping..."
+      continue
+    fi
+    
+    # Find the line with "## Table of Contents"
+    toc_line=$(grep -n "^## Table of Contents" "$file" | cut -d: -f1)
+    
+    if [ -n "$toc_line" ]; then
+      # Create a temporary file
+      temp_file=$(mktemp)
+      
+      # Extract content before TOC line
+      head -n "$toc_line" "$file" > "$temp_file"
+      
+      # Add TOC markers
+      echo "<!-- toc -->" >> "$temp_file"
+      echo "<!-- tocstop -->" >> "$temp_file"
+      
+      # Extract content after TOC line
+      tail -n +$((toc_line + 1)) "$file" >> "$temp_file"
+      
+      # Replace original file
+      mv "$temp_file" "$file"
+      
+      echo "  Added TOC markers to $file"
+    else
+      echo "  No '## Table of Contents' found in $file"
+    fi
+  else
+    echo "File $file does not exist"
+  fi
+done
+
+echo "Done adding TOC markers"