Giter VIP home page Giter VIP logo

typecho-theme-void's Introduction

[2023.04.07] 如果大家配合 Typecho 1.2 版本使用 VOID 时遇到问题,请到 GitHub 集中留言反馈:#87


Typecho Theme VOID 3.5.1

✏ 一款简洁优雅的 Typecho 主题

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

Build downloads

特性

介绍文章:VOID:现在可以公开的情报

  • 响应式设计
  • PJAX 无刷新体验
  • AJAX 评论
  • 前台无跳转登陆(兼容 PJAX)
  • 自动夜间模式
  • 优秀的可读性
  • 衬线、非衬线两种文字风格
  • 代码高亮(浅色暗色两种风格,随主题切换)
  • Mac 风格代码块(可开启或关闭)
  • 代码行号
  • 站点样式设置面板(日夜转换、字体、字号)
  • MathJax 公式
  • 表情解析(文章、评论可用)
  • 图片排版(可用作相册)
  • 图片懒加载
  • 灵活的头图设置
  • 文章目录解析
  • 完整的结构化数据支持
  • 够用的后台设置与丰富的高级设置

结合附带的配套专用插件,还有更多功能:

  • 浏览量统计
  • 文章点赞
  • 文章字数统计
  • 评论投票与自动折叠
  • 访客互动展示

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

开始使用

  1. 下载主题:发布版,注意是下载 VOID-x.x.x.zip 这个压缩包,而不是 Source code
  2. 解压
  3. 主题文件夹下的 VOID 文件夹上传至站点 /usr/themes 目录下
  4. 后台启用主题
  5. 配套插件文件夹下的 VOID 文件夹上传至站点 /usr/plugins 目录下
  6. 后台启用插件
  • 可选:将主题 assets 文件夹下的 VOIDCacheRule.js 复制一份到站点根目录,并在主题设置中启用 Service Worker 缓存。
  • 可选:主题文件夹下 advanceSetting.sample.json 中有一些高级设置,可以看看。

开发版主题可以在这里获取:开发版。注意,不保证开发版有更新更多的功能。而且开发版变动频繁,若无必要请使用发布版主题。

常见问题(请务必仔细阅读)

如何开启文章点赞?

文章点赞功能依赖配套插件,请上传至插件目录并启用。插件一般会随主题包发布,开发版主题请前往 https://github.com/AlanDecode/VOID-Plugin 获取。

如何开启文章浏览量统计?

文章浏览量统计功能依赖配套插件,请上传至插件目录并启用。插件一般会随主题包发布,开发版主题请前往 https://github.com/AlanDecode/VOID-Plugin 获取。

如何开启文章字数统计?

文章字数统计功能依赖配套插件,请上传至插件目录并启用。插件一般会随主题包发布,开发版主题请前往 https://github.com/AlanDecode/VOID-Plugin 获取。

下载安装后样式不对?

仓库中的是未压缩的源代码,包含大量实际使用中不需要的文件,并且可能无法直接使用。请一定通过这两个链接下载主题:发布版 | 开发版。注意其中发布版是下载 VOID-x.x.x.zip 这个压缩包,而不是 Source code。

添加归档页面

新建独立页面,自定义模板选择 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]

在某些 Typecho 版本中 HTML 会被转义后输出,请使用 !!! 包裹以上代码,例如:

!!!
[photos]
···
[/photos]
!!!

!!! 需要单独占一行。

增强的 Markdown 语法
  • 注音语法:{{文本:zhu yin}},会渲染为:文本 (zhu yin)
  • notice 提示块:[notice]提示内容[/notice]
页面空白
  • 首先检查是否有插件重复引入了 JQuery,若有,在插件设置页面关闭。
  • 另外,推荐使用 PHP 7.0 及以上版本搭配 MySQL 数据库。PHP 5.6 或者更低版本以及其它数据库可能出现未知问题(并且我不会去修复)。

更新

开始使用,区别是你可以直接覆盖主题文件。大多数情况下无需禁用主题,这样你的主题设置就不会丢失。

