hns-oss-docs-structure-map

Maps Hugo geekdoc docs-site structure including menus, locales, icons, and Vercel redirects.

1.2k|222|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/modu-ai/moai-adk --skill hns-oss-docs-structure-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hns-oss-docs-structure-map
Source: https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-structure-map
Command: npx skills add https://github.com/modu-ai/moai-adk --skill hns-oss-docs-structure-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Editing a multilingual Hugo documentation site without knowing its exact file layout causes silent defects like empty menu icons, broken redirects, and divergent locale trees. This Skill gives the structure-curator agent an authoritative map of every config surface before any navigation or config edit.

Core Features & Use Cases

  • Complete Path Map: Documents exact locations for hugo.toml, per-locale content trees, _meta.yaml section ordering, data/menu/main.yaml sidebar entries, shortcodes, and CSS files.
  • Icon Coupling Enforcement: Defines the hard rule that every icon value in main.yaml must have a matching SVG case in layouts/partials/menu.html, with a grep verification command.
  • Redirect Patterns: Provides the required dual-entry vercel.json redirect pattern covering locale-prefixed and bare paths for moved pages.
  • Use Case: Before renaming a docs section across the ko/en/ja/zh locale trees, load this map to know all four _meta.yaml files, the menu entry schema, and the redirect entries that must change together.

Quick Start

Load the docs-site structure map before editing any navigation, menu, or Hugo config file in the docs-site directory.

Frequently Asked Questions about hns-oss-docs-structure-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit the sidebar menu in a Hugo geekdoc site?

Edit data/menu/main.yaml, where each entry carries a 4-locale name map (ko, en, ja, zh), a ref path, and an icon value. Menu edits are manual since the legacy gen_menu.py script does not exist.

Why does my Hugo menu icon render as an empty SVG?

Every icon value in main.yaml must have a matching case in the SVG switch inside layouts/partials/menu.html. An unmatched value renders an empty svg with no build warning, so grep the partial for the icon value after any icon edit.

How do I add redirects in vercel.json for moved docs pages?

Add two entries per moved page: one matching locale-prefixed paths like /:locale(ko|en|ja|zh)/old-path, and one matching the bare /old-path redirecting to the default ko locale. Only the redirects array is editable.

Does section ordering need changes in multiple files for multilingual Hugo sites?

Yes. Section order lives in content/<locale>/_meta.yaml per locale, so a section change must land in all four locale files (ko, en, ja, zh) to keep the mirrored trees consistent.

How do I verify a Hugo docs site builds without config errors?

Run hugo --minify --gc from the docs-site directory and confirm it completes warning-free. Malformed _meta.yaml files or menu entries surface as build warnings or errors at this step.