Allow title of social cards to respect MkDocs hooks about mkdocs-material HOT 2 CLOSED

That hook works beautifully, thank you very much!

from mkdocs-material.

Thanks for suggesting. Insiders already allows to change many attributes for the default social card layouts by using the on_page_markdown hook, which deliberately uses a "latest" event priority to allow other plugins and hooks to change metadata before the social card is queued up for rendering. Moving rendering to on_page_content might be possible, but the problem is that the _title_from_render might contain markup, which will jam the social plugin.

Sticking to the title MkDocs derives before rendering is safe in regards to that it does not contain markup. Also note, that there are currently issues with title handling in MkDocs:

• mkdocs/mkdocs#3357

It seems that it was fixed, but we're still awaiting a release. We can re-evaluate this request once the changes are finally released, because it is unclear whether the title from rendering can "just be used" due to the potential presence of markup or unresolved icon short codes. Until then, here's a self-contained minimal reproduction that showcases how to change attributes for social cards programmatically in on_page_markdown for demo purposes:

social-card-title-hook.zip

Additionally, to work around the problem manually, you can use the following metadata in your page:

---
social:
  cards_layout_options:
    title: My page social card title
---

# My page title

Closing as resolved with configuration change.

from mkdocs-material.