VOID主题非官方使用指南

date
Oct 21, 2019
slug
VOID-theme-guide
status
Published
tags
效率笔记
summary
使用了 VOID 主题一段时间，该主题有一些小的技巧需要经常用到，以我更新博客的速度，没过一段时间就忘记了，不得不去作者博客搜使用指南，所以就有了这篇文章，一个非官方的使用指南。
type
Post
notion image
机缘巧合之下看到了 熊猫小A 大佬开发的 VOID主题，长期关注下发现这是一个正在不断更新且长期维护的 typecho 博客主题，简约的风格我非常喜欢。深入了解他的「三无计划」发现他在使用 hexo 博客做他的 wiki 站，使用 typecho 动态博客系统做 blog 站，前段时间我正苦恼于我将技术内容和日常随记放在一个站点，显得非常杂乱，「三无计划」就给我提供了一个非常好的参考，于是花了一些时间更新了博客系统，具体更新见 hushhw.cn版本更新说明。
使用了 VOID 主题一段时间，该主题有一些小的技巧需要经常用到，以我更新博客的速度，没过一段时间就忘记了，不得不去作者博客搜使用指南，所以就有了这篇文章，一个非官方的使用指南。

1. APlayer for Typecho | Meting 插件

notion image
APlayer 是一个体验非常棒的在线音乐播放器插件，配合 Meting 能非常优雅的使用各平台的音乐资源，下载地址：github。

1.1. 安装

  1. 上传到 /usr/plugins 目录
  1. 修改文件夹名为 Meting
  1. 后台启用插件

1.2. 使用

在文章编辑页面，点击编辑器上的 音乐图标 按钮，在弹出的窗口中输入音乐地址，最后点击确定即可

1.3. 遇到的问题

VOID 博客主题中如果启用了 PJAX 技术，可能会出现切换页面时没有重载播放器的问题，播放器不会加载出来，需要在主题设置页面的 PJAX 重载函数下写入：
loadMeting();

2. Typecho-Plugin-DoubanBoard 插件

内容主要摘录自作者文章：Typecho-Plugin-DoubanBoard 发布
去 GitHub 上下载或者 Clone 这个 repo：Typecho-Plugin-DoubanBoard，将解压后的文件夹改名为 DoubanBoard，上传至站点插件目录启用，并在插件设置面板进行必要的设置。设置项有：
  • 豆瓣 ID：，一般可以从你的个人主页的 URL 里找到，现在豆瓣可以在设置中自定义主页 URL，比较好记。
  • 每次加载的数量：从速度和节省流量的考虑，书单和影单不会一次全部加载。你可以填写每次加载的数量，建议 3 的整数倍显示比较优雅。
  • 缓存过期时间：插件对数据做了本地缓存以提高访问速度，你可以在这里填写缓存过期时间，单位为秒。两次访问时间间隔超过该时间则会重新拉取数据，不填默认 24 小时。注意，不建议设置得过短，否则豆瓣可能判定你的 IP 存在异常流量。
  • 是否加载 JQuery：如果你的主题没有引入则勾选它来引入，否则取消勾选。
注意：要保证 插件目录/cache 这个文件夹可写！

2.1. 插入书单与影单

想读清单：
<div data-status="wish" class="douban-book-list doubanboard-list"></div>
已读清单：
<div data-status="read" class="douban-book-list doubanboard-list"></div>
在读清单：
<div data-status="reading" class="douban-book-list doubanboard-list"></div>
电影想看清单：
<div data-status="wish" class="douban-movie-list doubanboard-list"></div>
电影已看清单：
<div data-status="watched" class="douban-movie-list doubanboard-list"></div>
电影在看清单：
<div data-status="watching" class="douban-movie-list doubanboard-list"></div>
注意，在某些 Type­cho 版本中你可能需要使用 !!! 来包裹住 HTML 代码。

2.2. 插入单部电影、书籍

插入单部电影：
<div class="douban-single" data-type="movie" data-id="电影 ID" data-rating="你的评分"></div>
其中电影 ID 可以在豆瓣电影页面的 URL 中找到。你的评分修改为你自己的评分，10 分制，可带小数。
插入单部书籍
<div class="douban-single" data-type="book" data-id="书籍 ID" data-rating="你的评分"></div>
其中书籍 ID 可以在豆瓣书籍页面的 URL 中找到。你的评分修改为你自己的评分，10 分制，可带小数。
注意，在某些 Type­cho 版本中你可能需要使用 !!! 来包裹住 HTML 代码。

3. 独立页面

3.1. 友链

[links]
[熊猫小A](https://www.imalan.cn)+(https://secure.gravatar.com/avatar/1741a6eef5c824899e347e4afcbaa75d?s=200&r=G&d=)
[熊猫小A的博客](https://blog.imalan.cn)+(https://secure.gravatar.com/avatar/1741a6eef5c824899e347e4afcbaa75d?s=64&r=G&d=)
[/links]
你也许需要用 !!! 来把 div 标签包起来。

3.2. 归档

新建独立页面，自定义模板选择 Archives，内容为空即可。

4. 图片排版

在文章编辑器顶部添加了「图集」按钮，然后在插入的 pho­tos 短代码中间使用常用的 Mark­down 语法插入图片即可实现排版（注意图片之间不要空行，只换行是 OK 的）。你还可以在标签中添加图集描述。
[photos des="图集描述"]
![]()
![]()
[/photos]

5. 增强 makedown 语法

注音语法：双花括号包裹 文本:zhu yin
notice 提示块：【notice】提示内容【/notice】（将中文符号替换为英文符号）
渲染为：[notice]提示内容[/notice]
 
未完待续。。。

参考

Typecho-Plugin-DoubanBoard 发布
Typecho Theme VOID 3.3.0

© hushhw 2015 - 2024