Skip to content

docs: redirect legacy URLs to new structure - #1950

Merged
pedrolamas merged 1 commit into
fluidd-core:developfrom
pedrolamas:pedrolamas/docs-redirects
Sep 2, 2026
Merged

docs: redirect legacy URLs to new structure#1950
pedrolamas merged 1 commit into
fluidd-core:developfrom
pedrolamas:pedrolamas/docs-redirects

Conversation

@pedrolamas

Copy link
Copy Markdown
Member

What

Adds redirects from the legacy documentation URLs to the current Zensical structure, and bumps Zensical to 0.0.58.

Why

The Jekyll → Zensical migration collapsed a deep page tree into a few long pages, leaving ~30 old URLs returning 404. This isn't just stale bookmarks — older shipped Fluidd builds link into those paths from the app itself (DOCS_AUTH, DOCS_MOONRAKER_COMPONENTS, DOCS_REQUIRED_CONFIGURATION), so printers on older releases hit a 404 from their own help links.

Zensical 0.0.58 adds an mkdocs-redirects-compatible plugin, so this is fixed in config alone — no new Markdown files.

How

[project.plugins.redirects.redirect_maps] in docs/zensical.toml, 35 entries. Old permalinks were extension-less and Jekyll wrote them as dir/index.html — the same layout Zensical produces with use_directory_urls — so it's a 1:1 map. Pages whose URL didn't change are deliberately excluded (a redirect there collides with the real page and fails the build).

Beyond the final Jekyll tree, the map also covers:

  • /configuration/required and /features/multiple_printers — only referenced by older shipped builds.
  • /features/system and /features/integrations — the page names that were briefly live between the migration and the later renames.

Testing

Local build is clean, and all 35 redirects were verified to emit their page, resolve to an existing target, and land on a real heading id — the plugin validates the target page but not the fragment.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LqQHLnnLoyPL4jdUwuVZJc

The Jekyll to Zensical migration collapsed a deep page tree into a few
long pages, leaving ~30 old URLs returning 404. Older shipped Fluidd
builds still link into those paths from the app itself (DOCS_AUTH,
DOCS_MOONRAKER_COMPONENTS, DOCS_REQUIRED_CONFIGURATION), so those
printers hit a 404 from their own help links.

Zensical 0.0.58 adds an mkdocs-redirects compatible plugin, so this is
fixed in config alone. The map also covers a few paths that only exist
in older shipped builds, plus the two page names that were briefly live
between the migration and the later renames.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LqQHLnnLoyPL4jdUwuVZJc
Signed-off-by: Pedro Lamas <pedrolamas@gmail.com>
@pedrolamas pedrolamas added this to the 1.37.5 milestone Sep 2, 2026
@pedrolamas
pedrolamas requested a lite review from Copilot September 2, 2026 23:04
@pedrolamas pedrolamas added the Docs - Enhancement Pertaining improvements or suggestions for the Docs label Sep 2, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

Redirect mappings target existing pages/headings and the dependency bump is to a published Zensical release.

Pull request overview

Adds documentation redirects so legacy Fluidd-in-app help links (from pre-Zensical builds) no longer 404 after the Jekyll → Zensical migration, leveraging the new redirects plugin support in Zensical 0.0.58.

Changes:

  • Add 35 legacy-to-current redirect mappings in docs/zensical.toml.
  • Bump zensical dependency from 0.0.570.0.58 in docs requirements.
File summaries
File Description
docs/zensical.toml Adds redirect map entries to forward old doc paths (and fragments) to the consolidated Zensical pages.
docs/requirements.txt Updates Zensical version to pick up redirects plugin support.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown

Bundle size report (gzip)

Chunk Base Head Δ
assets/index-*.js 161.0 kB 161.0 kB +8 B
sw.js 11.2 kB 11.2 kB -8 B
assets/Console-*.js 370 B 366 B -4 B
assets/Diagnostics-*.js 16.0 kB 16.0 kB -4 B
assets/GcodePreview-*.js 369 B 365 B -4 B
assets/Icons-*.js 528 B 525 B -3 B
assets/NotFound-*.js 439 B 436 B -3 B
assets/AppBtnCollapseGroup-*.js 640 B 638 B -2 B
assets/ConsoleCard-*.js 2.0 kB 2.0 kB -2 B
assets/FileSystem-*.js 31.2 kB 31.2 kB +2 B
assets/Settings-*.js 23.3 kB 23.3 kB +2 B
assets/Timelapse-*.js 1.9 kB 1.9 kB -2 B
assets/AppColorPicker-*.js 13.0 kB 13.0 kB -1 B
assets/BeaconCard-*.js 4.3 kB 4.3 kB -1 B
assets/Configure-*.js 775 B 776 B +1 B
assets/DiskUsageCard-*.js 3.2 kB 3.2 kB +1 B
assets/FullscreenCamera-*.js 425 B 424 B -1 B
assets/GcodePreviewCard-*.js 13.2 kB 13.2 kB -1 B
assets/History-*.js 3.8 kB 3.8 kB -1 B
assets/JobHistoryItemStatus-*.js 1.2 kB 1.2 kB -1 B
assets/Jobs-*.js 499 B 498 B -1 B
assets/MacroCategorySettings-*.js 2.0 kB 2.0 kB -1 B
assets/System-*.js 2.3 kB 2.3 kB +1 B
assets/TimelapseRenderSettingsDialog-*.js 1.8 kB 1.8 kB -1 B
assets/Tune-*.js 3.4 kB 3.4 kB +1 B
Total 2.9 MB 2.9 MB -25 B

119 chunks compared, 25 changed. Sizes are gzip, matching what nginx serves.

@pedrolamas
pedrolamas merged commit 66e6b1f into fluidd-core:develop Sep 2, 2026
8 checks passed
@pedrolamas
pedrolamas deleted the pedrolamas/docs-redirects branch September 2, 2026 23:09
pedrolamas added a commit that referenced this pull request Sep 3, 2026
Signed-off-by: Pedro Lamas <pedrolamas@gmail.com>
Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
(cherry picked from commit 66e6b1f)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Docs - Enhancement Pertaining improvements or suggestions for the Docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants