Typecho Plus (v0.6.2) 教程
UBB 代码
Typecho-Plus 支持一些简易的UBB代码,不过不建议您过于依赖UBB,请尽量使用Markdown的语法。因为与Markdown语法冲突,所以嵌套UBB时,记得一定要在两个UBB方括号之间添加一个空格:
[bgcolor=black] [color=#fff]这样才能正确解析UBB互相嵌套的代码[/color] [/bgcolor]
这样才能正确解析UBB互相嵌套的代码另外,Typecho-Plus 所生成的大部分元素都可以参考
typechoplus.css
,并通过插件目录下的 tpluscustom.css
来定义样式、进行美化!块级代码
Typecho-Plus 的块级UBB代码拥有最高权限,因此会与Markdown的Code块相互作用,若是你想在Code代码块中显示块级别的UBB代码,请记得使用\[
来注释掉它。目前 Typecho-Plus 只有
\[hide]
\[notify]
\[login]
\[picbox]
\[div]
这几个块级UBB,其他的UBB代码块不需要进行转义。最好将块级代码放在行首,尽量不要与其他的内容放在一行:
下方示例的代码使用了自定义类名,我采用Typecho的魔术方法将Style插入到了文章内:
!!!
<style>
.ClassName1 {text-shadow: 3px 3px #CCC}
.ClassName2 {font-style: italic}
.ClassName3 {text-decoration: line-through}
.ClassName4 {text-align: right}
.ClassName5 {border: 1px dotted #ccc}
</style>
!!!
隐藏内容
需要点击才会显示的内容,内部可以使用Markdown与UBB代码。可接受2个参数:
参数1为自定义标题,标题中可以使用简单的HTML代码;
参数2为自定义类名。
[hide=可以自定义标题,<i>甚至可以使用HTML</i>,ClassName1]
内部的内容,支持 **Markdown** 与 [color=red]UBB[/color]
[/hide]
通知、提醒
一个醒目的提示栏。可接受2个参数:
参数1为自定义标题;
参数2为自定义类名。
[notify=通知标题,ClassName2]
内部同样支持 **Markdown** 与 [color=red]UBB[/color]
[/notify]
通知标题
内部同样支持 Markdown 与 UBB
权限浏览块
某段内容只有注册会员、且高于指定权限才可浏览。可接受2个参数:
参数1为指定的权限,若为空则默认为4;
参数2为自定义类名。
权限参数可以是
0~4
,权限0代表管理员,之后依次是编辑、贡献者、关注者、访问者权限参数也可以直接写成文本形式:
administrator\admin\editor\contributor\subscriber\visitor\user
v0.6.2 可以直接写入中文描述符:
管理员\编辑\贡献者\关注者\访问者\用户
[login=0,ClassName3]
内部同样支持 **Markdown** 与 [color=red]UBB[/color]
[/login]
[login=管理员,ClassName3]
内部同样支持 **Markdown** 与 [color=red]UBB[/color]
[/login]
以下内容需要 管理员 以上权限才能浏览:
您无权浏览此文章,请退出当前帐号并 重新登录!
以下内容需要 编辑 以上权限才能浏览:
您无权浏览此文章,请退出当前帐号并 重新登录!
以下内容需要 贡献者 以上权限才能浏览:
您无权浏览此文章,请退出当前帐号并 重新登录!
以下内容需要 关注者 以上权限才能浏览:
您无权浏览此文章,请退出当前帐号并 重新登录!
以下内容需要 访问者 以上权限才能浏览:
您无权浏览此文章,请退出当前帐号并 重新登录!
图集
当发布大量图片时,只需要将图片链接按行发布即可,不需要填写繁琐的UBB和MD代码!可接受3个参数:
参数1为图集的标题,支持简易的HTML语法;
参数2代表是否隐藏图集,输入
1
即可;参数3为自定义类名。
如果出现了图集标题,则此图集会被一个边框包裹,并且可以通过点击标题来折叠。
如果没有出现标题,则此图集仅用作发布图片,不会有边框也无法被折叠。
如果隐藏了图集,只有用户点击了图集标题才会打开图集。
内部无效的文本会被忽略,但Typecho-Plus会智能识别Markdown与UBB的图片语法。
[picbox=图集标题 如果不填写则图集不会出现边框 也无法被折叠,1,ClassName4]
https://img.clso.fun/file/89a71e4909714f004e7b8.jpg
https://img.clso.fun/file/3544e955041cfc1e19a05.jpg
无效的内容会被忽略!!!
![](https://img.clso.fun/file/61267773297bac5173d42.jpg)
[img]https://img.clso.fun/file/73a08727dd95fade76751.jpg[/img]
Markdown与UBB格式图片也可以被识别!
https://img.clso.fun/file/1721cd19b6b4a96a8fc1f.jpg
[/picbox]
图集标题 如果不填写则图集不会出现边框 也无法被折叠
DIV 包装
为何要添加这个块级标签?请参阅此教程 https://blog.clso.fun/posts/typecho-plus-div-span-wrap.html
更多预设风格 https://blog.clso.fun/posts/typecho-plus-div-span-wrap.html?page=2
v0.6.0 新添加的块级标签,用以提供更强大的自定义功能,语法为:
[div=ClassName5,一个可用标题 <i>支持简易HTML</i>]
内容可多行
可使用 **Markdown** 与 [red]UBB[/red]
[/div]
[div=ClassName5]
没有标题的内容
[/div]
一个可用标题 支持简易HTML
内容可多行
可使用 Markdown 与 UBB
可使用 Markdown 与 UBB
没有标题的内容
行级代码
这类代码实现功能太过繁杂,我就不一一介绍了,只给出示例。位置
[center]居中文本[/center]
居中文本
[right]居右文本[/right]
居右文本
[align=right]另一种写法[/align]
另一种写法
URL
[url]URL地址[/url]
[url=URL地址]说明文本[/url]
[url=URL地址,blank]新窗体打开链接,不需要加 _ [/url]
[url=URL地址,blank,nofollow noopener]指定rel属性[/url]
安全链接可以在设置中指定检测地址,并自动应用 nofollow noopener 等属性
[safe]URL[/safe]
[safe=URL]说明文本[/safe]
CLSO.FUNCLSO.FUN 安全模式
Download
[download=文件URL]文件名[/download]
[download=/usr/uploads/xxx.7z]downfile.7z[/download]
[download=/usr/uploads/xxx.7z]downfile[/download]
(若不想改变附件后缀,文件名可以省略后缀)
为<A>
标签添加一个download
属性,并可以指定文件名!因为 Typecho 的附件系统会改变文件名,所以可以用这个方法来让用户下载原本的文件名,而不是一串数字。
不过这个功能仅支持现代浏览器,IE全系列是无效的,并且无法跨域,仅支持当前域名下的文件!
点此下载 老司机.jpg
IMG
[img]url[/img]
[img=宽x高]url[/img]
[img=宽,高]url[/img]
宽与高不用加px
Pic
[pic=url]带描述文本的图片[/pic]
[pic=url,宽x高]带描述文本的图片[/pic]
[pic=url,宽,高]带描述文本的图片[/pic]
[pic]url[/pic] 如果忽略了URL参数,则描述文本即为URL
带描述文本的图片
颜色
[color=red]文本[/color]
[color=#ccc]文本[/color]
[yellow]文本[/yellow]
[color=red,#ccc]带背景色的文本[/color]
[red=#ccc]带背景色的文本[/red]
文本文本
文本
带背景色的文本
带背景色的文本
颜色TAG支持
red|green|blue|white|purple|yellow|violet|brown|black|pink|orange|gold
v0.6.0 可设置第二个参数为背景色
[bgcolor=red]文本[/bgcolor]
[bgcolor=#ccc]文本[/bgcolor]
文本文本
字体
[font=宋体,5,red]字体[/font]
[size=7]字体[/size]
[face=黑体]字体[/face]
字体字体
字体
font
标签已被淘汰,我在考虑是否应该升级此标签为span
,风格也改换成CSS样式。)音频、视频
[audio=音量,播放速度,自动播放,重播]url[/audio]
[audio=0.3,1.5,1,1]url[/audio]
[mp3]url[/mp3]
[music]url[/music]
[video=音量,播放速度,自动播放,重播]url[/video]
[vod=0.25,1.5,1,1]url[/vod]
[movie]url[/movie]
[mov]url[/mov]
示例:音量25%,速度1.5倍,不自动播放,自动重播
[audio=0.25,1.5,,1]https://music.163.com/song/media/outer/url?id=28996013[/audio]
自 v0.6.1 开始,Typecho-Plus 已能正确对媒体元素进行控制,同时也支持对HTML的媒体元素进行控制,方式为:
<audio src="src" volume="0.3" playbackrate="1.5" autoplay muted loop width="400" height="280" />
注意:基于Chrome的视频自动播放规则,自 v0.6.2 开始,自动播放的视频会被添加 muted
属性,自动播放的视频会被静音播放。如果想让视频有声音,就不要让它自动播放,由用户点击播放的视频才能有声音。注音
一段[ruby=zhù yīn]注音[/ruby]文字
一段注音文字该功能兼容性其实不错,IE5都支持这个功能!
SPAN 包装
一个简易的[span=className]SPAN包装[/span]内容
一个简易的SPAN包装内容请参阅上面的
DIV 包装
,或者直接点击下方的教程:https://blog.clso.fun/posts/typecho-plus-div-span-wrap.html
下一页没了
下一页真的没了
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。
博主,我问一下,点进文章后收缩框点不开,需要再刷新一次才可以,这怎么解决呢
应该是JS加载的位置不对,可能是JS脚本被过早加载,没能触发对后面内容的处理。
请修改模板内JS的位置,尽量将脚本加载位置放到最后面,或者给JS标签添加延迟加载的属性。
好的,谢谢博主!
感谢博主,此乃神器,typecho也能写出五彩斑斓,功能丰富的华丽页面了!原版的Markdown还是太素了!
已知BUG 权限浏览在MIP模式下毫无作用,一览无余
请提供更多信息,是否启用了第三方的模板或者插件所实现的MIP功能。
可能你安装的插件或者模板,并非通过Typecho默认的接口对内容进行了操作,才会避开了typecho hook的触发。
如需兼容,可以参考 typecho plus 内的 content 函数,到相关的模板或插件中对内容进行过滤和修改。
使用login功能文章502
感谢博主,此乃神器,typecho也能写出五彩斑斓,功能丰富的华丽页面了!原版的Markdown还是太素了!