How are you adding citation to blockquotes?

[steppa]

Since Hugo disables inline HTML by default, which methods are y’all using to add citation? So far, I have found the two ways below. (The second one looks more promising).

1. With a render hook

Blockquote with render hook

I used a shortcode to generate quoteblock content. Now I switched to use a render hook. HTML blockquote can have a cite attribute. I added the author attribute. Here is it: Markdown ````quote { author="Sir Tim Berners-Lee" cite="https://cds.cern.ch/record/369245/files/dd-89-001.pdf"} Vague, but exciting… ```` layouts\_default\_markup\render-codeblock-quote.html {{ $author := .Attributes.author }} {{ $cite := .Attributes.cite }} <figure> <blockquote {{ with $cite }} cite="{{.| saf…

2. With replaceRE

Get missing inline HTML tags in Markdown without enabling HTML

Hi, Goldmark lacks formatting signs for a few inline HTML tags. We can enable HTML to use them in our Markdown, but this is not a good solution, where security should be a concern — e.g. for themes or larger projects with many contributors. The site configuration parameter unsafe should be left in its default state unsafe = false. In the last few month, I’ve found the following replacements very useful to inject some missing HTML tags after Goldmark has rendered the HTML. So far, there was no …

[ju52]

I think you want to show HTML?

in the MD files:

```HTML
<link rel=stylesheet href=/dark.css  media="(prefers-color-scheme: dark)">
<link rel=stylesheet href=/light.css media="(prefers-color-scheme: light)">
<link rel=stylesheet href=/main.css>
````

my render-codeblock.html

{{ $class   := .Attributes.class | default ""    }}
{{ $lang    := .Attributes.lang  | default .Type }}
{{ if transform.CanHighlight $lang }}
<div class="code {{ $class }}">{{ highlight .Inner $lang }}</div>
{{else}}
<pre><code class=" code {{ $class }}">{{.Inner}}</code></pre>
{{end}}

sometimes I use a shortcode to insert a file

<div>
  {{ $file := .Page.File.Path }}
  {{ $lang := path.Ext .Page.File.Path }}
  {{ if gt (len .Params) 0 -}}
  {{ $lang = .Get 1 | default "text"}}
  {{ $file = .Get 0 }}
  {{- end -}}
  {{ $file = readFile $file }}
  {{ highlight $file $lang "linenos=table" }}
</div>

hope this help to find your solution

[steppa]

@ju52

I think you want to show HTML?

No. But to include <cite>lorem ipsum</cite> in my blockquotes where applicable without enabling unsafe: true in the markdown parser.

[davidsneighbour]

I asked once to create a markup-render-hook for blockquote but it was somehow swatted down as not something the system needs. So I created my own shortcode for this. There is no Markdown-way to add cite attributes to blockquote tags. I did not “re-visit” the issue for some years now, it might have changed. My shortcode is the following setup:

layouts/shortcodes/quote.html

<blockquote class="blockquote">
	{{.Inner}}
    {{ if .Get "source" }}
    <footer class="blockquote-footer">
		<cite title="Quelle: {{ with .Get "source"}}{{.}}{{ end }}">
            {{ with .Get "src"}}
                Weiterlesen auf
                <a href="{{.}}" target="_blank" rel="noopener noreferrer">
            {{ end }}
            {{ with .Get "source" }}{{.}}{{ end }}
            {{ with .Get "src"}}
                </a>
            {{ end }}
		</cite>
	</footer>
    {{ end }}
</blockquote>

call this in your markdown files via:

Something something

{{< quote source="the guy who said it" src="https://alinktotheguywhosaidit.com" >}}
the quote
{{< /quote >}}

There are some optimizations in there (like the src-attribute for an URL and (my fault), plenty of German phrases), so you probably want to re-create the shortcode instead of just copying it.

It’s more work, but this is the way Hugo can add cite tags to your blockquotes (for now), because… it can’t (add cite tags to your blockquotes).

[steppa]

I will take this for a spin.

[Mehdi_Saada]

what’s wrong with your render hook ? I found it genius, and adopted it.

[steppa]

I went with this option after much testing

Get missing inline HTML tags in Markdown without enabling HTML

Hi, Goldmark lacks formatting signs for a few inline HTML tags. We can enable HTML to use them in our Markdown, but this is not a good solution, where security should be a concern — e.g. for themes or larger projects with many contributors. The site configuration parameter unsafe should be left in its default state unsafe = false. In the last few month, I’ve found the following replacements very useful to inject some missing HTML tags after Goldmark has rendered the HTML. So far, there was no …

[Mehdi_Saada]

security issue ?
I can understand, I needed the unsafe setting to add <cite> and <q>. But how does it relate with the render hook method ? No need for unsafe = true and it’s much more elegant than using shortcodes

[jmooring]

Please read this:
https://gohugo.io/about/security-model/#web-application-security

Templates authors (you) are trusted, but the data you send in is not.