mkdocs.base.yml.md

External Libraries

TACC/TACC-Docs uses external libraries with unintutive relationships.

Packages:

• MkDocs
  • uses Python-Markdown
    (which is normally installed as markdown,
    but MkDocs installs it as Markdown)
  • supports many Python-Markdown extensions
  • enables some Python-Markdown extensions by default
    (TACC-Docs enables some (in ./mkdocs.yml) via markdown_extensions)
  • offers:
    • MkDocs Theme
      (which is the default theme)
    • ReadTheDocs Theme
      (which is what TACC/TACC-Docs both uses—see theme—and extends)
• PyMdown-Extensions
  (which are extensions for Python-Markdown)
  (TACC-Docs enables some (in ./mkdocs.yml) via pymdownx.__extname__)
• mkdocs-macros
  • allows Jinja syntax
  • allows Python macros

Styles:

• TACC/Core-Styles
• Bootstrap-4
• HighlightJS
• TUP-CMS