seirdy.one/layouts/shortcodes/codecaption.html

{{- .Page.Scratch.Add "codeIndex" 1 -}}
{{- $codeIndex := (int (.Page.Scratch.Get "codeIndex")) -}}
{{- $id := (printf `code-%d` $codeIndex) -}}
{{- with .Get "id" -}}
	{{- $id = . -}}
{{- end -}}
{{ with .Parent }}
	{{- with .Get "id" -}}
		{{- $id = . -}}
	{{- end -}}
{{- end -}}
<figcaption id="{{ $id }}-caption">
	<span id="{{ $id }}" tabindex="-1">
	<strong itemprop="name"> <span itemprop="codeSampleType">Code snippet</span> {{ $codeIndex }}</strong>{{with .Get "lang"}} (<span itemprop="programmingLanguage">{{ . }}</span>){{ end -}}
	</span>:
{{ .Inner | .Page.RenderString | safeHTML }}
</figcaption>
Update for Hugo 0.123 - Stop using symlinks for template files, since those seem to have broken. - Force int data type for scratchpad integers since type inference seems to have changed. 2024-01-30 17:44:23 -05:00			`{{- .Page.Scratch.Add "codeIndex" 1 -}}`
			`{{- $codeIndex := (int (.Page.Scratch.Get "codeIndex")) -}}`
Give code figures both a label and description 2022-04-20 17:56:06 -07:00			{{- $id := (printf `code-%d` $codeIndex) -}}
Elaborate on focus indicators + fix anchors 2022-04-21 21:40:40 -07:00			`{{- with .Get "id" -}}`
			`{{- $id = . -}}`
			`{{- end -}}`
Give code figures both a label and description 2022-04-20 17:56:06 -07:00			`{{ with .Parent }}`
			`{{- with .Get "id" -}}`
			`{{- $id = . -}}`
			`{{- end -}}`
			`{{- end -}}`
			`<figcaption id="{{ $id }}-caption">`
A11y: drop draft ARIA, overhaul in-page links - Stop using draft WAI-ARIA 1.3 that isn't supported yet - Make in-page links focusable across shortcodes/partials - Replace existing in-page heading anchor links with a more accessible option. - Make backlinks aria-labelledby instead of giving them an aria-label, so they can be translated. 2022-05-19 17:18:14 -07:00			`<span id="{{ $id }}" tabindex="-1">`
Give code figures both a label and description 2022-04-20 17:56:06 -07:00			`<strong itemprop="name"> <span itemprop="codeSampleType">Code snippet</span> {{ $codeIndex }}</strong>{{with .Get "lang"}} (<span itemprop="programmingLanguage">{{ . }}</span>){{ end -}}`
			`</span>:`
Switch from markdownify to Page.Renderstring Just for consistency 2023-11-10 10:01:59 -08:00			`{{ .Inner \| .Page.RenderString \| safeHTML }}`
Split up figcaption partial, add some fignos - give code blocks their own figure numbers/names/ID - Split figcaption into quotecaption and codecaption - create codefigure partial to reduce markup for SoftwareSourceCode figures 2022-04-19 18:06:57 -07:00			`</figcaption>`