Skip to content

Latest commit

 

History

History
199 lines (128 loc) · 6.4 KB

README.md

File metadata and controls

199 lines (128 loc) · 6.4 KB

Typecho Theme VOID 2.1.1

✏ 一款简洁优雅的单栏 Typecho 主题

作为计算机术语时，VOID 的意思是「无类型」。

build status

特性

演示站点：熊猫小A的博客，介绍文章：VOID：现在可以公开的情报。

  • PJAX 无刷新体验
  • AJAX 评论
  • 夜间模式（支持随日出日落自动切换）
  • 响应式设计
  • 优秀的可读性
  • 代码高亮、行号
  • MathJax 公式
  • 表情解析（文章、评论可用）
  • 图片排版（可用作相册）
  • 灵活的头图设置
  • 目录解析
  • 完整的结构化数据支持
  • 够用的后台设置与丰富的高级设置
  • ...

以及其他很多细节，总之用起来还算舒服。我建立了一个示例页面，在这里你可以看到 VOID 对常用写作元素的支持以及一些特色功能演示：示例页面。

开始使用

  1. 下载主题：发布版 | 开发版
  2. 解压
  3. 把解压后的文件夹重命名为 VOID
  4. 检查文件夹名是否为 VOID，不是的话改成 VOID
  5. 检查文件夹名是否为 VOID，不是的话改成 VOID
  6. 检查文件夹名是否为 VOID，不是的话改成 VOID
  7. 上传文件夹至站点 /usr/themes 目录下
  8. 后台启用主题
  • 可选：将主题 assets 文件夹下的 VOIDCacheRule.js 复制一份到站点根目录，并在主题设置中启用 Service Worker 缓存。
  • 可选：主题文件夹下 advanceSetting.sample.json 中有一些高级设置，可以看看。

常见问题（请务必仔细阅读）

下载安装后样式不对？

仓库中的是未压缩的源代码，包含大量实际使用中不需要的文件，并且可能无法直接使用。请一定通过这两个链接下载主题：发布版 | 开发版

添加归档页面

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

添加友情链接

新建独立页面，然后如此书写：

[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]

文章中、独立页面中都可以通过该语法插入类似的展示块。在某些 Typecho 版本中 HTML 会被转义后输出，请使用 !!! 包裹以上代码，例如：

!!!
[links]
···
[/links]
!!!

!!! 需要单独占一行。

图片排版

在文章中，使用 [photos][/photos] 包起来的图片可显示在同一行。例如：

[photos]
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0073.jpeg)
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0053.jpeg)
[/photos]

[photos]
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0039.jpeg)
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0051.jpeg)
![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0005.jpeg)
[/photos]
浏览量统计

使用插件：TePostViews

文章点赞

使用插件：Like

SQLite 数据库支持

目前本主题在 SQLite 数据库下可能会有未知问题，请知悉。

更新

同开始使用，区别是你可以直接覆盖主题文件，不禁用主题，这样你的主题设置就不会丢失。

开发

展开详情

如果你有不错的想法，可以定制自己的版本。首先你需要准备好 NodeJS 环境，然后 clone 这个 repo：

git clone https://github.com/AlanDecode/Typecho-Theme-VOID ./VOID && cd ./VOID

安装依赖：

npm install -g gulp
npm install

然后将依赖打包：

gulp dev

你可以使用自己喜欢的方式编译 SCSS，或者使用：

gulp sass

监听 SCSS 更改然后实时编译。尽请添加自己想要的功能，满意后就提交代码。然后：

gulp build

构建你的主题，生成的主题位于 ./build 目录下。如果你对自己的更改很满意，欢迎提出 Pull Request。

更新日志

2019-04-21 Version 2.1.2

  • 优化夜间模式提醒
  • 优化字体细节
  • 使用 Prism.js 替换 Highlight.js
  • 调整脚本加载顺序，缩短白屏时间
  • 消灭了一些臭虫

高级设置：

  • 是否在底部显示最近访客

更多：change-log.md

鸣谢

开源项目

JQuery | Prism.js | MathJax | fancyBox | bigfoot.js | OwO | pjax | yue.css | tocbot | pangu.js | social | Headroom.js | sun.js | jsTimezoneDetect

其他

RAW | Mirages | handsome | Card | Casper | Typlog

捐助

如果本项目对你有所帮助，请考虑捐助我

谢谢支持

License

MIT © AlanDecode