POD Post Normalizer

This script normalizes POD blog posts in site/_posts/public.

What it does:

Builds or updates the Meta info callout (Authors, Paper, Affiliation, Published, Code, References)
Moves references: lines into the callout as References
Promotes Background, Problem States, Suggestions, Effects to H2 headings
Converts the final blockquote into > **Personal note.** ...

Usage

Run on all public posts:

python site/scripts/pod_normalize.py

Run on a specific file or folder:

python site/scripts/pod_normalize.py site/_posts/public/2024-07-10-pod-routellm-learning-to-route-llms-with-preference-data.md
python site/scripts/pod_normalize.py site/_posts/public

Rename filenames using CSV (Name, or Title first 3 words if Name is empty):

python site/scripts/pod_normalize.py \
  --rename-from-csv \
  --csv "site/assets/pod/notion_bakup/BAKUP (1) 2efdb1032c7980cbb219fdf961b04c46.csv" \
  --csv "site/assets/pod/notion_bakup/BAKUP (1) 2efdb1032c7980cbb219fdf961b04c46_all.csv"

Rename filenames and sync permalink to match the slug:

python site/scripts/pod_normalize.py \
  --rename-from-csv \
  --sync-permalink \
  --csv "site/assets/pod/notion_bakup/BAKUP (1) 2efdb1032c7980cbb219fdf961b04c46.csv" \
  --csv "site/assets/pod/notion_bakup/BAKUP (1) 2efdb1032c7980cbb219fdf961b04c46_all.csv"

Notes

Missing sections are left untouched.
The script is idempotent (safe to run multiple times).