Repository navigation
docs: redirect moved pages to their new location - #1348
Conversation
Each "This page has moved" stub now carries a meta refresh to the page it links to, so old URLs land on the new page without a click. The redirect lives in the stub rather than conf.py because every version is built with main's conf.py, and release branches still serve the original pages. Signed-off-by: Ivan Yang <yifanyang@nvidia.com>
|
No actionable comments were generated in the recent review.
|
|
✅ Preview deployed: https://NVIDIA.github.io/IsaacCapture/preview/pr-1348/ Built from commit 06017c9. It may take a minute for the updated preview to appear. |
Description
Old docs URLs from the restructure land on a "This page has moved to …" stub, and the reader has to click through. For example:
main/getting_started/lerobot/index.html→main/integrations/lerobot/index.htmlmain/references/egocentric_hand_reconstruction.html→main/ego_post_processing/egohand.htmlThis adds a meta refresh to each of the 34 stubs on
main, pointing at the page the stub already links to, so the browser goes straight there:Sphinx emits this as
<meta http-equiv="refresh">in<head>. No JavaScript is involved, matching the docs' no-JS rule and the existing rootdocs/index.htmlredirect. The visible "has moved" link stays as the fallback.The redirect is in each stub rather than in
conf.py(e.g.sphinx-reredirects), because every version is built withmain'sconf.pyand release branches still serve the original pages at these paths.Not covered: a few pages deleted earlier without a stub are still served stale from gh-pages (
keep_files: true), e.g.device/index.html,references/device.html,references/retargeting.html. They need a target chosen per page, so they are left for a follow-up.Type of change
Testing
make current-docs(sphinx-build -W --keep-going) succeeds with no warnings.<head>; each target exists, matches the stub's visible link, and is not itself a redirect (no chains)./IsaacCapture/main/and opened each of the 34 old URLs in a browser: every one landed on the expected page.Checklist
SKIP=check-copyright-year pre-commit run --all-filesgit commit -s) per the DCOSummary by CodeRabbit