1.5 KiB
| template |
|---|
| overrides/main.html |
Adding a comment system
Material for MkDocs is natively integrated with Disqus, a comment system that provides a wide range of features like social integrations, user profiles, as well as spam and moderation tools. Of course, other comment systems can be integrated, too.
Configuration
Disqus
:octicons-file-code-24: Source · :octicons-milestone-24: Default: none
First, ensure you've set site_url in mkdocs.yml. Then, to integrate
Material for MkDocs with Disqus, create an account and a site giving you a
shortname, and add it to mkdocs.yml:
extra:
disqus: <shortname>
This will insert a comment system on every page, except the index page.
Customization
Selective integration
:octicons-file-code-24: Source · :octicons-mortar-board-24: Difficulty: easy
If the Metadata extension is enabled, you can disable or enable Disqus for specific pages by adding the following to the front matter of a page:
=== "Enable Disqus"
``` markdown
---
disqus: <shortname>
---
```
=== "Disable Disqus"
``` markdown
---
disqus: ""
---
```