Infrastructure

Core MRDTech platform, network, security, automation, and operations documentation.

The sidebar lists pages assigned to this category through WikiDocs frontmatter. No nested document folders are used.

WikiDocs category sidebar patch durability

WikiDocs uses a custom MRDTech category-frontmatter sidebar patch. Stock zavy86/wikidocs does not understand the category: field used by the document files, so replacing the service with the bare upstream image will flatten the sidebar again.

Durable deployment details:

  • Compose stack: /data/compose/107/docker-compose.yml
  • Compose project: wikidocs
  • Custom image: mrdtech/wikidocs-category:20260728
  • Build context: /home/michaeld/stacks/wikidocs-category-patch
  • Dockerfile: /home/michaeld/stacks/wikidocs-category-patch/Dockerfile
  • Patched files baked into the image:
    • /var/www/localhost/htdocs/classes/Document.class.php
    • /var/www/localhost/htdocs/template.inc.php

Required patch markers:

  • Document::getMetadata()
  • Document::stripMetadata()
  • Document::getCategory()
  • Document::indexByCategory()
  • template logic using Document::getCategory($DOC->ID)

Expected verification after any rebuild or recreate:

cd /data/compose/107
docker compose -p wikidocs up -d --force-recreate wikidocs
docker inspect wikidocs-wikidocs-1 --format 'Image={{.Config.Image}} ImageID={{.Image}}'
docker exec wikidocs-wikidocs-1 sh -lc 'grep -nE "getMetadata|stripMetadata|getCategory|indexByCategory|current_category" /var/www/localhost/htdocs/classes/Document.class.php /var/www/localhost/htdocs/template.inc.php'

Rendered expectation:

  • Homepage/top sidebar has exactly 5 top-level items: About Michael, Hacker Culture, Infrastructure, Projects, Runbooks.
  • Infrastructure renders 19 categorized child pages.
  • Projects renders 3 categorized child pages.
  • No categorized page shows raw category: frontmatter.

Do not change the image back to zavy86/wikidocs unless the category patch is also preserved another way. The previous regression happened because the patch lived only inside the disposable container filesystem.


This page was last edited on 2026-07-28 05:21

Powered by Wiki|Docs

This page was last edited on 2026-07-28 05:21

MRDTECH Wiki / Engineer / Tech Enthusiast / Homelab Geek
No Copyright

Powered by Wiki|Docs