Meow 主题文档 - 标签插件
- 标签插件：可以在文章 / 页面中使用的模块，Meow 主题内置了多种美观且实用的标签插件供大家选择。
Fiction 虚构作品
Fiction 是 Meow 主题的特色模块，由 2.x 版本的小说模板移植优化而成，适合在小说、同人等作品中使用。
Meta 用于定义作品的基础属性，此标签插件可以帮助作者快速生成整洁美观的作品信息卡。
>> 元信息语法如下：
1 | {% fmeta %} |
>> 元信息参数说明：
元信息的参数应以 YAML 格式列出。
| 参数 | 必填 | 说明 |
|---|---|---|
| type | ✔ | 作品类型，比如：原创小说/同人作品/…… |
| fandom | ✘ | 原型 / 原作，一般只有当作品类型为 “同人作品” 时才需要指明，不填写则不显示 |
| relationship | ✘ | 作品涉及的角色关系，一般填写 CP，也可以填写重要的亲情、友情关系等，不填写则不显示 |
| character | ✘ | 作品中出现的重要角色，不填写则不显示 |
| rating | ✘ | 作品分级，标明适合阅读此作品的读者年龄范围 可选值：0/1/2/3（具体含义请参考下一个表格），不填写则不显示 |
| warning | ✘ | 预警信息，亦即读者应该在阅读正文前应该知悉的内容，防止某些读者被创到 比如：主要角色死亡、血腥暴力描写、病娇要素…… 预警信息由点状下划线着重标记。如果不需要显示预警，或者不希望剧透，请勿填写此项 |
| status | ✘ | 作品状态，用于标记作品是否已完结 可选值：Y（已完结）/ N（连载中），不填写则不显示 |
>> 元信息分级参数说明
| 分级 | 名称 | 说明 | 样式 |
|---|---|---|---|
| 0 | General | 适合全年龄段读者，无警告 | 无 |
| 1 | Teen | 建议青少年及以上读者阅读 | 字体加粗 |
| 2 | Mature | 成人级，一般指文章含有轻微的、非详细的限制级内容 | 字体加粗且显示为粉色 |
| 3 | Explicit | 限制级，一般指文章含有暴力、色情等成人主题相关的详细描写 | 字体加粗且显示为红色 |
- 元信息的属性名称以及可选值都可以在
主题配置文件中的fiction项下自定义显示值。- 作品状态还可以在 Markdown 文件开头的 FrontMatter 中通过
status: Y/N进行配置，此配置会在正文末尾生成提示信息。
Note 信息框
信息框是类似于引用块的模块，但比引用块有着更加丰富的样式供选择。
粉色信息框 Pink Note
黄色信息框 Yellow Note
蓝色信息框 Blue Note
绿色信息框 Green Note
紫色信息框 Purple Note
浅色信息框（默认） Light Note (Default)
>> 信息框语法如下：
1 | {% note [style] %} |
>> 信息框参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| style | ✘ | 信息框样式 可选值：pink/yellow/blue/green/purple/light (默认) |
Fold 折叠块
折叠块将特定的内容包裹在容器内，可以随时折叠 / 展开。
折叠块标题 Fold Title
折叠块内容，支持 Markdown 语法。
折叠块标题 Fold Title
这是一个粉色的、默认打开的折叠块。
>> 折叠块语法如下：
1 | {% fold title [style] [status] %} |
>> 折叠块参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| title | ✔ | 折叠块标题，如果包含空格，请用引号将标题包裹起来 |
| style | ✘ | 折叠块样式，颜色可参考信息框样式 可选值：pink/yellow/blue/green/purple/light (默认) |
| status | ✘ | 折叠块状态，默认为折叠，配置open则会自动展开内容 |
Button 按钮
按钮模块一般当作链接卡片使用。模块内存在多个按钮时，会自动排列布局。
>> 按钮语法如下：
1 | {% button %} |
>> 按钮参数说明：
按钮需要以 YAML 列表形式列出。
| 参数 | 必填 | 说明 |
|---|---|---|
| name | ✔ | 按钮的名字 |
| url | ✔ | 按钮指向的链接，可以是站内的相对路径 |
| desc | ✘ | 按钮的描述。为了效果美观，建议填写 |
| icon | ✘ | 按钮的图标链接，不填写则默认为主题内置的链接图标 |
Tabs 分栏选项卡
点击可以切换不同选项卡，右下角的按钮可以快速返回模块顶部。
第一个选项卡 The First One
如果不指定 tabName，则标签名称默认为tabId + 标签序号。
（示例源码在第三个选项卡）
第二个选项卡 The Second One
支持 Markdown 语法
示例源码：
1 | {% tabs First Tabs %} |
选项卡标签名称可以自定义。
这是默认打开的选项卡。
示例源码：
1 | {% tabs Second Tabs, 2 %} |
将activeIndex配置为 - 1，则默认不打开任何选项卡。
示例源码：
1 | {% tabs 中文选项卡, -1 %} |
当选项卡太多、超出页面宽度时，会自动显示水平滚动条。
（示例源码在最后一个选项卡）
Test.
Test.
Test.
Test.
Test.
示例源码：
1 | {% tabs OverLengthTabs %} |
>> 分栏选项卡语法如下：
1 | {% tabs tabId[,activeIndex] %} |
>> 分栏选项卡参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| tabId | ✔ | 分栏选项卡模块的标识，必须是当前页面中的唯一值 |
| activeIndex | ✘ | 活动选项卡（默认打开）的索引号，不配置则默认为 1；如配置 - 1，则不会自动打开任何选项卡 |
| tabName | ✘ | 自定义选项卡标题 |
每个选项卡的内容需要在tab和endtab的注释块之间填写，支持 Markdown 格式。
Timeline 时间线
时间线标签插件可以用于展示按时间或其它元素来分类的信息。
Meow 主题正式发布。
Meow 主题更新v2.0版本。
经过重构升级，Meow 主题v3.0全新版本发布。
>> 时间线语法如下：
1 | {% timeline title[,style] %} |
>> 时间线参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| title | ✔ | 时间线标题。如果包含空格，请用引号将标题包裹起来。支持 Markdown 格式。 |
| style | ✘ | 时间线样式，颜色可参考信息框样式 可选值：pink/yellow/blue/green/purple，留空则默认使用主题色 |
每个时间线的内容需要在timeline和endtimeline的注释块之间填写，支持 Markdown 格式。
Title 标题
标题标签插件支持生成居中加粗的文字，可以当作美观的文章内标题或醒目的内容使用。
>> 标题语法如下：
{% title 'Title Content' %} |
Music Player 音乐播放器
此标签插件可以在文章 / 页面内加入一个音乐播放器。Meow 对Aplayer 进行了适配与样式优化，并支持使用 Meting API。
>> 音乐播放器语法如下：
- 使用 Meting API 时的标签插件写法
1 | {% music [playerId, type] %} |
- 未使用 Meting API 时的标签插件写法
1 | {% music [playerId, type] %} |
标签插件内部的字段含义详见《进阶教程》中的音乐播放器章节。
>> 音乐播放器参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| playerId | ✘ | 播放器 id。如果需要在同一个页面中插入多个播放器，则必须指定 id，比如 1、2 |
| type | ✘ | 音频来源类型。置空则根据主题配置中是否存在 Meting API 地址来判断，配置local则指定不使用 Meting API |
💡 如果你只想在某些文章 / 页面加入音乐播放器而不需要全局播放器，那么请将主题配置中的music.enable设置为 false，并且在对应页面的 Front-Matter 中加入music: true配置项。
Chat Box 对话框
对话框标签插件用于模拟对话情景，显示效果类似于线上社交软件的聊天窗口。
使用场景举例：摘录与好友或群友的精华聊天记录/对话体小说/捡手机文学/……
蓝星上会有生物回应吗……[🔎搜寻呼叫中]
（正在除草……）
呀呀 —— 嗯帕帕 —— 啦啦 —— 欸？
乌！乌啦啦乌啦～乌啦呀哈啦呀哈！
乌啦 ————
🐱全然わかんない！
>> 对话框语法如下：
1 | {% chat title [status] %} |
>> 对话框参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| title | ✔ | 对话框标题。一般可以填入聊天对象名称或群聊名称 |
| status | ✘ | 对话框状态。默认自动折叠过长的内容，配置open则展开全部内容 |
| author | ✘ | 角色信息列表。配置格式：角色名称: 角色头像图片链接如果不需要自定义头像，则无需配置角色信息列表，主题会自动生成带问号的默认头像 |
| chat | ✔ | 对话信息列表。子项需要以 YAML 数组形式列出 |
| chat.time | ✘ | 对话时间。可以填写任意格式的日期、时间或自定义内容 （注意，对话时间是特殊内容，单独构成一个 chat 的子项） |
| chat.from | ✘ | 发送本条消息的角色名称。如果需要显示自定义头像，角色名称必须与 author 中的配置对应 不配置此项则不显示角色名称 |
| chat.content | ✘ | 本条消息的文本内容。支持 Markdown 语法 |
| chat.image | ✘ | 本条消息附带的图片列表。需要以 YAML 数组形式配置，格式：- 图片链接图片链接同时支持站内相对链接和外链 |
| chat.right | ✘ | 本条消息是否显示在右侧。对话框的背景颜色为配置的主题色 不配置则默认显示在左边，配置 Y则显示在右边，效果类似于 “本人” 发送的消息 |
Mask Text 遮罩文本
此标签插件可以将部分文本遮挡起来，当鼠标划过或点击该模块时，文本内容才会显示出来。
遮罩文本一般可以用在不想直接外显的内容上，也可以当挖空功能来使用（比如对一篇文章的多个关键词进行遮挡，辅助背诵或复习）。
-
这是默认的遮罩文本效果，一行之中可以添加多个遮罩文本🐱。
-
主题展示站内的加密内容，密码都是：meow
- 一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。一个完全被遮挡的超长段落。
-
类型为
1的遮罩文本，点击后会一直显示文本内容，再次点击会重新隐藏，鼠标划过则不会显示。 -
类型为
2的遮罩文本是带下划线的挖空形式，点击后显示文本内容，再次点击会隐藏，鼠标划过也不会显示。 -
类型为
2的遮罩文本指定颜色后的效果。
>> 遮罩文本语法如下：
{% mask 'Content' [type] [style] %} |
1 | - 这是默认的{% mask '遮罩文本' %}效果，一行之中可以添加多个{% mask '遮罩文本🐱' %}。 |
>> 遮罩文本参数说明：
| 参数 | 必填 | 说明 |
|---|---|---|
| content | ✔ | 需要遮挡的文本，使用引号将内容包裹起来 |
| type | ✘ | 遮挡类型，不配置则默认为0，可选配置值：1、2（具体效果见上方示例） |
| style | ✘ | 遮挡样式，颜色可参考信息框样式 可选值：pink/yellow/blue/green/purple/theme (主题颜色)/default (默认，与文章字体颜色一致) |
喜欢这篇作品的话，奖励一下我吧～
