mkdocs-material/docs/schema.json

{
  "$schema": "https://json-schema.org/draft-07/schema",
  "title": "Material for MkDocs",
  "markdownDescription": "Configuration",
  "type": "object",
  "properties": {
    "INHERIT": {
      "title": "Inherit from configuration",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#configuration-inheritance",
      "pattern": "\\.yml$"
    },
    "site_name": {
      "title": "Site name, used in header, title and drawer",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#site_name",
      "type": "string"
    },
    "site_url": {
      "title": "Site URL",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#site_url",
      "type": "string"
    },
    "site_author": {
      "title": "Site author, used in document head",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#site_author",
      "type": "string"
    },
    "site_description": {
      "title": "Site description, used in document head and in social cards",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#site_description",
      "type": "string"
    },
    "repo_name": {
      "title": "Repository name, used in header",
      "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/adding-a-git-repository/#repository-name",
      "type": "string"
    },
    "repo_url": {
      "title": "Repository URL",
      "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/adding-a-git-repository/#repository",
      "type": "string"
    },
    "edit_uri": {
      "title": "Path from repository root to directory containing Markdown",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#edit_uri",
      "type": "string"
    },
    "edit_uri_template": {
      "title": "More flexible variant of edit_uri",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#edit_uri_template",
      "type": "string"
    },
    "copyright": {
      "title": "Copyright, used in footer",
      "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-footer/#copyright-notice",
      "type": "string"
    },
    "docs_dir": {
      "title": "Directory containing the Markdown sources",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#docs_dir",
      "type": "string",
      "default": "docs"
    },
    "site_dir": {
      "title": "Directory containing the HTML output",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#site_dir",
      "type": "string",
      "default": "site"
    },
    "use_directory_urls": {
      "title": "Pages are located in their own directories",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#use_directory_urls",
      "type": "boolean",
      "default": false
    },
    "extra_templates": {
      "title": "Additional HTML files to include",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#extra_templates",
      "type": "array",
      "items": {
        "title": "Path to HTML file",
        "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#extra_templates",
        "pattern": "\\.html$"
      },
      "uniqueItems": true,
      "minItems": 1
    },
    "extra_css": {
      "title": "Additional CSS files to include",
      "markdownDescription": "https://squidfunk.github.io/mkdocs-material/customization/#additional-css",
      "type": "array",
      "items": {
        "title": "Path to CSS file",
        "markdownDescription": "https://squidfunk.github.io/mkdocs-material/customization/#additional-css",
        "pattern": "\\.css($|\\?)"
      },
      "uniqueItems": true,
      "minItems": 1
    },
    "extra_javascript": {
      "title": "Additional JavaScript files to include",
      "markdownDescription": "https://squidfunk.github.io/mkdocs-material/customization/#additional-javascript",
      "type": "array",
      "items": {
        "title": "Path to JavaScript file (may be local or absolute URL to external JS)",
        "markdownDescription": "https://squidfunk.github.io/mkdocs-material/customization/#additional-javascript"
      },
      "uniqueItems": true,
      "minItems": 1
    },
    "hooks": {
      "title": "Hooks",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#hooks",
      "type": "array",
      "items": {
        "title": "Path to Python file",
        "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#hooks",
        "pattern": "\\.py$"
      },
      "uniqueItems": true,
      "minItems": 1
    },
    "strict": {
      "title": "Strict mode",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#strict",
      "type": "boolean",
      "default": false
    },
    "dev_addr": {
      "title": "Development IP Address",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#dev_addr",
      "type": "string",
      "default": "127.0.0.1:8000"
    },
    "remote_branch": {
      "title": "Remote branch to deploy to",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#remote_branch",
      "type": "string",
      "default": "gh-pages"
    },
    "remote_name": {
      "title": "Remote origin to deploy to",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#remote_name",
      "type": "string",
      "default": "origin"
    },
    "theme": {
      "$ref": "schema/theme.json"
    },
    "plugins": {
      "$ref": "schema/plugins.json"
    },
    "markdown_extensions": {
      "$ref": "schema/extensions.json"
    },
    "extra": {
      "$ref": "schema/extra.json"
    },
    "nav": {
      "$ref": "schema/nav.json"
    },
    "validation": {
      "$ref": "schema/validation.json"
    },
    "exclude_docs": {
      "title": "Pattern to declare files to exclude from build",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#exclude_docs",
      "type": "string"
    },
    "not_in_nav": {
      "title": "Pattern to declare pages that do not appear in the navigation",
      "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#not_in_nav",
      "type": "string"
    },
    "watch": {
      "items": {
        "title": "Path to watch for changes",
        "type": "string"
      },
      "type": "array"
    }
  },
  "additionalProperties": false
}