Add initial implementation of site structure and content updates

MrHinsh · MrHinsh · commit ca0887e24bc6 · 2025-08-07T08:56:28.000+01:00
diff --git a/serve.ps1 b/serve.ps1
@@ -0,0 +1,2 @@
+Remove-Item -Recurse -Force .\public\
+hugo serve --source site --config hugo.yaml, hugo.local.yaml 
diff --git a/site/content/Guide1/_index.md b/site/content/Guide1/_index.md
@@ -33,6 +33,4 @@ layman_description: |
   [Guide 1](/guide-1/latest) is a short and clear handbook that explains how to manage work effectively. It helps team members visualize what they're working on, avoid multitasking, and deliver more reliably. It's written to be easy to follow, with just the essentials. Perfect for any team that wants a simple way to organize work and improve flow.
 practitioner_description: |
   [Guide 1](/guide-1/latest) is the official, succinct manual for work management in knowledge work. It outlines strategies for optimizing the flow of value through a process, using three core practices: visualizing workflow, actively managing work items, and continuously improving the workflow. It defines a minimal set of required elements and flow metrics. This guide is ideal for establishing a shared understanding of fundamentals in teams or organizations, especially where simplicity, stability, and clarity are essential.
-aliases:
-  - /guide1/latest
 ---
diff --git a/site/content/Guide1/_index.min.md b/site/content/Guide1/_index.min.md
@@ -40,6 +40,4 @@ layman_description: |
 
 practitioner_description: |
   [Da Guide 1](/min/guide-1/latest) is da pro banana booky. Say how to flow da value like a river of pudding. Got da 3 big things: see da work, manage da work, fix da work. All clean, all shiny. If you need clear, stable, no-headache work stuff, dis da one.
-aliases:
-  - /guide-1/latest
 ---
diff --git a/site/content/Guide1/translations/index.md b/site/content/Guide1/translations/index.md
@@ -6,5 +6,5 @@ description: Originals & Translations of Guide 1
 aliases:
   - /downloads/
   - /download/
-  - /translationsdirectory/
+  - /translations/
 ---
diff --git a/site/content/Guide2/2025.7/index.md b/site/content/Guide2/2025.7/index.md
@@ -15,8 +15,6 @@ sansfont: "Arial"
 monofont: "Courier New"
 sitemap:
   priority: 1.0
-aliases:
-  - /guide-2/latest/
 ---
 
 Guide 2 - Extended Edition
diff --git a/site/content/Guide2/2025.7/index.min.md b/site/content/Guide2/2025.7/index.min.md
@@ -18,8 +18,6 @@ sansfont: "Ari-Banana"
 monofont: "Courier Peel"
 sitemap:
   priority: 1.0
-aliases:
-  - /guide-2/latest/
 ---
 
 Guide 2 Banana Booky – For Smart Worky Stuff
diff --git a/site/content/Guide2/translations/index.md b/site/content/Guide2/translations/index.md
@@ -6,5 +6,5 @@ Type: "guide"
 aliases:
   - /downloads/
   - /download/
-  - /translationsdirectory/
+  - /translations/
 ---
diff --git a/site/content/_index.md b/site/content/_index.md
@@ -1,6 +1,5 @@
 ---
 title: "Guides Site"
-url: "/"
 not_sure_which_to_use: |
   This is the big guides site
 ---
diff --git a/site/content/_index.min.md b/site/content/_index.min.md
@@ -1,6 +1,5 @@
 ---
 title: "Banana Guide Bookies"
-url: "/"
 not_sure_which_to_use: |
   New to work stuff? Go go [Da Guide 1](/guide-1/latest) first-y!
 
diff --git a/site/go.mod b/site/go.mod
@@ -2,4 +2,7 @@ module github.com/nkdAgility/HugoGuides/site
 
 go 1.24.5
 
-require github.com/nkdAgility/HugoGuides/module v0.6.4 // indirect
+require (
+	github.com/KanbanGuides/KanbanGuides/site v0.0.0-20250807073058-1fb088304516 // indirect
+	github.com/nkdAgility/HugoGuides/module v0.7.2 // indirect
+)
diff --git a/site/go.sum b/site/go.sum
@@ -1,2 +1,8 @@
+github.com/KanbanGuides/KanbanGuides/site v0.0.0-20250807073058-1fb088304516 h1:bQ4DavaR+iSUnp08SEGOJX8QF9gPKBiemz4Hcxmz4hw=
+github.com/KanbanGuides/KanbanGuides/site v0.0.0-20250807073058-1fb088304516/go.mod h1:9SBjS7dL3fK2jPW/8vSRTH5Z3uogJHgV4P8cHF733c4=
+github.com/ScrumGuides/ScrumGuide-ExpansionPack/site v0.0.0-20250801110201-076bbcf543d8 h1:ZQbyJ44DJ7WCTqYtQp8MiVmPi+IW47C+1RU3PV1Eq+M=
+github.com/ScrumGuides/ScrumGuide-ExpansionPack/site v0.0.0-20250801110201-076bbcf543d8/go.mod h1:MplyV/zE4iA2b3ixo6kX8HUwn0kb8Gjts6JP8qedhww=
 github.com/nkdAgility/HugoGuides/module v0.6.4 h1:5MCak7zvxEJ9N0S6C74s22QNqhsiOoX2NMJ7tfMfOwk=
 github.com/nkdAgility/HugoGuides/module v0.6.4/go.mod h1:VGUy7t0I5Ba4FWVFpuBzVI1RN/cOBvcWSeYGsAj37tE=
+github.com/nkdAgility/HugoGuides/module v0.7.2 h1:eKkwj7p2r9+CpR7axltRWOX5KPJlhN3UQcVmhsOr8Zc=
+github.com/nkdAgility/HugoGuides/module v0.7.2/go.mod h1:VGUy7t0I5Ba4FWVFpuBzVI1RN/cOBvcWSeYGsAj37tE=
diff --git a/site/hugo.yaml b/site/hugo.yaml
@@ -24,6 +24,16 @@ languages:
       description: Bello! Banana Guides para banana work!
       keywords: Banana
       status: reference
+  ja:
+    languageName: Japanese
+    weight: 2
+    # title: Open Guide to Kanban <- 英語がKanban Guidesのため、ここは日本語のカンバンガイドに合わせる
+    title: カンバンガイド
+    params:
+      # description: The Open Guide to Kanban is a free, community-driven reference for applying Kanban in knowledge work. It defines the core practices, metrics, and principles necessary to improve flow, optimise value delivery, and enhance team sustainability. This guide supports scalable Kanban implementations across diverse industries and complements other agile, lean, and flow-based approaches.
+      description: オープン版カンバンガイドは、ナレッジワークにカンバンを適用するためのコミュニティ主体の無料のリファレンスです。フローを改善し、価値提供を最適化し、チームの持続可能性を向上させるために必要なコアプラクティス、計測指標、および原則を定義しています。このガイドは、多様な業界でのスケーラブルなカンバンの導入を支援し、他のアジャイル、リーン、およびフローに基づくアプローチを補完するものです。
+      # keywords: Kanban, Open Guide to Kanban, kanban guide, kanban method, knowledge work, flow optimisation, WIP limits, value delivery, agile, lean, continuous improvement, service level expectation, cumulative flow, throughput, metrics, work item age, flow efficiency, visualisation, work in progress, process improvement, kanban board, definition of workflow, outcome-oriented delivery
+      keywords: カンバン, オープン版カンバンガイド, カンバンガイド, カンバン手法, ナレッジワーク, フロー最適化, WIP制限, 価値提供, アジャイル, リーン, 継続的改善, サービスレベル期待値, 累積フロー, スループット, 計測指標, 作業項目の年齢, フロー効率, 可視化, 進行中の作業, プロセス改善, カンバンボード, ワークフローの定義, アウトカム指向の提供
 
 summaryLength: 30
 
@@ -77,6 +87,8 @@ outputFormats:
 
 module:
   imports:
