⬆️ Upgrade MkDocs Material, MDX-Include, and MkDocs structure (#356)
This commit is contained in:
parent
a1520dcda6
commit
b01f3bbca8
2 changed files with 114 additions and 113 deletions
223
mkdocs.yml
223
mkdocs.yml
|
@ -3,127 +3,128 @@ site_description: Typer, build great CLIs. Easy to code. Based on Python type hi
|
|||
site_url: https://typer.tiangolo.com/
|
||||
|
||||
theme:
|
||||
name: 'material'
|
||||
palette:
|
||||
primary: 'black'
|
||||
accent: 'teal'
|
||||
icon:
|
||||
repo: fontawesome/brands/github-alt
|
||||
logo: 'img/icon-white.svg'
|
||||
favicon: 'img/favicon.png'
|
||||
name: material
|
||||
palette:
|
||||
primary: black
|
||||
accent: teal
|
||||
icon:
|
||||
repo: fontawesome/brands/github-alt
|
||||
logo: img/icon-white.svg
|
||||
favicon: img/favicon.png
|
||||
|
||||
repo_name: tiangolo/typer
|
||||
repo_url: https://github.com/tiangolo/typer
|
||||
edit_uri: ''
|
||||
google_analytics:
|
||||
- 'UA-155009830-1'
|
||||
- 'auto'
|
||||
edit_uri: ""
|
||||
|
||||
nav:
|
||||
- Typer: 'index.md'
|
||||
- Features: 'features.md'
|
||||
- Tutorial - User Guide:
|
||||
- Tutorial - User Guide - Intro: 'tutorial/index.md'
|
||||
- First Steps: 'tutorial/first-steps.md'
|
||||
- Printing and Colors: 'tutorial/printing.md'
|
||||
- Terminating: 'tutorial/terminating.md'
|
||||
- CLI Arguments:
|
||||
- CLI Arguments Intro: 'tutorial/arguments/index.md'
|
||||
- Optional CLI Arguments: 'tutorial/arguments/optional.md'
|
||||
- CLI Arguments with Default: 'tutorial/arguments/default.md'
|
||||
- CLI Arguments with Help: 'tutorial/arguments/help.md'
|
||||
- CLI Arguments with Environment Variables: 'tutorial/arguments/envvar.md'
|
||||
- Other uses: 'tutorial/arguments/other-uses.md'
|
||||
- CLI Options:
|
||||
- CLI Options Intro: 'tutorial/options/index.md'
|
||||
- CLI Options with Help: 'tutorial/options/help.md'
|
||||
- Required CLI Options: 'tutorial/options/required.md'
|
||||
- CLI Option Prompt: 'tutorial/options/prompt.md'
|
||||
- Password CLI Option and Confirmation Prompt: 'tutorial/options/password.md'
|
||||
- CLI Option Name: 'tutorial/options/name.md'
|
||||
- CLI Option Callback and Context: 'tutorial/options/callback-and-context.md'
|
||||
- Version CLI Option, is_eager: 'tutorial/options/version.md'
|
||||
- CLI Option autocompletion: 'tutorial/options/autocompletion.md'
|
||||
- Commands:
|
||||
- Commands Intro: 'tutorial/commands/index.md'
|
||||
- Command CLI Arguments: 'tutorial/commands/arguments.md'
|
||||
- Command CLI Options: 'tutorial/commands/options.md'
|
||||
- Command Help: 'tutorial/commands/help.md'
|
||||
- Custom Command Name: 'tutorial/commands/name.md'
|
||||
- Typer Callback: 'tutorial/commands/callback.md'
|
||||
- One or Multiple Commands: 'tutorial/commands/one-or-multiple.md'
|
||||
- Using the Context: 'tutorial/commands/context.md'
|
||||
- CLI Parameter Types:
|
||||
- CLI Parameter Types Intro: 'tutorial/parameter-types/index.md'
|
||||
- Number: 'tutorial/parameter-types/number.md'
|
||||
- Boolean CLI Options: 'tutorial/parameter-types/bool.md'
|
||||
- UUID: 'tutorial/parameter-types/uuid.md'
|
||||
- DateTime: 'tutorial/parameter-types/datetime.md'
|
||||
- Enum - Choices: 'tutorial/parameter-types/enum.md'
|
||||
- Path: 'tutorial/parameter-types/path.md'
|
||||
- File: 'tutorial/parameter-types/file.md'
|
||||
- SubCommands - Command Groups:
|
||||
- SubCommands - Command Groups - Intro: 'tutorial/subcommands/index.md'
|
||||
- Add Typer: 'tutorial/subcommands/add-typer.md'
|
||||
- SubCommands in a Single File: 'tutorial/subcommands/single-file.md'
|
||||
- Nested SubCommands: 'tutorial/subcommands/nested-subcommands.md'
|
||||
- Sub-Typer Callback Override: 'tutorial/subcommands/callback-override.md'
|
||||
- SubCommand Name and Help: 'tutorial/subcommands/name-and-help.md'
|
||||
- Multiple Values:
|
||||
- Multiple Values Intro: 'tutorial/multiple-values/index.md'
|
||||
- Multiple CLI Options: 'tutorial/multiple-values/multiple-options.md'
|
||||
- CLI Options with Multiple Values: 'tutorial/multiple-values/options-with-multiple-values.md'
|
||||
- CLI Arguments with Multiple Values: 'tutorial/multiple-values/arguments-with-multiple-values.md'
|
||||
- Ask with Prompt: 'tutorial/prompt.md'
|
||||
- Progress Bar: 'tutorial/progressbar.md'
|
||||
- CLI Application Directory: 'tutorial/app-dir.md'
|
||||
- Launching Applications: 'tutorial/launch.md'
|
||||
- Testing: 'tutorial/testing.md'
|
||||
- Using Click: 'tutorial/using-click.md'
|
||||
- Building a Package: 'tutorial/package.md'
|
||||
- Typer CLI - completion for small scripts: 'typer-cli.md'
|
||||
- Alternatives, Inspiration and Comparisons: 'alternatives.md'
|
||||
- Help Typer - Get Help: 'help-typer.md'
|
||||
- Development - Contributing: 'contributing.md'
|
||||
- Release Notes: release-notes.md
|
||||
- Typer: index.md
|
||||
- Features: features.md
|
||||
- Tutorial - User Guide:
|
||||
- Tutorial - User Guide - Intro: tutorial/index.md
|
||||
- First Steps: tutorial/first-steps.md
|
||||
- Printing and Colors: tutorial/printing.md
|
||||
- Terminating: tutorial/terminating.md
|
||||
- CLI Arguments:
|
||||
- CLI Arguments Intro: tutorial/arguments/index.md
|
||||
- Optional CLI Arguments: tutorial/arguments/optional.md
|
||||
- CLI Arguments with Default: tutorial/arguments/default.md
|
||||
- CLI Arguments with Help: tutorial/arguments/help.md
|
||||
- CLI Arguments with Environment Variables: tutorial/arguments/envvar.md
|
||||
- Other uses: tutorial/arguments/other-uses.md
|
||||
- CLI Options:
|
||||
- CLI Options Intro: tutorial/options/index.md
|
||||
- CLI Options with Help: tutorial/options/help.md
|
||||
- Required CLI Options: tutorial/options/required.md
|
||||
- CLI Option Prompt: tutorial/options/prompt.md
|
||||
- Password CLI Option and Confirmation Prompt: tutorial/options/password.md
|
||||
- CLI Option Name: tutorial/options/name.md
|
||||
- CLI Option Callback and Context: tutorial/options/callback-and-context.md
|
||||
- Version CLI Option, is_eager: tutorial/options/version.md
|
||||
- CLI Option autocompletion: tutorial/options/autocompletion.md
|
||||
- Commands:
|
||||
- Commands Intro: tutorial/commands/index.md
|
||||
- Command CLI Arguments: tutorial/commands/arguments.md
|
||||
- Command CLI Options: tutorial/commands/options.md
|
||||
- Command Help: tutorial/commands/help.md
|
||||
- Custom Command Name: tutorial/commands/name.md
|
||||
- Typer Callback: tutorial/commands/callback.md
|
||||
- One or Multiple Commands: tutorial/commands/one-or-multiple.md
|
||||
- Using the Context: tutorial/commands/context.md
|
||||
- CLI Parameter Types:
|
||||
- CLI Parameter Types Intro: tutorial/parameter-types/index.md
|
||||
- Number: tutorial/parameter-types/number.md
|
||||
- Boolean CLI Options: tutorial/parameter-types/bool.md
|
||||
- UUID: tutorial/parameter-types/uuid.md
|
||||
- DateTime: tutorial/parameter-types/datetime.md
|
||||
- Enum - Choices: tutorial/parameter-types/enum.md
|
||||
- Path: tutorial/parameter-types/path.md
|
||||
- File: tutorial/parameter-types/file.md
|
||||
- SubCommands - Command Groups:
|
||||
- SubCommands - Command Groups - Intro: tutorial/subcommands/index.md
|
||||
- Add Typer: tutorial/subcommands/add-typer.md
|
||||
- SubCommands in a Single File: tutorial/subcommands/single-file.md
|
||||
- Nested SubCommands: tutorial/subcommands/nested-subcommands.md
|
||||
- Sub-Typer Callback Override: tutorial/subcommands/callback-override.md
|
||||
- SubCommand Name and Help: tutorial/subcommands/name-and-help.md
|
||||
- Multiple Values:
|
||||
- Multiple Values Intro: tutorial/multiple-values/index.md
|
||||
- Multiple CLI Options: tutorial/multiple-values/multiple-options.md
|
||||
- CLI Options with Multiple Values: tutorial/multiple-values/options-with-multiple-values.md
|
||||
- CLI Arguments with Multiple Values: tutorial/multiple-values/arguments-with-multiple-values.md
|
||||
- Ask with Prompt: tutorial/prompt.md
|
||||
- Progress Bar: tutorial/progressbar.md
|
||||
- CLI Application Directory: tutorial/app-dir.md
|
||||
- Launching Applications: tutorial/launch.md
|
||||
- Testing: tutorial/testing.md
|
||||
- Using Click: tutorial/using-click.md
|
||||
- Building a Package: tutorial/package.md
|
||||
- Typer CLI - completion for small scripts: typer-cli.md
|
||||
- Alternatives, Inspiration and Comparisons: alternatives.md
|
||||
- Help Typer - Get Help: help-typer.md
|
||||
- Development - Contributing: contributing.md
|
||||
- Release Notes: release-notes.md
|
||||
|
||||
markdown_extensions:
|
||||
- toc:
|
||||
permalink: true
|
||||
- markdown.extensions.codehilite:
|
||||
guess_lang: false
|
||||
- markdown_include.include:
|
||||
base_path: docs
|
||||
- admonition
|
||||
- codehilite
|
||||
- extra
|
||||
- pymdownx.superfences:
|
||||
custom_fences:
|
||||
- name: mermaid
|
||||
class: mermaid
|
||||
format: !!python/name:pymdownx.superfences.fence_div_format
|
||||
- pymdownx.tabbed
|
||||
- toc:
|
||||
permalink: true
|
||||
- markdown.extensions.codehilite:
|
||||
guess_lang: false
|
||||
- admonition
|
||||
- codehilite
|
||||
- extra
|
||||
- pymdownx.superfences:
|
||||
custom_fences:
|
||||
- name: mermaid
|
||||
class: mermaid
|
||||
format: !!python/name:pymdownx.superfences.fence_code_format ''
|
||||
- pymdownx.tabbed:
|
||||
alternate_style: true
|
||||
- mdx_include:
|
||||
base_path: docs
|
||||
|
||||
extra:
|
||||
social:
|
||||
- icon: fontawesome/brands/github-alt
|
||||
link: 'https://github.com/tiangolo/typer'
|
||||
- icon: fontawesome/brands/twitter
|
||||
link: 'https://twitter.com/tiangolo'
|
||||
- icon: fontawesome/brands/linkedin
|
||||
link: 'https://www.linkedin.com/in/tiangolo'
|
||||
- icon: fontawesome/brands/dev
|
||||
link: 'https://dev.to/tiangolo'
|
||||
- icon: fontawesome/brands/medium
|
||||
link: 'https://medium.com/@tiangolo'
|
||||
- icon: fontawesome/solid/globe
|
||||
link: 'https://tiangolo.com'
|
||||
analytics:
|
||||
provider: google
|
||||
property: UA-133183413-1
|
||||
social:
|
||||
- icon: fontawesome/brands/github-alt
|
||||
link: https://github.com/tiangolo/typer
|
||||
- icon: fontawesome/brands/twitter
|
||||
link: https://twitter.com/tiangolo
|
||||
- icon: fontawesome/brands/linkedin
|
||||
link: https://www.linkedin.com/in/tiangolo
|
||||
- icon: fontawesome/brands/dev
|
||||
link: https://dev.to/tiangolo
|
||||
- icon: fontawesome/brands/medium
|
||||
link: https://medium.com/@tiangolo
|
||||
- icon: fontawesome/solid/globe
|
||||
link: https://tiangolo.com
|
||||
|
||||
extra_css:
|
||||
- 'css/termynal.css'
|
||||
- 'css/custom.css'
|
||||
- css/termynal.css
|
||||
- css/custom.css
|
||||
|
||||
extra_javascript:
|
||||
- 'https://unpkg.com/mermaid@8.4.6/dist/mermaid.min.js'
|
||||
- 'js/termynal.js'
|
||||
- 'js/custom.js'
|
||||
- https://unpkg.com/mermaid@8.4.6/dist/mermaid.min.js
|
||||
- js/termynal.js
|
||||
- js/custom.js
|
||||
|
|
|
@ -49,8 +49,8 @@ test = [
|
|||
]
|
||||
doc = [
|
||||
"mkdocs >=1.1.2,<2.0.0",
|
||||
"mkdocs-material >=5.4.0,<6.0.0",
|
||||
"markdown-include >=0.5.1,<0.6.0"
|
||||
"mkdocs-material >=8.1.4,<9.0.0",
|
||||
"mdx-include >=1.4.1,<2.0.0",
|
||||
]
|
||||
dev = [
|
||||
"autoflake >=1.3.1,<2.0.0",
|
||||
|
|
Loading…
Reference in a new issue