{"id":13713239,"url":"https://github.com/AlanDecode/Typecho-Theme-VOID","last_synced_at":"2025-05-06T23:31:35.264Z","repository":{"id":40504727,"uuid":"166417108","full_name":"AlanDecode/Typecho-Theme-VOID","owner":"AlanDecode","description":"🐒 猴子打字机原理的产物","archived":false,"fork":false,"pushed_at":"2023-12-11T08:13:55.000Z","size":10130,"stargazers_count":855,"open_issues_count":6,"forks_count":129,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-11-14T00:33:45.611Z","etag":null,"topics":["typecho","typecho-theme"],"latest_commit_sha":null,"homepage":"https://blog.imalan.cn/archives/247/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlanDecode.png","metadata":{"files":{"readme":"README.md","changelog":"change-log.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-18T14:26:36.000Z","updated_at":"2024-11-06T01:26:34.000Z","dependencies_parsed_at":"2024-11-14T00:40:31.225Z","dependency_job_id":null,"html_url":"https://github.com/AlanDecode/Typecho-Theme-VOID","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanDecode%2FTypecho-Theme-VOID","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanDecode%2FTypecho-Theme-VOID/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanDecode%2FTypecho-Theme-VOID/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlanDecode%2FTypecho-Theme-VOID/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlanDecode","download_url":"https://codeload.github.com/AlanDecode/Typecho-Theme-VOID/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252787518,"owners_count":21804278,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["typecho","typecho-theme"],"created_at":"2024-08-02T23:01:30.469Z","updated_at":"2025-05-06T23:31:30.257Z","avatar_url":"https://github.com/AlanDecode.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"**[2023.04.07] 如果大家配合 Typecho 1.2 版本使用 VOID 时遇到问题，请到 GitHub 集中留言反馈：https://github.com/AlanDecode/Typecho-Theme-VOID/issues/87**\n\n---\n\n# Typecho Theme VOID 3.5.1\n\n\u003e ✏ 一款简洁优雅的 Typecho 主题\n\n作为计算机术语时，VOID 的意思是「无类型」。\n\n![](https://raw.githubusercontent.com/AlanDecode/Typecho-Theme-VOID/master/screenshot.png)\n\n[![Build](https://github.com/AlanDecode/Typecho-Theme-VOID/workflows/Build/badge.svg)](https://github.com/AlanDecode/Typecho-Theme-VOID/actions) [![downloads](https://img.shields.io/github/downloads/AlanDecode/Typecho-Theme-VOID/total.svg?style=flat-square)](https://github.com/AlanDecode/Typecho-Theme-VOID/releases) [![](https://img.shields.io/github/release/AlanDecode/Typecho-Theme-VOID.svg?style=flat-square)](https://github.com/AlanDecode/Typecho-Theme-VOID/releases) ![](https://img.shields.io/github/license/AlanDecode/Typecho-Theme-VOID.svg?style=flat-square)\n\n## 特性\n\n\u003e 介绍文章：[VOID：现在可以公开的情报](https://blog.imalan.cn/archives/247/)。\n\n* 响应式设计\n* PJAX 无刷新体验\n* AJAX 评论\n* 前台无跳转登陆（兼容 PJAX）\n* 自动夜间模式\n* 优秀的可读性\n* 衬线、非衬线两种文字风格\n* 代码高亮（浅色暗色两种风格，随主题切换）\n* Mac 风格代码块（可开启或关闭）\n* 代码行号\n* 站点样式设置面板（日夜转换、字体、字号）\n* MathJax 公式\n* 表情解析（文章、评论可用）\n* 图片排版（可用作相册）\n* 图片懒加载\n* 灵活的头图设置\n* 文章目录解析\n* 完整的结构化数据支持\n* 够用的后台设置与丰富的高级设置\n\n结合附带的配套专用插件，还有更多功能：\n\n* 浏览量统计\n* 文章点赞\n* 文章字数统计\n* 评论投票与自动折叠\n* 访客互动展示\n\n以及其他很多细节，总之用起来还算舒服。我建立了一个示例页面，在这里你可以看到 VOID 对常用写作元素的支持以及一些特色功能演示：[示例页面](https://blog.imalan.cn/archives/194/)。\n\n## 开始使用\n\n1. 下载主题：[发布版](https://github.com/AlanDecode/Typecho-Theme-VOID/releases)，注意是下载 VOID-x.x.x.zip 这个压缩包，而不是 Source code\n2. 解压\n3. 将**主题文件夹下**的 VOID 文件夹上传至站点 /usr/themes 目录下\n4. 后台启用主题\n5. 将**配套插件文件夹下**的 VOID 文件夹上传至站点 /usr/plugins 目录下\n6. 后台启用插件\n\n* 可选：将主题 `assets` 文件夹下的 `VOIDCacheRule.js` 复制一份到站点根目录，并在主题设置中启用 Service Worker 缓存。\n* 可选：主题文件夹下 advanceSetting.sample.json 中有一些高级设置，可以看看。\n\n开发版主题可以在这里获取：[开发版](https://github.com/AlanDecode/Typecho-Theme-VOID/archive/nightly.zip)。注意，不保证开发版有更新更多的功能。而且开发版变动频繁，若无必要请使用发布版主题。\n\n## **常见问题（请务必仔细阅读）**\n\n\u003cdetails\u003e\u003csummary\u003e如何开启文章点赞？\u003c/summary\u003e\u003cbr\u003e\n\n文章点赞功能依赖配套插件，请上传至插件目录并启用。插件一般会随主题包发布，开发版主题请前往 https://github.com/AlanDecode/VOID-Plugin 获取。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e如何开启文章浏览量统计？\u003c/summary\u003e\u003cbr\u003e\n\n文章浏览量统计功能依赖配套插件，请上传至插件目录并启用。插件一般会随主题包发布，开发版主题请前往 https://github.com/AlanDecode/VOID-Plugin 获取。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e如何开启文章字数统计？\u003c/summary\u003e\u003cbr\u003e\n\n文章字数统计功能依赖配套插件，请上传至插件目录并启用。插件一般会随主题包发布，开发版主题请前往 https://github.com/AlanDecode/VOID-Plugin 获取。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e下载安装后样式不对？\u003c/summary\u003e\u003cbr\u003e\n\n仓库中的是未压缩的源代码，包含大量实际使用中不需要的文件，并且可能无法直接使用。请一定通过这两个链接下载主题：[发布版](https://github.com/AlanDecode/Typecho-Theme-VOID/releases) | [开发版](https://github.com/AlanDecode/Typecho-Theme-VOID/archive/nightly.zip)。注意其中发布版是下载 VOID-x.x.x.zip 这个压缩包，而不是 Source code。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e添加归档页面\u003c/summary\u003e\u003cbr\u003e\n\n新建独立页面，自定义模板选择 `Archives`，内容留空。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e添加友情链接\u003c/summary\u003e\u003cbr\u003e\n\n新建独立页面，然后如此书写：\n\n```\n[links]\n[熊猫小A](https://www.imalan.cn)+(https://secure.gravatar.com/avatar/1741a6eef5c824899e347e4afcbaa75d?s=200\u0026r=G\u0026d=)\n[熊猫小A的博客](https://blog.imalan.cn)+(https://secure.gravatar.com/avatar/1741a6eef5c824899e347e4afcbaa75d?s=64\u0026r=G\u0026d=)\n[/links]\n```\n\n文章中、独立页面中都可以通过该语法插入类似的展示块。在某些 Typecho 版本中 HTML 会被转义后输出，请使用 `!!!` 包裹以上代码，例如：\n\n```\n!!!\n[links]\n···\n[/links]\n!!!\n```\n\n`!!!` 需要单独占一行。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e图片排版\u003c/summary\u003e\u003cbr\u003e\n\n在文章中，使用 `[photos][/photos]` 包起来的图片可显示在同一行。例如：\n\n```\n[photos]\n![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0073.jpeg)\n![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0053.jpeg)\n[/photos]\n\n[photos]\n![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0039.jpeg)\n![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0051.jpeg)\n![](https://cdn.imalan.cn/img/post/2018-10-26/IMG_0005.jpeg)\n[/photos]\n```\n\n在某些 Typecho 版本中 HTML 会被转义后输出，请使用 `!!!` 包裹以上代码，例如：\n\n```\n!!!\n[photos]\n···\n[/photos]\n!!!\n```\n\n`!!!` 需要单独占一行。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e增强的 Markdown 语法\u003c/summary\u003e\u003cbr\u003e\n\n* 注音语法：`{{文本:zhu yin}}`，会渲染为：\u003cruby\u003e文本\u003crp\u003e (\u003c/rp\u003e\u003crt\u003ezhu yin\u003c/rt\u003e\u003crp\u003e)\u003c/rp\u003e\u003c/ruby\u003e\n* notice 提示块：`[notice]提示内容[/notice]`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\u003csummary\u003e页面空白\u003c/summary\u003e\u003cbr\u003e\n\n* 首先检查是否有插件重复引入了 JQuery，若有，在插件设置页面关闭。\n* 另外，推荐使用 PHP 7.0 及以上版本搭配 MySQL 数据库。PHP 5.6 或者更低版本以及其它数据库可能出现未知问题（并且我不会去修复）。\n\n\u003c/details\u003e\n\n## 更新\n\n同[开始使用](#开始使用)，区别是你可以直接覆盖主题文件。大多数情况下无需禁用主题，这样你的主题设置就不会丢失。\n\n某些版本由于改用幅度较大需要重启主题与插件，请参见对应版本的发布日志。\n\n## 开发与自定义\n\n**首先注意：我不保证提供任何自定义修改相关的指导与帮助。You are on your own.**\n\n\u003cdetails\u003e\u003csummary\u003e展开详情\u003c/summary\u003e\u003cbr\u003e\n\n如果你有不错的想法，可以定制自己的版本。首先你需要准备好 NodeJS 环境，然后 clone 这个 repo：\n\n```bash\ngit clone https://github.com/AlanDecode/Typecho-Theme-VOID ./VOID \u0026\u0026 cd ./VOID\n```\n\n安装依赖：\n\n```bash\nnpm install -g gulp\nnpm install\n```\n\n用以下命令打包依赖的 JS 和 CSS：\n\n```bash\ngulp dev\n```\n\n主题的样式是用 SCSS 写的，你可以使用自己喜欢的方式编译 SCSS，或者使用：\n\n```bash\ngulp sass\n```\n\n监听 SCSS 更改然后实时编译。尽请添加自己想要的功能，满意后就提交代码。然后：\n\n```bash\ngulp build\n```\n\n构建你的主题，生成的主题位于 `./build` 目录下。如果你对自己的更改很满意，**欢迎提出 Pull Request**。\n\n\u003c/details\u003e\n\n## 更新日志\n\n**🍰 2020-07-04 Version 3.5.1**\n\n*该版本依赖 VOID 插件 1.20 及以上版本，请先禁用原插件，上传新插件后重新启用插件*\n\n* 修复：iframe 尺寸错误（#42）\n* 修复：归档页面显示未发布的文章（#45）\n\n**🍰 2020-05-01 Version 3.5.0**\n\n*该版本依赖 VOID 插件 1.20 及以上版本，请先禁用原插件，上传新插件后重新启用插件*\n\n* 新增：[高级设置]图片懒加载渐变（需要 CDN 支持）\n* 新增：JSON-LD 结构化数据支持\n* 新增：重新设计的 404 页面\n* 新增：[高级设置]站点标题设置自定义字体\n* 优化：Bilibili 播放器自适应\n* 优化：图题不再影响灯箱展开\n* 调整：默认西文字体替换为 OpenSans\n* 调整：简化头图设置\n* 修复：某些情况下懒加载可能不触发的问题\n* 修复：懒加载导致归档页面错乱\n* 修复：Safari 平滑滚动无法打断, thank @Reedo0910\n* 修复：[#32](https://github.com/AlanDecode/Typecho-Theme-VOID/issues/32)\n* 修复：[#34](https://github.com/AlanDecode/Typecho-Theme-VOID/issues/34)\n* 移除：Microdata\n* 其它细节优化\n\n从 2.2 版本起，主题部分功能需要配套插件支持，例如文章点赞、浏览量统计、字数统计等。**请先卸载**原来的 Likes、TePostViews 插件，否则数据会出现错误！TePostViews 插件卸载前请设置为**卸载后保留数据**，以防丢失浏览数据。\n\n更多：[change-log.md](https://github.com/AlanDecode/Typecho-Theme-VOID/blob/master/change-log.md)\n\n## 鸣谢\n\n### 开源项目\n\n[JQuery](https://github.com/jquery/jquery) | [PrismJS](https://prismjs.com/index.html) | [MathJax](https://www.mathjax.org/) | [fancyBox](http://fancyapps.com/fancybox/3/) | [bigfoot.js](http://www.bigfootjs.com/) | [OwO](https://github.com/DIYgod/OwO) | [pjax](https://github.com/defunkt/jquery-pjax) | [yue.css](https://github.com/lepture/yue.css) | [tocbot](https://tscanlin.github.io/tocbot/) | [pangu.js](https://github.com/vinta/pangu.js) | [social](https://github.com/lepture/social) | [Headroom.js](http://wicky.nillia.ms/headroom.js/) | [hypher](https://github.com/bramstein/hypher)\n\n### 其他\n\n[RAW](https://github.com/AlanDecode/Typecho-Theme-RAW) | [Mirages](https://get233.com/archives/mirages-intro.html) | [handsome](https://www.ihewro.com/archives/489/) | [Card](https://blog.shuiba.co/bitcron-theme-card) | [Casper](https://github.com/TryGhost/Casper) | [Typlog](https://typlog.com/) | [FORMA](https://justgoodthemes.com/ghost-themes/forma/)\n\n## 捐助\n\n**如果本项目对你有所帮助，请考虑捐助我**\n\n![谢谢支持](https://wx1.sinaimg.cn/large/0060lm7Tly1g0c4cbi71lj30sc0iv453.jpg)\n\n## License\n\nMIT © [AlanDecode](https://github.com/AlanDecode)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlanDecode%2FTypecho-Theme-VOID","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlanDecode%2FTypecho-Theme-VOID","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlanDecode%2FTypecho-Theme-VOID/lists"}