Rework zoduki assembly pages, fix sidebar nav on new sections - #11
Open
Jerome-Cooper wants to merge 2 commits into
Open
Jerome-Cooper wants to merge 2 commits into
Jerome-Cooper wants to merge 2 commits into
Conversation
- Cap every zoduki step at 4 or fewer top-level items (bullets and numbered list items alike) across existing pages, splitting oversized steps into multiple, sensibly-titled ones so pages don't render with too many simultaneous step colors. - Fix a content-loss bug in the zoduki plugin's interaction with existing docs: any markdown sitting outside a `###` step div was being silently dropped from the rendered page once zoduki activated. Restructured affected pages (worst case: lumen/control-box, where most of the page was invisible) so all existing content lives inside a step and survives rendering. - Convert the "v4 Upgrade Parts", "v2/v3 Spare Parts", and "DIY Components" assembly guide sections to the interactive zoduki step-by-step format, matching the rest of the site. - Give the still-unwritten Endstop PCB Set placeholder a real page title instead of falling back to "Index". - Add the "Other Products" accessory pages to the site nav.
The DIY Components, v2/v3 Spare Parts, and v4 Upgrade Parts pages were never wired into mkdocs.yml's nav tree (they sat in a dead commented-out block), so mkdocs-material had no nav context to render in the left sidebar regardless of page frontmatter. Removed the leftover `hide: navigation` frontmatter on 17 pages where it was an inconsistent copy-paste artifact (kept it on the two genuine full-bleed landing pages), added the three sections as a nested "Other Products" nav group mirroring assembly-guides/index.md's structure, dropped the stale commented-out nav block, and fixed one nav entry that referenced an in-page anchor mkdocs nav doesn't support.
Jerome-Cooper
force-pushed
the
zoduki-rework
branch
from
September 4, 2026 15:40
96cd429 to
762495f
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Zoduki page rework (existing pages):
###step div was being silently dropped from the rendered page once zoduki activated on it. Worst case waslumen/control-box, where most of the page's content was invisible. Restructured affected pages so everything lives inside a step and actually renders.New sections converted to zoduki:
Sidebar navigation fix:
mkdocs.yml'snav:tree (they sat in a long-dead commented-out block), so they had no left-sidebar navigation regardless of page frontmatter. Wired them in as a nested "Other Products" group, removed a leftoverhide: navigationfrontmatter key that was an inconsistent copy-paste artifact on 17 of those pages, and dropped the dead commented-out nav block.All changes verified with a clean
mkdocs build(no new errors) and spot-checked in a browser.Test plan
mkdocs buildruns clean, no errorslumen/control-box) now renders