+    #- path: github.com/ScrumGuides/ScrumGuide-ExpansionPack/site
+    - path: github.com/KanbanGuides/KanbanGuides/site
     - path: github.com/nkdAgility/HugoGuides/module
   replacements:
     - github.com/nkdAgility/HugoGuides/module -> ../../module
diff --git a/site/layouts/index.html b/site/layouts/index.html
@@ -0,0 +1,144 @@
+{{- define "main" }}
+  <!-- Hero Section with lighter background -->
+  <section class="section container-fluid" style="background: linear-gradient(135deg, #f8f9fa 0%, #e9ecef 100%);">
+    <div class="container py-5">
+      <div class="row justify-content-center">
+        <div class="col-12 text-center mb-5">
+          <h1 class="display-4 text-dark mb-4">{{ .Site.Title }}</h1>
+          <p class="lead text-muted fs-5">{{ i18n "guides_intro_text" . }}</p>
+        </div>
+      </div>
+
+      <!-- Guide Cards with lighter design -->
+      <div class="row">
+        {{ $sections := .Site.Sections }}
+        {{ range .Site.Home.Translations }}
+          {{ $sections = $sections | lang.Merge .Site.Sections }}
+        {{ end }}
+        {{/* {{ $sections = lang.Merge $defaultSite.sections $sections }} */}}
+        {{- range $sections.ByWeight }}
+          <div class="col-12 col-lg-6 col-xl-6 p-3">
+            <div class="card h-100 shadow-sm border-0" style="background: #ffffff;">
+              <div class="card-header bg-white border-0 text-center py-3">
+                <h5 class="card-title mb-2 text-dark">{{ .Params.short_title | default .Title }}</h5>
+                <div class="mx-auto rounded" style="height: 4px; width: 60px; background-color: {{ .Params.brand.bg_colour | default "#135289" }};"></div>
+              </div>
+              <div class="card-body d-flex flex-column p-4">
+                <p class="flex-grow-1 text-muted">{{ .Params.which_to_use_summary | markdownify }}</p>
+
+                <!-- Action buttons with more inviting design -->
+                <div class="d-flex flex-wrap gap-2 justify-content-center py-3">
+                  {{- $latestVersion := partial "functions/get-latest-version" . }}
+                  <a href="{{ partial "functions/safe-page-link.html" .Path }}" class="btn btn-primary btn-sm px-3">
+                    <i class="fa-solid fa-book-open me-2"></i>{{ i18n "read_online_button" . }}
+                  </a>
+                  <a href="{{ partial "functions/safe-page-link.html"  (path.Join .Path "translations") }}" class="btn btn-outline-secondary btn-sm px-3">
+                    <i class="fa-solid fa-globe me-2"></i>{{ i18n "translations_button" . }}
+                  </a>
+                  <a href="{{ partial "functions/safe-page-link.html" (path.Join .Path "history") }}" class="btn btn-outline-secondary btn-sm px-3">
+                    <i class="fa-solid fa-clock-rotate-left me-2"></i>{{ i18n "history_button" . }}
+                  </a>
+                </div>
+
+                <!-- Comparison details with better visual hierarchy -->
+                {{- if .Params.guide_comparison }}
+                  {{- $guideComparison := .Params.guide_comparison }}
+                  {{- if and $guideComparison (reflect.IsSlice $guideComparison) (gt (len $guideComparison) 0) }}
+                    <div class="mt-3 p-3 rounded" style="background-color: #f8f9fa;">
+                      <h6 class="text-primary mb-3 fw-bold text-center"><i class="fa-solid fa-list-check me-2"></i>{{ i18n "at_a_glance_title" . }}</h6>
+                      <div class="small">
+                        {{- range $index, $item := $guideComparison }}
+                          <div class="row {{ if eq $index (sub (len $guideComparison) 1) }}mb-0{{ else }}mb-2{{ end }}">
+                            <div class="col-5 text-end fw-semibold text-secondary">{{ $item.title | title }}:</div>
+                            <div class="col-7 text-dark">{{ $item.content | markdownify }}</div>
+                          </div>
+                        {{- end }}
+                      </div>
+                    </div>
+                  {{- end }}
+                {{- end }}
+              </div>
+            </div>
+          </div>
+        {{- end }}
+      </div>
+
+      <!-- Information Cards - Two left, One right -->
+      <div class="row justify-content-center mt-5 mb-4 g-3">
+        <!-- Left Column: Two stacked cards -->
+        <div class="col-12 col-lg-6 d-flex flex-column">
+          <!-- Not Sure Which to Use Card -->
+          <div class="card shadow-sm border-0 mb-3 flex-fill" style="background: linear-gradient(45deg, #fff3cd 0%, #f8f9fa 100%);">
+            <div class="card-header bg-transparent border-0 text-center py-3">
+              <h3 class="card-title mb-0 text-primary">
+                <i class="fa-solid fa-compass me-2"></i>
+                {{ i18n "not_sure_which_to_use_title" . }}
+              </h3>
+            </div>
+            <div class="card-body text-center px-4 pb-4">
+              <div class="fs-6 text-dark">
+                {{ .Params.not_sure_which_to_use | markdownify }}
+              </div>
+            </div>
+          </div>
+
+          <!-- What are the Guides Card -->
+          <div class="card shadow-sm border-0 flex-fill" style="background: linear-gradient(45deg, #f0f9ff 0%, #f8f9fa 100%);">
+            <div class="card-header bg-transparent border-0 text-center py-3">
+              <h3 class="card-title mb-0 text-primary">
+                <i class="fa-solid fa-question-circle me-2"></i>
+                {{ i18n "what_is_guides_title" . }}
+              </h3>
+            </div>
+            <div class="card-body text-center px-4 pb-4">
+              <div class="text-muted">
+                {{ .Site.Params.description | markdownify }}
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <!-- Right Column: Open Source & Community Card -->
+        <div class="col-12 col-lg-6">
+          <div class="card shadow-sm border-0 h-100" style="background: linear-gradient(45deg, #e3f2fd 0%, #f8f9fa 100%);">
+            <div class="card-header bg-transparent border-0 text-center py-3">
+              <h3 class="card-title mb-0 text-primary">
+                <i class="fa-solid fa-users me-2"></i>
+                {{ i18n "open_source_title" . }}
+              </h3>
+            </div>
+            <div class="card-body text-center px-4 pb-4 d-flex flex-column">
+              <p class="card-text text-muted mb-3">{{ i18n "open_source_description" . }}</p>
+              <div class="mt-auto">
+                <a href="{{ .Site.Params.githubUrl }}/discussions" class="btn btn-primary btn-lg px-4 mb-2" target="_blank">
+                  <i class="fa-solid fa-comments me-2"></i>{{ i18n "join_discussion_button" . }}
+                </a>
+              </div>
+              <h6 class="text-primary mb-3 fw-bold">{{ i18n "contributors_title" . }}</h6>
+              <p class="small text-muted">{{ i18n "contributors_description" . }}</p>
+              {{ $sections := .Site.Sections }}
+              {{ range .Site.Home.Translations }}
+                {{ $sections = $sections | lang.Merge .Site.Sections }}
+              {{ end }}
+              {{- range $sections.ByWeight }}
+                <h6 class="text-primary mb-3 fw-bold">{{ .Params.short_title | default .Title }}</h6>
+                <!-- Contributors Section -->
+                {{- $contributors := partial "functions/get-contributors.html" . -}}
+                {{- $contributors = where $contributors "role" "in" (slice "contributor" "creator") -}}
+                {{- if $contributors -}}
+                  <div class="mb-4">
+                    <div class="d-flex flex-wrap justify-content-center gap-2">
+                      {{ range sort $contributors "weight" "asc" }}
+                        {{ partial "components/guide/guide-author.html" . }}
+                      {{ end }}
+                    </div>
+                  </div>
+                {{- end -}}
+              {{- end }}
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </section>
+{{- end }}

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+Remove-Item -Recurse -Force .\public\`
	`2`	`+hugo serve --source site --config hugo.yaml, hugo.local.yaml`