How to add commenting system to all pages?

[syeda-git]

Hello,
As per the instructions on this page, I have configured Giscus and added the front matter at the top of a topic. The commenting system is visible. This is good.
https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/

Now, to add the commenting system to all the pages, i think that i need to use the meta plugin. So, i created a .meta.yml file in a subfolder under 'docs'. This is how my .meta.yml file looks like:

This is mkdocs.yml

When i run the mkdocs serve command, this error is displayed:

Am i missing anything?

Syed

[kamilkrzyskow]

Hello @syeda-git,
your .meta.yml file should not contain any ---, which in YAML define an end of file.

Instead of setting the comments: true for every file in a directory you could also change the conditional inside of comments.html
Like if page.file.src_uri.startswith("howto/"), it's up to you which is more straightforward.

Also keep in mind the indentation in the YAML file should be constant, the meta_file inside of meta plugin, should be on the same level as type inside of git-revision-date-localized

[syeda-git]

Thanks @kamilkrzyskow . That fixed the issue. Is it necessary to add a note in the topic so beginners like me don't stumble?

[kamilkrzyskow]

Thanks for offering. I personally don't think that more information is needed, as there is an example with the tags meta:
https://squidfunk.github.io/mkdocs-material/plugins/meta/#how-it-works

It doesn't contain any ---, so if it weren't for my answer you'd figure it out by running the example on the page 🤔
However, it's up to you. If you strongly consider this an issue you could create a PR with a Tip admonition.

Or the plugin could try to modify the error message, instead of using the default expected a single document / found another document the error should say, "there are --- in your file, please remove or comment them out`