Move and reorganize documentation
move-pagecommandsetup L1★1
axoflow/docsy-axoflow ↗What it does
Move documentation page or directory with link rewriting
Best for
Documentation sites where URL stability matters (SEO, existing links) and bulk link maintenance is manual burden.
Inputs
- · Source path (relative, e.g., content/docs/old-section/page.md)
- · Destination path (relative)
Outputs
- · File moved via git mv (preserves history)
- · Old URL in moved file's front matter as alias
- · All xref/relref/ref: links rewritten across content/
- · Hugo build verification
Requires
- · git
- · Python script (move_hugo_files.py)
- · Hugo
Preconditions
- · Docsy Hugo theme installed
- · content/ directory structure initialized
- · Hugo configured
Failure modes
- · Broken links in build output — rewrite pattern misses a reference type
- · File not found on move — script silently skips (user must verify)
- · Hugo build errors after move — old alias or xref syntax invalid
Trust signals
- · Preserves git history via git mv (not copy-delete)
- · Automatic alias injection (old URL still works)
- · Hugo build verification prevents silent breakage