RawBlock html table: is it possible to use "special" cross reference syntax?

[aborruso]

Description

Hi,
in this sample page I have added <span data-qmd="[-@sec-soggetti-destinatari]"></span>, to hide cross reference label and show only its ID.

But I have always the CR label.

Is it possible to use this special CR syntax in RawBlock html table? Did I make any syntax errors??

Thank you

[mcanouil]

Could you not hide links behind code contents and preferably share code snippets directly inside the post itself?

This is for two reasons:

• it's harder to read when having to go back and forth between the post and the links targets
• the text used to hide links has no meaning with the target links which means people with disabilities using screen readers, etc. will be completely lost and won't understand anything from your post. When using text as links, the text should be meaningful and let readers know what the link (and its content) is about.

[cscheid]

Can you provide a minimal, self-contained reproducible example so that we can follow up?

[aborruso]

Can you provide a minimal, self-contained reproducible example so that we can follow up?

Thank you @cscheid. First of all, congratulations on your talk at posit-conf, very very interesting.

The small example:

• rendered https://ondata.github.io/linee-guida-opendata/debug/raw-html-cr.html
• the code https://github.com/ondata/linee-guida-opendata/blob/main/debug/raw-html-cr.qmd

Actually the problem doesn't seem related to the HTML table, but it seems not to work on this page.
And there is something strange, which I see creating this example for you.

I have inserted this code

Please [see par. @sec-soggetti-destinatari]

Please [see par. -@sec-soggetti-destinatari]

and in both cases now I have only the CR ID.
It is as if there is a "broken" cache. How can I eleminate it and launch a clean render?

Thank you

[cscheid]

Thanks! However, we do need a "minimal, self-contained example". You have a whole book with a lot of content in this. Can you provide a small example instead?

[aborruso]

Can you provide a minimal, self-contained reproducible example so that we can follow up?

I'm confusing myself and closing because I can actually get what I needed. Excuse me.

But I have a documentation related question. In this page we have

To refer to a chapter or appendix explicitly you should spell out “Chapter” or “Appendix” and use the number-only form of cross reference

But if I write

See [lorem -@sec-soggetti-destinatari]

See [lorem @sec-soggetti-destinatari]

I get in both cases only the ID. I get only "See lorem 1.1". So it seems that to get just the ID, just write anything before the CR. Whether there is - at the beginning of CR, or not, seems indifferent.

The small example https://aborruso.quarto.pub/sample/cr.html (the code).

Thank you

[cderv]

I get in both cases only the ID. I get only "See lorem 1.1". So it seems that to get just the ID, just write anything before the CR. Whether there is - at the beginning of CR, or not, seems indifferent.

It seems so. From our codebase, we do use the Prefix passed when there is one, no matter about the - syntax, which is about suppressing author information in citeproc syntax.

quarto-cli/src/resources/filters/crossref/refs.lua

Lines 47 to 77 in 476da18

	-- create ref text
	local ref = pandoc.List()
	local category = crossref.categories.by_ref_type[type]
	if category ~= nil and category.custom_ref_command ~= nil and _quarto.format.isLatexOutput() then
	-- do nothing else, this was all handled by the custom command
	ref:extend({pandoc.RawInline('latex', '\\' .. category.custom_ref_command .. '{' .. label .. '}')})
	elseif #cite.prefix > 0 then
	add_ref_prefix(ref, type, cite.prefix)
	elseif cite.mode ~= pandoc.SuppressAuthor then
	-- some special handling to detect chapters and use
	-- an alternate prefix lookup
	local prefixType = type
	local chapters = crossrefOption("chapters", false)
	if chapters and entry then
	if resolve and type == "sec" and isChapterRef(entry.order.section) then
	if entry.appendix then
	prefixType = "apx"
	else
	prefixType = "ch"
	end
	end
	end
	if resolve or type ~= "sec" then
	local prefix = refPrefix(prefixType, upper)
	if #prefix > 0 then
	add_ref_prefix(ref, type, prefix)
	end
	end
	end

Not sure this has changed recently - maybe documentation was not updated 🤔