search

fralau / mkdocs-macros-plugin

Create richer and more beautiful pages in MkDocs, by using variables and calls to macros in the markdown code.
https://mkdocs-macros-plugin.readthedocs.io
Other
331 stars 51 forks source link

Disable Rendering source page info messages #248

Open mhussein opened 2 hours ago

mhussein commented 2 hours ago

We recently updated from 1.0.5 to 1.3.5 and started seeing a lot of messages in the log, for example

INFO    -  [macros] - Rendering source page: index.md
INFO    -  [macros] - Rendering source page: apis.md
INFO    -  [macros] - Rendering source page: docs.md
INFO    -  [macros] - Rendering source page: tags.md
...
...

Is there a way to suppress those log messages?

github-actions[bot] commented 2 hours ago

Welcome to this project and thank you!

fralau commented 50 minutes ago

Good question. We could perhaps downgrade some of these messages as DEBUG? 🤔

Aside of these, which are the ones you find annoying?

mhussein commented 26 minutes ago

my 2c

The "Macros arguments" one feels like Debug, but it is useful, so maybe keep it as INFO, similar to the "Loading yaml file" ones.

The "Configuring the macros environment..." and "End of environment config" are useless outside debug env. Those can go.

The "config [variables|macros|filters] again feels like debug, but they are useful to discover things you can do that you may not be aware of.

fralau commented 20 minutes ago

Thanks for the feedback. I'll have a look at this.

For the context, I introduced a new testing framework (see #244), so I went a little overboard. 🙂

In reality, the testing framework relies minimally on the log, except for reading the variables, filters and macros (but these are DEBUG entries, not INFO).