mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-12-26 06:14:52 +01:00
73 lines
2.0 KiB
Markdown
73 lines
2.0 KiB
Markdown
# Setting up the header
|
|
|
|
Material for MkDocs' header can be customized to show an announcement bar that
|
|
disappears upon scrolling, and provides some options for further configuration.
|
|
It also includes the [search bar] and a place to display your project's
|
|
[git repository], as explained in those dedicated guides.
|
|
|
|
[search bar]: setting-up-site-search.md
|
|
[git repository]: adding-a-git-repository.md
|
|
|
|
## Configuration
|
|
|
|
### Automatic hiding
|
|
|
|
<!-- md:version 6.2.0 -->
|
|
<!-- md:feature -->
|
|
|
|
When autohiding is enabled, the header is automatically hidden when the
|
|
user scrolls past a certain threshold, leaving more space for content. Add the
|
|
following lines to `mkdocs.yml`:
|
|
|
|
``` yaml
|
|
theme:
|
|
features:
|
|
- header.autohide
|
|
```
|
|
|
|
### Announcement bar
|
|
|
|
<!-- md:version 5.0.0 -->
|
|
<!-- md:flag customization -->
|
|
|
|
Material for MkDocs includes an announcement bar, which is the perfect place to
|
|
display project news or other important information to the user. When the user
|
|
scrolls past the header, the bar will automatically disappear. In order to add
|
|
an announcement bar, [extend the theme] and [override the `announce`
|
|
block][overriding blocks], which is empty by default:
|
|
|
|
``` html
|
|
{% extends "base.html" %}
|
|
|
|
{% block announce %}
|
|
<!-- Add announcement here, including arbitrary HTML -->
|
|
{% endblock %}
|
|
```
|
|
|
|
[extend the theme]: ../customization.md#extending-the-theme
|
|
[overriding blocks]: ../customization.md#overriding-blocks
|
|
|
|
#### Mark as read
|
|
|
|
<!-- md:version 8.4.0 -->
|
|
<!-- md:feature -->
|
|
<!-- md:flag experimental -->
|
|
|
|
In order to render temporary announcements that can be marked as read by the
|
|
user, a button to dismiss the current announcement can be included. Add the
|
|
following lines to `mkdocs.yml`:
|
|
|
|
``` yaml
|
|
theme:
|
|
features:
|
|
- announce.dismiss
|
|
```
|
|
|
|
When the user clicks the button, the current announcement is dismissed and not
|
|
displayed again until the content of the announcement changes. This is handled
|
|
automatically.
|
|
|
|
[Scroll to the top of this page][top] to see it in action.
|
|
|
|
[top]: #
|