| Atari-Games |
- introspective |
+ JS-compiler |
SFML Multithread verlet |
| Beneficial-C programming |
- JS-compiler |
+ Json Converter |
Simple-Code |
| Chess 3 D |
- Json Converter |
+ Kalman-Filtering-Simulation |
simple turso |
@@ -80,39 +80,44 @@
| define evil |
- ofx Async |
+ Naive Circuit Simulator |
Terminal File Manager |
| Design-Patterns |
- Open GL examples |
+ ofx Async |
Thread Pool |
| Dump C++ |
- PFAD |
+ Open GL examples |
Tokenizer tok |
| File Lock Socket |
- Pipes Screen Saver |
+ PFAD |
Trigonometric-Functions |
| Gen XPassword |
- POng |
+ Pipes Screen Saver |
Vite FA config |
| Hangman |
- Random Utility tools |
+ POng |
volumetric-clouds |
| Inject Hook |
- Regular Expression Convertors |
+ Random Utility tools |
Word Proc |
+
+ | introspective |
+ Regular Expression Convertors |
+ |
+
diff --git a/scripts/order.py b/scripts/order.py
index 86832213..10461b6c 100644
--- a/scripts/order.py
+++ b/scripts/order.py
@@ -1,21 +1,30 @@
#!/usr/bin/env python3
+"""
+README Table of Contents Generator
+
+This script automatically generates and updates the Table of Contents (TOC)
+in the README.md file based on project directories in the repository.
+"""
import os
+import sys
import math
import re
import urllib.parse
+from pathlib import Path
from itertools import zip_longest
# Configuration
README = "README.md"
-EXCLUDE = {".git", ".github", "scripts", "__pycache__"}
+EXCLUDE = {".git", ".github", "scripts", "__pycache__", "wiki"}
# Override mapping: directory name -> desired header display
OVERRIDES = {
"Dump_c++": "Dump C++",
# can add any other overrides
}
-# Derive a human-friendly display name for TOC entries
+
def display_name(name):
+ """Derive a human-friendly display name for TOC entries."""
if name in OVERRIDES:
return OVERRIDES[name]
# Insert spaces before camelCase boundaries, then replace underscores
@@ -23,8 +32,9 @@ def display_name(name):
s = s.replace('_', ' ')
return s.strip()
-# Create a GitHub-style slug for IDs
+
def slugify(name):
+ """Create a GitHub-style slug for anchor IDs."""
base = OVERRIDES.get(name, name)
# Split camelCase and underscores
s = re.sub(r'(?<=[a-z0-9])(?=[A-Z])', ' ', base)
@@ -37,84 +47,137 @@ def slugify(name):
# Collapse spaces into hyphens
return re.sub(r"\s+", "-", s.strip())
-# Convert slug back to a Title Case display without hyphens
+
def header_display_from_slug(slug):
+ """Convert slug back to a Title Case display without hyphens."""
disp = slug.replace('-', ' ')
return disp.title()
-# Compute column header ranges
+
def header_range(col):
+ """Compute column header ranges (e.g., 'A-M')."""
if not col:
return ""
first = slugify(col[0])[0].upper()
last = slugify(col[-1])[0].upper()
return f"{first}ā{last}"
-# Collect project directories
-projects = sorted(
- [d for d in os.listdir('.')
- if os.path.isdir(d)
- and d not in EXCLUDE
- and not d.startswith('.')],
- key=str.lower
-)
-
-# Split into 3 roughly even columns
-cols = 3
-chunk = math.ceil(len(projects) / cols)
-columns = [projects[i*chunk:(i+1)*chunk] for i in range(cols)]
-
-# Build HTML table
-lines = [
- '