iframe-proxy | Sunbelt Computer Software

230 lines (219 loc) · 5.92 KB
# Project information
site_name: cmd2
site_description:
  cmd2 - quickly build feature-rich and user-friendly interactive command line applications in
site_dir: build/html
site_url: !ENV [READTHEDOCS_CANONICAL_URL, https://cmd2.readthedocs.io/]
# Repository
repo_name: cmd2
repo_url: https://github.com/python-cmd2/cmd2
edit_uri: edit/main/docs
# Copyright
copyright: Copyright &copy; 2026, cmd2 contributors.
# Configuration
  name: material
  language: en
  custom_dir: docs/overrides
    repo: fontawesome/brands/github
    logo: material/home
    edit: material/pencil
    view: material/eye
    # Palette toggle for light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: light blue
      accent: deep orange
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    # Palette toggle for dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: blue
      accent: deep purple
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode
  features:
    - announce.dismiss
    - content.action.view
    - content.action.edit
    - content.code.copy
    - content.tabs.link
    - navigation.footer
    - navigation.indexes
    - navigation.prune
    - navigation.sections
    - navigation.tabs
    - navigation.top
    - navigation.tracking
    - toc.follow
  - git-revision-date-localized
  - mkdocstrings:
      handlers:
        python:
          options:
            show_root_heading: true
            show_if_no_docstring: true
            preload_modules:
              - argparse
            inherited_members: true
            members_order: source
            separate_signature: true
            unwrap_annotated: true
            filters:
              - "!^_"
              - "get_bottom_toolbar"
            merge_init_into_class: true
            docstring_style: sphinx
            docstring_section_style: spacy
            signature_crossrefs: true
            show_symbol_type_heading: true
            show_symbol_type_toc: true
# Customizations
    - icon: fontawesome/brands/github
      link: https://github.com/python-cmd2/cmd2
    - icon: simple/pypi
      link: https://pypi.org/project/cmd2/
# Extensions
# - These are carefully chosen to work with pandoc markdown support for whole document translation
markdown_extensions:
  - admonition
  - attr_list
  - def_list
  - md_in_html
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
      options:
        custom_icons:
          - overrides/.icons
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      base_path: [".", "docs"]
      check_paths: true
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
# Validation
validation:
  invalid_link_anchors: true
  invalid_links: true
  shadowed_definitions: true
  shadowed_footnotes: true
  unresolved_footnotes: true
  # bug with mkdocstrings autorefs: https://github.com/zensical/zensical/issues/600
  unresolved_references: false
  unused_definitions: true
  unused_footnotes: true
not_in_nav: |
  **/download/*.md
# Page tree
  - Home: index.md
  - Getting Started:
      - overview/index.md
      - overview/installation.md
      - overview/integrating.md
      - overview/alternatives.md
      - overview/resources.md
  - Upgrading from cmd to cmd2:
      - migrating/index.md
      - migrating/why.md
      - migrating/incompatibilities.md
      - migrating/minimum.md
      - migrating/next_steps.md
  - Features:
      - features/index.md
      - features/argument_processing.md
      - features/annotated.md
      - features/async_commands.md
      - features/builtin_commands.md
      - features/clipboard.md
      - features/commands.md
      - features/completion.md
      - features/disable_commands.md
      - features/embedded_python_shells.md
      - features/generating_output.md
      - features/help.md
      - features/history.md
      - features/hooks.md
      - features/initialization.md
      - features/misc.md
      - features/modular_commands.md
      - features/multiline_commands.md
      - features/os.md
      - features/packaging.md
      - features/plugins.md
      - features/prompt.md
      - features/redirection.md
      - features/scripting.md
      - features/settings.md
      - features/shortcuts_aliases_macros.md
      - features/startup_commands.md
      - features/table_creation.md
      - features/theme.md
  - Examples:
      - examples/index.md
      - examples/getting_started.md
      - examples/alternate_event_loops.md
      - examples/examples.md
  - Mixins:
      - mixins/index.md
      - mixins/mixin_template.md
  - Testing:
      - testing.md
  - API Reference:
      - api/index.md
      - api/cmd.md
      - api/annotated.md
      - api/argparse_completer.md
      - api/argparse_utils.md
      - api/clipboard.md
      - api/colors.md
      - api/command_set.md
      - api/completion.md
      - api/constants.md
      - api/decorators.md
      - api/exceptions.md
      - api/history.md
      - api/parsing.md
      - api/plugin.md
      - api/pt_utils.md
      - api/py_bridge.md
      - api/rich_utils.md
      - api/string_utils.md
      - api/styles.md
      - api/theme.md
      - api/utils.md
  - Version Upgrades:
      - upgrades.md
      - doc_conventions.md
# Include extra CSS to make some style adjustments for visible width
  - stylesheets/cmd2.css
# Include extra JS to setup Read the Docs addons integrations
extra_javascript:
  - javascripts/readthedocs.js
Sunbelt Computer Software

PL/B Language Development and Support

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

mkdocs.yml

Latest commit

History

mkdocs.yml

File metadata and controls
