search

mondeja / mkdocs-mdpo-plugin

Mkdocs translation plugin using PO files.
https://mondeja.github.io/mkdocs-mdpo-plugin/
BSD 3-Clause "New" or "Revised" License
7 stars 5 forks source link

Add support to mkdocs-macros plugin #63

Open yanedie opened 1 year ago

yanedie commented 1 year ago

Mkdocs-Macros is a plugin/mini-framework for unleashing the power of a static website generator, using variables and macros. It converts markdown into a Jinja template. So you can store some variables in a YAML file, and type {{ variable_name }} in the markdown file. So can you add a function that allows the mkdocs-mdpo-plugin to recognize the Jinja syntax (especially control structure syntax...) and extract the values from variables in the YAML files and replace the declarations with them?

mondeja commented 1 year ago

I would prefer to create a standarized system to translate non-static Mkdocs content. This should be done in Mkdocs. The current way of adding support for a lot of plugins is unmaintenable: support for compatible Mkdocs versions for the plugin and external ones + "raw" (as not standarized) support for plugins versions + Python versions support for the plugin, Mkdocs, externals... But seems that Markdown writers are not totally aware that the language is composed by just blocks of content and they prefer static solutions.

Keep in mind that this is a voluntary project and I don't have time nor motivation to support all this work, which implies days of writing, refactoring, testing...