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

Link checker: use the non-greedy quantifier to parse anchors #1104

Merged
merged 2 commits into from
Mar 27, 2024

Conversation

arnaucasau
Copy link
Collaborator

@arnaucasau arnaucasau commented Mar 27, 2024

This small PR changes the regex used in the link checker to parse the anchors for a non-greedy version of it. After regenerating the API docs with the mdx components, our link checker wasn't able to detect the id from them that we previously had as <span> tags.

The problem was how the script was searching for the ids. In the the following screenshots, we can see the change introduced here.

Before

Captura desde 2024-03-27 17-27-06

After
Captura desde 2024-03-27 17-39-51

More information on the non-greedy quantifier here: https://www.ibm.com/docs/en/netcoolomnibus/8.1?topic=library-minimal-non-greedy-quantifiers

To see that it fixed the issue, this change was applied to ##1094, #1101, and #1102

@qiskit-bot
Copy link
Contributor

Thanks for contributing to Qiskit documentation!

Before your PR can be merged, it will first need to pass continuous integration tests and be reviewed. Sometimes the review process can be slow, so please be patient. Thanks! 🙌

Copy link
Member

@frankharkins frankharkins left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice, thanks!

Good explanation too.

Copy link
Collaborator

@Eric-Arellano Eric-Arellano left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Can you please add a test for this?

@arnaucasau
Copy link
Collaborator Author

Thank you both for the review! I added an mdx component to the test we already had 👍

@arnaucasau arnaucasau added this pull request to the merge queue Mar 27, 2024
Merged via the queue into Qiskit:main with commit 7e4f9f2 Mar 27, 2024
2 checks passed
@arnaucasau arnaucasau deleted the AC/fix-link-checker-anchors branch March 27, 2024 17:58
frankharkins pushed a commit to frankharkins/documentation that referenced this pull request Jul 22, 2024
…1104)

This small PR changes the regex used in the link checker to parse the
anchors for a non-greedy version of it. After regenerating the API docs
with the mdx components, our link checker wasn't able to detect the id
from them that we previously had as `<span>` tags.

The problem was how the script was searching for the ids. In the the
following screenshots, we can see the change introduced here.

**Before**

![Captura desde 2024-03-27
17-27-06](https://github.com/Qiskit/documentation/assets/47946624/d1896d55-2a94-4992-8ec3-c52234aefd6a)

**After**
![Captura desde 2024-03-27
17-39-51](https://github.com/Qiskit/documentation/assets/47946624/0b063a3e-9ef6-4d5f-a775-cf53497339ec)

More information on the non-greedy quantifier here:
https://www.ibm.com/docs/en/netcoolomnibus/8.1?topic=library-minimal-non-greedy-quantifiers

To see that it fixed the issue, this change was applied to #Qiskit#1094,
Qiskit#1101, and Qiskit#1102
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

4 participants