From dd294db10b1159f5d2e44b777bb9f1014cd1eb1e Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Mon, 16 Sep 2024 17:50:29 +0200
Subject: [PATCH] hugo: add main nav icons and fix mobile rendering
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
---
content/get-started/_index.md | 46 +++++++------
content/guides/_index.md | 49 ++++++-------
content/learning-paths/_index.md | 2 +
content/manuals/_index.md | 114 ++++++++++++++++---------------
content/reference/_index.md | 75 ++++++++++----------
hugo_stats.json | 8 +--
layouts/_default/baseof.html | 39 ++++++++---
layouts/partials/sidebar.html | 4 +-
8 files changed, 182 insertions(+), 155 deletions(-)
diff --git a/content/get-started/_index.md b/content/get-started/_index.md
index 415944ce30..e577696978 100644
--- a/content/get-started/_index.md
+++ b/content/get-started/_index.md
@@ -2,30 +2,32 @@
title: Get started
keywords: Docker, get started
description: Get started with Docker
-notoc: true
layout: wide
-get-started:
-- title: Get Docker
- description: Choose the best installation path for your setup.
- link: /get-started/get-docker/
+params:
icon: download
-- title: What is Docker?
- description: Learn about the Docker platform.
- link: /get-started/docker-overview/
- icon: summarize
-get-started2:
-- title: Introduction
- description: Get started with the basics and the benefits of containerizing your applications.
- link: /get-started/introduction/
- icon: rocket
-- title: Docker concepts
- description: Gain a better understanding of foundational Docker concepts.
- link: /get-started/docker-concepts/the-basics/what-is-a-container/
- icon: foundation
-- title: Docker workshop
- description: Get guided through a 45-minute workshop to learn about Docker.
- link: /get-started/workshop/
- icon: desk
+ notoc: true
+ get-started:
+ - title: Get Docker
+ description: Choose the best installation path for your setup.
+ link: /get-started/get-docker/
+ icon: download
+ - title: What is Docker?
+ description: Learn about the Docker platform.
+ link: /get-started/docker-overview/
+ icon: summarize
+ get-started2:
+ - title: Introduction
+ description: Get started with the basics and the benefits of containerizing your applications.
+ link: /get-started/introduction/
+ icon: rocket
+ - title: Docker concepts
+ description: Gain a better understanding of foundational Docker concepts.
+ link: /get-started/docker-concepts/the-basics/what-is-a-container/
+ icon: foundation
+ - title: Docker workshop
+ description: Get guided through a 45-minute workshop to learn about Docker.
+ link: /get-started/workshop/
+ icon: desk
---
If you're new to Docker, this section guides you through the essential resources to get started.
diff --git a/content/guides/_index.md b/content/guides/_index.md
index 66ddd904d2..7731143cd2 100644
--- a/content/guides/_index.md
+++ b/content/guides/_index.md
@@ -2,31 +2,32 @@
title: Guides
keywords: Docker guides
description: Explore the Docker guides
-notoc: true
+params:
+ icon: developer_guide
+ notoc: true
+ dive-deeper:
+ - title: Language-specific guides
+ description: Learn how to containerize, develop, and test language-specific apps using Docker.
+ link: /language/
+ icon: code
+ - title: Use-case guides
+ description: Walk through practical Docker applications for specific scenarios.
+ link: /guides/use-case/
+ icon: task
+ - title: Deployment and Orchestration
+ description: Deploy and manage Docker containers at scale.
+ link: /guides/deployment-orchestration/orchestration/
+ icon: workspaces
+ resources:
+ - title: Educational resources
+ description: Explore diverse Docker training and hands-on experiences.
+ link: /guides/resources/
+ icon: book
+ - title: Contribute to Docker's docs
+ description: Learn how to help contribute to Docker docs.
+ link: /contribute/
+ icon: edit
layout: wide
-dive-deeper:
-- title: Language-specific guides
- description: Learn how to containerize, develop, and test language-specific apps using Docker.
- link: /language/
- icon: code
-- title: Use-case guides
- description: Walk through practical Docker applications for specific scenarios.
- link: /guides/use-case/
- icon: task
-- title: Deployment and Orchestration
- description: Deploy and manage Docker containers at scale.
- link: /guides/deployment-orchestration/orchestration/
- icon: workspaces
-
-resources:
-- title: Educational resources
- description: Explore diverse Docker training and hands-on experiences.
- link: /guides/resources/
- icon: book
-- title: Contribute to Docker's docs
- description: Learn how to help contribute to Docker docs.
- link: /contribute/
- icon: edit
---
This section contains more advanced guides to help you learn how Docker can optimize your development workflows.
diff --git a/content/learning-paths/_index.md b/content/learning-paths/_index.md
index 04236d6d1d..f7abdf3cb6 100644
--- a/content/learning-paths/_index.md
+++ b/content/learning-paths/_index.md
@@ -3,6 +3,8 @@ title: Learning paths
description: |
Docker Learning Paths offer structured guides to help you master Docker.
keywords: docker, learning, paths, tutorials, resources
+params:
+ icon: "school"
---
diff --git a/content/manuals/_index.md b/content/manuals/_index.md
index 22d4256719..30f8876f01 100644
--- a/content/manuals/_index.md
+++ b/content/manuals/_index.md
@@ -5,62 +5,64 @@ keywords: docker, docs, manuals, products, user guides, how-to
# hard-code the URL of this page
url: /manuals/
layout: wide
-notoc: true
-development:
-- title: Docker Desktop
- description: Your command center for container development.
- icon: /assets/icons/Whale.svg
- link: /desktop/
-- title: Docker Compose
- description: Define and run multi-container applications.
- icon: /assets/icons/Compose.svg
- link: /compose/
-- title: Docker Build
- description: Build and ship any application anywhere.
- icon: build
- link: /build/
-- title: Docker Engine
- description: The industry-leading container runtime.
- icon: developer_board
- link: /engine/
-- title: Docker Extensions
- description: Customize your Docker Desktop workflow.
- icon: extension
- link: /extensions/
-services:
-- title: Docker Hub
- description: Discover, share, and integrate container images
- icon: hub
- link: /docker-hub/
-- title: Docker Scout
- description: Image analysis and policy evaluation.
- icon: /assets/icons/Scout.svg
- link: /scout/
-- title: Trusted content
- description: Curated, high-quality content from trusted sources.
- icon: verified
- link: /trusted-content/
-- title: Build Cloud
- description: Build your images faster in the cloud.
- icon: /assets/images/logo-build-cloud.svg
- link: /build-cloud/
-admin:
-- title: Administration
- description: Centralized observability for companies and organizations.
- icon: admin_panel_settings
- link: /admin/
-- title: Security
- description: Security guardrails for both administrators and developers.
- icon: lock
- link: /security/
-- title: Billing
- description: Manage billing and payment methods.
- icon: payments
- link: /billing/
-- title: Subscription
- description: Commercial use licenses for Docker products.
- icon: card_membership
- link: /subscription/
+params:
+ icon: description
+ notoc: true
+ development:
+ - title: Docker Desktop
+ description: Your command center for container development.
+ icon: /assets/icons/Whale.svg
+ link: /desktop/
+ - title: Docker Compose
+ description: Define and run multi-container applications.
+ icon: /assets/icons/Compose.svg
+ link: /compose/
+ - title: Docker Build
+ description: Build and ship any application anywhere.
+ icon: build
+ link: /build/
+ - title: Docker Engine
+ description: The industry-leading container runtime.
+ icon: developer_board
+ link: /engine/
+ - title: Docker Extensions
+ description: Customize your Docker Desktop workflow.
+ icon: extension
+ link: /extensions/
+ services:
+ - title: Docker Hub
+ description: Discover, share, and integrate container images
+ icon: hub
+ link: /docker-hub/
+ - title: Docker Scout
+ description: Image analysis and policy evaluation.
+ icon: /assets/icons/Scout.svg
+ link: /scout/
+ - title: Trusted content
+ description: Curated, high-quality content from trusted sources.
+ icon: verified
+ link: /trusted-content/
+ - title: Build Cloud
+ description: Build your images faster in the cloud.
+ icon: /assets/images/logo-build-cloud.svg
+ link: /build-cloud/
+ admin:
+ - title: Administration
+ description: Centralized observability for companies and organizations.
+ icon: admin_panel_settings
+ link: /admin/
+ - title: Security
+ description: Security guardrails for both administrators and developers.
+ icon: lock
+ link: /security/
+ - title: Billing
+ description: Manage billing and payment methods.
+ icon: payments
+ link: /billing/
+ - title: Subscription
+ description: Commercial use licenses for Docker products.
+ icon: card_membership
+ link: /subscription/
---
This section contains user guides on how to install, set up, configure, and use
diff --git a/content/reference/_index.md b/content/reference/_index.md
index 41716204f7..b0b093cd70 100644
--- a/content/reference/_index.md
+++ b/content/reference/_index.md
@@ -1,44 +1,47 @@
---
title: Reference documentation
+linkTitle: Reference
layout: wide
description: Find reference documentation for the Docker platform’s various APIs, CLIs, and file formats
-notoc: true
-grid_files:
-- title: Dockerfile
- description: Defines the contents and startup behavior of a single container.
- icon: edit_document
- link: /reference/dockerfile/
-- title: Compose file
- description: Defines a multi-container application.
- icon: polyline
- link: /reference/compose-file/
-grid_clis:
-- title: Docker CLI
- description: The main Docker CLI, includes all `docker` commands.
+params:
icon: terminal
- link: /reference/cli/docker/
-- title: Compose CLI
- description: The CLI for Docker Compose, for building and running multi-container
- applications.
- icon: subtitles
- link: /reference/cli/docker/compose/
-- title: Daemon CLI (dockerd)
- description: Persistent process that manages containers.
- icon: developer_board
- link: /reference/cli/dockerd/
-grid_apis:
-- title: Engine API
- description: The main API for Docker, provides programmatic access to a daemon.
- icon: api
- link: /reference/api/engine/
-- title: Docker Hub API
- description: API to interact with Docker Hub.
- icon: communities
- link: /reference/api/hub/latest/
-- title: DVP Data API
- description: API for Docker Verified Publishers to fetch analytics data.
- icon: area_chart
- link: /reference/api/hub/dvp/
+ notoc: true
+ grid_files:
+ - title: Dockerfile
+ description: Defines the contents and startup behavior of a single container.
+ icon: edit_document
+ link: /reference/dockerfile/
+ - title: Compose file
+ description: Defines a multi-container application.
+ icon: polyline
+ link: /reference/compose-file/
+ grid_clis:
+ - title: Docker CLI
+ description: The main Docker CLI, includes all `docker` commands.
+ icon: terminal
+ link: /reference/cli/docker/
+ - title: Compose CLI
+ description: The CLI for Docker Compose, for building and running multi-container
+ applications.
+ icon: subtitles
+ link: /reference/cli/docker/compose/
+ - title: Daemon CLI (dockerd)
+ description: Persistent process that manages containers.
+ icon: developer_board
+ link: /reference/cli/dockerd/
+ grid_apis:
+ - title: Engine API
+ description: The main API for Docker, provides programmatic access to a daemon.
+ icon: api
+ link: /reference/api/engine/
+ - title: Docker Hub API
+ description: API to interact with Docker Hub.
+ icon: communities
+ link: /reference/api/hub/latest/
+ - title: DVP Data API
+ description: API for Docker Verified Publishers to fetch analytics data.
+ icon: area_chart
+ link: /reference/api/hub/dvp/
---
This section includes the reference documentation for the Docker platform's
diff --git a/hugo_stats.json b/hugo_stats.json
index b1158cb9c1..fab35754bc 100644
--- a/hugo_stats.json
+++ b/hugo_stats.json
@@ -234,6 +234,7 @@
"dark:hover:bg-blue-dark-500",
"dark:hover:bg-gray-dark-200",
"dark:hover:bg-gray-dark-500",
+ "dark:hover:text-blue-dark",
"dark:hover:text-white",
"dark:prose-invert",
"dark:ring-gray-dark-400",
@@ -379,7 +380,9 @@
"md:max-w-[66%]",
"md:px-20",
"md:scale-100",
+ "md:sticky",
"md:text-sm",
+ "md:top-16",
"md:w-[300px]",
"md:z-auto",
"min-h-screen",
@@ -426,6 +429,7 @@
"pl-5",
"place-items-center",
"placeholder:text-white",
+ "pr-2",
"prose",
"pt-0",
"px-1",
@@ -445,7 +449,6 @@
"right-8",
"ring-[1.5px]",
"ring-gray-light-200",
- "rotate-180",
"rotate-45",
"rounded",
"rounded-[6px]",
@@ -470,7 +473,6 @@
"sm:items-center",
"sm:w-full",
"space-x-2",
- "space-y-2",
"space-y-4",
"sticky",
"svg-container",
@@ -513,9 +515,7 @@
"top-3",
"top-6",
"top-full",
- "transform",
"transition",
- "transition-transform",
"truncate",
"underline",
"underline-offset-2",
diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html
index b5815ccda6..3083fe64db 100644
--- a/layouts/_default/baseof.html
+++ b/layouts/_default/baseof.html
@@ -11,7 +11,7 @@
-
-
-
{{ .FirstSection.LinkTitle }}
+
diff --git a/layouts/partials/sidebar.html b/layouts/partials/sidebar.html
index 6ccf588944..693ebb4fcb 100644
--- a/layouts/partials/sidebar.html
+++ b/layouts/partials/sidebar.html
@@ -63,7 +63,7 @@
{{ define "renderSingle" }}
{{- if .Params.goto }}
-
+
@@ -72,7 +72,7 @@
{{- else }}
{{ $isCurrent := eq page . }}
-