Files
hextra_mirror/exampleSite/content/docs/guide/shortcodes/others.zh-cn.md
Ludovic Fernandez 22c1a4f9df feat(badges): colors and border (#774)
* feat(badges): add more colors and allow to disable the border

* feat(badges): more colors

* chore: generate

* docs: add Others inside the sidebar

* chore: i18n

---------

Co-authored-by: Xin <5097752+imfing@users.noreply.github.com>
2025-08-23 14:42:23 +01:00

4.4 KiB
Raw Blame History

title, linkTitle, next
title linkTitle next
其他短代码 其他 /docs/guide/deploy-site

{{< callout type="warning" >}} 其中部分为Hugo内置短代码。 这些短代码稳定性较低,可能随时变更。 {{< /callout >}}

示例

{{< badge "default" >}}  {{< badge content="border" border=false >}}  {{< badge content="color" color="green" >}}  {{< badge content="link" link="https://github.com/imfing/hextra/releases" >}}  {{< badge content="icon" icon="sparkles" >}} 

使用

默认

{{< badge "徽章" >}} 

{{</* badge "徽章" */>}}

颜色

{{< badge content="徽章" >}}  {{< badge content="徽章" color="purple" >}}  {{< badge content="徽章" color="indigo" >}}  {{< badge content="徽章" color="blue" >}}   {{< badge content="徽章" color="green" >}}   {{< badge content="徽章" color="yellow" >}}   {{< badge content="徽章" color="amber" >}}   {{< badge content="徽章" color="orange" >}}   {{< badge content="徽章" color="red" >}} 

{{</* badge content="徽章" */>}}
{{</* badge content="徽章" color="purple" */>}}
{{</* badge content="徽章" color="indigo" */>}}
{{</* badge content="徽章" color="blue" */>}}
{{</* badge content="徽章" color="green" */>}}
{{</* badge content="徽章" color="yellow" */>}}
{{</* badge content="徽章" color="amber" */>}}
{{</* badge content="徽章" color="orange" */>}}
{{</* badge content="徽章" color="red" */>}}

{{< badge content="徽章" border=false >}}   {{< badge content="徽章" color="purple" border=false >}}   {{< badge content="徽章" color="indigo" border=false >}}   {{< badge content="徽章" color="blue" border=false >}}   {{< badge content="徽章" color="green" border=false >}}   {{< badge content="徽章" color="yellow" border=false >}}   {{< badge content="徽章" color="amber" border=false >}}   {{< badge content="徽章" color="orange" border=false >}}  {{< badge content="徽章" color="red" border=false >}} 

{{</* badge content="徽章" border=false */>}}
{{</* badge content="徽章" color="purple" border=false */>}}
{{</* badge content="徽章" color="indigo" border=false */>}}
{{</* badge content="徽章" color="blue" border=false */>}}
{{</* badge content="徽章" color="green" border=false */>}}
{{</* badge content="徽章" color="yellow" border=false */>}}
{{</* badge content="徽章" color="amber" border=false */>}}
{{</* badge content="徽章" color="orange" border=false */>}}
{{</* badge content="徽章" color="red" border=false */>}}

变体

{{< badge content="徽章" icon="sparkles" >}}  {{< badge content="Releases" link="https://github.com/imfing/hextra/releases" icon="github" >}} 

{{</* badge content="徽章" icon="sparkles" */>}}
{{</* badge content="Releases" link="https://github.com/imfing/hextra/releases" icon="github" */>}}

选项

姓名 描述
content 徽章的文字。
link 徽章的链接。
icon 徽章的图标。
color 徽章的颜色。
gray (默认), purple, indigo, blue, green, yellow, amber, orange, red.
class 徽章的等级。
border 添加或删除边框 (默认true).

YouTube

嵌入YouTube视频。

{{</* youtube 视频ID */>}}

效果:

{{< youtube id=dQw4w9WgXcQ loading=lazy >}}

更多信息,请参阅 Hugo 的 YouTube 短代码

PDF

通过PDF短代码可在内容中嵌入PDF文件。

{{</* pdf "https://example.com/sample.pdf" */>}}

也可将PDF文件置于项目目录中并使用相对路径。

{{</* pdf "path/to/file.pdf" */>}}

示例:

{{< pdf "https://upload.wikimedia.org/wikipedia/commons/1/13/Example.pdf" >}}