Open amotl opened 3 months ago
Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada:
We have not been able to find any notation to satisfy the MyST parser, trying to link to the orm
reference, in both directions, either trying to be more explicit to reference std:ref:
, or std:doc:
. Do you have any hints how to make it work?
I am also running into this issue. I need to have user be able to use the [](#some-class)
which is xref.
But I also have a 500 files with those same names. Having to rename those will be a pain.
What version of
myst-parser
are you using?2.0.0
What version dependencies are you using?
What operating system are you using?
Mac
Describe the Bug
Problem
In a file called
df.md
, we want to cross-reference theorm
label, which is in a fileorm.md
, next todf.md
, likeWhen doing it using MyST linking, in either of that form,
we are receiving the venerable ambiguity warning, which is an error in our case, because we are exclusively using Sphinx with
-W --keep-going
:However, we have not been able to find any notation to satisfy the MyST parser, in both directions, either trying to be more explicit to reference
std:ref:
, orstd:doc:
. Do you have any hints how to make it work?Workaround
It works well when using the
{doc}
/{ref}
syntax, apparently, well, because it is explicit by design?Expected Behavior
Documentation or Bug?
Thoughts
Regarding the handling of invalid references, it would be sweet if any of the applicable features to suppress warnings about
myst.xref_ambiguous
could be made work per-page through a corresponding front matter. We have not been able to make it work. If you can confirm, and agree, this item should probably make it into a separate issue?To Reproduce
Trivia: Within a file called
orm.md
, there is a reference label also calledorm
. C'est la vie.orm.md
df.md