Merge pull request #19665 from dvdksn/taxo

hugo: add tags
This commit is contained in:
David Karlsson 2024-04-23 11:05:34 +02:00 committed by GitHub
commit 25b21cfe30
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
85 changed files with 544 additions and 296 deletions

View File

@ -13,7 +13,7 @@ ENV NODE_ENV=production
RUN npm install
FROM base AS hugo
ARG HUGO_VERSION=0.122.0
ARG HUGO_VERSION=0.124.1
ARG TARGETARCH
WORKDIR /tmp/hugo
RUN wget -O "hugo.tar.gz" "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-${TARGETARCH}.tar.gz"

View File

@ -1,12 +1,6 @@
@layer components {
#TableOfContents {
nav {
@apply border-l-2 border-divider-light;
}
ul ul {
@apply pl-2;
}
a {
.toc a {
@apply block max-w-full truncate py-1 pl-2 hover:font-medium hover:no-underline;
&[aria-current="true"],
&:hover {

View File

@ -2,8 +2,10 @@
description: Company FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, company, administration, company management
title: FAQs on companies
tags: [FAQ]
aliases:
- /docker-hub/company-faqs/
- /faq/admin/company-faqs/
---
### Are existing subscriptions affected when you create a company and add organizations to it?

View File

@ -2,9 +2,11 @@
title: General FAQs for Docker accounts
description: Frequently asked Docker account and administration questions
keywords: onboarding, docker, teams, orgs, user accounts, organization accounts
tags: [FAQ]
aliases:
- /docker-hub/general-faqs/
- /docker-hub/onboarding-faqs/
- /faq/admin/general-faqs/
---
### What is a Docker ID?
@ -58,7 +60,7 @@ The organization owner can also add additional owners to help them manage users,
### Can I configure multiple SSO identity providers (IdPs) to authenticate users to a single org?
Docker SSO allows only one IdP configuration per organization. For more
information, see [Configure SSO](../../security/for-admins/single-sign-on/configure/_index.md) and [SSO FAQs](../security/single-sign-on/faqs.md).
information, see [Configure SSO](../../security/for-admins/single-sign-on/configure/_index.md) and [SSO FAQs](../../security/faqs/single-sign-on/faqs.md).
### What is a service account?

View File

@ -2,8 +2,10 @@
description: Organization FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, organizations, administration
title: FAQs on organizations
tags: [FAQ]
aliases:
- /docker-hub/organization-faqs/
- /faq/admin/organization-faqs/
---
### What if the Docker ID I want for my organization or company is taken?

View File

@ -2,6 +2,7 @@
title: Billing FAQs
description: Frequently asked questions related to billing
keywords: billing, renewal, payments, faq
tags: [FAQ]
---
For more information on billing, see [Billing and payments](_index.md).

View File

@ -2,6 +2,7 @@
title: Build secrets
description: Manage credentials and other secrets securely
keywords: build, secrets, credentials, passwords, tokens, ssh, git, auth, http
tags: [Secrets]
---
A build secret is any piece of sensitive information, such as a password or API

View File

@ -2,6 +2,7 @@
title: Using secrets with GitHub Actions
description: Example using secret mounts with GitHub Actions
keywords: ci, github actions, gha, buildkit, buildx, secret
tags: [Secrets]
---
A build secret is sensitive information, such as a password or API token, consumed as part of the build process.

View File

@ -2,6 +2,7 @@
title: Dockerfile release notes
description: Release notes for Dockerfile frontend
keywords: build, dockerfile, frontend, release notes
tags: [Release notes]
toc_max: 2
---

View File

@ -2,6 +2,7 @@
title: Build release notes
description: Release notes for Buildx
keywords: build, buildx, buildkit, release notes
tags: [Release notes]
toc_max: 2
---

View File

@ -3,6 +3,7 @@ title: Best practices for working with environment variables in Docker Compose
description: Explainer on the best ways to set, use, and manage environment variables in
Compose
keywords: compose, orchestration, environment, env file, environment variables
tags: [Best practices]
---
#### Handle sensitive information securely

View File

@ -2,6 +2,7 @@
description: Frequently asked questions for Docker Compose
keywords: documentation, docs, docker, compose, faq, docker compose vs docker-compose
title: Compose FAQs
tags: [FAQ]
---
{{< include "compose-eol.md" >}}

View File

@ -2,6 +2,7 @@
title: Docker Compose release notes
description: Release notes for Docker Compose
keywords: release notes, compose
tags: [Release notes]
toc_max: 2
aliases:
- /release-notes/docker-compose/

View File

@ -2,6 +2,7 @@
title: How to use secrets in Docker Compose
description: How to use secrets in Compose and their benefits
keywords: secrets, compose, security, environment variables
tags: [Secrets]
---
A secret is any piece of data, such as a password, certificate, or API key, that shouldnt be transmitted over a network or stored unencrypted in a Dockerfile or in your applications source code.

View File

@ -2,6 +2,7 @@
title: Troubleshooting the Docker daemon
description: Learn how to troubleshoot errors and misconfigurations in the Docker daemon
keywords: docker, daemon, configuration, troubleshooting, error, fail to start
tags: [ Troubleshooting ]
---
This page describes how to troubleshoot and debug the daemon if you run into

View File

@ -16,7 +16,7 @@ We support these broad categories of callouts:
## Examples
{{< introduced buildx 0.10.4 "../../release-notes.md#0104" >}}
{{< introduced buildx 0.10.4 >}}
> **Note**
>

View File

@ -6,37 +6,33 @@ keywords: how to use docker desktop, what is docker desktop used for, what does
title: Overview of Docker Desktop
grid:
- title: Install Docker Desktop
description: 'Install Docker Desktop on
description: |
Install Docker Desktop on
[Mac](/desktop/install/mac-install/),
[Windows](/desktop/install/windows-install/), or
[Linux](/desktop/install/linux-install/).
'
icon: download
- title: Explore Docker Desktop
description: Navigate Docker Desktop and learn about its key features.
icon: feature_search
link: /desktop/use-desktop
link: /desktop/use-desktop/
- title: View the release notes
description: Find out about new features, improvements, and bug fixes.
icon: note_add
link: /desktop/release-notes
link: /desktop/release-notes/
- title: Browse common FAQs
description: Explore general FAQs or FAQs for specific platforms.
icon: help
link: /desktop/faqs/
- title: Find additional resources
description: Find information on networking features, deploying on Kubernetes, and
more.
description: |
Find information on networking features, deploying on Kubernetes, and more.
icon: category
link: /desktop/kubernetes
link: /desktop/kubernetes/
- title: Give feedback
description: Provide feedback on Docker Desktop or Docker Desktop features.
icon: sms
link: /desktop/feedback
link: /desktop/feedback/
aliases:
- /desktop/opensource/
- /docker-for-mac/dashboard/
@ -52,17 +48,16 @@ It provides a straightforward GUI (Graphical User Interface) that lets you manag
Docker Desktop reduces the time spent on complex setups so you can focus on writing code. It takes care of port mappings, file system concerns, and other default settings, and is regularly updated with bug fixes and security updates.
{{< tabs >}}
{{< tab name="What's included in Docker Desktop?" >}}
- [Docker Engine](../engine/index.md)
- [Docker Engine](../engine/_index.md)
- Docker CLI client
- [Docker Scout](../scout/_index.md) (additional subscription may apply)
- [Docker Build](../build/index.md)
- [Docker Extensions](extensions/index.md)
- [Docker Compose](../compose/index.md)
- [Docker Content Trust](../engine/security/trust/index.md)
- [Docker Build](../build/_index.md)
- [Docker Extensions](./extensions/_index.md)
- [Docker Compose](../compose/_index.md)
- [Docker Content Trust](../engine/security/trust/_index.md)
- [Kubernetes](https://github.com/kubernetes/kubernetes/)
- [Credential Helper](https://github.com/docker/docker-credential-helpers/)

View File

@ -2,6 +2,7 @@
description: Frequently asked Docker Desktop questions for all platforms
keywords: desktop, mac, windows, faqs
title: General FAQs for Desktop
tags: [FAQ]
aliases:
- /mackit/faqs/
- /docker-for-mac/faqs/

View File

@ -2,6 +2,7 @@
description: Frequently asked questions for Docker Desktop for Linux
keywords: desktop, linux, faqs
title: FAQs for Docker Desktop for Linux
tags: [FAQ]
aliases:
- /desktop/linux/space/
---

View File

@ -2,6 +2,7 @@
description: Frequently asked questions for Docker Desktop for Mac
keywords: desktop, mac, faqs
title: FAQs for Docker Desktop for Mac
tags: [FAQ]
aliases:
- /desktop/mac/space/
- /docker-for-mac/space/

View File

@ -2,6 +2,7 @@
description: Frequently asked Docker Desktop questions for all platforms
keywords: desktop, mac, windows, faqs
title: FAQs on Docker Desktop releases
tags: [FAQ]
---
### How frequent will new releases be?

View File

@ -2,6 +2,7 @@
description: Frequently asked questions for Docker Desktop for Windows
keywords: desktop, windows, faqs
title: FAQs for Docker Desktop for Windows
tags: [FAQ]
---
### Can I use VirtualBox alongside Docker Desktop?

View File

@ -59,7 +59,7 @@ For more information on how Enhanced Container Isolation work, see [How does it
>
> Enhanced Container Isolation does not yet fully protect Docker builds,
> Kubernetes pods and Extension containers. For more information on known
> limitations and workarounds, see [FAQs](../../../faq/security/eci-faq.md).
> limitations and workarounds, see [FAQs](../../../security/faqs/eci-faq.md).
{.important }
### What host OSes / platforms is Enhanced Container Isolation supported on?
@ -87,7 +87,7 @@ To enable Enhanced Container Isolation as a developer:
> **Important**
>
> Enhanced Container Isolation does not protect containers created prior to enabling ECI. For more information on known limitations and workarounds, see [FAQs](../../../faq/security/eci-faq.md).
> Enhanced Container Isolation does not protect containers created prior to enabling ECI. For more information on known limitations and workarounds, see [FAQs](../../../security/faqs/eci-faq.md).
{ .important }
#### As an admin

View File

@ -16,7 +16,7 @@ When [Enhanced Container Isolation is enabled](index.md#how-do-i-enable-enhanced
created by users through `docker run` or `docker create` are automatically
launched using Sysbox instead of the standard OCI runc runtime. Users need not
do anything else and can continue to use containers as usual. For exceptions,
see [FAQs](../../../faq/security/eci-faq.md).
see [FAQs](../../../security/faqs/eci-faq.md).
Even containers that use the insecure `--privileged` flag can now be run
securely with Enhanced Container Isolation, such that they can no longer be used

View File

@ -2,6 +2,7 @@
description: Release notes for Docker Desktop for Mac, Linux, and Windows
keywords: Docker desktop, release notes, linux, mac, windows
title: Docker Desktop release notes
tags: [Release notes]
toc_max: 2
aliases:
- /docker-for-mac/release-notes/

View File

@ -2,6 +2,7 @@
description: Find known issues for Docker Desktop
keywords: mac, troubleshooting, known issues, Docker Desktop
title: Known issues
tags: [ Troubleshooting ]
---
{{< tabs >}}

View File

@ -13,6 +13,7 @@ aliases:
- /windows/troubleshoot/
- /docker-for-win/troubleshoot/
- /docker-for-windows/troubleshoot/
tags: [ Troubleshooting ]
---
This page contains information on how to diagnose and troubleshoot Docker Desktop, and how to check the logs.

View File

@ -3,6 +3,7 @@ description: Explore common troubleshooting topics for Docker Desktop
keywords: Linux, Mac, Windows, troubleshooting, topics, Docker Desktop
title: Troubleshoot topics for Docker Desktop
toc_max: 4
tags: [ Troubleshooting ]
---
> **Tip**

View File

@ -2,6 +2,7 @@
description: Common workarounds
keywords: linux, mac, windows, troubleshooting, workarounds, Docker Desktop
title: Workarounds for common problems
tags: [ Troubleshooting ]
---
### Reboot

View File

@ -2,6 +2,7 @@
title: Best practices
description: Best practices for using Docker Desktop with WSL 2
keywords: wsl, docker desktop, best practices
tags: [Best practices]
---
- Always use the latest version of WSL. At a minimum you must use WSL version 1.1.3.0., otherwise Docker Desktop may not work as expected. Testing, development, and documentation is based on the newest kernel versions. Older versions of WSL can cause:

View File

@ -2,6 +2,7 @@
title: Docker development best practices
description: Rules of thumb for making your life easier as a Docker application developer
keywords: application, development
tags: [Best practices]
---
The following development patterns have proven to be helpful for people

View File

@ -8,6 +8,7 @@ aliases:
- /docker-cloud/getting-started/intermediate/optimize-dockerfiles/
- /docker-cloud/tutorials/optimize-dockerfiles/
- /engine/userguide/eng-image/dockerfile_best-practices/
tags: [Best practices]
---
This topic covers recommended best practices and methods for building

View File

@ -2,6 +2,7 @@
description: Hints, tips and guidelines for writing clean, reliable Dockerfiles
keywords: parent image, images, dockerfile, best practices, hub, official image
title: General best practices for writing Dockerfiles
tags: [Best practices]
---
## Use multi-stage builds

View File

@ -4,6 +4,7 @@ description: Image security best practices guide
keywords: docker, images, containers, vulnerability, cve
aliases:
- /develop/scan-images/
tags: [Best practices]
---
You can take a few steps to improve the security of your

View File

@ -2,6 +2,7 @@
title: Troubleshoot your autobuilds
description: How to troubleshoot Automated builds
keywords: docker hub, troubleshoot, automated builds, autobuilds
tags: [ Troubleshooting ]
---
> **Note**

View File

@ -5,6 +5,7 @@ description: Learn about the new features, bug fixes, and breaking changes for D
keywords: docker hub, whats new, release notes
toc_min: 1
toc_max: 2
tags: [Release notes]
---
Here you can learn about the latest changes, new features, bug fixes, and

View File

@ -2,6 +2,7 @@
title: Troubleshoot Docker Engine installation
description: Learn how to diagnose and resolve error messages related to the Docker Engine installation.
keywords: Docker Engine, troubleshooting, error, Linux, install Docker Engine
tags: [ Troubleshooting ]
---
This page contains instructions for troubleshooting and diagnosing the Docker

View File

@ -3,6 +3,7 @@ title: Manage sensitive data with Docker secrets
description: How to securely store, retrieve, and use sensitive data with Docker services
keywords: swarm, secrets, credentials, sensitive strings, sensitive data, security,
encryption, encryption at rest
tags: [Secrets]
---
## About secrets

View File

@ -1,28 +0,0 @@
---
title: Frequently asked questions
description: Landing page to common FAQ topics
keywords: faqs, desktop, Hub, Scout, Engine, Build, Extensions
grid:
- title: Subscription
icon: contact_page
link: /subscription/faq/
- title: Billing
icon: credit_score
link: /billing/faqs/
- title: Docker account
icon: lan
link: /faq/admin/general-faqs/
- title: Enforcing Single Sign-On
icon: key
link: /single-sign-on/enforcement-faqs/
- title: Single Sign-On and IdPs
icon: checklist
link: /single-sign-on/idp-faqs/
- title: Docker Desktop
icon: explore
link: /desktop/faqs/general/
---
Explore popular FAQ topics.
{{< grid >}}

View File

@ -1,34 +0,0 @@
---
description: Release notes for Docker
keywords: docker, documentation, about, technology, understanding, release, scout, desktop, hub, compose, build, engine
title: Release notes for Docker
grid:
- title: Docker Desktop
icon: web_asset
link: /desktop/release-notes/
- title: Docker Engine
icon: developer_board
link: /engine/release-notes/
- title: Docker Compose
icon: storage
link: /compose/release-notes/
- title: Docker Build
icon: construction
link: /build/release-notes/
- title: Docker Hub
icon: widgets
link: /docker-hub/release-notes/
- title: Docker Scout (platform)
icon: query_stats
link: /scout/release-notes/platform/
- title: Docker Scout (CLI)
icon: query_stats
link: /scout/release-notes/cli/
---
Find out what's new in Docker. Release notes contain information about new
features, improvements, known issues, and bug fixes in each release. You can
find release notes for each component in the Manuals section. We suggest
that you regularly visit the release notes to learn about updates.
{{< grid >}}

View File

@ -4,6 +4,7 @@ description: Learn about the latest features of Docker Scout
keywords: docker scout, release notes, changelog, features, changes, delta, new, releases
aliases:
- /scout/release-notes/
tags: [Release notes]
---
This page contains information about the new features, improvements, known

View File

@ -3,8 +3,10 @@ title: Enhanced Container Isolation (ECI) FAQs
description: Frequently asked questions for Enhanced Container Isolation
keywords: enhanced container isolation, security, faq, sysbox, Docker Desktop
toc_max: 2
tags: [FAQ]
aliases:
- /desktop/hardened-desktop/enhanced-container-isolation/faq/
- /faq/security/eci-faq/
---
### Do I need to change the way I use Docker when ECI is switched on?

View File

@ -2,6 +2,9 @@
description: Find the answers to common security related FAQs
keywords: Docker, Docker Hub, Docker Desktop secuirty FAQs, secuirty, platform, Docker Scout, admin, security
title: General security FAQs
tags: [FAQ]
aliases:
- /faq/security/general/
---
### How do I report a vulnerability?

View File

@ -2,6 +2,9 @@
description: Find the answers to FAQs related to networking and virtualization
keywords: Docker, Docker Hub, Docker Desktop secuirty FAQs, secuirty, platform, networks, vms
title: Network and VM FAQs
tags: [FAQ]
aliases:
- /faq/security/networking-and-vms/
---
### How can I limit the type of internet access allowed by the container when it runs, to prevent it from being able to exfiltrate data or download malicious code?

View File

@ -2,8 +2,10 @@
description: Single Sign-on domain FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, domains, domain verification
title: Domains
tags: [FAQ]
aliases:
- /single-sign-on/domain-faqs/
- /faq/security/single-sign-on/domain-faqs/
---
### Can I add sub-domains?

View File

@ -2,8 +2,10 @@
description: Single Sign-on enforcement FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, enforce SSO, SSO enforcement
title: Enforcement
tags: [FAQ]
aliases:
- /single-sign-on/enforcement-faqs/
- /faq/security/single-sign-on/enforcement-faqs/
---
### We currently have a Docker Team subscription. How do we enable SSO?

View File

@ -2,8 +2,10 @@
description: Single Sign-on FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, administration, security
title: General FAQs on SSO
tags: [FAQ]
aliases:
- /single-sign-on/faqs/
- /faq/security/single-sign-on/faqs/
---
### Is Docker SSO available for all paid subscriptions?

View File

@ -2,8 +2,10 @@
description: Single Sign-on IdP FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, IdP
title: Identity providers
tags: [FAQ]
aliases:
- /single-sign-on/idp-faqs/
- /faq/security/single-sign-on/idp-faqs/
---
### Is it possible to use more than one IdP with Docker SSO?

View File

@ -2,8 +2,10 @@
description: Single Sign-on SAML FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on, SAML
title: SAML
tags: [FAQ]
aliases:
- /single-sign-on/saml-faqs/
- /faq/security/single-sign-on/saml-faqs/
---
### Does SAML authentication require additional attributes?

View File

@ -2,8 +2,10 @@
description: Single Sign-on user management FAQs
keywords: Docker, Docker Hub, SSO FAQs, single sign-on
title: Manage users
tags: [FAQ]
aliases:
- /single-sign-on/users-faqs/
- /faq/security/single-sign-on/users-faqs/
---
### How do I manage users when using SSO?

View File

@ -37,4 +37,4 @@ In addition, you should add all email addresses to your IdP.
## What's next?
- Start [configuring SSO](configure/_index.md) in Docker
- Explore the [FAQs](../../../faq/security/single-sign-on/faqs.md)
- Explore the [FAQs](../../../security/faqs/single-sign-on/faqs.md)

View File

@ -4,6 +4,7 @@ keywords: cadvisor, troubleshooting, volumes, bind-mounts
title: Troubleshoot storage errors
aliases:
- /engine/admin/troubleshooting_volume_errors/
tags: [ Troubleshooting ]
---
This topic discusses errors which may occur when you use Docker volumes or bind

View File

@ -2,6 +2,7 @@
description: FAQs on Docker subscriptions
keywords: Docker, Docker Hub, subscription FAQs, subscription, platform
title: Subscription FAQs
tags: [FAQ]
---
For more information on Docker subscriptions, see [Docker subscription overview](_index.md).

View File

@ -98,10 +98,4 @@ For more information, see [Docker Data Processing Agreement](https://www.docker.
Before seeking support, you can perform basic troubleshooting. See [Diagnose and troubleshooting](../desktop/troubleshoot/overview.md) for more information.
You can also see if an answer already exists in the following FAQs:
- [Docker Business or Team onboarding](faq/admin/general-faqs.md)
- [Docker Desktop](../desktop/faqs/general.md)
- [Docker Desktop for Linux](../desktop/faqs/linuxfaqs.md)
- [Docker Desktop for Mac](../desktop/faqs/macfaqs.md)
- [Docker Desktop for Windows](../desktop/faqs/windowsfaqs.md)
- [Single Sign-on](faq/security/single-sign-on/faqs.md)
You can also see if an answer already exists in the [FAQs](/tags/faq/).

5
content/tags/_index.md Normal file
View File

@ -0,0 +1,5 @@
---
title: Tags
---
Here you can browse Docker docs by tag.

View File

@ -0,0 +1,8 @@
---
title: Best practices
icon: star
description: Optimal patterns for Docker
---
Best practices articles describe methods and techniques that are generally
the most idiomatic and optimized way to do something.

View File

@ -0,0 +1,9 @@
---
title: FAQ
icon: quiz
description: Frequently asked questions
---
FAQs contain frequently asked questions about all things Docker, from accounts
and administration to organization management, Docker Desktop, Docker Compose,
and more.

View File

@ -0,0 +1,10 @@
---
title: Release notes
icon: note_stack_add
description: Find out about the latest features
aliases:
- /release-notes/
---
Release notes describe corrections, changes or enhancements made to a product
product in a given release.

View File

@ -0,0 +1,11 @@
---
title: Secrets
icon: password
description: Use sensitive information in containers securely
---
A secret is a piece of data, such as a password, SSH private key, SSL
certificate, or anything that should not be transmitted over a network or
stored unencrypted in a Dockerfile or in your application's source code.
Docker provides specially designated features for managing secrets.

View File

@ -0,0 +1,8 @@
---
title: Troubleshooting
icon: troubleshoot
description: Fix common issues
---
Troubleshooting articles contain guidelines for solving common problems and
pitfalls that you might encounter with Docker products.

View File

@ -1016,13 +1016,11 @@ Reference:
title: Version 2
- path: /glossary/
title: Glossary
Samples:
- path: /samples/
- sectiontitle: Samples
section:
- path: /samples/
title: Overview
- sectiontitle: Databases
- sectiontitle: Databases
section:
- path: /samples/mariadb/
title: MariaDB
@ -1036,7 +1034,7 @@ Samples:
title: PostgreSQL
- path: /samples/redis/
title: Redis
- sectiontitle: Frameworks
- sectiontitle: Frameworks
section:
- path: /samples/dotnet/
title: .NET
@ -1062,7 +1060,7 @@ Samples:
title: Spring Boot
- path: /samples/vuejs/
title: Vue.js
- sectiontitle: Languages
- sectiontitle: Languages
section:
- path: /samples/go/
title: Go
@ -1080,7 +1078,7 @@ Samples:
title: Rust
- path: /samples/typescript/
title: TypeScript
- sectiontitle: Platforms
- sectiontitle: Platforms
section:
- path: /samples/gitea/
title: Gitea
@ -1092,7 +1090,7 @@ Samples:
title: Prometheus
- path: /samples/wordpress/
title: WordPress
- sectiontitle: Other samples
- sectiontitle: Other samples
section:
- path: /samples/ai-ml/
title: AI/ML
@ -1113,7 +1111,6 @@ Samples:
- path: /samples/wireguard/
title: Wireguard
Manuals:
- path: /manuals/
title: Overview
@ -1247,6 +1244,18 @@ Manuals:
title: Uninstall Docker Desktop
- path: /desktop/feedback/
title: Give feedback
- sectiontitle: Desktop FAQs
section:
- path: /desktop/faqs/general/
title: General
- path: /desktop/faqs/macfaqs/
title: Mac
- path: /desktop/faqs/windowsfaqs/
title: Windows
- path: /desktop/faqs/linuxfaqs/
title: Linux
- path: /desktop/faqs/releases/
title: Releases
- path: /desktop/release-notes/
title: Release notes
- sectiontitle: Previous versions
@ -2050,6 +2059,8 @@ Manuals:
title: Give feedback
- path: /compose/migrate/
title: Migrate to Compose V2
- path: /compose/faq/
title: Compose FAQ
- path: /compose/release-notes/
title: Release notes
@ -2136,6 +2147,14 @@ Manuals:
title: Manage users
- path: /admin/company/owners/
title: Manage company owners
- sectiontitle: Account and admin FAQ
section:
- path: /admin/faqs/general-faqs/
title: General
- path: /admin/faqs/organization-faqs/
title: Organization
- path: /admin/faqs/company-faqs/
title: Company
- path: /admin/convert-account/
title: Convert an account into an organization
- path: /admin/deactivate-account/
@ -2189,6 +2208,28 @@ Manuals:
title: Generate a new recovery code
- path: /security/security-announcements/
title: Security announcements
- sectiontitle: Security FAQs
section:
- path: /security/faqs/general/
title: General
- path: /security/faqs/networking-and-vms/
title: Networking and VMs
- path: /security/faqs/eci-faq/
title: Enhanced Container Isolation
- sectiontitle: Single Sign-On
section:
- path: /security/faqs/single-sign-on/faqs/
title: General
- path: /security/faqs/single-sign-on/saml-faqs/
title: SAML
- path: /security/faqs/single-sign-on/idp-faqs/
title: Identity providers
- path: /security/faqs/single-sign-on/domain-faqs/
title: Domains
- path: /security/faqs/single-sign-on/enforcement-faqs/
title: Enforcement
- path: /security/faqs/single-sign-on/users-faqs/
title: Manage users
- sectiontitle: Billing
section:
@ -2208,6 +2249,8 @@ Manuals:
title: Docker Build Cloud billing
- path: /billing/scout-billing/
title: Docker Scout billing
- path: /billing/faqs/
title: Billing FAQs
- sectiontitle: Subscription
section:
@ -2235,6 +2278,8 @@ Manuals:
title: Docker Scout subscriptions and features
- path: /subscription/desktop-license/
title: Docker Desktop license agreement
- path: /subscription/faq/
title: Subscription FAQ
- sectiontitle: Trusted content
section:
@ -2255,61 +2300,7 @@ Manuals:
- path: /trusted-content/insights-analytics/
title: Insights and analytics
- path: /release-notes/
title: Release notes
- path: /support/
title: Get support
- path: /release-lifecycle/
title: Product release lifecycle
FAQ:
- path: /faq/
title: Overview
- path: /billing/faqs/
title: Billing
- path: /compose/faq/
title: Compose
- sectiontitle: Desktop
section:
- path: /desktop/faqs/general/
title: General
- path: /desktop/faqs/macfaqs/
title: Mac
- path: /desktop/faqs/windowsfaqs/
title: Windows
- path: /desktop/faqs/linuxfaqs/
title: Linux
- path: /desktop/faqs/releases/
title: Releases
- sectiontitle: Docker account and admin
section:
- path: /faq/admin/general-faqs/
title: General
- path: /faq/admin/organization-faqs/
title: Organization
- path: /faq/admin/company-faqs/
title: Company
- path: /subscription/faq/
title: Subscription
- sectiontitle: Security
section:
- path: /faq/security/general/
title: General
- path: /faq/security/networking-and-vms/
title: Networking and VMs
- path: /faq/security/eci-faq/
title: Enhanced Container Isolation
- sectiontitle: Single Sign-On
section:
- path: /faq/security/single-sign-on/faqs/
title: General
- path: /faq/security/single-sign-on/saml-faqs/
title: SAML
- path: /faq/security/single-sign-on/idp-faqs/
title: Identity providers
- path: /faq/security/single-sign-on/domain-faqs/
title: Domains
- path: /faq/security/single-sign-on/enforcement-faqs/
title: Enforcement
- path: /faq/security/single-sign-on/users-faqs/
title: Manage users

View File

@ -4,9 +4,9 @@ refLinksErrorLevel: ERROR
enableGitInfo: true
disablePathToLower: true
enableInlineShortcodes: true
disableKinds:
- taxonomy
- term
taxonomies:
tag: tags
markup:
tableOfContents:
@ -126,12 +126,6 @@ menus:
- name: Reference
url: /reference/
weight: 3
- name: Samples
url: /samples/
weight: 4
- name: FAQ
url: /faq/
weight: 5
footer:
- url: https://www.docker.com/products
@ -236,7 +230,7 @@ module:
proxy: https://proxy.golang.org,direct
hugoVersion:
extended: false
min: "0.116.1"
min: "0.124.1"
mounts:
- source: assets
target: assets

View File

@ -150,6 +150,7 @@
"build-push-action",
"chroma",
"cls-1",
"cursor-not-allowed",
"cursor-pointer",
"dark:bg-accent-dark",
"dark:bg-amber-dark",
@ -159,6 +160,7 @@
"dark:bg-blue-dark-400",
"dark:bg-gray-dark-100",
"dark:bg-gray-dark-200",
"dark:bg-gray-dark-300",
"dark:bg-gray-dark-300/50",
"dark:bg-gray-dark-400",
"dark:bg-green-dark",
@ -178,6 +180,7 @@
"dark:hover:bg-blue-dark",
"dark:hover:bg-blue-dark-500",
"dark:hover:bg-gray-dark-500",
"dark:hover:text-white",
"dark:prose-invert",
"dark:syntax-dark",
"dark:text-blue-dark",
@ -186,6 +189,7 @@
"dark:text-gray-dark-500",
"dark:text-gray-dark-600",
"dark:text-gray-dark-700",
"dark:text-gray-dark-800",
"dark:text-violet-dark",
"dark:text-white",
"dark:to-blue-dark-100",
@ -206,6 +210,7 @@
"flex-col-reverse",
"flex-initial",
"flex-row-reverse",
"flex-wrap",
"font-medium",
"footnote-backref",
"footnote-ref",
@ -246,8 +251,10 @@
"hover:drop-shadow-lg",
"hover:opacity-75",
"hover:opacity-90",
"hover:text-black",
"hover:underline",
"hub-api",
"icon-lg",
"icon-sm",
"icon-svg",
"important",
@ -264,10 +271,14 @@
"justify-self-end",
"leading-snug",
"left-0",
"lg:block",
"lg:grid-cols-2",
"lg:grow-0",
"lg:hidden",
"lg:link",
"lg:pb-0",
"lg:px-4",
"lg:text-base",
"lg:w-full",
"link",
"lntable",
@ -300,8 +311,10 @@
"ml-auto",
"mt-1",
"mt-20",
"mt-auto",
"mx-auto",
"my-0",
"my-2",
"my-4",
"no-underline",
"no-wrap",
@ -319,6 +332,7 @@
"p-6",
"p-8",
"p-[2px]",
"pb-0.5",
"pb-2",
"pb-4",
"pl-1",
@ -331,6 +345,7 @@
"pt-0",
"px-1",
"px-2",
"px-3",
"px-4",
"py-1",
"py-2",
@ -393,6 +408,7 @@
"to-blue-light-500",
"to-magenta-light-400",
"to-transparent",
"toc",
"top-0",
"top-16",
"top-3",

View File

@ -8,6 +8,9 @@
{{ with .Title }}
<h1 class="scroll-mt-36">{{ . }}</h1>
{{ end }}
<div class="hidden lg:block">
{{ partial "pagemeta.html" . }}
</div>
{{ .Content }}
</article>
{{ end }}

View File

@ -8,6 +8,10 @@
{{ with .Title }}
<h1 class="scroll-mt-36">{{ . }}</h1>
{{ end }}
<div class="hidden lg:block">
{{ partial "pagemeta.html" . }}
<hr>
</div>
{{ .Content }}
</article>
{{ end }}

View File

@ -190,6 +190,16 @@
{{ end }}
</div>
</div>
<div class="flex flex-col gap-4">
<h2 class="mb-4 text-xl">Browse by tag</h2>
<div class="flex flex-wrap gap-4">
{{ $tags := slice }}
{{- range site.Taxonomies.tags }}
{{ $tags = $tags | append .Page }}
{{ end }}
{{ partial "tags.html" $tags }}
</div>
</div>
</div>
<div

View File

@ -1,4 +1,6 @@
<aside class="py-4 space-y-4">
{{ partial "github-links.html" . }}
{{ partial "toc-default.html" . }}
<div id="TableOfContents">
{{ partial "pagemeta.html" . }}
</div>
</aside>

View File

View File

@ -0,0 +1,41 @@
{{- $toc := false }}
{{- with .Fragments }}
{{- $toc = and (ne page.Params.notoc true) .Headings }}
{{- end }}
{{- $tags := .GetTerms "tags" }}
{{- if or $toc $tags }}
<div class="not-prose">
{{- with $tags }}
<div class="flex flex-col gap-2 my-2">
<span class="text-lg">Tags</span>
<div class="flex flex-wrap items-center gap-2">
{{- partial "tags.html" . -}}
</div>
</div>
{{- end }}
{{- with $toc }}
<div class="text-lg pb-2 lg:pb-0">Table of contents</div>
<nav class="toc">
{{ $root := (index page.Fragments.Headings 0).Headings }}
{{- template "walkHeadingFragments" $root }}
</nav>
{{- end }}
</div>
{{- end }}
{{- define "walkHeadingFragments" }}
{{- $min := 2 }}
{{- $max := 3 }}
<ul class="pl-2">
{{- range . }}
{{- if and (ge .Level $min) (le .Level $max) }}
<li>
<a class="lg:link" href="#{{ .ID }}">{{ .Title }}</a>
</li>
{{- end }}
{{- with .Headings }}
{{ template "walkHeadingFragments" . }}
{{- end }}
{{- end }}
</ul>
{{- end }}

View File

@ -0,0 +1,70 @@
{{- if gt .Paginator.TotalPages 1 }}
{{ $selectable := "cursor-pointer" }}
{{ $active := "hover:text-black dark:hover:text-white underline underline-offset-8" }}
{{ $disabled := "cursor-not-allowed text-gray-light dark:text-gray-dark" }}
<ul class="flex gap-6 items-center">
{{- with .Paginator }}
{{- $currentPageNumber := .PageNumber }}
{{- with .First }}
{{- if ne $currentPageNumber .PageNumber }}
<li>
<a class="{{ $selectable }}" href="{{ .URL }}" aria-label="First">
<span class="icon-svg">
{{- partialCached "icon" "navigate_before" "navigate_before" -}}
</span>
</a>
</li>
{{- else }}
<li>
<a class="{{ $disabled }}" aria-disabled="true" aria-label="First">
<span class="icon-svg">
{{- partialCached "icon" "navigate_before" "navigate_before" -}}
</span>
</a>
</li>
{{- end }}
{{- end }}
{{- $slots := 5 }}
{{- $start := math.Max 1 (sub .PageNumber (math.Floor (div $slots 2))) }}
{{- $end := math.Min .TotalPages (sub (add $start $slots) 1) }}
{{- if lt (add (sub $end $start) 1) $slots }}
{{- $start = math.Max 1 (add (sub $end $slots) 1) }}
{{- end }}
{{- range $k := seq $start $end }}
{{- if eq $.Paginator.PageNumber $k }}
<li>
<a class="{{ $active }}" aria-current="page" aria-label="Page {{ $k }}">{{ $k }}</a>
</li>
{{- else }}
<li>
<a class="{{ $selectable }}" href="{{ (index $.Paginator.Pagers (sub $k 1)).URL }}" aria-label="Page {{ $k }}">{{ $k }}</a>
</li>
{{- end }}
{{- end }}
{{- with .Last }}
{{- if ne $currentPageNumber .PageNumber }}
<li>
<a class="{{ $selectable }}" href="{{ .URL }}" aria-label="Last">
<span class="icon-svg">
{{- partialCached "icon" "navigate_next" "navigate_next" -}}
</span>
</a>
</li>
{{- else }}
<li>
<a class="{{ $disabled }}" aria-disabled="true" aria-label="Last">
<span class="icon-svg">
{{- partialCached "icon" "navigate_next" "navigate_next" -}}
</span>
</a>
</li>
{{- end }}
{{- end }}
{{- end }}
</ul>
{{- end }}

View File

@ -0,0 +1,13 @@
{{- /*
List of tag "chips" as links
Context: page.Pages
*/ -}}
{{- range . -}}
{{- if eq .File nil }}
{{- errorf "[tags] Undefined tag: '%s' in %s" (urlize (strings.ToLower .Title)) page.File.Filename }}
{{- end }}
<a class="flex items-center gap-2 lg:text-base px-2 rounded text-gray-light-800 bg-gray-light-200 dark:bg-gray-dark-300 dark:text-gray-dark-800" href="{{ .Permalink }}">
<div class="icon-svg icon-sm pb-0.5">{{ partialCached "icon" .Params.icon .Params.icon }}</div>
<div>{{ .LinkTitle }}</div>
</a>
{{- end -}}

View File

@ -1,8 +0,0 @@
{{ if ne .Params.notoc true }}
{{ if gt (len .TableOfContents) 32 }}
<div>
<div class="text-lg pb-2">{{ T "tableOfContents" }}</div>
{{ .TableOfContents }}
</div>
{{ end }}
{{ end }}

View File

@ -4,7 +4,7 @@
<nav>
<ul class="box-content flex mt-1 gap-4 md:hidden">
{{ range site.Menus.main }}
<li {{- if eq $firstSection .Name }} class="border-b-4" {{- end }}>
<li {{- if or (eq $firstSection .Name) }} class="border-b-4" {{- end }}>
<a class="block py-1 px-2" href="{{ .URL }}">{{ .Name }}</a>
</li>
{{ end }}

19
layouts/tag/baseof.html Normal file
View File

@ -0,0 +1,19 @@
<!DOCTYPE html>
<html lang="en">
<head>
{{ partial "head.html" . }}
</head>
<body class="flex flex-col min-h-screen bg-background-light text-base dark:bg-background-dark dark:text-white">
{{ partial "header.html" . }}
<main class="flex justify-center">
<div class="w-[1200px] overflow-clip p-6 pt-0 md:w-lvw">
{{ block "main" . }}
{{ end }}
</div>
</main>
<footer class="mt-auto">{{ partialCached "footer.html" . }}</footer>
</body>
</html>

19
layouts/tag/taxonomy.html Normal file
View File

@ -0,0 +1,19 @@
{{ define "main" }}
{{ partial "breadcrumbs.html" . }}
<article class="DocSearch-content prose max-w-none dark:prose-invert">
<h1 class="scroll-mt-36">{{ .Title }}</h1>
{{ .Content }}
<div class="grid grid-cols-3 gap-4 sm:flex sm:flex-col lg:grid-cols-2">
{{ range site.Taxonomies.tags }}
{{ partial "components/card.html"
(dict
"link" .Page.Permalink
"title" .Page.Title
"description" .Page.Description
"icon" .Page.Params.icon
)
}}
{{ end }}
</div>
</article>
{{ end }}

44
layouts/tag/term.html Normal file
View File

@ -0,0 +1,44 @@
{{ define "main" }}
{{ partial "breadcrumbs.html" . }}
<article class="DocSearch-content prose max-w-none dark:prose-invert">
<a class="link" href="/tags/"><span class="icon-svg">{{ partialCached "icon" "navigate_before" "navigate_before" }}</span>View all tags</a>
<h1 class="scroll-mt-36 flex gap-4 items-center">
<span class="bg-gray-light-200 dark:bg-gray-dark-300 rounded-full px-3 icon-svg icon-lg pb-2">{{ partialCached "icon" .Params.icon .Params.icon }}</span>
</span>{{ .Title }}</span>
</h1>
{{ .Content }}
<div class="not-prose flex justify-between items-center">
<span class="text-gray-light dark:text-gray-dark">Pages with this tag:</span>
{{ partial "pagination.html" . }}
</div>
<table>
<thead>
<tr>
<th width="50%">Title</th>
<th width="50%">Section</th>
</tr>
</thead>
<tbody>
{{ range .Paginator.Pages }}
{{ $scratch := partialCached "utils/tocparser.html" . . }}
{{ $sections := $scratch.GetSortedMapValues "sections" }}
<tr>
<td>
<a href="{{ .Permalink }}" class="link">
{{ .Title }}
</a>
</td>
<td>
<span class="text-gray-light dark:text-gray-dark">
{{ range $i, $e := $sections }}
{{ if $i }} / {{ end }}
{{ $e.title }}
{{ end }}
</span>
</td>
</tr>
{{ end }}
</tbody>
</table>
</article>
{{ end }}

View File

@ -4,7 +4,7 @@ publish = "public"
[context.deploy-preview.environment]
NODE_VERSION = "20"
NODE_ENV = "production"
HUGO_VERSION = "0.122.0"
HUGO_VERSION = "0.124.1"
HUGO_ENABLEGITINFO = "true"
HUGO_ENVIRONMENT = "preview"