# 主题短代码演示与说明
这里是(Plain,Sinner,Dinner,Winner,Sola,MiLi,Hani,Speed,Avideo)主题短代码效果展示,不同主题之间样式可能略有差异请以实际为准。
短代码助手插件1.1.9版本下载:https://qqdie.lanzouw.com/i46nQ3nmy8xe
(其中,居中,居右按钮可鼠标选中文本然后点击即可自动为选中文本设置好对应的短代码)
如果看了文章还是不知道怎么写,可以访问这个地址:https://shop.typecho.show/2842.md 这个地址下的文本就是这个文章的实例
### 文章目录树
{tabs selected="3"}
{tab name="说明"}
在屏幕右侧显示文章目录树
{/tab}
{tab name="示例"}
```
{postindex}
```
{/tab}
{tab name="效果"}
如屏幕右侧所示
{/tab}
{/tabs}
{postindex}
### 居中/居右
{tabs selected="3"}
{tab name="说明"}
可以让文本或者图片居中
{/tab}
{tab name="示例"}
```
{center}需要居中的文字或图片{/center}
因为typecho默认能识别
所以居中比较推荐这样写
需要居中的文字或图片
{right}需要居右的文字(不支持图片){/right}
```
{/tab}
{tab name="效果"}
{center}需要居中的文字或图片{/center}
{right}需要居右的文字(不支持图片){/right}
{/tab}
{/tabs}
### ToDo
{tabs selected="3"}
{tab name="说明"}
创建TodoList
{/tab}
{tab name="示例"}
```
- [x]这是勾选表头
- [ ]里面为空格则是未勾选
```
{/tab}
{tab name="效果"}
- [x]这是勾选表头
- [ ]里面为空格则是未勾选
{/tab}
{/tabs}
### 登录可见
{tabs selected="3"}
{tab name="说明"}
设置登录可见内容
{/tab}
{tab name="示例"}
```
{login}登录可见内容{/login}
```
{/tab}
{tab name="效果"}
{login}登录可见内容{/login}
{/tab}
{/tabs}
### 文本样式
{tabs selected="3"}
{tab name="说明"}
为文本设置颜色下划线等属性,这个短代码有些可能不太短,可以使用编辑器上的按钮来快速设置哈!
{/tab}
{tab name="实例"}
```
{red}红色文字{/red}
{green}绿色文字{/green}
{blue}蓝色文字{/blue}
{yellow}黄色文字{/yellow}
{purple}紫色文字{/purple}
+-下划线文本+-
-+双下划线文本-+
~~删除线文本~~
或者
{span class="text-red-600"}红色文字{/span}
{span class="text-green-600"}绿色文字{/span}
{span class="text-blue-600"}蓝色文字{/span}
{span class="text-yellow-600"}黄色文字{/span}
{span class="text-purple-600"}紫色文字{/span}
{span class="underline"}下划线文本{/span}
{span class="underline decoration-double"}双下划线文本{/span}
{span class="line-through"}删除线文本{/span}
```
{/tab}
{tab name="效果"}
{red}红色文字{/red}
{green}绿色文字{/green}
{blue}蓝色文字{/blue}
{yellow}黄色文字{/yellow}
{purple}紫色文字{/purple}
+-下划线文本+-
-+双下划线文本-+
~~删除线文本~~
{/tab}
{/tabs}
### 按钮样式的链接
{tabs selected="3"}
{tab name="说明"}
生成一个按钮样式的超链接,并且支持四种样式
{/tab}
{tab name="示例"}
```html
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="red"}红色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="green"}绿色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="blue"}蓝色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="yellow"}黄色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="purple"}紫色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="gray"}灰色按钮{/button}
```
{/tab}
{tab name="效果"}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="red"}红色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="green"}绿色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="blue"}蓝色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="yellow"}黄色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="purple"}紫色按钮{/button}
{button href="https://www.bilibili.com/video/BV1mN4y167JK" type="gray"}灰色按钮{/button}
{/tab}
{tab name="参数说明"}
|参数|说明|别名|
|:--|:--|:--|
|href|点击按钮后跳转的链接|`url`|
|内容|按钮显示的标题||
{/tab}
{/tabs}
### 标签卡
{tabs selected="3"}
{tab name="说明"}
生成一个多标签页的卡片
{/tab}
{tab name="示例"}
```
{tabs}
{tab name="标签页 1"}内容 1{/tab}
{tab name="标签页 2"}内容 2{/tab}
{/tabs}
或
{tabs selected="2"}
{tab name="标签页 1"}内容 1{/tab}
{tab name="标签页 2"}内容 2{/tab}
{/tabs}
```
{/tab}
{tab name="效果"}
如你所见
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|name|标签页的名称|
|selected|默认选中的标签页|
|内容|标签卡选中后显示的内容|
{/tab}
{/tabs}
### 相册短代码
{tabs selected="3"}
{tab name="说明"}
将标签内的图片按照设置的数量进行排列
{/tab}
{tab name="示例"}
```
{photo title="御坂美琴"}
































{/photo}
```
{/tab}
{tab name="效果"}
{photo title="御坂美琴"}
































