# 短代码

短代码是 Facile 主题提供的一种特殊语法,通过短代码可以插入一些特殊样式的内容。

Facile 主题的短代码使用的是类似于 WordPress Shortcode 和 BBCode 风格的方括号语法。

常见的短代码类似:

[alert]提示框[/alert]

[alert type="info"]提示框[/alert]

其中的 type 是样式属性,内容包裹在两个方括号的中间,结尾的方括号会有一个 / 结尾符,类似于 HTML。

目前支持的短代码还不多,后续会增加更多。

# 提示框

下面是提示框的语法:

[alert type="primary"]Typecho博客主题primary[/alert]

[alert type="info"]Typecho博客主题info[/alert]

[alert type="success"]Typecho博客主题success[/alert]

[alert type="secondary"]Typecho博客主题success[/alert]

[alert type="danger"]Typecho博客主题danger[/alert]

[alert type="warning"]Typecho博客主题warning[/alert]

[alert type="dark"]Typecho博客主题dark[/alert]

效果如下:

facile提示框短代码

不加 type 属性默认使用 primary 样式。

# 链接按钮

链接按钮就是按钮样式的链接。

下面是链接按钮语法:

[button url="http://example.com" type="primary"]按钮primary[/button]

[button url="http://example.com" type="info"]按钮info[/button]

[button url="http://example.com" type="success"]按钮success[/button]

[button url="http://example.com" type="secondary"]按钮secondary[/button]

[button url="http://example.com" type="danger"]按钮danger[/button]

[button url="http://example.com" type="warning"]按钮warning[/button]

[button url="http://example.com" type="dark"]按钮dark[/button]

链接按钮样式如下:

Facile链接按钮短代码

url 里就是链接地址,不加 type 默认使用 primary 样式。

# 折叠框

折叠框是一种可以展开和收起的内容容器。

下面是折叠框语法:

[collapse title="点击查看折叠内容"]
这就是被折叠的内容。
[/collapse]

折叠框样式如下:

Facile折叠框短代码

title 是折叠框显示的标题。

# 并排显示

并排显示可以实现并排显示多张图片,也可以是图文并排显示。

下面是3段并排显示的短代码:

下面是并排显示的图片:

[row]
[col] ![图1](1.jpg) [/col]
[col] ![图2](2.jpg) [/col]
[/row]

图文并排

[row]
[col] ![图1](1.jpg) [/col]
[col]
鸣沙山月牙泉风景名胜区,位于敦煌城南五公里,沙泉共处,妙造天成,古往今来以“沙漠奇观”著称于世。

鸣沙山以沙动成响而得名。东汉称沙角山,俗名神沙山,晋代始称鸣沙山,其山东西长40余公里,南北宽约20公里,主峰海拔1715米。

峰恋危峭,山脊如刃,经缩复初;人乘沙流,有鼓角之声,轻若丝竹,重若雷鸣,此即“沙岭晴鸣”。
[/col]
[/row]

三张图片

[row]
[col] ![图1](1.jpg) [/col]
[col] ![图2](2.jpg) [/col]
[col] ![图3](3.jpg) [/col]
[/row]

外层使用 row ,行内使用 col 包裹内容。

宽度是平均分配的,如果一个 row 里只有一个 col,宽度就是 100%,一个 row 里有两个 col,每个的宽度就是接近 50%。

col 里可以放任何内容,图片、文字、列表、按钮 都可以。

下面是并排显示的效果:

Facile并排显示

考虑到手机的屏幕比较窄,在手机上会变为一列显示。

# 徽章

徽章是一种外形类似标签的元素,经常逛 Github 的,对徽章 badge 应该不陌生。

下面是徽章的语法:

[badge type="primary" url="https://www.misterma.com"]徽章primary[/badge]

[badge type="success"]徽章success[/badge]

[badge type="danger"]徽章danger[/badge]

[badge type="warning"]徽章warning[/badge]

[badge type="info"]徽章info[/badge]

[badge type="light"]徽章light[/badge]

[badge type="dark"]徽章dark[/badge]

徽章样式如下:

Facile徽章短代码

type 是样式,不加 type 默认使用 primary 样式。

url 是可选的链接地址,不加 url 解析为 span 普通文本,加 url 解析为 a 链接。

# 隐藏内容

主题提供的隐藏内容可以实现让文章的部分内容隐藏,可以设置为登录才能查看,或者评论才能查看。

下面是隐藏内容的短代码:

[hide type="comment"]隐藏内容[/hide]

[hide type="login"]不让看[/hide]

隐藏后的效果如下:

Facile隐藏内容短代码

type="comment" 需要在文章页发送评论,评论通过审核后才能查看,登录也能查看。

type="login" 只有登录才能查看。

不加 type 默认是评论查看。

# 进度条

下面是进度条短代码:

[progress type="primary"]60[/progress]

[progress type="info"]60[/progress]

[progress type="success"]60[/progress]

[progress type="danger"]60[/progress]

[progress type="warning"]60[/progress]

[progress type="dark"]60[/progress]

进度条效果:

Facile进度条短代码

type 设置进度条样式,不加 type 默认显示 primary 样式。

进度条的进度数字直接包裹在短代码中间,数字不需要加 %

# 选项卡

选项卡(又称标签页)是一种用户界面控件,通过切换不同的标签项在同一屏幕区域展示对应内容,从而节省界面空间并优化信息布局。

下面是选项卡的短代码:

[tabs]
[tab title="第一项"]这是第一项的内容[/tab]
[tab title="第二项"]这是第二项的内容[/tab]
[/tabs]

选项卡效果:

Facile选项卡短代码

外层是 tabs ,标签页用 tabtitle 是标题,内容包裹在标签页中间。

在选项卡内插入一个列表和按钮短代码:

[tabs]
[tab title="有列表"]
下面是一个列表

* 第一项的列表
* 第一项的列表
[/tab]
[tab title="有按钮"]
[button url="https://www.misterma.com"]一个链接按钮[/button]
[/tab]
[/tabs]

效果如下:

Facile在选项卡内插入列表和按钮

# 可访问性

所有的可交互组件,包括 collapse 折叠框和 tab 选项卡,都支持屏幕阅读器和键盘操作。