mkdocs-macros-plugin icon indicating copy to clipboard operation
mkdocs-macros-plugin copied to clipboard

Mermaid seems to be incompatible with mkdocs-macros

Open SPyofgame opened this issue 1 year ago • 6 comments

With mermaid.js and html, css inside the table, I can make some visualization like this

image

But after using mkdocs-macros, I can still you mermaid.js but I can not name any nodes nor using CSS

image

SPyofgame avatar Apr 09 '24 07:04 SPyofgame

Welcome to this project and thank you!' first issue

github-actions[bot] avatar Apr 09 '24 07:04 github-actions[bot]

Fixed, by doing something like

      j2_block_start_string: '{{{%'
      j2_block_end_string: '%}}}'
      j2_variable_start_string: '{{{@'
      j2_variable_end_string: '}}}@'
      j2_comment_start_string: '{{{#'
      j2_comment_end_string: '#}}}'

SPyofgame avatar Apr 09 '24 08:04 SPyofgame

Wow, what a pretty diagram!

For our information did you identify the piece of code in Mermaid that was tripping MkDocs-Macros?

fralau avatar Apr 09 '24 19:04 fralau

I don't know for sure, but I think some kind of start_string and end_string of mermaid and macros was incompatible so we must use them differently. I tried to change a few permutations of order of the plugins but it seems... ehmmmm not working I guess ?

SPyofgame200 avatar Apr 14 '24 18:04 SPyofgame200

Wow, what a pretty diagram!

For our information did you identify the piece of code in Mermaid that was tripping MkDocs-Macros?

I was dedicated with my own project, in order to teach my students better, so I tried to make my site with many interactive features

SPyofgame200 avatar Apr 14 '24 18:04 SPyofgame200

Perhaps searching with your editor for offending strings might help?

I am just curious about it: the question of how to ensure compatibility of Mkdocs-Macros' syntax with other plugins has been a topic of extensive research.

And considering that I am the author of both plugins 🙂 ...

fralau avatar Apr 27 '24 06:04 fralau