Add tool/migrate.sh as a one-stop conversion script for the whole repo.
This script's duties include:
- Changing all links from their old (.html) paths to new paths
- Converting most Dactyl-specific syntax to Redocly equivalents
- Generating Redocly sidebar and redirects YAML files
This script is meant to be run from the repo top. It replaces syntax
in-place. Unless this is the final migration phase, the results of
running the migration script should be committed in a separate commit
whose message starts with '[DROP]' so it can be re-run on the latest
version of the master branch during rebasing.
Many commits have been squashed into this one, including:
- Add tool/migrate_links.sh as a one-stop conversion script for links.
- Enable the update_links filter in dactyl config but make it inactive
unless you pass the appropriate vars
- Hack include_svg script to assume content/img instead of img
[FOLD] Migration scripting improvements:
- Roll scripting into all-in-one tool/migrate.sh
- Script moving/renaming Japanese snippets into @i18n
- Link replacment in snippets
- Handle links with query params
- Handle ref-links with anchors
- Remove some macro syntax that breaks Redocly
- Follow internal redirects in link replacement
- Handle links to some non-md pages
[FOLD] Migration script: handle more reflinks & imgs
[FOLD] tweak link migration
[FOLD] Fix substitution of reflinks
Add sidebar script
[FOLD] Fix link migration and whitespace noisiness
[FOLD] Link migration: auto-generate better link replacements
[FOLD] Convert badge syntax
[FOLD] Migration script: handle :not_enabled: syntax
[FOLD] Script generation of redirects
[FOLD] Migration script: make reusable common links
[FOLD] Fix common links code & conversion script comments
[FOLD] Add more non-md links
[FOLD] Fix filter_update_links syntax
[FOLD] Fix script's common links include placement
[FOLD] Migration script: update badge replacement to work w/ common-links
[FOLD] Fix ordering of converting common-links vs partials
[FOLD] Fix link substitution in common-links and fix trailing /index in redirects
Script replacing include_code with code-snippet
Migration script: partials, some variables
Add variables to conversion script
draft repo-link component
Complete repo-link component
Migration script: handle github links
Draft include_svg→inline-svg (non-functional)
Currently doesn't work due to image path issues.
Also, captions and custom classes (for inlining) not implemented yet.
Conversion script: refactor & add code-page-name
Custom code-page-name component works around Markdoc limitation where
vars can't be used in `inline code` sections.
Migrate script: Handle more code includes correctly
Migration script: tabs and tabbed code samples
Child pages macro & conversion script
Adapted from 70cffa67ed
Migration script: update with some partial fixes
Migration script: callouts→admonitions
Fix auto-generation of index pages
Migration script: fix SVG migration
Migration scripting: fix code block prefixes & indentation
- Use the Redocly 0.66 feature for code block prefixes
- Update the script for converting indented code blocks to fences with
Roman's latest fixes (now uses 4 spaces per level, for consistency)
