安装
下载仓库 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 规定下拉框的样式