Skip to content

Incompatibility with d2 plugin in version 1.3 #249

@Karreg

Description

@Karreg

Hello,

I have found an incompatibility with d2 plugin in the 1.3 version, that did not exist in version 1.2.
I don't have all the details, but here is what I found:

Since version 1.3, I get this error when building my documentation:

Error: The current file is not set for the '!relative' tag. It cannot be used in this context; the intended usage is within `markdown_extensions`.

Without more context in the error, I could not find out which content generated this error, however:

  • If I disable the macros plugin, the documentation will build correctly (without macros of course)
  • If I disable the d2 plugin, the documentation will build correctly (without d2 of course)
  • If I force the macros 1.2 version, the documentation will build correctly with both macros and d2 content

My guess is that since version 1.3, macros plugin analyzes incorrectly the d2 generated content, which is SVG. But that is just a guess.

I have created a repository (with a devcontainer if that can help) here to show the issue. The mkdocs content is minimal (no content other than a simple d2 diagram, no plugin other than search, macros and d2, no theming...): https://gitlab.com/karreg/mkdocs-macros-d2-issue

If I can help, I'll be glad to try :)

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingfixedA fix has been submitted

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions