2016-08-07 19:01:56 +03:00
|
|
|
|
# Material <small>for MkDocs</small>
|
2016-02-09 23:59:37 +03:00
|
|
|
|
|
2020-03-29 21:26:22 +03:00
|
|
|
|
|
|
|
|
|
<style>
|
|
|
|
|
.md-typeset .admonition.seealso .admonition-title::before {
|
|
|
|
|
content: "question_answer";
|
|
|
|
|
}
|
|
|
|
|
</style>
|
|
|
|
|
|
|
|
|
|
!!! seealso "[User Survey 2020][0]{ target="_blank" rel="noopener" } – tell us about you, it takes only 2 minutes of your time!"
|
|
|
|
|
|
|
|
|
|
__Material for MkDocs 5__ is around the corner and we would like to learn
|
|
|
|
|
more __about you__ and __how you use__ this project. [Take the survey][0]{ target="_blank" rel="noopener" }
|
|
|
|
|
and help us learn about your experiences, so we can make this project even
|
|
|
|
|
better!
|
|
|
|
|
|
|
|
|
|
[0]: https://forms.gle/4mJgtJRbvZr1spk38
|
|
|
|
|
|
2018-01-19 00:32:40 +03:00
|
|
|
|
## Create beautiful project documentation
|
2016-02-09 23:59:37 +03:00
|
|
|
|
|
2017-01-03 01:11:32 +03:00
|
|
|
|
Material is a theme for [MkDocs][1], an excellent static site generator geared
|
2017-01-12 02:49:28 +03:00
|
|
|
|
towards project documentation. It is built using Google's [Material Design][2]
|
2017-01-12 22:15:30 +03:00
|
|
|
|
guidelines.
|
2016-02-09 23:59:37 +03:00
|
|
|
|
|
2017-11-18 20:00:39 +03:00
|
|
|
|
[![Material for MkDocs](assets/images/material.png)](assets/images/material.png)
|
2017-01-13 00:39:18 +03:00
|
|
|
|
|
2018-06-10 16:30:26 +03:00
|
|
|
|
[1]: https://www.mkdocs.org
|
2019-08-23 18:33:06 +03:00
|
|
|
|
[2]: https://material.io/design/
|
2017-01-03 01:11:32 +03:00
|
|
|
|
|
2016-02-24 19:31:01 +03:00
|
|
|
|
## Quick start
|
|
|
|
|
|
2017-01-03 01:11:32 +03:00
|
|
|
|
Install the latest version of Material with `pip`:
|
2016-02-24 19:31:01 +03:00
|
|
|
|
|
|
|
|
|
``` sh
|
|
|
|
|
pip install mkdocs-material
|
|
|
|
|
```
|
|
|
|
|
|
2017-09-06 11:18:57 +03:00
|
|
|
|
Append the following line to your project's `mkdocs.yml`:
|
2016-02-24 19:31:01 +03:00
|
|
|
|
|
|
|
|
|
``` yaml
|
2017-10-31 21:42:43 +03:00
|
|
|
|
theme:
|
|
|
|
|
name: 'material'
|
2016-02-24 19:31:01 +03:00
|
|
|
|
```
|
|
|
|
|
|
2017-09-06 11:18:57 +03:00
|
|
|
|
## What to expect
|
|
|
|
|
|
|
|
|
|
* Responsive design and fluid layout for all kinds of screens and devices,
|
2020-02-09 00:15:47 +03:00
|
|
|
|
designed to serve your project documentation in a user-friendly way in 41
|
2018-01-13 19:19:07 +03:00
|
|
|
|
languages with optimal readability.
|
2017-09-06 11:18:57 +03:00
|
|
|
|
|
|
|
|
|
* Easily customizable primary and accent color, fonts, favicon and logo;
|
|
|
|
|
straight forward localization through theme extension; integrated with Google
|
|
|
|
|
Analytics, Disqus and GitHub.
|
|
|
|
|
|
|
|
|
|
* Well-designed search interface accessible through hotkeys (<kbd>F</kbd> or
|
|
|
|
|
<kbd>S</kbd>), intelligent grouping of search results, search term
|
|
|
|
|
highlighting and lazy loading.
|
|
|
|
|
|
2017-01-12 02:49:28 +03:00
|
|
|
|
For detailed instructions see the [getting started guide][3].
|
|
|
|
|
|
|
|
|
|
[3]: getting-started.md
|