Hugo

Notes about the world’s fastest framework for building websites

Updated on 21.04.2024 https://rehborn.dev/notes/hugo/

Notes about the configuration of this site and some shortcodes

Shortcodes

External Link

{{< link "https://google.com" "Google" "btn btn-primary" >}}

shortcodes/link.html

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


{{ $href := .Get 0 }}
{{ $text := compare.Default $href (.Get 1) }}
{{ $css := compare.Default "" (.Get 2) }}
{{ $rel := compare.Default "noopener nofollow" (.Get 3) }}
{{ $icon := compare.Default "external-link" (.Get 4) }}
{{ $target := compare.Default true (.Get 5) }}
<a href="{{ $href }}" class="{{ $css }}" rel="{{ $rel }}" {{ if $target }}target="_blank"{{ end }}>
    {{ $text }}
    <i class="fa-duotone fa-{{ $icon }} fa-fw"></i>
</a>

Copy to Clipboard

{{< clipboard "text to copy" >}}

shortcodes/clipboard.html

1
2
3


<span class="clipboard" data-clipboard-text="{{ .Get 0 }}">
    <i class="fa-duotone fa-copy"></i>
</span>

Render Code from File

{{< code "script.py" "python" >}}

shortcodes/code.html

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


{{ $data := readFile (print "data/" (.Get 0)) }}
{{ $syntax := (compare.Default "text" (.Get 1)) }}
{{ $opts := (compare.Default "linenos=true" (.Get 2)) }}

<div class="card my-3">
    <div class="card-header bg-primary bg-gradient">
        <span>{{ .Get 0 }}</span>
        <a class="clipboard float-end" data-clipboard-text="{{ $data }}">
            <i class="fa-duotone fa-copy"></i>
        </a>
    </div>
    <div class="card-footer p-0">
        {{ highlight $data $syntax $opts }}
    </div>
</div>

Syntax Highlighting

Render CSV

{{< csv file >}}

shortcodes/csv.html

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27


{{ $param := .Get 0 }}
{{ $url := print "data/" $param ".csv"  }}

{{ $sep := "," }}
{{ $data := getCSV $sep $url  }}

{{ $title := ( (.Get 0) | humanize ) }}

<table class="table table-striped">
{{ range $i, $row := $data }}
    <tr>
    {{ range $j, $cell := $row }}
        <td>
            {{ $match := findRESubmatch ":(check|xmark):" $cell 1 }}
            {{ $icon := index $match 0 0 }}
            {{ if $icon }}
            {{ $fa := strings.Replace $icon ":" "" }}
            <i class="fa-duotone fa-{{ $fa }}"></i>
            {{ strings.ReplaceRE $icon "" $cell 1 }}
            {{ else }}
            {{ $cell }}
        {{ end }}
    </td>
    {{ end }}
    </tr>
{{ end }}
</table>

getCSV

Font-Awesome Icon

{{< fa brands linux >}}

shortcodes/fa.html

1
2
3
4
5
6
7


{{ $icon := compare.Default "square" (.Get 0) }}
{{ $type := compare.Default "duotone" (.Get 1) }}
{{ $fa_size := "" }}
{{ if .Get 2 }}
{{ $fa_size = compare.Default "" (print "fa-" (.Get 2) "x") }}
{{ end }}
<i class="fa-{{ $type }} fa-{{ $icon }} fa-fw {{ $fa_size }}"></i>