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 checking with DocumenterCitations #58

Closed
ArnoStrouwen opened this issue Feb 21, 2023 · 9 comments · Fixed by #62
Closed

Link checking with DocumenterCitations #58

ArnoStrouwen opened this issue Feb 21, 2023 · 9 comments · Fixed by #62
Labels
bug Something isn't working

Comments

@ArnoStrouwen
Copy link

Link checking errors when using citations from
https://github.com/ali-ramadhan/DocumenterCitations.jl

@mortenpi
Copy link
Member

While we should probably provide some hooks in Documenter for DocumenterCitations to use, this seems more like a feature request for that package?

@odow
Copy link

odow commented Nov 1, 2023

Should this be transferred to https://github.com/JuliaDocs/DocumenterCitations.jl? cc @goerz

@goerz
Copy link
Member

goerz commented Nov 1, 2023

Yes, feel free to open an issue, if you have an example where DocumenterCitations has some unexpected behavior… but I was under the assumption that link checking already works. I'm pretty sure I've seen it warn about broken links, although there may not be an explicit test to ensure that. In any case, the way it should work is that the normal link checking in Documenter just automatically handles any URLs in the rendered bibliography. Since the pipeline step that does the checking runs after any of the pipeline steps that expand the bibliography, it shouldn't be much of a problem.

@mortenpi mortenpi transferred this issue from JuliaDocs/Documenter.jl Nov 1, 2023
@mortenpi
Copy link
Member

mortenpi commented Nov 1, 2023

I took the liberty of transferring the issue, but maybe this should be closed instead if it's no longer an issue. Perhaps @ArnoStrouwen could confirm whether it is or not.

@odow
Copy link

odow commented Nov 1, 2023

Yes, since there wasn't a concrete example from OP, you should close this issue (I don't have permission). But anyone reading this who encounters a similar issue should either comment below, or open a new issue.

@goerz
Copy link
Member

goerz commented Nov 1, 2023

I'd consider "Add a test that checks that invalid links trigger the link checker" as the actionable item for closing this.

@goerz goerz added the bug Something isn't working label Nov 2, 2023
@goerz
Copy link
Member

goerz commented Nov 2, 2023

Trying to add a test uncovered that, in fact, the link checker does not traverse into the bibliography.

That's a bug, and should be fixed.

@goerz
Copy link
Member

goerz commented Nov 3, 2023

This will require a fix in Documenter: JuliaDocs/Documenter.jl#2329

@goerz
Copy link
Member

goerz commented Nov 3, 2023

As soon as JuliaDocs/Documenter.jl#2330 is merged, I'll be able to fix this

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants