mirror of
https://github.com/tiennm99/hugoDocs.git
synced 2026-10-14 08:18:30 +00:00
1 parent
f9b5938dde
commit
c60cd20a87
61 files changed
+126
-126
No files matched your search
@@ -12,7 +12,7 @@ action:
|
||||
toc: true
|
||||
---
|
||||
|
||||
Specify the parameter by position or by name. When calling a shortcode within markdown, use either positional or named parameters, but not both.
|
||||
Specify the parameter by position or by name. When calling a shortcode within Markdown, use either positional or named parameters, but not both.
|
||||
|
||||
{{% note %}}
|
||||
Some shortcodes support positional parameters, some support named parameters, and others support both. Refer to the shortcode's documentation for usage details.
|
||||
|
||||
@@ -46,13 +46,13 @@ Is rendered to:
|
||||
```
|
||||
|
||||
{{% note %}}
|
||||
Content between opening and closing shortcode tags may include leading and/or trailing newlines, depending on placement within the markdown. Use the [`trim`] function as shown above to remove both carriage returns and newlines.
|
||||
Content between opening and closing shortcode tags may include leading and/or trailing newlines, depending on placement within the Markdown. Use the [`trim`] function as shown above to remove both carriage returns and newlines.
|
||||
|
||||
[`trim`]: /functions/strings/trim/
|
||||
{{% /note %}}
|
||||
|
||||
{{% note %}}
|
||||
In the example above, the value returned by `Inner` is markdown, but it was rendered as plain text. Use either of the following approaches to render markdown to HTML.
|
||||
In the example above, the value returned by `Inner` is Markdown, but it was rendered as plain text. Use either of the following approaches to render Markdown to HTML.
|
||||
{{% /note %}}
|
||||
|
||||
|
||||
@@ -99,9 +99,9 @@ We design the **best** widgets in the world.
|
||||
{{%/* /card */%}}
|
||||
{{< /code >}}
|
||||
|
||||
When you use the `{{%/* */%}}` notation, Hugo renders the entire shortcode as markdown, requiring the following changes.
|
||||
When you use the `{{%/* */%}}` notation, Hugo renders the entire shortcode as Markdown, requiring the following changes.
|
||||
|
||||
First, configure the renderer to allow raw HTML within markdown:
|
||||
First, configure the renderer to allow raw HTML within Markdown:
|
||||
|
||||
{{< code-toggle file=hugo >}}
|
||||
[markup.goldmark.renderer]
|
||||
@@ -110,7 +110,7 @@ unsafe = true
|
||||
|
||||
This configuration is not unsafe if _you_ control the content. Read more about Hugo's [security model].
|
||||
|
||||
Second, because we are rendering the entire shortcode as markdown, we must adhere to the rules governing [indentation] and inclusion of [raw HTML blocks] as provided in the [CommonMark] specification.
|
||||
Second, because we are rendering the entire shortcode as Markdown, we must adhere to the rules governing [indentation] and inclusion of [raw HTML blocks] as provided in the [CommonMark] specification.
|
||||
|
||||
{{< code file=layouts/shortcodes/card.html >}}
|
||||
<div class="card">
|
||||
|
||||
@@ -14,7 +14,7 @@ Similar to the [`Inner`] method, `InnerDeindent` returns the content between ope
|
||||
|
||||
This allows us to effectively bypass the rules governing [indentation] as provided in the [CommonMark] specification.
|
||||
|
||||
Consider this markdown, an unordered list with a small gallery of thumbnail images within each list item:
|
||||
Consider this Markdown, an unordered list with a small gallery of thumbnail images within each list item:
|
||||
|
||||
{{< code file=content/about.md lang=md >}}
|
||||
- Gallery one
|
||||
@@ -42,7 +42,7 @@ With this shortcode, calling `Inner` instead of `InnerDeindent`:
|
||||
</div>
|
||||
{{< /code >}}
|
||||
|
||||
Hugo renders the markdown to:
|
||||
Hugo renders the Markdown to:
|
||||
|
||||
```html
|
||||
<ul>
|
||||
@@ -73,7 +73,7 @@ Although technically correct per the CommonMark specification, this is not what
|
||||
</div>
|
||||
{{< /code >}}
|
||||
|
||||
Hugo renders the markdown to:
|
||||
Hugo renders the Markdown to:
|
||||
|
||||
```html
|
||||
<ul>
|
||||
|
||||
Reference in new issue
Block a user