{/photo}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|set|有四个数字参数,为手机端、大手机端、平板端、电脑端一行显示的图片数量,第一个数字参数为必填,多个参数之间用英文的逗号隔开|
|bili|可以设置图片显示的比例,默认支持`21x9`、`16x9`、`4x3`、`2x3`、`10x14`、`3x4`、`1x2`、`2x1`、`3x1`、`4x1`这些比例,此参数非必填项,不填写则为`1:1`比例|
|Plain主题|该主题相册为瀑布流模式没有上述两个参数,如果想要使用类似上方参数效果可看文档使用`grid`布局短代码|
{/tab}
{/tabs}
### 提示及警告框
{tabs selected="3"}
{tab name="说明"}
生成一个提示或警告卡片
{/tab}
{tab name="示例"}
```html
{tip}内容{/tip}
{tip type="warning"}内容{/tip}
{tip type="error"}内容{/tip}
{tip type="success"}内容{/tip}
```
{/tab}
{tab name="效果"}
{tip}内容{/tip}
{tip type="warning"}内容{/tip}
{tip type="error"}内容{/tip}
{tip type="success"}内容{/tip}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|type|提示类型,默认为 info,在没有警告标题的情况下,可以直接将提示类型的值写到参数处。可选的提示类型为 `info`,`warning`(同 `warn`), `danger`(同 `error`),`success`|
|内容|提示内容|
{/tab}
{/tabs}
### 点击复制文本
{tabs selected="3"}
{tab name="说明"}
生成点击复制的文本样式按钮,make主题不支持
{/tab}
{tab name="示例"}
```
{copy text="被复制的内容"}内容{/copy}
```
{/tab}
{tab name="效果"}
{copy text="泽泽社bilibili.com/video/BV1mN4y167JK"}点击复制{/copy}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|text|被复制的内容|
|内容|表面显示出来的内容,一般设置为“点击复制”|
{/tab}
{/tabs}
### 下载文件链接
{tabs selected="3"}
{tab name="说明"}
生成一个下载文件的链接按钮
{/tab}
{tab name="示例"}
```html
{file url="https://example.com/download.zip"}示例文件名{/file}
```
{/tab}
{tab name="效果"}
{file url="https://example.com/download.zip"}示例文件名{/file}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|href|文件的下载链接,也可以用`url`|
|内容|按钮显示的内容|
{/tab}
{/tabs}
### 调用文章
{tabs selected="3"}
{tab name="说明"}
调用文章,并显示卡片形式的文章样式
{/tab}
{tab name="示例"}
```html
{post cid="文章cid"}
```
{/tab}
{tab name="效果"}
{post cid="43"}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|cid|在后台的编辑文章的地址可以看到,比如`http://localhost/build/admin/write-post.php?cid=23`,`23`就是文章cid|
{/tab}
{/tabs}
### 折叠框
{tabs selected="3"}
{tab name="说明"}
可以点击标题展开 / 折叠的内容
{/tab}
{tab name="实例"}
```
{collapse title="标题"}
折叠内容
{/collapse}
或
{collapse title="标题" show="true"}
默认展开的折叠内容
{/collapse}
```
{/tab}
{tab name="效果"}
{collapse title="标题"}
折叠内容
{/collapse}
{collapse title="标题" show="true"}
默认展开的折叠内容
{/collapse}
{/tab}
{tab name="说明"}
|参数|说明|
|:--|:--|
|title|折叠框标题|
|show|参数值为`true`时默认展开,不使用show参数时则默认折叠|
|内容|折叠内容|
{/tab}
{/tabs}
### Bilibili
{tabs selected="3"}
{tab name="说明"}
以卡片形式调用哔哩哔哩内容,依赖泽泽的`api`
{/tab}
{tab name="实例"}
```
单个视频
{bilibili av="内容"}
如:{bilibili av="22183590"}
或者
{bilibili bv="内容"}
如:{bilibili bv="BV1As411p7z6"}
```
{/tab}
{tab name="效果"}
{bilibili av="22183590"}
{bilibili bv="BV1As411p7z6"}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|`av`或`bv`|声明调用的内容的类型为单独视频,建议全面使用`bv`类型|
|内容|用`av`内容就是`av`号,用`bv`内容就是`bv`号|
{/tab}
{/tabs}
### 时间线
{tabs selected="3"}
{tab name="说明"}
建立个时间线内容
{/tab}
{tab name="实例"}
```
{timeline}
**2015年6月初:**
想起自己初高中时期想建立网站的愿望
{p}
**2015年6月6日:**
购入域名,并确立网站类型为个人博客
{/p}
**2020年12月3日**
网站域名与数据卖了,并更换新域名数据照旧
{/timeline}
```
{/tab}
{tab name="效果"}
{timeline}
**2015年6月初:**
想起自己初高中时期想建立网站的愿望
{p}
**2015年6月6日:**
购入域名,并确立网站类型为个人博客
{/p}
**2020年12月3日**
网站域名与数据卖了,并更换新域名数据照旧
{/timeline}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|timeline|使用timeline参数包裹内容,每个段落即为一个时间的内容复杂情况是使用`{p}`标签包裹,段落开头加粗部分为时间|
{/tab}
{/tabs}
### 导航链接模块
{tabs selected="3"}
{tab name="说明"}
在文章或独立页面里建立链接导航,部分功能要求typecho在1.2.0及以上版本
{/tab}
{tab name="示例"}
```
{link}
{网站名,网站描述,网站地址}
{网站名,网站描述,网站地址,网站图标链接}
{/link}
如上在link标签内,按照上述格式插入链接即可,(网站图标链接选填,不填则调用api获取,并要求typecho在1.2.0及以上版本)
```
{/tab}
{tab name="效果"}
{link}
{哔哩哔哩,泽泽的小视频,https://www.bilibili.com/video/BV1mN4y167JK}
{哔哩哔哩,泽泽的小视频,https://www.bilibili.com/video/BV1mN4y167JK}
{哔哩哔哩,泽泽的小视频,https://www.bilibili.com/video/BV1mN4y167JK}
{哔哩哔哩,泽泽的小视频,https://www.bilibili.com/video/BV1mN4y167JK}
{哔哩哔哩,泽泽的小视频,https://www.bilibili.com/video/BV1mN4y167JK}
{哔哩哔哩,泽泽的小视频,https://www.bilibili.com/video/BV1mN4y167JK}
{/link}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|link|使用link参数包裹内容,内容中每个大括号内即为一个链接卡片|
|链接卡片|有四个参数依次为网站名,网站描述,网站地址,网站图标链接,每个参数直接用`,`号隔开,
其中网站图标链接选填,不填则通过api获取,并要求typecho在1.2.0及以上版本|
{/tab}
{/tabs}
### 影视卡片
{tabs selected="3"}
{tab name="说明"}
在文章或独立页面里建立视频模块卡片,要求typecho在1.2.0及以上版本(低版本未测试也许用不了)
{/tab}
{tab name="示例"}
```
**单集视频**
{video}https://s3.bfzycdn.com/video/shizilukouduanpian/HD中字/index.m3u8{/video}
**多集视频**
{video title="日语歌曲"}
ツユ - やっぱり雨は降るんだね$https://www.bilibili.com/video/BV13f4y1G7sA
ツユ - くらべられっ子$https://www.bilibili.com/video/BV1z341127mZ
生まれた意味などなかった。 / まふまふ$https://www.bilibili.com/video/BV1i4411q7vA
{/video}
**多线路多集视频**
{video title="动画奇遇"}
(哔哩哔哩){
夏日奇遇$https://www.bilibili.com/video/BV14t4y1W7qg
大雄的喜马拉雅行进记$https://www.bilibili.com/video/BV174411L77n
我们仍未知晓的天空之蓝$https://www.bilibili.com/video/BV1YZ4y1Z7FW
}
(西瓜视频){
夏日奇遇$https://www.ixigua.com/7106423992654758413
大雄的喜马拉雅行进记$https://www.ixigua.com/7077930787571663367
我们仍未知晓的天空之蓝$https://www.ixigua.com/7059594949062296078
}
{/video}
```
{/tab}
{tab name="效果"}
**单集效果**
{video pic="https://img.bfzypic.com/upload/vod/20230424-32/c679398db8c065fd6bf6d16484ef2e62.jpg"}https://s3.bfzycdn.com/video/shizilukouduanpian/HD中字/index.m3u8{/video}
**多集效果如下**
{video title="日语歌曲"}
ツユ - やっぱり雨は降るんだね$https://www.bilibili.com/video/BV13f4y1G7sA
ツユ - くらべられっ子$https://www.bilibili.com/video/BV1z341127mZ
生まれた意味などなかった。 / まふまふ$https://www.bilibili.com/video/BV1i4411q7vA
{/video}
**多线路效果如下:**
{video title="动画奇遇"}
(哔哩哔哩){
夏日奇遇$https://www.bilibili.com/video/BV14t4y1W7qg
大雄的喜马拉雅行进记$https://www.bilibili.com/video/BV174411L77n
我们仍未知晓的天空之蓝$https://www.bilibili.com/video/BV1YZ4y1Z7FW
}
(西瓜视频){
夏日奇遇$https://www.ixigua.com/7106423992654758413
大雄的喜马拉雅行进记$https://www.ixigua.com/7077930787571663367
我们仍未知晓的天空之蓝$https://www.ixigua.com/7059594949062296078
}
{/video}
{/tab}
{tab name="参数说明"}
|参数|说明|
|:--|:--|
|video|使用video参数包裹内容,可以使用title属性填写标题(非强制),可以使用pic属性自定义封面图(非强制),title与pic参数同时使用时,pic属性必须在title后面|
|内容|内容格式为(集数$视频链接)一行一集,其他详见实例代码|
|视频链接|默认自动识别a、b站视频/直播间、西瓜视频、腾讯视频、斗鱼视频、Youtube,同时也支持填写视频直链m3u8,mp4后缀的链接|
特殊说明:在直链视频地址前或者后追加"{no}"字符串,可以使播放器追加禁止追踪域名
{/tab}
{/tabs}
### 网格布局(仅部分主题支持)
{tabs selected="3"}
{tab name="说明"}
仅`Plain`主题和`Sola`主题支持
{/tab}
{tab name="示例"}
```
图片网格布局
{grid set="2,4"}




{/grid}
图文卡片布局
{grid set="1,2" bili="4x3"}
{card}

{center}点击下载{/center}
{/card}
{card}

{center}点击下载{/center}
{/card}
{card}

{center}点击下载{/center}
{/card}
{card}

{center}点击下载{/center}
{/card}
{/grid}
```
{/tab}
{tab name="效果"}
图片网格布局
{grid set="2,4"}




{/grid}
图文卡片布局
{grid set="1,2" bili="4x3"}
{card}

{center}点击下载{/center}
{/card}
{card}

{center}点击下载{/center}
{/card}
{card}

{center}点击下载{/center}
{/card}
{card}

{center}点击下载{/center}
{/card}
{/grid}
{/tab}
{tab name="说明"}
`gird`为网格布局,`set`属性为必填属性,`set`完整为`set="1,2,3,4,5,6"`共计`6`个数字(数字键用","号隔开,至少要有一个数值),数字键最大值为`12`,数字表示每行的列数。
```
第1个数字:表示列数
第2个数字:屏幕宽度>'640px'时的列数
第3个数字:屏幕宽度>'768px'时的列数
第4个数字:屏幕宽度>'1024px'时的列数
第5个数字:屏幕宽度>'1280px'时的列数
第6个数字:屏幕宽度>'1536px'时的列数
```
网格布局内将使得换行失效,如需使用换行,可以使用`{br}`来实现
{/tab}
{/tabs}
[1]: https://www.ixigua.com/7106423992654758413