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

Incorrect links generated for cross-references with same name when using tagfiles #10850

Closed
tttapa opened this issue May 2, 2024 · 4 comments
Labels

Comments

@tttapa
Copy link
Contributor

tttapa commented May 2, 2024

Describe the bug
When an external project and the current project both have a MarkDown page with the same name/label, references in the current project resolve to the version of the page of the external project (instead of the current one).

Screenshots

image

The text refers to "Examples B" (which is the current project's version of the page), but the link points to the external project's version of the page (which has the title "Examples A").

image

The "Related Pages" index is also incorrect (and doesn't even link to the current project's version of the examples page at all).

To Reproduce
Doxygen-10850.zip

Expected behavior
Inside of project B, the @ref examples command should link to project B's version of the example.md file.

Bonus: it would be nice to be able to explicitly refer to project A's version of the file as well.

Version
1.10.0 (ebc57c6)

Additional context
In my specific use case, I'm using the following in my DoxygenLayout.xml:

  <navindex>
    ...
    <tab type="user" visible="yes" title="Examples" url="@ref examples" intro=""/>
  </navindex>

The @ref examples produces the wrong link when using a tagfile from a project that also has a page labeled examples.

@albert-github albert-github added bug Markdown Markdown translation input related issue labels May 3, 2024
albert-github added a commit to albert-github/doxygen that referenced this issue May 7, 2024
…th same name when using tagfiles

- properly reset in case of reuse the page definition (util.cpp)
- when having multiple times (multiple tag files) with the same info warnings like `warning: Duplicate anchor md_README found` will occur, better to replace in that case and no warning (tagreader.cpp)
- better debug output (doxygen.cpp)
@albert-github albert-github removed the Markdown Markdown translation input related issue label May 7, 2024
@albert-github
Copy link
Collaborator

I've just pushed a proposed patch, pull request #10854

doxygen added a commit that referenced this issue May 7, 2024
issue #10850 Incorrect links generated for cross-references with same name when using tagfiles
@albert-github albert-github added the fixed but not released Bug is fixed in github, but still needs to make its way to an official release label May 8, 2024
@albert-github
Copy link
Collaborator

Code has been integrated in master on GitHub (please don't close the issue as this will be done at the moment of an official release).

@tttapa
Copy link
Contributor Author

tttapa commented May 15, 2024

Thanks a lot!

@doxygen
Copy link
Owner

doxygen commented May 20, 2024

This issue was previously marked 'fixed but not released',
which means it should be fixed in doxygen version 1.11.0.
Please verify if this is indeed the case. Reopen the
issue if you think it is not fixed and please include any additional information
that you think can be relevant (preferably in the form of a self-contained example).

@doxygen doxygen removed the fixed but not released Bug is fixed in github, but still needs to make its way to an official release label May 20, 2024
@doxygen doxygen closed this as completed May 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

3 participants