pandoc-crossref
pandoc-crossref copied to clipboard
lierdakil
I developed a slightly enhanced version of the filter `texref.lua` suggested by @lierdakil above:
In case you want to use https://quarto.org/ you should remove the comments from the line with the comment -- for quarto. Here we will replace : with - in the reference labels, because quarto uses a slightly different prefix convention for labels than pandoc-crossref (see https://quarto.org/docs/authoring/cross-references.html ).
Originally posted by @asmaier in https://github.com/lierdakil/pandoc-crossref/issues/250#issuecomment-1169233033
Is it possible to change the convention fig: to fig- (same for other type of references too) in pandoc-crossref so that I can render a .md file using my standard Pandora AND using Quarto ?
No, prefixes are hard-coded, at least in the mainline version.
Sorry @lierdakil , I don't understand your reply. Do you mean that the syntax doesn't matter for the Labels ? If this is the case, which is good, then the fact that the fig: links are not working in Quarto is due to Quarto and not to Pandoc. Am I correct ?
Uh. Looking back at it, I guess I misunderstood the question?
So the prefixes are hard-coded, : included, so there's no way to change those client-side. Changing this convention pandoc-crossef side at this point would break compatibility in a big way, besides - is kind of ambiguous.
Arguably I could cook something up hidden behind a flag, but this seems like a very niche use case, so I'm not sure if I can justify the effort. Feel free to argue otherwise.
You understood correctly. I would be very nice to be able to define the prefixes in a yaml configuration file but I totally understand that this may not be the priority. The fact that there is no global convention throughout the markdown galaxy can be a bit annoying but I guess we all have to leave with that. The problem is when you want to share your .md document with somebody else who does not have the same setup. This is one big advantage of working with a mature editing language like TeX: it works equally everywhere. To me Markdown is still behind in terms of "syntax maturity" but it is evolving fast !! Thank you again for your work !
Hi @lierdakil , I would like to know if a pandoc filter could help me on that. I don't know anything about Lua-filter but I guess there could be a filter converting all references from say #fig- to #fig:. Do you think that could be a solution ?
I suggest to modify the lua filter script in order to prevent producing empty lines, see my comment in #250.
a filter converting all references from say #fig- to #fig:
Do you even need a filter though? I suspect a simple regex substitution could work, something to the tune of s/([#@])(fig|eq|tbl|lst)-/\1\2:/g?