Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@ <h2 class="mb-3">{{ i18n "download_community_translations" . }}</h2>
{{- $productionLanguagesData = $productionLanguagesFile.Content | transform.Unmarshal }}
{{- end }}
{{- else }}
{{- $productionLanguagesUrl := printf "%slanguages.json?v=%d" .Site.Params.productionSiteUrl now.Unix }}
{{- $baseUrl := strings.TrimSuffix "/" .Site.Params.productionSiteUrl }}
{{- $productionLanguagesUrl := printf "%s/languages.json?v=%d" $baseUrl now.Unix }}
{{- with try (resources.GetRemote $productionLanguagesUrl) }}
{{ with .Err }}
{{ warnf "Error fetching production languages: %s" . }}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,15 @@
{{- if eq hugo.Environment "production" }}
{{- $productionLanguagesUrl = "/languages.json" }}
{{- else }}
{{- $productionLanguagesUrl = printf "%slanguages.json?v=%d" .Site.Params.productionSiteUrl now.Unix }}
{{- $baseUrl := strings.TrimSuffix "/" .Site.Params.productionSiteUrl }}
{{- $productionLanguagesUrl = printf "%s/languages.json?v=%d" $baseUrl now.Unix }}
{{- end }}

{{- if eq hugo.Environment "preview" }}
{{- $previewLanguagesUrl = "/languages.json" }}
{{- else }}
{{- $previewLanguagesUrl = printf "%slanguages.json?v=%d" .Site.Params.previewSiteUrl now.Unix }}
{{- $baseUrl := strings.TrimSuffix "/" .Site.Params.previewSiteUrl }}
{{- $previewLanguagesUrl = printf "%s/languages.json?v=%d" $baseUrl now.Unix }}
{{- end }}

{{/* Load production languages */}}
Expand Down
2 changes: 2 additions & 0 deletions serve.ps1
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Remove-Item -Recurse -Force .\public\
hugo serve --source site --config hugo.yaml, hugo.local.yaml
2 changes: 0 additions & 2 deletions site/content/Guide1/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
2 changes: 0 additions & 2 deletions site/content/Guide1/_index.min.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
2 changes: 1 addition & 1 deletion site/content/Guide1/translations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@ description: Originals & Translations of Guide 1
aliases:
- /downloads/
- /download/
- /translationsdirectory/
- /translations/
---
2 changes: 0 additions & 2 deletions site/content/Guide2/2025.7/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,6 @@ sansfont: "Arial"
monofont: "Courier New"
sitemap:
priority: 1.0
aliases:
- /guide-2/latest/
---

Guide 2 - Extended Edition
Expand Down
2 changes: 0 additions & 2 deletions site/content/Guide2/2025.7/index.min.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion site/content/Guide2/translations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,5 +6,5 @@ Type: "guide"
aliases:
- /downloads/
- /download/
- /translationsdirectory/
- /translations/
---
1 change: 0 additions & 1 deletion site/content/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
---
title: "Guides Site"
url: "/"
not_sure_which_to_use: |
This is the big guides site
---
1 change: 0 additions & 1 deletion site/content/_index.min.md
Original file line number Diff line number Diff line change
@@ -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!

Expand Down
6 changes: 5 additions & 1 deletion site/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,8 @@ 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/ScrumGuides/ScrumGuide-ExpansionPack/site v0.0.0-20250801110201-076bbcf543d8 // indirect
github.com/nkdAgility/HugoGuides/module v0.7.2 // indirect
)
6 changes: 6 additions & 0 deletions site/go.sum
Original file line number Diff line number Diff line change
@@ -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=
18 changes: 18 additions & 0 deletions site/hugo.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -77,6 +87,14 @@ outputFormats:

module:
imports:
- path: github.com/ScrumGuides/ScrumGuide-ExpansionPack/site
mounts:
- source: content
target: content
- path: github.com/KanbanGuides/KanbanGuides/site
mounts:
- source: content
target: content
- path: github.com/nkdAgility/HugoGuides/module
replacements:
- github.com/nkdAgility/HugoGuides/module -> ../../module
Expand Down
144 changes: 144 additions & 0 deletions site/layouts/index.html
Original file line number Diff line number Diff line change
@@ -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 }}