theme.json (24556B)
1 { 2 "$schema": "https://json-schema.org/draft-07/schema", 3 "title": "Theme configuration", 4 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/", 5 "type": "object", 6 "properties": { 7 "name": { 8 "title": "Theme name", 9 "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#name", 10 "oneOf": [ 11 { 12 "enum": [ 13 "material" 14 ] 15 }, 16 { 17 "type": "null" 18 } 19 ], 20 "default": "material" 21 }, 22 "custom_dir": { 23 "title": "Directory with theme overrides", 24 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/customization/#setup-and-theme-structure", 25 "type": "string", 26 "defaultSnippets": [ 27 { 28 "body": "${1:overrides}" 29 } 30 ] 31 }, 32 "static_templates": { 33 "title": "Static templates to render", 34 "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#static_templates", 35 "type": "array", 36 "items": { 37 "title": "Path to HTML file", 38 "markdownDescription": "https://www.mkdocs.org/user-guide/configuration/#static_templates", 39 "pattern": "\\.html$" 40 }, 41 "uniqueItems": true, 42 "minItems": 1 43 }, 44 "language": { 45 "title": "Site language", 46 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/", 47 "oneOf": [ 48 { 49 "title": "Site language: Custom", 50 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#custom-translations", 51 "enum": [ 52 "custom" 53 ] 54 }, 55 { 56 "title": "Site language: Afrikaans", 57 "enum": [ 58 "af" 59 ] 60 }, 61 { 62 "title": "Site language: Arabic", 63 "enum": [ 64 "ar" 65 ] 66 }, 67 { 68 "title": "Site language: Bulgarian", 69 "enum": [ 70 "bg" 71 ] 72 }, 73 { 74 "title": "Site language: Bengali (Bangla)", 75 "enum": [ 76 "bn" 77 ] 78 }, 79 { 80 "title": "Site language: Catalan", 81 "enum": [ 82 "ca" 83 ] 84 }, 85 { 86 "title": "Site language: Czech", 87 "enum": [ 88 "cs" 89 ] 90 }, 91 { 92 "title": "Site language: Danish", 93 "enum": [ 94 "da" 95 ] 96 }, 97 { 98 "title": "Site language: German", 99 "enum": [ 100 "de" 101 ] 102 }, 103 { 104 "title": "Site language: Greek", 105 "enum": [ 106 "el" 107 ] 108 }, 109 { 110 "title": "Site language: English", 111 "enum": [ 112 "en" 113 ] 114 }, 115 { 116 "title": "Site language: Esperanto", 117 "enum": [ 118 "eo" 119 ] 120 }, 121 { 122 "title": "Site language: Spanish", 123 "enum": [ 124 "es" 125 ] 126 }, 127 { 128 "title": "Site language: Estonian", 129 "enum": [ 130 "et" 131 ] 132 }, 133 { 134 "title": "Site language: Persian (Farsi)", 135 "enum": [ 136 "fa" 137 ] 138 }, 139 { 140 "title": "Site language: Finnish", 141 "enum": [ 142 "fi" 143 ] 144 }, 145 { 146 "title": "Site language: French", 147 "enum": [ 148 "fr" 149 ] 150 }, 151 { 152 "title": "Site language: Galician", 153 "enum": [ 154 "gl" 155 ] 156 }, 157 { 158 "title": "Site language: Hebrew", 159 "enum": [ 160 "he" 161 ] 162 }, 163 { 164 "title": "Site language: Hindi", 165 "enum": [ 166 "hi" 167 ] 168 }, 169 { 170 "title": "Site language: Croatian", 171 "enum": [ 172 "hr" 173 ] 174 }, 175 { 176 "title": "Site language: Hungarian", 177 "enum": [ 178 "hu" 179 ] 180 }, 181 { 182 "title": "Site language: Armenian", 183 "enum": [ 184 "hy" 185 ] 186 }, 187 { 188 "title": "Site language: Indonesian", 189 "enum": [ 190 "id" 191 ] 192 }, 193 { 194 "title": "Site language: Icelandic", 195 "enum": [ 196 "is" 197 ] 198 }, 199 { 200 "title": "Site language: Italian", 201 "enum": [ 202 "it" 203 ] 204 }, 205 { 206 "title": "Site language: Japanese", 207 "enum": [ 208 "ja" 209 ] 210 }, 211 { 212 "title": "Site language: Georgian", 213 "enum": [ 214 "ka" 215 ] 216 }, 217 { 218 "title": "Site language: Korean", 219 "enum": [ 220 "kr" 221 ] 222 }, 223 { 224 "title": "Site language: Lithuanian", 225 "enum": [ 226 "lt" 227 ] 228 }, 229 { 230 "title": "Site language: Latvian", 231 "enum": [ 232 "lv" 233 ] 234 }, 235 { 236 "title": "Site language: Macedonian", 237 "enum": [ 238 "mk" 239 ] 240 }, 241 { 242 "title": "Site language: Mongolian", 243 "enum": [ 244 "mn" 245 ] 246 }, 247 { 248 "title": "Site language: Bahasa Malaysia", 249 "enum": [ 250 "ms" 251 ] 252 }, 253 { 254 "title": "Site language: Burmese", 255 "enum": [ 256 "my" 257 ] 258 }, 259 { 260 "title": "Site language: Dutch", 261 "enum": [ 262 "nl" 263 ] 264 }, 265 { 266 "title": "Site language: Norwegian (Nynorsk)", 267 "enum": [ 268 "nn" 269 ] 270 }, 271 { 272 "title": "Site language: Norwegian", 273 "enum": [ 274 "no" 275 ] 276 }, 277 { 278 "title": "Site language: Polish", 279 "enum": [ 280 "pl" 281 ] 282 }, 283 { 284 "title": "Site language: Portuguese", 285 "enum": [ 286 "pt" 287 ] 288 }, 289 { 290 "title": "Site language: Portuguese (Brasilian)", 291 "enum": [ 292 "pt-BR" 293 ] 294 }, 295 { 296 "title": "Site language: Romanian", 297 "enum": [ 298 "ro" 299 ] 300 }, 301 { 302 "title": "Site language: Russian", 303 "enum": [ 304 "ru" 305 ] 306 }, 307 { 308 "title": "Site language: Serbo-Croatian", 309 "enum": [ 310 "sh" 311 ] 312 }, 313 { 314 "title": "Site language: Sinhalese", 315 "enum": [ 316 "si" 317 ] 318 }, 319 { 320 "title": "Site language: Slovak", 321 "enum": [ 322 "sk" 323 ] 324 }, 325 { 326 "title": "Site language: Slovenian", 327 "enum": [ 328 "sl" 329 ] 330 }, 331 { 332 "title": "Site language: Serbian", 333 "enum": [ 334 "sr" 335 ] 336 }, 337 { 338 "title": "Site language: Swedish", 339 "enum": [ 340 "sv" 341 ] 342 }, 343 { 344 "title": "Site language: Thai", 345 "enum": [ 346 "th" 347 ] 348 }, 349 { 350 "title": "Site language: Tagalog", 351 "enum": [ 352 "tl" 353 ] 354 }, 355 { 356 "title": "Site language: Turkish", 357 "enum": [ 358 "tr" 359 ] 360 }, 361 { 362 "title": "Site language: Ukrainian", 363 "enum": [ 364 "uk" 365 ] 366 }, 367 { 368 "title": "Site language: Urdu", 369 "enum": [ 370 "ur" 371 ] 372 }, 373 { 374 "title": "Site language: Uzbek", 375 "enum": [ 376 "uz" 377 ] 378 }, 379 { 380 "title": "Site language: Vietnamese", 381 "enum": [ 382 "vi" 383 ] 384 }, 385 { 386 "title": "Site language: Chinese (Simplified)", 387 "enum": [ 388 "zh" 389 ] 390 }, 391 { 392 "title": "Site language: Chinese (Traditional)", 393 "enum": [ 394 "zh-Hant" 395 ] 396 }, 397 { 398 "title": "Site language: Chinese (Taiwanese)", 399 "enum": [ 400 "zh-TW" 401 ] 402 } 403 ], 404 "default": "en" 405 }, 406 "direction": { 407 "title": "Directionality", 408 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#directionality", 409 "enum": [ 410 "ltr", 411 "rtl" 412 ] 413 }, 414 "favicon": { 415 "title": "Favicon", 416 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-logo-and-icons/#favicon", 417 "pattern": "\\.(ico|png|svg|jpe?g)$", 418 "defaultSnippets": [ 419 { 420 "body": "${1:path/to/file}.png" 421 } 422 ] 423 }, 424 "logo": { 425 "title": "Logo", 426 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-logo-and-icons/#logo", 427 "pattern": "\\.(png|svg|jpe?g)$", 428 "defaultSnippets": [ 429 { 430 "body": "${1:path/to/file}.png" 431 } 432 ] 433 }, 434 "icon": { 435 "title": "Icons", 436 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-logo-and-icons/", 437 "type": "object", 438 "properties": { 439 "logo": { 440 "$ref": "#/definitions/icon" 441 }, 442 "repo": { 443 "$ref": "#/definitions/icon" 444 }, 445 "admonition": { 446 "title": "Admonition icon", 447 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/admonitions/#admonition-icons", 448 "type": "object", 449 "properties": { 450 "note": { 451 "$ref": "#/definitions/icon" 452 }, 453 "abstract": { 454 "$ref": "#/definitions/icon" 455 }, 456 "info": { 457 "$ref": "#/definitions/icon" 458 }, 459 "tip": { 460 "$ref": "#/definitions/icon" 461 }, 462 "success": { 463 "$ref": "#/definitions/icon" 464 }, 465 "question": { 466 "$ref": "#/definitions/icon" 467 }, 468 "warning": { 469 "$ref": "#/definitions/icon" 470 }, 471 "failure": { 472 "$ref": "#/definitions/icon" 473 }, 474 "danger": { 475 "$ref": "#/definitions/icon" 476 }, 477 "bug": { 478 "$ref": "#/definitions/icon" 479 }, 480 "example": { 481 "$ref": "#/definitions/icon" 482 }, 483 "quote": { 484 "$ref": "#/definitions/icon" 485 } 486 }, 487 "additionalProperties": false, 488 "defaultSnippets": [ 489 { 490 "label": "note", 491 "body": "note: ${1:material/pencil}" 492 }, 493 { 494 "label": "abstract", 495 "body": "abstract: ${1:material/clipboard-text}" 496 }, 497 { 498 "label": "info", 499 "body": "info: ${1:material/information}" 500 }, 501 { 502 "label": "tip", 503 "body": "tip: ${1:material/fire}" 504 }, 505 { 506 "label": "success", 507 "body": "success: ${1:material/check-bold}" 508 }, 509 { 510 "label": "question", 511 "body": "question: ${1:material/help-circle}" 512 }, 513 { 514 "label": "warning", 515 "body": "warning: ${1:material/alert}" 516 }, 517 { 518 "label": "failure", 519 "body": "failure: ${1:material/close-thick}" 520 }, 521 { 522 "label": "danger", 523 "body": "danger: ${1:material/lightning-bolt}" 524 }, 525 { 526 "label": "bug", 527 "body": "bug: ${1:material/bug}" 528 }, 529 { 530 "label": "example", 531 "body": "example: ${1:material/format-list-numbered}" 532 }, 533 { 534 "label": "quote", 535 "body": "quote: ${1:material/format-quote-close}" 536 } 537 ] 538 }, 539 "tag": { 540 "title": "Tag icon", 541 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-tags/#tag-icons", 542 "type": "object", 543 "patternProperties": { 544 "^\\w+$": { 545 "$ref": "#/definitions/icon" 546 } 547 }, 548 "additionalProperties": false 549 } 550 }, 551 "additionalProperties": false, 552 "defaultSnippets": [ 553 { 554 "label": "logo", 555 "body": "logo: ${1:material/library}" 556 }, 557 { 558 "label": "repo", 559 "body": "repo: ${1:fontawesome/brands/git-alt}" 560 } 561 ] 562 }, 563 "features": { 564 "title": "Feature flags", 565 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/", 566 "type": "array", 567 "items": { 568 "oneOf": [ 569 { 570 "title": "Mark as read", 571 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-header/#mark-as-read", 572 "enum": [ 573 "announce.dismiss" 574 ] 575 }, 576 { 577 "title": "Code annotations", 578 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/code-blocks/#code-annotations", 579 "enum": [ 580 "content.code.annotate" 581 ] 582 }, 583 { 584 "title": "Linked content tabs", 585 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/content-tabs/#linked-content-tabs", 586 "enum": [ 587 "content.tabs.link" 588 ] 589 }, 590 { 591 "title": "Improved tooltips", 592 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/reference/tooltips/#improved-tooltips", 593 "enum": [ 594 "content.tooltips" 595 ] 596 }, 597 { 598 "title": "Header hides automatically when scrolling", 599 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-the-header/#automatic-hiding", 600 "enum": [ 601 "header.autohide" 602 ] 603 }, 604 { 605 "title": "Navigation expansion", 606 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-expansion", 607 "enum": [ 608 "navigation.expand" 609 ] 610 }, 611 { 612 "title": "Section index pages", 613 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#section-index-pages", 614 "enum": [ 615 "navigation.indexes" 616 ] 617 }, 618 { 619 "title": "Instant loading", 620 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#instant-loading", 621 "enum": [ 622 "navigation.instant" 623 ] 624 }, 625 { 626 "title": "Navigation pruning", 627 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-pruning", 628 "enum": [ 629 "navigation.prune" 630 ] 631 }, 632 { 633 "title": "Navigation sections", 634 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-sections", 635 "enum": [ 636 "navigation.sections" 637 ] 638 }, 639 { 640 "title": "Navigation tabs", 641 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-tabs", 642 "enum": [ 643 "navigation.tabs" 644 ] 645 }, 646 { 647 "title": "Sticky navigation tabs", 648 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#sticky-navigation-tabs", 649 "enum": [ 650 "navigation.tabs.sticky" 651 ] 652 }, 653 { 654 "title": "Back-to-top button", 655 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#back-to-top-button", 656 "enum": [ 657 "navigation.top" 658 ] 659 }, 660 { 661 "title": "Anchor tracking", 662 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#anchor-tracking", 663 "enum": [ 664 "navigation.tracking" 665 ] 666 }, 667 { 668 "title": "Search higlighting", 669 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#search-highlighting", 670 "enum": [ 671 "search.highlight" 672 ] 673 }, 674 { 675 "title": "Search sharing", 676 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#search-sharing", 677 "enum": [ 678 "search.share" 679 ] 680 }, 681 { 682 "title": "Search suggestions", 683 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#search-suggestions", 684 "enum": [ 685 "search.suggest" 686 ] 687 }, 688 { 689 "title": "Integrated table of contents", 690 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#anchor-following", 691 "enum": [ 692 "toc.follow" 693 ] 694 }, 695 { 696 "title": "Integrated table of contents", 697 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/#navigation-integration", 698 "enum": [ 699 "toc.integrate" 700 ] 701 } 702 ] 703 }, 704 "uniqueItems": true, 705 "minItems": 1 706 }, 707 "palette": { 708 "oneOf": [ 709 { 710 "title": "Color palette", 711 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/", 712 "type": "object", 713 "properties": { 714 "scheme": { 715 "$ref": "#/definitions/scheme" 716 }, 717 "primary": { 718 "$ref": "#/definitions/primary" 719 }, 720 "accent": { 721 "$ref": "#/definitions/accent" 722 } 723 }, 724 "additionalProperties": false 725 }, 726 { 727 "title": "Color palette", 728 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/", 729 "type": "array", 730 "items": { 731 "type": "object", 732 "properties": { 733 "scheme": { 734 "$ref": "#/definitions/scheme" 735 }, 736 "primary": { 737 "$ref": "#/definitions/primary" 738 }, 739 "accent": { 740 "$ref": "#/definitions/accent" 741 }, 742 "media": { 743 "oneOf": [ 744 { 745 "title": "System preference", 746 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#system-preference", 747 "type": "string", 748 "enum": [ 749 "\"(prefers-color-scheme: light)\"", 750 "\"(prefers-color-scheme: dark)\"" 751 ] 752 }, 753 { 754 "type": "string" 755 } 756 ], 757 "defaultSnippets": [ 758 { 759 "label": "\"(prefers-color-scheme: light)\"", 760 "body": "\"(prefers-color-scheme: ${1:light})\"" 761 } 762 ] 763 }, 764 "toggle": { 765 "title": "Color palette toggle", 766 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#color-palette-toggle", 767 "properties": { 768 "icon": { 769 "$ref": "#/definitions/icon" 770 }, 771 "name": { 772 "title": "Color palette toggle name", 773 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#toggle-name", 774 "type": "string" 775 } 776 }, 777 "additionalProperties": false, 778 "required": [ 779 "icon", 780 "name" 781 ] 782 } 783 }, 784 "additionalProperties": false, 785 "required": [ 786 "toggle" 787 ] 788 }, 789 "uniqueItems": true, 790 "minItems": 1 791 } 792 ], 793 "default": { 794 "scheme": "default", 795 "primary": "indigo", 796 "accent": "indigo" 797 } 798 }, 799 "font": { 800 "oneOf": [ 801 { 802 "title": "Google Fonts", 803 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-fonts/", 804 "properties": { 805 "text": { 806 "$ref": "assets/fonts.json" 807 }, 808 "code": { 809 "$ref": "assets/fonts.json" 810 } 811 }, 812 "additionalProperties": false 813 }, 814 { 815 "title": "Disable Google Fonts", 816 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-fonts/#autoloading", 817 "enum": [ 818 false 819 ] 820 } 821 ], 822 "defaultSnippets": [ 823 { 824 "body": { 825 "text": "${1:Roboto}", 826 "code": "${2:Roboto Mono}" 827 } 828 } 829 ] 830 }, 831 "include_search_page": { 832 "title": "Only necessary when installing from git", 833 "markdownDescription": "Must be set to `false`", 834 "enum": [ 835 false 836 ] 837 }, 838 "search_index_only": { 839 "title": "Only necessary when installing from git", 840 "markdownDescription": "Must be set to `false`", 841 "enum": [ 842 true 843 ] 844 } 845 }, 846 "additionalProperties": false, 847 "required": [ 848 "name" 849 ], 850 "definitions": { 851 "scheme": { 852 "title": "Color scheme", 853 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#color-scheme", 854 "oneOf": [ 855 { 856 "enum": [ 857 "default", 858 "slate" 859 ] 860 }, 861 { 862 "type": "string" 863 } 864 ], 865 "defaultSnippets": [ 866 { 867 "label": "default", 868 "body": "${1:default}" 869 } 870 ] 871 }, 872 "primary": { 873 "title": "Primary color", 874 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#primary-color", 875 "enum": [ 876 "red", 877 "pink", 878 "purple", 879 "deep purple", 880 "indigo", 881 "blue", 882 "light blue", 883 "cyan", 884 "teal", 885 "green", 886 "light green", 887 "lime", 888 "yellow", 889 "amber", 890 "orange", 891 "deep orange", 892 "brown", 893 "grey", 894 "blue grey", 895 "black", 896 "white" 897 ] 898 }, 899 "accent": { 900 "title": "Accent color", 901 "markdownDescription": "https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#accent-color", 902 "enum": [ 903 "red", 904 "pink", 905 "purple", 906 "deep purple", 907 "indigo", 908 "blue", 909 "light blue", 910 "cyan", 911 "teal", 912 "green", 913 "light green", 914 "lime", 915 "yellow", 916 "amber", 917 "orange", 918 "deep orange", 919 "brown", 920 "grey", 921 "blue grey", 922 "black", 923 "white" 924 ] 925 }, 926 "icon": { 927 "oneOf": [ 928 { 929 "$ref": "assets/icons.json" 930 }, 931 { 932 "title": "Unknown icon", 933 "type": "string" 934 } 935 ] 936 } 937 } 938 }