mirror of https://github.com/docker/docs.git
259 lines
7.7 KiB
YAML
259 lines
7.7 KiB
YAML
##
|
|
# Default configuration file
|
|
#
|
|
# This file overrides options set in _config.yml for production / deploy
|
|
##
|
|
|
|
name: Docker Documentation
|
|
repo: https://github.com/docker/docs
|
|
|
|
markdown: kramdown
|
|
highlighter: rouge
|
|
incremental: true
|
|
permalink: pretty
|
|
safe: false
|
|
lsi: false
|
|
|
|
# https://kramdown.gettalong.org/options.html
|
|
# https://github.com/kramdown/parser-gfm/blob/master/lib/kramdown/parser/gfm/options.rb
|
|
kramdown:
|
|
input: GFM
|
|
gfm_quirks: [paragraph_end, no_auto_typographic]
|
|
hard_wrap: false
|
|
html_to_native: true
|
|
syntax_highlighter: rouge
|
|
toc_levels: 2..3
|
|
|
|
# https://jekyllrb.com/docs/configuration/liquid/
|
|
liquid:
|
|
error_mode: strict
|
|
|
|
# Exclude directories and/or files from the conversion. These exclusions are
|
|
# relative to the site's source directory and cannot be outside the source
|
|
# directory.
|
|
exclude:
|
|
- _deploy
|
|
- _releaser
|
|
- docker-bake.hcl
|
|
- LICENSE
|
|
- Makefile
|
|
- README.md
|
|
|
|
# Component versions -- address like site.docker_ce_version
|
|
# You can't have - characters in these for non-YAML reasons.
|
|
# When updating 'latest_engine_api_version', also update 'min_api_threshold' below.
|
|
latest_engine_api_version: "1.42"
|
|
docker_ce_version: "23.0.0"
|
|
compose_v1_version: "1.29.2"
|
|
compose_version: "v2.17.0"
|
|
compose_file_v3: "3.9"
|
|
compose_file_v2: "2.4"
|
|
machine_version: "0.16.0"
|
|
distribution_version: "2.7"
|
|
compose_switch_version: "1.0.4"
|
|
buildkit_version: "0.10.5"
|
|
|
|
# Options for displaying minimum API version requirements in the reference pages.
|
|
#
|
|
# The reference pages show badges for commands and options (flags) that require
|
|
# a minimum API version. While this information can be useful if an option was
|
|
# added in a recent version of the Docker Engine (and API), these badges are no
|
|
# longer relevant to most users if the minimum required version is quite "old".
|
|
#
|
|
# We assume users reading these pages to be on the current version, or at most
|
|
# on the version before that (which is already "unsupported"). Users running
|
|
# older versions have bigger problems on their hand, so we're not accounting for
|
|
# those.
|
|
#
|
|
# So, to reduce unnecessary clutter on the page, we only show the minimum required
|
|
# API version if it requires a relatively recent version of the Engine.
|
|
#
|
|
# The "min_api_threshold" option specifies the minimum required API version for
|
|
# which we show a badge (currently: API v1.40, or "Docker 19.03").
|
|
min_api_threshold: 1.40
|
|
|
|
# Enable search autocompletion (requires metadata.json to be generated)
|
|
local_search: true
|
|
|
|
# List of plugins to enable for local development builds. Mostly the same as
|
|
# for production.
|
|
plugins:
|
|
- jekyll-redirect-from
|
|
- jekyll-relative-links
|
|
- jekyll-sitemap
|
|
|
|
# Assets
|
|
#
|
|
# We specify the directory for Jekyll so we can use @imports.
|
|
#
|
|
# For local development, we build css with the "expanded" format to produce
|
|
# human-readable output for easier debugging.
|
|
sass:
|
|
sass_dir: _scss
|
|
style: expanded
|
|
|
|
# Setting options here prevents having to repeat the same option in front-matter
|
|
# on every page.
|
|
# https://jekyllrb.com/docs/configuration/front-matter-defaults/
|
|
defaults:
|
|
- scope:
|
|
path: ""
|
|
type: "pages"
|
|
values:
|
|
layout: docs
|
|
toc_min: 2
|
|
toc_max: 4
|
|
|
|
# Exclude from sitemap
|
|
- scope:
|
|
path: "desktop/enterprise"
|
|
values:
|
|
sitemap: false
|
|
- scope:
|
|
path: "assets/**"
|
|
values:
|
|
sitemap: false
|
|
- scope:
|
|
path: "**/nav.html"
|
|
values:
|
|
sitemap: false
|
|
- scope:
|
|
path: "google*.html"
|
|
values:
|
|
sitemap: false
|
|
- scope:
|
|
path: "**/*.pdf"
|
|
values:
|
|
sitemap: false
|
|
|
|
# Set the correct edit-URL for some local and remote resources. We usually don't create a direct
|
|
# edit link for these, and instead point to the directory that contains the file.
|
|
- scope:
|
|
path: engine/reference
|
|
values:
|
|
# FIXME: This edit url is as "best-effort" and doesn't match anything in docker/cli repo for plugins for example. It should be generated autmatically.
|
|
edit_url: "https://github.com/docker/cli/tree/master/docs/reference"
|
|
- scope:
|
|
path: engine/reference/commandline
|
|
values:
|
|
edit_url: "https://github.com/docker/cli/tree/master/docs/reference/commandline"
|
|
skip_read_time: true
|
|
- scope:
|
|
path: glossary.md
|
|
values:
|
|
edit_url: "https://github.com/docker/docs/blob/master/_data/glossary.yaml"
|
|
|
|
# Fetch upstream resources (reference documentation) used by _plugins/fetch_remote.rb
|
|
# - repo is the GitHub repository to fetch from
|
|
# - default_branch used to generate edit_url link
|
|
# - ref the Git reference
|
|
# - paths is a list to the resources within the remote repository
|
|
# - dest is the destination path within the working tree
|
|
# - src is a list of glob source paths within the remote repository
|
|
fetch-remote:
|
|
- repo: "https://github.com/docker/cli"
|
|
default_branch: "master"
|
|
ref: "23.0"
|
|
paths:
|
|
- dest: "engine/extend"
|
|
src:
|
|
- "docs/extend/**"
|
|
- dest: "engine"
|
|
src:
|
|
- "docs/deprecated.md"
|
|
- dest: "engine/reference"
|
|
src:
|
|
- "docs/reference/run.md"
|
|
- dest: "engine/reference/commandline"
|
|
src:
|
|
- "docs/reference/commandline/cli.md"
|
|
- "docs/reference/commandline/dockerd.md"
|
|
|
|
- repo: "https://github.com/docker/docker"
|
|
default_branch: "master"
|
|
ref: "23.0"
|
|
paths:
|
|
- dest: "engine/api"
|
|
src:
|
|
- "docs/api/**"
|
|
|
|
- repo: "https://github.com/docker/compose-cli"
|
|
default_branch: "main"
|
|
ref: "main"
|
|
paths:
|
|
- dest: "cloud"
|
|
src:
|
|
- "docs/*.md"
|
|
- "!docs/README.md" # readme to make things nice in the compose-cli repo, but meaningless here
|
|
- "!docs/architecture.md" # Compose-CLI architecture, unrelated to cloud integration
|
|
|
|
- repo: "https://github.com/distribution/distribution"
|
|
default_branch: "main"
|
|
ref: "main"
|
|
paths:
|
|
- dest: "registry/spec"
|
|
src:
|
|
- "docs/spec/**"
|
|
- "!docs/spec/api.md.tmpl"
|
|
- dest: "registry"
|
|
src:
|
|
- "docs/configuration.md"
|
|
|
|
- repo: "https://github.com/moby/buildkit"
|
|
default_branch: "master"
|
|
ref: "master"
|
|
paths:
|
|
- dest: "engine/reference/builder.md"
|
|
src:
|
|
- "frontend/dockerfile/docs/reference.md"
|
|
- dest: "build/buildkit/toml-configuration.md"
|
|
src:
|
|
- "docs/buildkitd.toml.md"
|
|
- dest: "build/attestations/slsa-definitions.md"
|
|
src:
|
|
- "docs/attestations/slsa-definitions.md"
|
|
- dest: "build/attestations/attestation-storage.md"
|
|
src:
|
|
- "docs/attestations/attestation-storage.md"
|
|
|
|
- repo: "https://github.com/compose-spec/compose-spec"
|
|
default_branch: "master"
|
|
ref: "master"
|
|
paths:
|
|
- dest: "compose/compose-file/01-status.md"
|
|
src:
|
|
- "01-status.md"
|
|
- dest: "compose/compose-file/02-model.md"
|
|
src:
|
|
- "02-model.md"
|
|
- dest: "compose/compose-file/03-compose-file.md"
|
|
src:
|
|
- "03-compose-file.md"
|
|
- dest: "compose/compose-file/04-version-and-name.md"
|
|
src:
|
|
- "04-version-and-name.md"
|
|
- dest: "compose/compose-file/05-services.md"
|
|
src:
|
|
- "05-services.md"
|
|
- dest: "compose/compose-file/06-networks.md"
|
|
src:
|
|
- "06-networks.md"
|
|
- dest: "compose/compose-file/07-volumes.md"
|
|
src:
|
|
- "07-volumes.md"
|
|
- dest: "compose/compose-file/08-configs.md"
|
|
src:
|
|
- "08-configs.md"
|
|
- dest: "compose/compose-file/09-secrets.md"
|
|
src:
|
|
- "09-secrets.md"
|
|
- dest: "compose/compose-file/10-fragments.md"
|
|
src:
|
|
- "10-fragments.md"
|
|
- dest: "compose/compose-file/11-extension.md"
|
|
src:
|
|
- "11-extension.md"
|
|
- dest: "compose/compose-file/12-interpolation.md"
|
|
src:
|
|
- "12-interpolation.md"
|