同类文档

BracketDown Plugin for Typecho 使用方法

安装

下载仓库 main 分支中的文件,或者使用 git clone
将插件目录重命名为 BracketDown(注意大小写)
将插件文件夹放置于 typecho 安装目录下的 /usr/plugins/ 目录
在 Typecho 后台启用插件
按照设置界面的提示配置插件

语法
文字块(Block)

文字块用于让一部分文段以更加显眼的方式展示出来,默认样式的文字块是一个有淡灰色边框和浅灰色背景的盒子。 通常情况下文字块用于标记正文中较为重要的额外信息,很多时候博主会用块引用(Blockquote)来完成同样的事情,即使那些文本并非是引用,在这样的情况下,文字块是比块引用更好的选择。

你可以这样创建一个文字块。

[block]你要标记的文段。[/block]

下拉框(Details)

顾名思义,下拉框语法可以创造一个默认只显示标题,点击后就会展示详细内容,再次点击则会收起的结构,用于书写一些不那么重要但可以用于参考的信息。 BracketDown 的下拉框使用的是 HTML 原生的

标签,这个特性比较新,所以插件引入了相应的垫片来提高其兼容性。

你可以这样创建一个下拉框。

[details sum="默认显示的标题"]点击后展开的内容[/details]

如果你是开发者,可以用 details.bracketdown 规定下拉框的样式
文章卡片(Art)

该功能的灵感即短代码语法来自于 youranreus/G

当你需要在你的一篇文章里提及另一篇文章,并引导读者阅读,可以使用文章卡片。

[art]cid[/art]

其中,cid 表示 Typecho 文章的标识符,每篇文章都有自己独一无二的 cid,可以到后台查看,具体方法为:管理-文章-点击一篇文章进行编辑-查看浏览器地址栏最后的数字

如果你是开发者,可以用 .bracketdown-post 规定文章卡片的样式
链接解析(Link to Content)

此功能还在测试,可以在插件设置中开启/关闭

如果你在文章中直接输入一个链接,而不使用 MD 语法(如 名字),就像这样:

https://github.com/BigCoke233/typecho-plugin-BracketDown

它就会被插件识别,如果它指向的是插件支持的平台,它就会被转化为特定的格式,如:

GitHub:指向仓库或用户页面的链接会以卡片展示内容
Bilibili:指向视频页面的链接会被解析为视频插入到文章中(代码参考 superLink 插件)

关于 Pjax

如果你是开发者,可以用 [data-github] 规定 GitHub 卡片的样式
文字上色(TextColor)

有些时候我们可能会想要给一段文字加上背景色或者改变它的颜色,用于强调或者装饰,可以这样写。

&{被上色的文字|颜色|背景色}

如果只想要更改文字颜色和背景色其中的一个,则可以这样写。

&{被上色的文字|颜色}

{被上色的文字|背景色}

其中,颜色和背景色都可以用 css 中能够使用的方式表示颜色,例如:英文单词(red/yellow/white...)、十六进制颜色代码(#000/#66ccff/#fefefe...)、RGB 值(rgb(0,0,0)/rgba(0,0,0,1)...)等。
下划线

可以用以下语法给一段文字添加下划线,默认样式为 text-decoration: underline。

??画线的句子??

如果你是开发者,可以用 .bracketdown-underline 规定下划线文字的样式
注音

遇到一些生僻字或者纯粹想要调皮一下的时候,可能会需要给文字注音。

{{文字:拼音}}

键盘按键

在表示键盘上的按键,如 ctrl、tab 等,可以使用以下语法,创建一个外观与按键类似的小框。

[[键盘按键]]

如果你是开发者,可以用 kbd 规定下拉框的样式

更多文档