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
|
---
myst:
html_meta:
"description lang=en": |
Documentation for users who wish to build sphinx sites with
pydata-sphinx-theme.
---
# User Guide
You can configure the behavior, look, and feel of the theme in many ways.
The remaining pages in the user guide cover various ways of doing so.
```{danger}
This theme is still under active development, and we make no promises
about the stability of any specific HTML structure, CSS variables, etc.
Make these customizations at your own risk, and pin versions if you're
worried about breaking changes!
```
There are a number of options for configuring your site's look and feel.
All configuration options are passed with the `html_theme_options` variable in your `conf.py` file.
This is a dictionary with `key: val` pairs that you can configure in various ways.
```{toctree}
:caption: Get started
install
layout
```
```{toctree}
:caption: Navigation and links
navigation
page-toc
header-links
source-buttons
indices
```
```{toctree}
:maxdepth: 2
:caption: User Interface
announcements
version-dropdown
search
keyboard-shortcuts
i18n
back-to-top
```
```{toctree}
:caption: Content and features
theme-elements
ablog
web-components
extending
```
```{toctree}
:caption: Theming and Style
branding
styling
fonts
light-dark
```
```{toctree}
:caption: Miscellaneous
accessibility
analytics
static_assets
performance
warnings
readthedocs
```
|
