-
Notifications
You must be signed in to change notification settings - Fork 84
/
Copy pathmkdocs_template.yml
131 lines (121 loc) · 3.35 KB
/
mkdocs_template.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
# Site metadata
site_name: Geek Time Docs
site_description: 极客时间在线文档
site_url:
site_author: zkep
repo_url: https://github.com/uaxe/geektime-docs
edit_uri: https://github.com/uaxe/geektime-docs
repo_name: uaxe/geektime-docs
remote_name: https://github.com/uaxe/geektime-docs
docs_dir: "dist/" # where to find the markdown files
site_dir: "site/" # where to publish to
use_directory_urls: true # don't display 'index.html' in slugs
# Theme customization
theme:
name: material
language: en
custom_dir: overrides/
logo:
favicon:
icon:
repo: fontawesome/brands/github
# font: # disabled for faster page load times
# text: Helvetica
# code: Roboto Mono
palette:
- media: "(prefers-color-scheme)"
toggle:
icon: material/brightness-auto
name: Switch to light mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: black
accent: indigo
toggle:
icon: material/brightness-4
name: Switch to system preference
- media: "(prefers-color-scheme: light)"
scheme: default
primary: indigo
accent: indigo
toggle:
icon: material/brightness-7
name: Switch to dark mode
features:
- content.action.edit
- content.code.annotate
- content.code.copy
- content.tooltips
- toc.follow
- navigation.top
- navigation.tabs
- navigation.tabs.sticky
- navigation.prune
- navigation.footer
- navigation.tracking
- navigation.instant
- navigation.instant.progress
- navigation.indexes
# - navigation.sections # navigation.expand or navigation.sections
- content.tabs.link # all code tabs change simultaneously
# Customization
copyright: Copyright © 2025-Present zkep
extra_css:
- stylesheets/style.css
extra_javascript:
- javascript/extra.js
- javascript/giscus.js
markdown_extensions:
- admonition
- md_in_html
- tables
- attr_list
- def_list
- pymdownx.critic
- pymdownx.caret
- pymdownx.keys
- pymdownx.mark
- pymdownx.tilde
- pymdownx.details
- pymdownx.superfences
- pymdownx.inlinehilite
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.snippets:
base_path: ./
- pymdownx.tabbed:
alternate_style: true
# Validation settings https://www.mkdocs.org/user-guide/configuration/#validation
validation:
nav:
omitted_files: info
not_found: warn
absolute_links: info
links:
absolute_links: relative_to_docs
anchors: warn
unrecognized_links: warn
# Plugins including 301 redirects navigation ---------------------------------------------------------------------------
plugins:
- mkdocstrings:
enabled: true
default_handler: python
handlers:
python:
options:
docstring_options:
ignore_init_summary: true
merge_init_into_class: true
docstring_style: google
show_root_heading: true
show_source: true
separate_signature: true
line_length: 80
show_signature_annotations: true
show_symbol_type_heading: true # insiders
show_symbol_type_toc: true # insiders
show_inheritance_diagram: true # insiders
- redirects:
redirect_maps:
# Primary navigation ---------------------------------------------------------------------------------------------------
nav: