hugo-theme-relearn/exampleSite/content/shortcodes/include/index.en.md

57 lines
1.7 KiB
Markdown
Raw Normal View History

+++
description = "Displays content from other files"
title = "Include"
+++
The `include` shortcode includes other pages, resources or files from your project.
## Usage
2024-04-12 15:30:16 +00:00
While the examples are using shortcodes with named parameter you are free to use positional as well or also call this shortcode from your own partials.
{{< tabs groupid="shortcode-parameter">}}
{{% tab title="shortcode" %}}
````go
{{%/* include file="shortcodes/include/INCLUDE_ME.md" */%}}
````
{{% /tab %}}
{{% tab title="shortcode (positional)" %}}
````go
{{%/* include "shortcodes/include/INCLUDE_ME.md" */%}}
````
{{% /tab %}}
{{% tab title="partial" %}}
````go
{{ partial "shortcodes/include .html" (dict
"page" .
"file" "shortcodes/include/INCLUDE_ME.md"
)}}
````
{{% /tab %}}
{{< /tabs >}}
The included files can even contain Markdown and will be taken into account when generating the table of contents.
### Parameter
| Name | Position | Default | Notes |
|----------------------|----------|------------------|-------------|
| **file** | 1 | _&lt;empty&gt;_ | The path to the page, resource or file to be included. Page and resource paths adhere to [Hugo's logical path](https://gohugo.io/methods/page/path/). If not found by logical path it falls back to [Hugo's build-in `readFile` function](https://gohugo.io/functions/readfile/) |
| **hidefirstheading** | 2 | `false` | When `true` and the included file contains headings, the first heading will be hidden. This comes in handy, eg. if you include otherwise standalone Markdown files. |
## Examples
2022-10-31 11:10:36 +00:00
### Arbitrary Content
````go
{{%/* include "shortcodes/include/INCLUDE_ME.md" */%}}
````
{{% include "shortcodes/include/INCLUDE_ME.md" %}}