You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
People may have .bib files with entries like the above because at some point I speculated on this being a workaround to deal with the missing support for \url/\href. I was actually wrong about that even at the time: you would have been able to put html in the .bib file in the previous version of DocumenterCitations, not markdown. The fact that markdown worked was exploiting a bug even then (the same bug as now).
The correct and only officially suppored way to define a link in a BibTeX entry (as of now) is to use LaTeX syntax:
I'm not going to go out of my way to fix this bug. First of all, I'm not completely sure how to escape arbitrary markdown for the stdlib markdown parser (I'm not even sure it's always possible)
Presumably, for the above string it would be sufficient to escape the brackets:
Second, it seems unnecessary to break existing .bib files that use the "workaround".
But, for the record: Having markdown syntax in the .bib file is officially exploiting an bug in DocumenterCitations. I strongly discourage the workaround, and I make no guarantees that it will continue to work. In particular, as soon as someone files a bug report that is due to a failure to escape brackets, I'll have to do something about this.
The text was updated successfully, but these errors were encountered:
The first way actually does still work (if one is able to type the markdown link correctly) – and since I am lazy I might continue using that ;) For exactly the code you have – that is from the pre-eprint-time and I should change that, that is correct.
That's fine, as long as we're clear that this is officially non-sanctioned ;-)
How do you feel about me checking for the presence of ](http in the .bib strings and printing a warning that "markdown links must be rewritten with the tex-command \href"? Helpful, or too much noise?
At least some markdown syntax that might occur in a BibTeX entry is not properly escaped by the internal
tex_to_markdown
function:People may have
.bib
files with entries like the above because at some point I speculated on this being a workaround to deal with the missing support for\url
/\href
. I was actually wrong about that even at the time: you would have been able to put html in the.bib
file in the previous version ofDocumenterCitations
, not markdown. The fact that markdown worked was exploiting a bug even then (the same bug as now).The correct and only officially suppored way to define a link in a BibTeX entry (as of now) is to use LaTeX syntax:
Specifically for preprint links, it would be recommended to use the
eprint
field, which is fully supported. See the documentation for details.I'm not going to go out of my way to fix this bug. First of all, I'm not completely sure how to escape arbitrary markdown for the stdlib markdown parser (I'm not even sure it's always possible)
Presumably, for the above string it would be sufficient to escape the brackets:
Second, it seems unnecessary to break existing
.bib
files that use the "workaround".But, for the record: Having markdown syntax in the
.bib
file is officially exploiting an bug in DocumenterCitations. I strongly discourage the workaround, and I make no guarantees that it will continue to work. In particular, as soon as someone files a bug report that is due to a failure to escape brackets, I'll have to do something about this.The text was updated successfully, but these errors were encountered: