Hugo Static Site Implementation Plan

Directory Structure

hugo-docs/
├── config.toml
├── content/
│   ├── _index.md
│   ├── core-planning/
│   ├── phases/
│   ├── technical/
│   └── processes/
│   └── architecture.md
├── static/
└── themes/

Configuration Outline

baseURL = "https://docs.example.com/"
title = "Nairametrics Documentation"
theme = "docsy"
paginate = 10

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true

Content Migration Strategy

1. Path Conversion:

   • docs/roadmap/start-here.md → content/_index.md
   • docs/roadmap/phases/phase-a-theme.md → content/phases/phase-a-theme.md

2. Front Matter Requirements:

   ---
   title: "Phase A: Custom WordPress Theme Redesign"
   date: 2025-10-11
   weight: 10
   description: "Implementation plan for theme redesign phase"
   ---
   

3. Navigation Menu:

   [[menu.main]]
     name = "Roadmap"
     url = "/roadmap/"
     weight = 10
   
   [[menu.main]]
     name = "Phases"
     url = "/phases/"
     weight = 20
   

Next Steps

1. Install Hugo locally
2. Initialize site with hugo new site hugo-docs
3. Add selected theme
4. Migrate content with front matter
5. Configure build process