hugo-theme-hilfe/exampleSite/content/shortcodes/includes.md
Robert Kaussow 5e105c9ff4
feat: auto-load custom svg sprites from assets folder (#79)
BREAKING CHANGE: Build-in icons are prefixed with `gdoc_` now. If you use build-in icons in e.g. menus you have to rename these references!
2021-03-03 21:07:59 +01:00

2.4 KiB

Include shortcode can include files of different types. By specifying a language, the included file will have syntax highlighting.

Shortcode

{{</* include file="relative/path/from/hugo/root" language="go" markdown=[false|true] */>}}

Attributes:

Name Usage default
file path to the included file relative to the hugo root empty value
language* language for syntax highlighting empty value
markdown included file is markdown false
options highlighting options linenos=table

* if not set, the content will be rendered as plain HTML

Include *.yml file with options

{{</* include file="config.yaml" language="yaml" options="linenos=table,hl_lines=5-6,linenostart=100" */>}}

{{< include file="config.yaml" language="yaml" options="linenos=table,hl_lines=5-6,linenostart=100">}}

Include *.md file

Included markdown files will be rendered using the RenderString function.

{{< hint warning >}} Location of markdown files
If you include markdown files that should not get a menu entry, place them outside the content folder or exclude them otherwise. {{< /hint >}}

{{</* include file="static/includes/table.md.part" markdown="true" */>}}

{{< include file="static/includes/table.md.part" markdown="true" >}}

Include *.html file

HTML content will be filtered by the safeHTML filter and added to the rendered page output.

{{</* include file="static/includes/example.html.part" */>}}

{{< include file="static/includes/example.html.part" >}}