Duplicate keys in `:alpha`betic style about documentercitations.jl HOT 12 CLOSED

I will use the alpha style “in the wild”! But no worries, for now I do not have such a collision and this is also really not urgent.

Yes once I have finished the PR (maybe this week), I will add it to the list of examples, for sure.

from documentercitations.jl.

That’s definitely a workaround! It also has the benefit that you have the same labels in the docstrings as in the rendered documentation, when reading them in a text editor.

I might be able to push out a smarter :alpha style today, though.

from documentercitations.jl.

You are absolutely correct! I thought I could slide this one by for the moment 😉

The way I was planning to fix this was to have a slightly smarter :alpha style. More specifically, one would have an AlphaStyle object that gets passed as style to CitationBibliography, and which would keep track of all generated labels, and modify them appropriately when there are duplications. Similar to (but simpler than) the approach in #13, and in fact a good example for a "stateful" style to be discussed in the documentation.

I'd prioritize this a bit more if someone actually wanted to use the :alpha style "in the wild", but it will be fixed eventually, in any case. (Just probably not in the next few weeks, due to conference travel.)

I promise this is the last issue for now

Not at all! Keep them coming!

I even managed to rework my references and have a PR at that is [...] reworked and I think it is overall quite nice!

When it's merged and the documentation is online, feel free to make a PR here to add Manopt to the list of examples.

from documentercitations.jl.

I am trying to convert Oscar.jl to the v1.0.0 and would like to stay with the :alpha mode that was decided on long ago. Unfortunately, there occur some collisions of the above form.
I think this is a blocker for us to use it until this is fixed.

from documentercitations.jl.

Alright, I'll give it some priority

from documentercitations.jl.

We change to https://juliadocs.org/DocumenterCitations.jl/v1.0.0/gallery/#Custom-style:-Citation-key-labels for the time being, as we can put working and distinct labels in the .bib file.

from documentercitations.jl.

Should be fixed in #31. Have a look if this works as expected, if you can

from documentercitations.jl.

Should be fixed in #31. Have a look if this works as expected, if you can

I unfortunately will be out of office the whole week, and without any device running julia.

from documentercitations.jl.

I'm okay with waiting a little bit…

from documentercitations.jl.

Thanks for working on that, due to conferences and travels, II will only have time around Wednesday to take a look, but if you are sure it works merge it without my feedback for sure.

from documentercitations.jl.

Take your time, this is really for you guys' benefit, so it makes more sense to wait until you've had a chance to look at it 😉

from documentercitations.jl.

Should be fixed in #31. Have a look if this works as expected, if you can

The preview in https://juliadocs.org/DocumenterCitations.jl/previews/PR31/gallery/#alphabetic_style looks great. Unfortunately, I cannot get it to work on my repo, but that may be due to my local setup.

from documentercitations.jl.