SphinxTable

pydantic model technote.config.SphinxTable

The [technote.sphinx] table permits Sphinx project configuration.

Parameters:

data (Any) –

Show JSON schema

{
   "title": "SphinxTable",
   "description": "The ``[technote.sphinx]`` table permits Sphinx project configuration.",
   "type": "object",
   "properties": {
      "nitpicky": {
         "title": "Nitpicky",
         "description": "Escalate warnings to build errors.",
         "default": false,
         "type": "boolean"
      },
      "nitpick_ignore": {
         "title": "Nitpick Ignore",
         "description": "Errors to ignore. First item is the type (like a role or directive) and the second is the target (like the argument to the role).",
         "type": "array",
         "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": [
               {
                  "type": "string"
               },
               {
                  "type": "string"
               }
            ]
         }
      },
      "nitpick_ignore_regex": {
         "title": "Nitpick Ignore Regex",
         "description": "Same as ``nitpick_ignore``, but both type and target are interpreted as regular expressions.",
         "type": "array",
         "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": [
               {
                  "type": "string"
               },
               {
                  "type": "string"
               }
            ]
         }
      },
      "extensions": {
         "title": "Extensions",
         "description": "Additional Sphinx extensions to use in the build.",
         "type": "array",
         "items": {
            "type": "string"
         }
      },
      "intersphinx": {
         "title": "Intersphinx",
         "description": "Intersphinx configurations.",
         "allOf": [
            {
               "$ref": "#/definitions/IntersphinxTable"
            }
         ]
      },
      "linkcheck": {
         "title": "Linkcheck",
         "description": "Link check builder settings.",
         "allOf": [
            {
               "$ref": "#/definitions/LinkcheckTable"
            }
         ]
      }
   },
   "definitions": {
      "IntersphinxTable": {
         "title": "IntersphinxTable",
         "description": "Intersphinx configuration in the ``[technote.sphinx]`` table.",
         "type": "object",
         "properties": {
            "projects": {
               "title": "Projects",
               "description": "Mapping of projects and their URLs.",
               "type": "object",
               "additionalProperties": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 2083,
                  "format": "uri"
               }
            }
         }
      },
      "LinkcheckTable": {
         "title": "LinkcheckTable",
         "description": "Linkcheck builder configurations in the ``[technote.sphinx]`` table.",
         "type": "object",
         "properties": {
            "ignore": {
               "title": "Ignore",
               "description": "Regular expressions of URLs to skip checking links",
               "type": "array",
               "items": {
                  "type": "string"
               }
            }
         }
      }
   }
}

Fields:

• extensions (List[str])

• intersphinx (technote.config.IntersphinxTable)

• linkcheck (technote.config.LinkcheckTable)

• nitpick_ignore (List[Tuple[str, str]])

• nitpick_ignore_regex (List[Tuple[str, str]])

• nitpicky (bool)

field extensions: List[str] [Optional]

Additional Sphinx extensions to use in the build.

field intersphinx: IntersphinxTable [Optional]

Intersphinx configurations.

field linkcheck: LinkcheckTable [Optional]

Link check builder settings.

field nitpick_ignore: List[Tuple[str, str]] [Optional]

Errors to ignore. First item is the type (like a role or directive) and the second is the target (like the argument to the role).

field nitpick_ignore_regex: List[Tuple[str, str]] [Optional]

Same as nitpick_ignore, but both type and target are interpreted as regular expressions.

field nitpicky: bool = False

Escalate warnings to build errors.