短代码
向文章/页面中添加短代码,让文章的表达形式更加丰富
Argon 主题提供了多种短代码的支持,这些短代码可以给文章中增加特殊的内容,让文章的表达形式更加丰富。
通过短代码,您可以很轻松地向文中插入一个折叠区块,或者插入一个 TODO-List、进度条、标签、提示、警告、隐藏文本、一个友情链接列表、时间轴、 Github Repo 信息卡等。
而要做到这些,你只需要在文中插入例如
[alert]foobar[/alert]
的短代码。Wordpress 和 Argon 主题会自动解析这些短代码并呈现在文章中。一个短代码由标签、内容、和参数组成,和 HTML 有些类似。下面是一个短代码的结构。
[标签名 参数名1="参数值1" 参数名2="参数值2"]内容[/标签名]
在一个短代码中,标签是必须的,而参数和内容是不必须的。Wordpress 根据标签来识别短代码。不同标签名的短代码会被解析成不同的形式。
参数是对短代码中的附加内容,例如,你可以在一个提示短代码中,设置它的颜色、它的标题、图标等。接下来的文档中,对于某个短代码,会将其所有支持的参数列在一张表格中。
例如,
[alert]foobar[/alert]
就是一个最简单的的短代码。alert
是短代码的标签名称,foobar
是这个短代码的内容。这个短代码没有参数。另一个例子,
[alert icon="flag"]foobar[/alert]
, 这个短代码给有一个参数 icon
,参数值为 flag
,意思是在这个短代码生成的提示中会显示一个旗帜图标。本文档会详细地对每一个短代码举例。
本章节将介绍 Argon 主题提供的各个短代码的用法及效果。
最近更新 3yr ago