From 8726a873fdcf61572e72f32f0136047b50c37467 Mon Sep 17 00:00:00 2001 From: Pedro Lamas Date: Wed, 2 Sep 2026 23:54:46 +0100 Subject: [PATCH] docs: redirect legacy URLs to new structure 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 Claude-Session: https://claude.ai/code/session_01LqQHLnnLoyPL4jdUwuVZJc Signed-off-by: Pedro Lamas --- docs/requirements.txt | 2 +- docs/zensical.toml | 54 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 55 insertions(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index dad8b70a3d..07c672f0a7 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,2 +1,2 @@ codespell==2.4.3 -zensical==0.0.57 +zensical==0.0.58 diff --git a/docs/zensical.toml b/docs/zensical.toml index ccec34b851..9416662534 100644 --- a/docs/zensical.toml +++ b/docs/zensical.toml @@ -83,6 +83,60 @@ auto_append = [ "includes/glossary.md" ] +[project.plugins.redirects.redirect_maps] +# Installation -> Getting Started +"installation/index.md" = "getting-started.md" +"installation/kiauh.md" = "getting-started.md#kiauh" +"installation/docker.md" = "getting-started.md#docker" +"installation/manual.md" = "getting-started.md#manual-installation" +"installation/fluiddpi.md" = "getting-started.md#fluiddpi" + +# Configuration +"configuration/initial_setup.md" = "configuration.md#initial-setup" +"configuration/required.md" = "configuration.md#initial-setup" +"configuration/moonraker.md" = "configuration.md#moonraker" +"configuration/moonraker_conf.md" = "configuration.md#example-configuration" +"configuration/multiple_printers.md" = "configuration.md#multiple-printers" +"configuration/fluidd_xyz.md" = "getting-started.md#fluiddxyz" +"configuration/obico_for_remote_access.md" = "features/third-party-integrations.md#obico" +"configuration/octoeverywhere_free_remote_access.md" = "features/third-party-integrations.md#octoeverywhere" + +# Customize +"customize/layout.md" = "customize.md#application-layout" +"customize/themes.md" = "customize.md#themes" +"customize/hide.md" = "customize.md#hiding-components" + +# Top-level sections that moved under Features +"authorization/index.md" = "features/authorization.md" +"updates/index.md" = "features/updates.md" +"updates/automated.md" = "features/updates.md#automated-updates" +"updates/manual.md" = "features/updates.md#manual-updates" + +# Features -> Printing +"features/gcode-viewer.md" = "features/printing.md#g-code-viewer" +"features/bed_mesh.md" = "features/printing.md#bed-mesh" +"features/print_history.md" = "features/printing.md#print-history" +"features/thumbnails.md" = "features/printing.md#thumbnails" + +# Features -> Thermals +"features/chart.md" = "features/thermals.md#chart" +"features/presets.md" = "features/thermals.md#presets" +"features/sensors.md" = "features/thermals.md#sensors" + +# Features -> Multi-Material +"features/multiple_extruders.md" = "features/multi-material.md#multiple-extruders" +"features/spoolman.md" = "features/multi-material.md#spool-management-spoolman" + +# Features -> renamed pages +"features/printers.md" = "features/multiple-printers.md" +"features/multiple_printers.md" = "features/multiple-printers.md" +"features/system.md" = "features/system-and-notifications.md#system" +"features/notifications.md" = "features/system-and-notifications.md#notifications" +"features/integrations.md" = "features/third-party-integrations.md" + +# Development +"development/localization.md" = "development.md#localization" + [[project.extra.social]] icon = "fontawesome/brands/github" link = "https://github.com/fluidd-core/fluidd"