Skip to content

v0.5.0 - 2023-04-04

Material for MkDocs has its own social cards plugin, but there are some limitations of it (or rather I should say, their implementation is limiting in some areas). The Material approach to social cards is to generate an image based on document information and requires changing the template manually to add those cards.

Publisher for MkDocs uses a different approach to social cards:

  • you can set an image per document, but you have to create this image by yourself - it gives you a better control over how it looks like, so it can be more create than the one generated from the template,
  • you don't have to change a document template because all the data related to social cards is injected into HTML code of the document while rendering it.

If you need support for additional plugins, please make an issue with a future description.

For more details about this release, read more below or jump directly to pub-socialplugin documentation.

Changelog

Blog

  • ❎ index blog post title is now a link to a post

Social (new plugin)

  • ❎ automatic addition of Open Graph tags directly into HTML code (no template modification is needed) based on document meta
  • ❎ automatic addition of Twitter tags directly into HTML code (no template modification is needed) based on document meta

Note

❎ - added ✅ - fixed ♻️️ - changed 🚫 - removed