某些版本由于改用幅度较大需要重启主题与插件,请参见对应版本的发布日志。

开发与自定义

首先注意:我不保证提供任何自定义修改相关的指导与帮助。You are on your own.

展开详情

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

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

安装依赖:

npm install -g gulp
npm install

用以下命令打包依赖的 JS 和 CSS:

gulp dev

主题的样式是用 SCSS 写的,你可以使用自己喜欢的方式编译 SCSS,或者使用:

gulp sass

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

gulp build

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

更新日志

🍰 2020-07-04 Version 3.5.1

该版本依赖 VOID 插件 1.20 及以上版本,请先禁用原插件,上传新插件后重新启用插件

  • 修复:iframe 尺寸错误(#42)
  • 修复:归档页面显示未发布的文章(#45)

🍰 2020-05-01 Version 3.5.0

该版本依赖 VOID 插件 1.20 及以上版本,请先禁用原插件,上传新插件后重新启用插件

  • 新增:[高级设置]图片懒加载渐变(需要 CDN 支持)
  • 新增:JSON-LD 结构化数据支持
  • 新增:重新设计的 404 页面
  • 新增:[高级设置]站点标题设置自定义字体
  • 优化:Bilibili 播放器自适应
  • 优化:图题不再影响灯箱展开
  • 调整:默认西文字体替换为 OpenSans
  • 调整:简化头图设置
  • 修复:某些情况下懒加载可能不触发的问题
  • 修复:懒加载导致归档页面错乱
  • 修复:Safari 平滑滚动无法打断, thank @Reedo0910
  • 修复:#32
  • 修复:#34
  • 移除:Microdata
  • 其它细节优化

从 2.2 版本起,主题部分功能需要配套插件支持,例如文章点赞、浏览量统计、字数统计等。请先卸载原来的 Likes、TePostViews 插件,否则数据会出现错误!TePostViews 插件卸载前请设置为卸载后保留数据,以防丢失浏览数据。

更多:change-log.md

鸣谢

开源项目

JQuery | PrismJS | MathJax | fancyBox | bigfoot.js | OwO | pjax | yue.css | tocbot | pangu.js | social | Headroom.js | hypher

其他

RAW | Mirages | handsome | Card | Casper | Typlog | FORMA

捐助

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

谢谢支持

License

MIT © AlanDecode

typecho-theme-void's People

Contributors

alandecode avatar kaygb avatar mikusaa avatar reedo0910 avatar thefunny avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

typecho-theme-void's Issues

关于蛆音娘表情无法生效。

实际行为描述
从3.4覆盖安装升级致3.5后,新增加的蛆音娘表情,在评论中不生效,输出仍是字串符( 在评论中依然是:&(蛆音娘_偷看) )

应有的行为

应该输出表情呀

复现步骤

配置与环境

  • 出错页面链接:例如www.okace.cn中
  • PHP 版本:7.3
  • MySQL 版本:5.6.46
  • Typecho 版本:1.1
  • 主题版本:3.5
  • 插件版本:1.2

截图(若有)

补充信息

时间轴页面会显示未发布的文章

实际行为描述
如果设置一个定时发布的文章,在文章真正发布之前就可以在时间轴页面中找到,但是因为文章其实还没有发布,所以点进去是404

应有的行为
应该只显示已发布并且不是隐藏的文章

复现步骤

  1. 创建一个定时发布的文章
  2. 看时间轴页面

配置与环境

截图(若有)

补充信息

父评论者为博主时,子评论都有小闪电。

实际行为描述
父评论为博主时,子评论将全员都有小闪电。

应有的行为
非博主不应该显示小闪电图标

复现步骤
父评论为博主时可复现

配置与环境

  • 出错页面链接:(本地测试)
  • PHP 版本:7.3.0
  • MySQL 版本:5.7
  • Typecho 版本:1.1 (17.10.30)
  • 主题版本:3.4.0
  • 插件版本:1.2

截图(若有)

补充信息

关于Markdown渲染脚本

问题描述
能否在主题中添加markdown渲染所需的js,支持甘特图,流程图,时序图等等,markdown preview enhanced中支持的那些都可以的。这样的话,可以让typecho 如虎添翼;;

配置与环境
任意

  • 出错页面链接:
  • PHP 版本:
  • MySQL 版本:
  • Typecho 版本:
  • 主题版本:
    最新release
  • 插件版本:
    最新release

截图(若有)


补充信息

评论已有数量 Pjax 问题

实际行为描述

不开启评论审核,开启 Pjax 后,提交新的评论,评论成功后上方评论已有数量不变

应有的行为

评论已有数量应该随之刷新

复现步骤

  1. 开启 Pjax ,新建 InPrivate 窗口打开页面
  2. 页面提交一个评论,评论数量不变

配置与环境

截图

出错
添加 #pjax-container

补充信息

/includes/comments.php 79 行 <div> 添加 id 可修复此错误

<div class="comment-tab-current" id="pjax-container">
</div>

刚装的主题 底部 感谢陪伴 显示时间不正确

刚装的主题 底部的感谢陪伴显示时间位18348 天 21 小时 18 分 0 秒
不知道这个是读取的哪里的时间?

docker内nginx下装的Typecho
MySQL 也是docker装的5.6版本

主题版本:版本: 3.4.0
插件版本:1.2

超高级设置填入参数后不起作用

问题描述
超高级设置填入参数后不起作用

配置与环境

  • 出错页面链接:
  • PHP 版本:7.4
  • MySQL 版本:5.5.62
  • Typecho 版本:1.2
  • 主题版本:3.5.1
  • 插件版本:1.2

截图(若有)

补充信息

代码无法高亮,关闭Mac代码风格和开启Mac代码风格均无法高亮

问题描述:

默认代码无法高亮,关闭Mac代码风格后仍然无法高亮
我发现貌似是pre类名貌似没有添加上
我试着手动加上类名,但是并没有效果,应该是没有这个样式文件吧

这是博主你的代码块:
image.png

这是我的代码块:
image.png

我检查过我的markdown语法,在typora上面是完全没有问题的,由于我没学过php,也不知道你用的是什么插件,所以无法自行解决,希望博主能给个解决方案,感激不尽

代码块显示不全问题

在Android手机的微信、chrome浏览器上超过59(也可能是61)行代码会被蒙上,图为微信和chrome浏览器,在火狐浏览器正常显示。
Screenshot_2019-07-25-21-00-59-485_com tencent mm
Screenshot_2019-07-25-21-01-29-655_com chrome bet

您好,我想修改下代码高亮部分应该改哪个文件啊

代码高亮支持的语言有限,不太适合我。想自定义一下。看了下项目好像是用 hightlight.js.实现的,但是找了文件里并没有这个 JS 文件。不知道该如何改起,诸位可以指点一下吗?
顺便,强力安利一波 Prism.js 可以自定义支持的语言,插件(代码复制,行号,高亮之类的)。二次开发超级方便。希望作者大大能爱上它。

Typecho 1.1 报 Warning

使用 Helper::widgetById('contents', $cid); 方法时警告参数缺失:

Warning: Missing argument 1 for Widget_Abstract::__construct(), called in ...

启用1.1版本插件时报错

升级3.3版本时安装插件出错,原版1.01插件已经彻底删除
随主题发布的插件和开发版插件全都试过,同样报错
数据库用的是sqlite
SQLSTATE[HY000]: General error: 1 near "SHOW": syntax error

3.4.0 评论出现 call to a member function delete() on null

(扩展和主题均为26号版本)
输入评论提交后会出现以上错误
image
但是后台正常收到评论,这个报错就像没报错一样。

 mysql -V
mysql  Ver 14.14 Distrib 5.5.62, for Linux (x86_64) using readline 5.1
PHP 7.3.10 (cli) (built: Sep 30 2019 16:24:09) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.10, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.3.10, Copyright (c) 1999-2018, by Zend Technologies
由 Typecho 强力驱动, 版本 1.2 (18.1.29)

PJAX&&Aplayer出现冲突

实际行为描述
当开启PJAX功能的时候,同时开启 APlayer插件的时候,发现当打开包含音乐的页面时,音乐控件不显示,只有再次刷新页面才会出现控件。

应有的行为
两个功能互不干扰

复现步骤
开启PJAX功能,然后再文章中插入歌曲,访问文章,音乐控件不显示,再次刷新才会出现控件

配置与环境

  • 出错页面链接:
  • PHP 版本:php7.3.8
  • MySQL 版本:mysql5.7.27
  • Typecho 版本:1.2 (18.10.23)
  • 主题版本:3.4.0
  • 插件版本:1.2

截图(若有)
image
插件
image

关于修改内容页banner不生效的问题

你好,再请教一个问题,因为我这边引用了第三方的评论系统,所以内容页面banner里面的评论统计需要改一下,但是我这边不知道什么情况,无论怎么改动都不起作用,准确的说是banner里面的任何内容(例如author、time、comments等)我修改之后都没有任何反应。

但是我把我自己的评论统计代码加到 postCheck 段里是可以正常工作的,唯独就是banner里不生效,还请指点。

选中文字背景颜色 与 日间/夜间模式

目前选中文字的样式是 文字白色,背景黄色高亮

::selection {
    color: #fff;
    background-color: #ffe150;
}

在夜间模式下选中文字的可见度尚可,但日间模式下选中文字看不清,难以阅读

希望能提高两种模式下选中文字的可读性,分离日间和夜间模式的选中文字样式,如日间使用深灰高亮
或加入advance settings让用户自定义两种模式的高亮色

用新版本主题覆盖后出错,typecho主题选择界面加载不出所有主题

问题描述
下载3.4.0和3.3.0版本主题并覆盖3.0.0版本主题后,博客网页空白,在admin界面,进行主题选择的时候所有界面均显示不出来,删去VOID主题文件夹后即可正常加载其他主题选项并启用,且重新移入3.0.0版本VOID主题后可正常使用。

配置与环境

  • PHP 版本:php-5.4
  • MySQL 版本:mysql 5.5
  • Typecho 版本:1.1
  • 主题版本:3.4.0, 3.3.0
  • 插件版本:1.2

截图(若有)
屏幕快照2
屏幕快照1

补充信息
将版本更换回3.0.0版本后,启用后报错显示:
Duplicate entry 'theme:VOID-0' for key 'PRIMARY'exception 'Typecho_Db_Query_Exception' with message 'Duplicate entry 'theme:VOID-0' for key 'PRIMARY'' in /www/wwwroot/lostking.cn/var/Typecho/Db/Adapter/Mysql.php:88
Stack trace:
#0 /www/wwwroot/lostking.cn/var/Typecho/Db.php(354): Typecho_Db_Adapter_Mysql->query('INSERT INTO typ...', Resource id #27, 2, 'INSERT')
#1 /www/wwwroot/lostking.cn/var/Widget/Abstract/Options.php(56): Typecho_Db->query(Object(Typecho_Db_Query))
#2 /www/wwwroot/lostking.cn/var/Widget/Themes/Edit.php(61): Widget_Abstract_Options->insert(Array)
#3 /www/wwwroot/lostking.cn/var/Widget/Themes/Edit.php(173): Widget_Themes_Edit->changeTheme('VOID')
#4 /www/wwwroot/lostking.cn/var/Widget/Do.php(82): Widget_Themes_Edit->action()
#5 /www/wwwroot/lostking.cn/var/Typecho/Widget.php(221): Widget_Do->execute()
#6 /www/wwwroot/lostking.cn/var/Typecho/Router.php(135): Typecho_Widget::widget('Widget_Do', NULL, Array)
#7 /www/wwwroot/lostking.cn/index.php(23): Typecho_Router::dispatch()
#8 {main}

刷新后便未出现问题

3.4.0版本新发文章无法自动添加图片信息

新发布文章不会自动添加信息,getimginfo 处理失败,cleanimginfo 可以清除信息。是不是对数据库权限有些要求,我是虚拟主机。
另外,图集排版自动适应宽度也不行。您的示例是这样:
我的是这样:
我的博客相册链接:https://luhe.xyz/photos.html
查看 F12 也没能理解问题出在哪里。

似乎文章封面图片加载不出来

实际行为描述

应有的行为

复现步骤

配置与环境

  • 出错页面链接:
  • PHP 版本:
  • MySQL 版本:
  • Typecho 版本:
  • 主题版本:
  • 插件版本:

截图(若有)

补充信息

3.5.0更新后iframe显示异常

实际行为描述
在更新到3.5.0之后,使用网易云音乐的外链播放器出现异常,iframe外还有一个很大的框(3.4.0的时候是正常的)
image

诸位有遇到过友链乱码的问题吗?

我是这么做的。

1,新建独立页面。

image

2,在独立页面,直接复制粘贴示例代码。

image

3,发布以后就变成这样子了。

image

求教大概可能是哪方面的问题,用的是最新的开发版。

怎么让首页背景图铺满整个监视器

问题描述
您好,我想知道怎么使首页背景图铺满整个屏幕,类似于https://9bie.org/ 这样的样式?我实在不知道怎么更改,烦请您帮忙解答

配置与环境

  • 出错页面链接:index.php
  • PHP 版本:7.0
  • MySQL 版本:5.6
  • Typecho 版本:1.1
  • 主题版本:最新
  • 插件版本:最新

截图(若有)
批注 2020-07-28 100418

批注 2020-07-28 100601

补充信息

清空缓存刷新后页面跳动

实际行为描述

清空缓存后打开一个有图片的页面,页面出现跳动。

应有的行为

应该恢复原滚动位置,不应该跳动。

复现步骤

清空缓存后打开一个有图片的页面。

配置与环境

  • 出错页面链接:
  • PHP 版本:
  • MySQL 版本:
  • Typecho 版本:
  • 主题版本:nightly
  • 插件版本:

截图(若有)

补充信息

目录树的一些显示问题

  • 小bug: 页面拉到底部时, 较长的目录树会覆盖footer

  • bug: 目录树上方有多个欢迎的div盖住, 导致一些标签不可点击
    image

  • idea: 希望对目录树增加一些样式. 如 鼠标经过突出显示, 标题加粗或可折叠等

感谢大佬提供并开源漂亮的主题~

改变代码块样式

您好,我注意到 latest release 已经把代码高亮换成了 Prism.js,能知道下如何替换成自己想要的风格吗?谢谢努力。

主题相关

作者你好,我想请问网站的logo如何添加?同时作者可以增加登陆界面吗?

主题部署失败,求助~!

问题描述
部署主题失败:更改主题页面、博客对外页面500错误

配置与环境

  • 出错页面链接:
  • PHP 版本:PHP 7.2.31 (cli) (built: May 31 2020 16:18:31) ( NTS )
  • MySQL 版本:5.6.47 MySQL Community Server (GPL)
  • Typecho 版本:1.1 (17.10.30)
  • 主题版本:3.2.0~3.5.1
  • 插件版本:1.2

截图(若有)
图片
图片

补充信息

我按照教程将PHP升级到最新版本,禁用了所有的插件,确保没有其他插件同时加载了JQuery。此时我应用VOID主题得到了这个错误。我尝试了3.2.0~3.5.1版本都得到这个错误。

safari 浏览网页时出现莫名字符

实际行为描述
电脑 chrome 浏览时正常, safari 浏览时出现莫名字符(iphone 和 mac都可复现)

应有的行为
内容应显示一致

复现步骤

  1. Chrome 打开 https://lushan.me/archives/33/

image

此内容显示正常

  1. safari 打开 https://lushan.me/archives/33/
    image

image

出现莫名字符

配置与环境

  • 出错页面链接:https://lushan.me/archives/33/
  • PHP 版本: php 7.2
  • MySQL 版本: 5.7.27-0 ubuntu0.18.04.1 (Ubuntu)
  • Typecho 版本:1.1 (17.10.30)
  • 主题版本: 3.4.0
  • 插件版本:1.2

截图(若有)

补充信息

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.