File Structure¶

mkdocs-dap/
├── mkdocs.yml                    Site configuration
├── docs/                         Your Markdown content
│   ├── index.md
│   └── assets/
│       └── img/
│           ├── avatar.png        Sidebar profile image
│           ├── og-default.png    Default Open Graph image
|           └── favicon.ico       Custom favicon
└── themes/dap/
    ├── main.html                 Root template — assembles all partials
    ├── partials/
    │   ├── analytics.html        Google Analytics injection
    │   ├── cookie-banner.html    GDPR/LOPD consent banner
    │   ├── footer.html           Footer with social icons
    │   ├── header.html           Sticky header bar
    │   ├── icons.html            Shared social SVG macro
    │   ├── i18n.html.bak         Reference only (T is defined in main.html)
    │   ├── page-nav.html         Previous/Next navigation
    │   ├── seo.html              All SEO meta tags
    │   ├── sidebar.html          Sidebar with profile + nav
    │   ├── toc.html              Table of contents
    │   └── topnav.html           Top navigation bar
    └── assets/
        ├── css/
        │   ├── vars.css           Design tokens, color schemes, reset
        │   ├── sidebar.css        Sidebar styles
        │   ├── header.css         Header + theme panel + GitHub button
        │   ├── topnav.css         Top navigation dropdowns
        │   ├── content.css        Article, code, admonitions, TOC, page-nav
        │   ├── footer.css         Footer + social icons
        │   ├── highlight.css      Syntax highlighting
        │   └── cookie-banner.css  Cookie consent banner
        └── js/
            ├── theme-toggle.js    Scheme + accent color panel
            ├── sidebar.js         Mobile toggle + collapsible nav + search
            ├── topnav.js          Dropdown logic (hover/click, unlimited depth)
            ├── toc.js             Active TOC link tracking
            ├── copy-code.js       Copy button on code blocks
            ├── github-btn.js      Fetches star count from GitHub API
            └── cookie-banner.js   GDPR consent + analytics gating

Adding custom CSS¶

Place your file in docs/assets/ and reference it:

extra_css:
  - assets/extra.css

Adding custom JS¶

extra_javascript:
  - assets/extra.js

Custom JS files are loaded after all theme scripts.