Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support to mkdocs-macros plugin #63

Open
yanedie opened this issue Aug 14, 2023 · 1 comment
Open

Add support to mkdocs-macros plugin #63

yanedie opened this issue Aug 14, 2023 · 1 comment
Labels
enhancement New feature or request

Comments

@yanedie
Copy link

yanedie commented Aug 14, 2023

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
Copy link
Owner

mondeja commented Aug 14, 2023

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...

@mondeja mondeja added the enhancement New feature or request label Aug 14, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants