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?
@ -61,4 +63,4 @@ See [SCIM](scim.md) and [Group mapping](../../security/for-admins/group-mapping.
### What's the definition of a company vs an organization?
A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together.
A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together.

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?
@ -68,4 +70,4 @@ A [service account](../../docker-hub/service-accounts.md) is a Docker ID used fo
Only someone with access to the Docker account can deactivate the account. For more details, see [Deactivating an account](../../admin/deactivate-account.md).
If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team).
If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team).

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?
@ -88,4 +90,4 @@ organization. See [Configure repository permissions for a team](manage-a-team.md
### Does my organization need to use Docker's registry?
A registry is a hosted service containing repositories of images that responds to the Registry API. Docker Hub is Docker's primary registry, but you can use Docker with other container image registries. You can access the default registry by browsing to [Docker Hub](https://hub.docker.com) or using the `docker search` command.
A registry is a hosted service containing repositories of images that responds to the Registry API. Docker Hub is Docker's primary registry, but you can use Docker with other container image registries. You can access the default registry by browsing to [Docker Hub](https://hub.docker.com) or using the `docker search` command.

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

@ -90,4 +90,4 @@ For more information about BuildKit, see [BuildKit](buildkit/index.md).
The following diagram shows an example build sequence involving Buildx and
BuildKit.
![Buildx and BuildKit sequence diagram](./images/build-execution.png)
![Buildx and BuildKit sequence diagram](./images/build-execution.png)

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" >}}
@ -105,4 +106,4 @@ supports hot code reloading or live-reload.
There may be cases where you want to use both. You can have the image
include the code using a `COPY`, and use a `volume` in your Compose file to
include the code from the host during development. The volume overrides
the directory contents of the image.
the directory contents of the image.

View File

@ -48,4 +48,4 @@ You can [install the Compose standalone](standalone.md) on Linux or on Windows S
> **Warning**
>
>This install scenario is not recommended and is only supported for backward compatibility purposes.
{ .warning }
{ .warning }

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

@ -39,4 +39,4 @@ These samples focus specifically on Docker Compose:
## Awesome Compose samples
The Awesome Compose samples provide a starting point on how to integrate different frameworks and technologies using Docker Compose. All samples are available in the [Awesome-compose GitHub repo](https://github.com/docker/awesome-compose) and are ready to run with `docker compose up`.
The Awesome Compose samples provide a starting point on how to integrate different frameworks and technologies using Docker Compose. All samples are available in the [Awesome-compose GitHub repo](https://github.com/docker/awesome-compose) and are ready to run with `docker compose up`.

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**
>
@ -114,4 +114,4 @@ For both of the following callouts, consult [the Docker release lifecycle](/rele
> Docker Scout is an [early access](/release-lifecycle/#early-access-ea)
> product.
{ .restricted }
```
```

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

@ -47,4 +47,4 @@ Some of the above options require you to extend our MUI theme. See the MUI docum
## What's next?
- Take a look at our [UI styling guide](index.md).
- Learn how to [publish your extension](../extensions/index.md).
- Learn how to [publish your extension](../extensions/index.md).

View File

@ -90,4 +90,4 @@ $ docker extension rm <name-of-your-extension>
- Learn how to [test and debug](dev/test-debug.md) your extension.
- Learn how to [setup CI for your extension](dev/continuous-integration.md).
- Learn more about extensions [architecture](architecture/index.md).
- Learn more about [designing the UI](design/design-guidelines.md).
- Learn more about [designing the UI](design/design-guidelines.md).

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

@ -53,4 +53,4 @@ $ sudo pacman -S gnome-terminal
- Take a look at the [Get started](../../get-started/index.md) training modules to learn how to build an image and run it as a containerized application.
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

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 >}}
@ -72,4 +73,4 @@ title: Known issues
- `ping` from inside a container to the Internet does not work as expected. To test the network, use `curl` or `wget`. See [docker/for-mac#5322](https://github.com/docker/for-mac/issues/5322#issuecomment-809392861).
- Users may occasionally experience data drop when a TCP stream is half-closed.
{{< /tab >}}
{{< /tabs >}}
{{< /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.
@ -312,4 +313,4 @@ to learn how to view the Docker Daemon logs.
- View specific [troubleshoot topics](topics.md).
- Implement [workarounds for common problems](workarounds.md)
- View information on [known issues](known-issues.md)
- View information on [known issues](known-issues.md)

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
@ -44,4 +45,4 @@ typically occurs after a Windows update and
manifests as an error response from the Docker daemon and a Docker Desktop start failure.
For a temporary workaround, uninstall the anti-virus software, or
explore other workarounds suggested on Docker Desktop forums.
explore other workarounds suggested on Docker Desktop forums.

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:
@ -17,4 +18,4 @@ keywords: wsl, docker desktop, best practices
- Instead, from a Linux shell use a command like `docker run -v ~/my-project:/sources <my-image>` where `~` is expanded by the Linux shell to `$HOME`.
- If you have concerns about the size of the docker-desktop-data VHDX, or need to change it, take a look at the [WSL tooling built into Windows](https://learn.microsoft.com/en-us/windows/wsl/disk-space).
- If you have concerns about CPU or memory usage, you can configure limits on the memory, CPU, and swap size allocated to the [WSL 2 utility VM](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#global-configuration-options-with-wslconfig).
- If you have concerns about CPU or memory usage, you can configure limits on the memory, CPU, and swap size allocated to the [WSL 2 utility VM](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#global-configuration-options-with-wslconfig).

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**
@ -66,4 +67,4 @@ system access to the repositories.
> **Note**
>
> You must configure your private git submodules using git clone over SSH
> (`git@submodule.tld:some-submodule.git`) rather than HTTPS.
> (`git@submodule.tld:some-submodule.git`) rather than HTTPS.

View File

@ -216,4 +216,4 @@ You've successfully:
- Automatically build container images from code through [builds](builds/index.md).
- [Explore](https://hub.docker.com/explore) official & publisher images.
- [Upgrade your subscription](https://www.docker.com/pricing) to push additional private Docker images to
Docker Hub.
Docker Hub.

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

@ -142,4 +142,4 @@ options:
- Read the [Get started](../../get-started/index.md) training modules
to learn how to build an image and run it as a containerized application.
- Review the topics in [Develop with Docker](../../develop/index.md) to learn
how to build new applications using Docker.
how to build new applications using Docker.

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
@ -288,4 +289,4 @@ Docker isn't running.
An error occurs if your GRUB configuration file has incorrect syntax. In this
case, repeat steps 2 and 3.
The changes take effect when you reboot the system.
The changes take effect when you reboot the system.

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?
@ -30,4 +33,4 @@ On Mac it is an unprivileged operation to start a VM, so that is not enforced by
### How does Docker Desktop achieve network level isolation when Hyper-V and/or WSL2 is used?
The VM processes are the same for both WSL 2 (running inside the `docker-desktop` distro) and Hyper-V (running inside the `DockerDesktopVM`). Host/VM communication uses `AF_VSOCK` hypervisor sockets (shared memory). It does not use Hyper-V network switches or network interfaces. All host networking is performed using normal TCP/IP sockets from the `com.docker.vpnkit.exe` and `com.docker.backend.exe` processes. For more information see [How Docker Desktop networking works under the hood](https://www.docker.com/blog/how-docker-desktop-networking-works-under-the-hood/).
The VM processes are the same for both WSL 2 (running inside the `docker-desktop` distro) and Hyper-V (running inside the `DockerDesktopVM`). Host/VM communication uses `AF_VSOCK` hypervisor sockets (shared memory). It does not use Hyper-V network switches or network interfaces. All host networking is performed using normal TCP/IP sockets from the `com.docker.vpnkit.exe` and `com.docker.backend.exe` processes. For more information see [How Docker Desktop networking works under the hood](https://www.docker.com/blog/how-docker-desktop-networking-works-under-the-hood/).

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?
@ -28,4 +30,4 @@ Runtime for Docker Desktop if they configure Docker Desktop to require authentic
### Do you support IdP-initiated authentication (e.g., Okta tile support)?
We don't support IdP-initiated authentication. Users must initiate login through Docker Desktop or Hub.
We don't support IdP-initiated authentication. Users must initiate login through Docker Desktop or Hub.

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?
@ -32,4 +34,4 @@ Yes, all users in your organization must upgrade to Docker Desktop version 4.4.2
### Can I retain my Docker ID when using SSO?
For a personal Docker ID, a user is the account owner. A Docker ID is associated with access to the user's repositories, images, assets. An end user can choose to have a company domain email on the Docker account. When enforcing SSO, the account is connected to the organization account. When enforcing SSO for an organization(s) or company, any user logging in without an existing account using verified company domain email will automatically have an account provisioned, and a new Docker ID created.
For a personal Docker ID, a user is the account owner. A Docker ID is associated with access to the user's repositories, images, assets. An end user can choose to have a company domain email on the Docker account. When enforcing SSO, the account is connected to the organization account. When enforcing SSO for an organization(s) or company, any user logging in without an existing account using verified company domain email will automatically have an account provisioned, and a new Docker ID created.

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?
@ -20,4 +22,4 @@ At runtime for Docker Desktop if its configured to require authentication to
### Do you have any information on how to use the Docker Desktop application in accordance with the SSO users we provide? How can we verify that we're handling the licensing correctly?
Verify that your users have downloaded the latest version of Docker Desktop. An enhancement in user management observability and capabilities will become available in the future.
Verify that your users have downloaded the latest version of Docker Desktop. An enhancement in user management observability and capabilities will become available in the future.

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
@ -58,4 +59,4 @@ $ sudo lsof /var/lib/docker/containers/74bef250361c7817bee19349c93139621b272bc8f
```
To work around this problem, stop the container which bind-mounts
`/var/lib/docker` and try again to remove the other container.
`/var/lib/docker` and try again to remove the other container.

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,103 +1016,100 @@ Reference:
title: Version 2
- path: /glossary/
title: Glossary
Samples:
- path: /samples/
title: Overview
- sectiontitle: Databases
- sectiontitle: Samples
section:
- path: /samples/mariadb/
title: MariaDB
- path: /samples/mongodb/
title: MongoDB
- path: /samples/ms-sql/
title: MS-SQL
- path: /samples/mysql/
title: MySQL
- path: /samples/postgres/
title: PostgreSQL
- path: /samples/redis/
title: Redis
- sectiontitle: Frameworks
section:
- path: /samples/dotnet/
title: .NET
- path: /samples/angular/
title: Angular
- path: /samples/django/
title: Django
- path: /samples/express/
title: Express
- path: /samples/fastapi/
title: FastAPI
- path: /samples/flask/
title: Flask
- path: /samples/nodejs/
title: Node.js
- path: /samples/react/
title: React
- path: /samples/rails/
title: Rails
- path: /samples/spark/
title: Spark
- path: /samples/spring/
title: Spring Boot
- path: /samples/vuejs/
title: Vue.js
- sectiontitle: Languages
section:
- path: /samples/go/
title: Go
- path: /samples/java/
title: Java
- path: /samples/javascript/
title: JavaScript
- path: /samples/php/
title: PHP
- path: /samples/python/
title: Python
- path: /samples/ruby/
title: Ruby
- path: /samples/rust/
title: Rust
- path: /samples/typescript/
title: TypeScript
- sectiontitle: Platforms
section:
- path: /samples/gitea/
title: Gitea
- path: /samples/nextcloud/
title: Nextcloud
- path: /samples/portainer/
title: Portainer
- path: /samples/prometheus/
title: Prometheus
- path: /samples/wordpress/
title: WordPress
- sectiontitle: Other samples
section:
- path: /samples/ai-ml/
title: AI/ML
- path: /samples/cloudflared/
title: Cloudflared
- path: /samples/elasticsearch/
title: Elasticsearch / Logstash / Kibana
- path: /samples/minecraft/
title: Minecraft
- path: /samples/nginx/
title: NGINX
- path: /samples/pi-hole/
title: Pi-hole
- path: /samples/plex/
title: Plex
- path: /samples/traefik/
title: Traefik
- path: /samples/wireguard/
title: Wireguard
- path: /samples/
title: Overview
- sectiontitle: Databases
section:
- path: /samples/mariadb/
title: MariaDB
- path: /samples/mongodb/
title: MongoDB
- path: /samples/ms-sql/
title: MS-SQL
- path: /samples/mysql/
title: MySQL
- path: /samples/postgres/
title: PostgreSQL
- path: /samples/redis/
title: Redis
- sectiontitle: Frameworks
section:
- path: /samples/dotnet/
title: .NET
- path: /samples/angular/
title: Angular
- path: /samples/django/
title: Django
- path: /samples/express/
title: Express
- path: /samples/fastapi/
title: FastAPI
- path: /samples/flask/
title: Flask
- path: /samples/nodejs/
title: Node.js
- path: /samples/react/
title: React
- path: /samples/rails/
title: Rails
- path: /samples/spark/
title: Spark
- path: /samples/spring/
title: Spring Boot
- path: /samples/vuejs/
title: Vue.js
- sectiontitle: Languages
section:
- path: /samples/go/
title: Go
- path: /samples/java/
title: Java
- path: /samples/javascript/
title: JavaScript
- path: /samples/php/
title: PHP
- path: /samples/python/
title: Python
- path: /samples/ruby/
title: Ruby
- path: /samples/rust/
title: Rust
- path: /samples/typescript/
title: TypeScript
- sectiontitle: Platforms
section:
- path: /samples/gitea/
title: Gitea
- path: /samples/nextcloud/
title: Nextcloud
- path: /samples/portainer/
title: Portainer
- path: /samples/prometheus/
title: Prometheus
- path: /samples/wordpress/
title: WordPress
- sectiontitle: Other samples
section:
- path: /samples/ai-ml/
title: AI/ML
- path: /samples/cloudflared/
title: Cloudflared
- path: /samples/elasticsearch/
title: Elasticsearch / Logstash / Kibana
- path: /samples/minecraft/
title: Minecraft
- path: /samples/nginx/
title: NGINX
- path: /samples/pi-hole/
title: Pi-hole
- path: /samples/plex/
title: Plex
- path: /samples/traefik/
title: Traefik
- path: /samples/wireguard/
title: Wireguard
Manuals:
- path: /manuals/
@ -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"