insiders.local.build.yml

# A few plugins like privacy and glightbox plugin significantly increase time to build, so use this config file for building locally with INSIDERS.
# Don't use this build configuration unless you have Insiders installed locally. 

INHERIT: mkdocs.yml

extra_css:
    - stylesheets/extra.css

plugins:
  #- glightbox Leave this commented out for local builds -- super SLOW plugin. If you need to test lightbox functionality, use insiders.mkdocs.yml instead.
  - search
  - tags #insiders
  - git-revision-date
  - social: #insiders
      cards_color:
        fill: "#1E61F0"
        text: "#FFFFFF"
      cards_font: IBM Plex Sans
  #- privacy: #slow plugin, leave commented out for local builds
      #external_links_attr_map:
        #target: _blank

# Extensions
markdown_extensions:
  - admonition
  - abbr
  - attr_list
  - def_list
  - footnotes
  - meta
  - md_in_html
  - tables
  - toc:
      permalink: true
      title: "On this page"
      toc_depth: 3
      permalink_title: Link to this section
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret # Enables super scripts
  - pymdownx.details # Enables collapsible admonitions
  - pymdownx.emoji: # Enables all sorts of emoji support
      emoji_index: !!python/name:materialx.emoji.twemoji
      emoji_generator: !!python/name:materialx.emoji.to_svg
      options:
        custom_icons:
          - overrides/.icons
  - pymdownx.highlight: # Enables code block syntax highlighting
      #anchor_linenums: true
      use_pygments: true
  - pymdownx.inlinehilite
  - pymdownx.keys # Enables inline key display
  - pymdownx.mark #
  - pymdownx.snippets # Enables snippets (content reuse)
  - pymdownx.smartsymbols
  - pymdownx.superfences: # Enables more nestable codeblocks
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed: # Enables content tabs
      alternate_style: true 
      slugify: !!python/object/apply:pymdownx.slugs.slugify
       kwds:
          case: lower
  - pymdownx.tasklist: # Enables task lists
      custom_checkbox: true
  - pymdownx.tilde # enables strikthrough (<del> tags) and subscripts https://facelessuser.github.io/pymdown-extensions/extensions/tilde/


# Long explanation for this extra doc. 
# In order to use config inheritance, everything must use the alternative syntax (key:value vs lists)
# Lists are replaced wholesale with config inheritence. 
# I couldn't get alternative syntax to work on mkdocs.yml without throwing constant errors and strange behavior.
# For now, mkdocs.yml plugins need to be all NON-insiders plugins and extensions, and insiders.mkdocs.yml is ALL plugins and extensions.