MENU

短代码 - Mirages 帮助文档

• December 27, 2018 • Read: 27845 • 教程

短代码 - Mirages 帮助文档

短代码是主题提供的一种快速生成特定内容的方式。

目前主题只是的短代码还不多,后续会进行扩充(真的,不管你信不信,反正我是信了)

短代码的书写方式为:

[shortcode param="value"]内容[/shortcode]
[shortcode param="value"/]

基本为以上两种写法,需要 Content 的使用第一行的写法,不需要的采用第二行的写法。

其中,shortcode 为短代码的名称,后面的列表中会提供,同一种样式可能会有一个或多个别名;例如短代码 hinttip 其实是同一个短代码。

param="value" 为短代码的参数,内容 为短代码的内容(参数说明中将简称为 内容)。

1.7.10 版本新增可视化编辑页面

主题 1.7.10 版本新增了可视化编辑页面,可以在「文章编辑页面」中内容编辑框上方的快捷操作按钮处找到并使用。

目前可能可用的短代码列表

按钮样式的链接

短代码名称:buttonbtn

生成一个内置按钮样式的超链接。
[button href="https://store.get233.com"]简陋的小商店传送门[/button]

[button url="https://store.get233.com"]简陋的小商店传送门[/button]

[btn url="https://store.get233.com"]简陋的小商店传送门[/btn]
参数说明别名
href点击按钮后跳转的链接linkurl
内容按钮显示的标题

标签卡

短代码名称:tabs

生成一个多标签页的卡片
[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]
如你所见
参数说明别名
name标签页的名称title
selected默认选中的标签页
内容标签卡选中后显示的内容

提示及警告框

短代码名称:hinttip

生成一个提示或警告卡片
[hint]提示内容[/hint]

[hint warn]警告内容[/hint]

[hint type="danger" title="提示标题"]
提示内容
[/hint]
提示内容

警告内容

提示标题

提示内容
参数说明别名
type提示类型,默认为 info,在没有警告标题的情况下,可以直接将提示类型的值写到参数处。可选的提示类型为infowarning(同 warn), danger(同error),success
title提示标题,用于加重展示
内容提示的内容

下载文件链接

短代码名称:file

生成一个下载文件的卡片
[file url="https://example.com/download.zip"]示例文件名[/file]
参数说明别名
href下载文件的链接linkurl
内容文件名

标签

短代码名称:taglabel

生成一个标签
使用鼠标选中文字时[tag]文字的颜色[/tag],默认为[tag type="danger"]白色[/tag]。

[tag]默认 Tag[/tag]
[tag type="primary"]文字的颜色[/tag]
[tag type="info"]文字的颜色[/tag]
[tag type="warn"]文字的颜色[/tag]
[tag type="danger"]文字的颜色[/tag]
[tag type="success"]文字的颜色[/tag]

[tag outline]文字的颜色[/tag]
[tag type="primary" outline]文字的颜色[/tag]
[tag type="info" outline]文字的颜色[/tag]
[tag type="warn" outline]文字的颜色[/tag]
[tag type="danger" outline]文字的颜色[/tag]
[tag type="success" outline="1"]文字的颜色[/tag]
使用鼠标选中文字时文字的颜色,默认为白色

默认 Tag

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

文字的颜色

参数说明别名
type默认为 default,可选值为infowarning(同 warn), danger(同error),successprimarydefault
outline是否使用 outline 样式的标签
内容标签展示的文字

快速输入警告符:   

短代码名称:!

快速输入:   
快速输入: [!/]
快速输入:   

内容回复可见

短代码名称:hide

添加需要评论才可以查看的内容
[hide]这里是评论可见的内容[/hide]
此处内容需要评论回复后方可阅读
莫的参数

折叠框

短代码名称:collapse

可以点击标题展开/折叠的内容
[collapse title="标题"]
折叠内容
[/collapse]

Araby

北理奇蒙德街的一头是不通的,除了基督兄弟学校的学童们放学回家那段时间外,平时很寂静。在街尽头有一幢无人住的两层楼房,跟一块方地上比邻的房子隔开着。街上其他房屋仿佛自以为有像样的住户,而沉下褐色的脸,互相凝视。

我们从前的房客,一个教士,死在这屋子的后客厅里。由于长期关闭,所有的房间散发出一股霉味。厨房后面的废物间里,满地都是乱七八糟的废纸。我在其中翻到几本书页卷起而潮湿的平装书:瓦尔特•司各特作的《修道院长》,还有《虔诚的圣餐者》和《维道克回忆录》。我最喜欢最后一本,因为那些书页是黄的。屋子后面有个荒芜的花园,中间一株苹果树,四周零零落落的几株灌木;在一棵灌木下面,我发现死去的房客留下的一个生锈的自行车打气筒。那教士是个心肠很好的人,他在遗嘱中把全部存款捐给了各种慈善机构,又把家具赠给他的妹妹。

参数说明别名
title折叠框标题
内容折叠内容

Github

短代码名称:github

放置一个 Github 仓库控件
[github repo="typecho/typecho" /]
参数说明
repoGithub 仓库所属用户及仓库名,示例:
对于仓库链接: https://github.com/typecho/typecho,去除域名部分https://github.com/,剩余的 typecho/typecho 就是啦,注意尾部不要加 .git 后缀

Last Modified: January 7, 2020
Archives QR Code Tip
QR Code for this page
Tipping QR Code
Leave a Comment

26 Comments
  1. 主题越来越好了

  2. 真的爱死了,为什么可以这么好看,之前没找到这个文档,超赞@(吐舌)

  3. 用了楼主的产品瞬间感觉如沐春风,很多事情都轻松了不少。

  4. 小小 小小

    这是我见过最棒的主题了@(呵呵)

  5. 增加个自定义字段,可以调文章的宽窄呗,手动调的好丑,不会html