常见问题

安装完主题后，页面中间部分空白/安装后首页报错

  • 依次检查主题文件夹名称是否为：handsome
  • 是否已经安装并且启用主题必要的插件links
  • php版本 5.4+，必须安装 mbstring 扩展，否则无法使用（正确检查方式是在你的服务器新建一个test.php,然后复制粘贴该代码<?php phoinfo();?>,最后在浏览器访问该文件可以查看服务器的php信息）
  • 初次使用主题必须保证博客有一篇文章，如果一篇文章都没有的话会导致向数据库添加 view（浏览次数字段）失败
  • PostgreSql 数据库安装 links 插件时，需要手动新建 typechos_links 表。（会在下一个版本修复）

点击首页头像，显示404页面

  • 需要新建“时光机”独立页面，具体方法见 独立页面

主题内的博客头像怎么设置

  • 主题头像需要设置两处：

    • 主题外观设置——初级设置——头像设置：现在在首页侧边栏中
    • gravatar（全球通用头像），打开后台——控制台——个人设置，点击左侧的头像，去该网站使用你在个人设置里填写的电子邮箱地址注册账号，并上传头像，typecho 的头像会自动更新：会显示在时光机、评论、右上角顶部的头像处。

links插件无法启用，显示500错误

  • 更新主题包中最新版本的 links 插件1.1.2
  • 一般是有鱼你的usr/plugin没有足够的权限导致的。

如果是 Linux 服务器尝试，在 typecho 的 usr 目录下输入此命令：

sudo chmod -R 777 plugin

如果仍有问题，请练习我

友链设置后前台不输出内容(使用无效）

  • links 插件需要填写链接分类来判断输出的位置，请详细阅读友链设置文档

无法评论，提示输入内容不符合规则

请依次检查以下内容：

  • cdn 缓存静态缓存了 HTML 页面，导致评论功能失败（cdn 缓存建议只缓存静态资源文件，如 CSS js image）
  • 使用了服务器缓存功能
  • 使用了数据库缓存功能
  • 使用了页面代码压缩的插件
  • 当你作为游客身份评论时，你的邮箱地址不能和后台已有用户的邮箱地址重复

如有问题，请联系我。

typecho 1.1 版本编辑器无法解析 HTML 代码

  • typecho 1.0 正式版本原生 markdown 解析器非常弱，可以解析 HTML，但是无法解析表格。可以配合以下插件使用 typecho-plugin-Parsedown 或者 typecho-markdown (包含更多markdown语法）

插件安装后请注意文件夹命名要求。安装插件后，无需任何设置，自动替换前台文章解析，支持解析表格和 HTML 代码。

  • typecho 1.1 正式版本原生 markdown 解析器不支持 HTML 代码，必须使用特权模式才可以解析 HTML 代码，示例如下：
!!!
//你的HTML代码
!!!

全局音乐播放器一直在加载，无法显示歌单

  • PHP 必须满足 PHP>=5.4
  • 某些国外服务器无法云解析，请使用手动添加歌曲功能
  • 服务器需要安装 curl 扩展，请勿禁用curl_exec函数，并且 curl 扩展需要支持https
  • 网易云会时常封禁cookie，导致解析失败，请打开主题目录下面的libs/Get.php根据注释要求修改$netease_cookie变量。（一般有问题的话，我会在群内通知的）或者换用QQ音乐或者其他平台
  • QQ音乐歌单请勿设置为私密歌单，否则无法解析

如果仍有问题，请联系我。

全局音乐播放器显示「当前音乐地址无效」

  • 说明你的 ip 无法解析当前音乐的资源地址，是一种友好的正常的提示（就类似于音乐软件提示「“该资源无版权换首歌听吧”一样」
  • 原因可能是该歌曲是付费歌曲，或者你的 ip 被当前音乐平台封锁（此种情况下任何歌曲都无法解析出资源地址）
  • 解决办法：换另一个平台、换歌单试试

主题出现了问题，样式错误？无法点击？

  • 配置出现了问题，切换到别的主题，然后再切换回来，这一过程会清空之前的所有配置，请提前备份。
  • 修改了源代码导致了问题。删除以前的旧主题文件，然后上传新的主题文件夹
  • qq上给我留言

主题前台、后台均不显示样式，样式彻底乱掉

  • 主题外观设置——速度优化——选择公共CDN库，选择本地或者别的CDN库

评论区不能斗图不能显示图片|说说不能显示图片/音乐播放器/视频播放器

  • 后台设置——评论——允许使用的 HTML 标签和属性里面添加 markdown 语法对应的 html 标签
<img src="">
<audio class="" src="" preload>
<video src=""></video>

评论区无法使用 markdown 语法

  • 后台设置——评论——在评论中使用 Markdown 语法（选中) 后台 设置——评论——允许使用 HTML 标签和属性` 里面添加 markdown 语法的 html 标签
<blockquote><pre><code><strong><em><h5><h6><a href title><table><thead><tr><th><tbody><td>

使用 EditorMD 前台文章首次不加载，刷新一次才能加载

  • 主题 pjax 与 EditorMD 的前台解析js有冲突，在该插件的设置界面，将接管前台 Markdown 解析并启用 ToC、TeX 科学公式、流程图 Flowchart、时序图 Sequence Diagram 等扩展选择否即可。

启用插件总是显示500错误

有些插件必须修改插件的文件夹为指定的名称才能正常使用，一般插件的说明都会有提到修改插件的文件夹名称，请留意。

Aplayer 无法正常使用

主题内置支持云解析的文章播放器，详见文章内插入音乐
如果你仍然喜欢 Aplayer 插件，你可以使用MoePlayer作者开发的APlayer-Typecho版本的插件，主题已经默认兼容该款插件。

文章首页分页数目怎么修改？我想修改每页显示 6 篇文章？

  • typecho bug，详见issue#705
  • 打开 typecho 目录下面的var/Widget/Archive.php文件
    *搜索$keywords = $this->request->filter('url', 'search')->keywords;替换成$keywords = $this->request->keywords;

Dplayer-Typecho不能显示弹幕

密码文章/登录界面输入正确密码显示密码错误/登录失败

  • 主题使用 ajax 请求，通过提交密码后的页面是否有「相应的内容」（登录成功后有登录信息，密码文章输入正确后后文章内容）来判断是否提交成功。如果你使用全站静态缓存全站页面，即使你提交正确密码，页面内容是不会变得（因为被缓存了），所以显示提示失败。
  • 动态 PHP 博客不应该缓存.php、.html后缀文件，只需要缓存.js、.css 和图片类型的文件即可。
  • 怎么取消缓存？ 问相应的 CDN 运营商，发工单都会得到满意回复。提问的内容跟是「如何取消全站缓存，只缓存静态资源文件?」
Last modification：July 8th, 2020 at 12:30 am
© 允许规范转载
If you think my article is useful to you, please feel free to appreciate