安裝完主題后,頁面中間部分空白/安裝后首頁報錯,500錯誤
如果因為任何原因導致了「啟用主題」失敗, 后續解決了啟用主題失敗的問題,都需要切換到別的主題再切換回來(切換主題過程會清空原來的配置并且還原默認配置),確保默認的設置可以設置成功 ,因為「啟用主題」失敗的時候,默認的初始化數據都沒有設置成功的,會導致主題使用過程中的一些其它問題,比如評論頭像不顯示等等。
- typecho至少為1.0版本,不支持0.9版本?。?!typecho 1.2版本需要使用 handsome8.3 及其以上版本(typecho1.2版本不要使用開發版本,需要使用正式版本,開發版本會在某些服務器上無法保存設置數據)
- 依次檢查主題文件夾名稱是否為
handsome
(首字母不用大寫),插件文件夾名稱為Handsome
(首字母大寫) - 是否已經安裝并且啟用主題必要的插件Handsome
服務器環境檢查 :
- php版本需要5.6及其以上版本,必須安裝curl、mbstring、openssl、json、zlib擴展 ,否則無法使用(正確檢查方式是在你的服務器新建一個
test.php
,然后復制粘貼該代碼<?php phpinfo(); ?>
,最后在瀏覽器訪問該文件可以查看服務器的php信息,一般自己手動編譯的php庫可能會有這個問題) - windows 服務器 php 版本請使用 5.6 暫不支持 php7 (目前排查問題可能是 xampp 的某個問題導致,暫時無法解決)。
- Linux 服務器可以支持 php7、8(php8 需要最新版本主題和 typecho 倉庫的最新代碼)
- 老薛主機不支持php8,可以使用php7.x 或者php5.6及其以上版本
- php版本需要5.6及其以上版本,必須安裝curl、mbstring、openssl、json、zlib擴展 ,否則無法使用(正確檢查方式是在你的服務器新建一個
- 主題目錄給777權限,包括遞歸子文件夾和子文件,也可以嘗試給644或者755權限。因為有的服務器上傳文件之后,默認給的權限php都沒辦法執行的
- 初次使用主題必須保證博客有一篇文章,如果一篇文章都沒有的話會導致向數據庫中添加view(瀏覽次數字段)失敗
- 如果你的 typecho 版本是好久之前的開發版本,需要升級到最新的 typecho 1.2 版本
- 最后確保自己上傳的文件沒有缺失,比如handsome文件夾下有fucntions.php,Handsome文件夾下有Plugin.php 則是最起碼的
Handsome插件無法啟用,顯示Database Query Error
- 原因是文章太多,在首次啟用插件的時候會構建搜索緩存,緩存大小超過了mysql的默認設置
- 在mysql中的控制執行下面的sql語句:
SET GLOBAL max_allowed_packet=4294967295;
如果你裝了phpmyadmin的mysql控制臺面板,在如下圖的位置執行:
如果執行上面語句成功后,還是無法啟用插件,可以參考這里https://blog.csdn.net/wanbin6470398/article/details/81633922 修改innodb_log_file_size 變量的大小,修改值為2G。如果是寶塔面板,就是如下的設置位置,修改配置保存后,再次重啟mysql服務即可。
打開 handsome 外觀設置/插件設置界面顯示后1s后白屏
- 按照上一條中的「服務器環境檢查」檢查服務器配置是否正常
- 檢查 typecho 目錄下的 index.php 或者 config.inc.php 文件最上面是不是自己修改多了空行,或者多了自己添加的注釋
- 確保functions.php 頭部的
//如果需要顯示php錯誤打開這兩行注釋,問題修復后必須關閉!
這一行注釋下面的兩行是注釋的,上面兩行是沒有注釋的。 - 確認Handsome插件和handsome主題文件夾命名是否正確(Handsome插件文件夾首字母需要大寫,handsome主題文件夾首字母不用大寫),同時確認Handsome插件版本與主題版本一致。
- 檢查typecho 列表中是否錯誤的插件(“此插件文件已經損壞或者被不安全移除,強烈建議你禁用它” 這樣提示的插件需要禁用)
啟動主題后,首頁的樣式不正常(如左側邊欄黑色,很多樣式和我的博客不一致)
- 原因是第一次啟用主題的時候默認的配置沒有初始化成功導致的
- 可以切換到別的主題,再切換回來恢復默認的主題設置即可
啟動主題,主題列表中沒有主題,甚至其他主題都不顯示了
- 主題目錄給777或者755權限包括遞歸子文件夾和子文件 ,Linux是在
usr/themes/
目錄下執行chmod -R 777 ./
必須包含-R
參數,表示遞歸執行。 - 檢查typecho 目錄下的
usr/themes/handsome
目錄下是否是一系列主題文件,而不是另一個嵌套的文件夾 - 確定 php 版本是5.6 ~ 8.0,如果是 Windows 服務器嘗試使用低版本 php,如 php5.6
AppNode 面板啟用主題會出錯
該問題是app node 面板版本的是一個bug,具體見:https://bbs.appnode.com/thread-2621.htm
解決方法:
- 找到正在使用的php版本的 php.ini 文件
- 在該文件中搜索
max_execution_time
,將后面的值 0d 改成0,不需要后面的單位,然后保存。 - 最后重啟一下php服務, 切記后續不要在面板中修改配置??! 否則
max_execution_time
的值又會變成0d了。
友情鏈接欄目點擊/添加友情鏈接顯示404
依次按照下面操作進行檢查:
- 禁用Handsome插件后再啟用一下試試
- 檢查Handsome插件文件夾首字母是否是大寫
- 重新安裝Handsome插件(刪除舊的Handsome文件夾),確保文件上傳沒有遺漏,沒有漏上傳,自己比較一下下載的本地文件和服務器上的文件是不是一致
- 請勿安裝第三方Links插件 ,如果已經安裝了,先禁用Links插件,再刪除Links插件,最后一樣再按照上面的前三條依次操作檢查。