跳到正文
Hello World

文章

山果主题短代码全家桶:排版也能很有表现力

这是一篇短代码的测试页。主题目前只保留了一条短代码

,其余 17 条内置短代码已整组移除。

基本用法

一条最简单的短代码,只有内容、没有属性:

[sg_test]这里是被包裹的内容。短代码的作用就是把这段文字包进一个带样式的容器里。

带标题

加一个 title 属性,标题会出现在内容上方:

带标题的测试

标题走 Guard::e() 转义,内容走 Guard::sanitizeHtml() 清洗,两者都不可省。

只写标题

内容留空也成立,只显示标题:

只有标题

内容里可以用 Markdown

包裹内容会先经过 Markdown 转换,再进短代码:

Markdown 混排

加粗、斜体、行内代码 都正常。

  • 列表第一项
  • 列表第二项
列一列二
甲乙

两条紧挨着写

这是最容易出问题的一处:Markdown 会把 [sg_x][sg_y] 当成引用式链接、连方括号一起吃掉。主题在转换前做了保护,所以下面两条应当都渲染出来:

第一条

相邻的第一条

第二条

相邻的第二条

未知名字不会吞内容

写一个不存在的名字,标记原样保留、里面的文字也不会丢:

[sg_unknown]这段文字应该照常出现[/sg_unknown]

怎么加新短代码

照 Feature/Shortcode.php 里 test 那一段抄:NAMES 加一行、renderOne() 加一个 case、catalog() 加一条、components.css 第 22 节加样式。

暂无评论

还没有人说话,来做第一个。

添加新评论

提交后可能需要审核,请稍候。