centersl/mkdocs
1
0
Fork 0
mirror of https://github.com/mkdocs/mkdocs.git synced 2026-03-27 09:58:31 +07:00
Code Issues Packages Projects Releases Wiki Activity

Improved theme config docs.

Browse Source
This commit is contained in:
Waylan Limberg
2017-10-19 10:48:57 -04:00
parent 3f98d1deb3
commit 4b8626c166
3 changed files with 22 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/user-guide/custom-themes.md
View File

@@ -468,7 +468,7 @@ directory is a package.
### Theme Configuration
A packaged theme is required to include a configuration file named
`mkdocs.theme.yml` which is placed in the root of your template files. The file
`mkdocs_theme.yml` which is placed in the root of your template files. The file
should contain default configuration options for the theme. However, if the
theme offers no configuration options, the file is still required and can be
left blank.
@@ -476,7 +476,7 @@ left blank.
The theme author is free to define any arbitrary options deemed necessary and
those options will be made available in the templates to control behavior.
For example, a theme might want to make a sidebar optional and include the
following in the `mkdocs-theme.yml` file:
following in the `mkdocs_theme.yml` file:
```yaml
show_sidebar: true

11
docs/user-guide/styling-your-docs.md
View File

@@ -25,10 +25,18 @@ the [Customizing a Theme][customize] section below.
### mkdocs
The default theme, which was built as a custom [Bootstrap] theme, supports most
every feature of MkDocs. It only supports the default
[theme configuration options].
![mkdocs](/img/mkdocs.png)
### readthedocs
A clone of the default theme used by the [Read the Docs] service. This theme
only supports features in its parent theme and does not support any MkDocs
[theme configuration options] in addition to the defaults.
![ReadTheDocs](http://docs.readthedocs.io/en/latest/_images/screen_mobile.png)
### Third Party Themes
@@ -252,6 +260,9 @@ any additional CSS files included in the `custom_dir`.
[browse source]: https://github.com/mkdocs/mkdocs/tree/master/mkdocs/themes/mkdocs
[built-in themes]: #built-in-themes
[Bootstrap]: http://getbootstrap.com/
[theme configuration options]: configuration.md#theme
[Read the Docs]: https://readthedocs.org/
[community wiki]: https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes
[custom theme]: ./custom-themes.md
[customize]: #customizing-a-theme