WordPress高亮代碼插件Pure Highlightjs後台設定幫助文檔

Pure Highlightjs插件介紹

WordPress原生pre代碼高亮插件Pure Highlightjs重大更新：升級至Highlight.js v11.11.1版本

後台設定

主題選擇

日間主題：揀代碼塊嘅風格樣式，揀完之後保存，預覽。冇做精簡，可以揀幾十種樣式。
夜間主題：需要主題支援根html元素加dark切換夜間模式嘅方式先會生效，否則只能用日間主題。

滾動條顏色

要根據揀嘅主題樣式設定滾動條樣式，滾動條用嘅係simplebar，兼容所有主流瀏覽器，可以應用到全站需要滾動條嘅地方，可惜唔支援頁面body同html屏幕邊上嘅滾動條樣式。

注意：插件後台設定嘅滾動條顏色只會對代碼塊嘅滾動條生效。

如果網站其他地方需要用simplebar時，打開以下插件目錄檔案：

//位置 plugins/Pure-Highlightjs/assets/pure-highlight.js
// 根据类名添加simplebar滚动条样式
document
  .querySelectorAll(
    'pre, .a, .b, .c，.com-scrollbar'
  )
  .forEach((el) => {
    el.setAttribute('data-simplebar', '');
  });

以上代碼好似.a，.b，.c，.com-scrollbar咁樣將div或者其他元素嘅類名加喺呢度，就會應用到simplebar滾動條，例如：

<!-- 滚动条类最好是添加在这个div -->
<div class="com-scrollbar flex flex-col gap-4">
  <!-- 不建议在这个div添加滚动条类 -->
  <div class="content">
    <span>內容</span>
    <span>內容</span>
    <span>內容</span>
    <span>內容</span>
  </div>
</div>

工具欄顏色設定

因為插件每個主題風格樣式都唔同，所以加咗工具樣式顏色設定，如果將顏色直接固定喺程式碼入面，對某啲主題樣式會唔協調，後台可以根據揀嘅樣式嚟設定工具列顏色。

工具列顯示模式

始終顯示：工具列會一直顯示，唔會消失。
鼠標懸停顯示：當鼠標放喺程式碼區塊嗰陣，工具列先會顯示，流動裝置係點擊一下程式碼區塊先會顯示。

工具列浮動

工具列會一直跟住滑動，始終會顯示喺視窗區域內，頁面向下滑時跟住下滑，向上滑時跟住上滑，當視窗口超過代碼區塊時，就會返返去原本位置。

代碼區塊高度

當文章入面有好多代碼區塊，而每個代碼區塊嘅代碼行數又好多時，建議設定代碼區塊最大高度（max-height），經典編輯器係輸入代碼嘅時候填高度，區塊編輯器就用類名方式。

經典編輯器代碼塊高度設定

如圖，經典編輯器點擊代碼按鈕插入代碼時，默認係380最大高度，可以改做其他數字，插入代碼時最後會默認加一個空行，該代碼塊冇其他代碼時建議刪除（?當初小編以為係代碼問題，點解最後會多咗20px空位，搵咗半日原來係插入代碼時加嘅空行，喊?‍♀️），下面係經典編輯器示範，最大高度係300px：

<?php
/**
 * PHP长行代码演示示例
 * 用于测试滚动条效果
 */
 
// 基本变量定义
$testString = "这是一个普通的字符串变量，用于演示PHP的基本语法特性";
$numberValue = 123456;
$arrayData = [
    'name' => '测试数据',
    'type' => '演示',
    'values' => [10, 20, 30, 40, 50]
];
 
// 这是一行很长的代码，包含了多个函数调用和字符串拼接，目的是测试滚动条效果。这里我们模拟一个复杂的数据处理过程，包含字符串操作、数组处理和数学计算等多种操作的组合。这段代码会将多个不同类型的数据进行转换和组合，生成一个复杂的结果字符串。
$longLine1 = "处理结果: " . strtoupper(trim(json_encode(array_merge($arrayData, ['timestamp' => time(), 'random' => rand(1000, 9999), 'status' => 'completed', 'message' => '这是一条很长的消息，用于增加字符串长度，测试滚动效果。这里继续添加一些内容，让这行代码变得足够长，以便在显示时需要滚动条才能完全查看。']), " \t\n\r\0\x0B"))) . " | 计算结果: " . (sqrt(pow($numberValue, 2) + pow($numberValue / 2, 2)) * 1.5) . " | 状态信息: 操作已完成，耗时 " . microtime(true) . " 毫秒，内存使用: " . memory_get_usage() . " 字节";
 
// 另一个长行代码，演示条件判断和函数嵌套的复杂情况
if (strlen($testString) > 10 && is_array($arrayData) && count($arrayData['values']) > 3 && $numberValue > 100000 && strpos($testString, 'PHP') !== false && (time() % 2 == 0)) {
    $longLine2 = "满足所有条件 | 数组信息: " . print_r($arrayData, true) . " | 字符串长度: " . strlen($testString) . " | 随机数: " . rand(1, 1000) . " | 当前时间: " . date('Y-m-d H:i:s') . " | 这是为了测试滚动条而添加的额外内容，继续增加长度直到足够长，确保在大多数编辑器或显示窗口中都需要滚动才能看到完整内容。这里再添加一些文字，让这行代码变得更长一些，以达到测试目的。";
} else {
    $longLine2 = "不满足所有条件的默认值";
}
 
// 函数定义
function processData($input) {
    if (!is_array($input)) {
        return "无效输入: 必须提供数组类型";
    }
    
    // 处理数据的逻辑
    $result = [];
    foreach ($input as $key => $value) {
        $result[strtoupper($key)] = is_string($value) ? strrev($value) : $value;
    }
    
    return $result;
}
 
// 类定义
class DemoClass {
    private $property1;
    protected $property2;
    public $property3;
    
    public function __construct($param1, $param2) {
        $this->property1 = $param1;
        $this->property2 = $param2;
        $this->property3 = "默认值: " . $param1 . " - " . $param2;
    }
    
    public function getCombined() {
        return $this->property1 . "|" . $this->property2 . "|" . $this->property3;
    }
}
 
// 执行演示
echo "PHP长行代码测试演示\n";
echo "=====================\n";
echo "1. 长行字符串1: " . $longLine1 . "\n\n";
echo "2. 长行字符串2: " . $longLine2 . "\n\n";
echo "3. 处理后的数据: " . print_r(processData($arrayData), true) . "\n\n";
 
$demoObj = new DemoClass("参数1", "参数2");
echo "4. 对象信息: " . $demoObj->getCombined() . "\n";
?>

經典編輯器代碼區有高度嗰陣，工具列會顯示展開摺疊掣。

經典編輯器代碼冇高度嗰陣

<?php
// 简单的PHP类示例
class Greeting {
    private $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
    
    public function sayHello() {
        return "Hello, " . $this->name . "!";
    }
}
 
$greeter = new Greeting("World");
echo $greeter->sayHello();
?>

經典編輯器冇高度嗰陣唔會顯示展開摺疊掣。

區塊編輯器代碼塊高度設定

而家就有呢幾個高度類名：

h-200 {
  max-height: 200px; /*最大高度为200px*/
}
h-300 {
  max-height: 300px; /*最大高度为300px*/
}
h-380 {
  max-height: 380px; /*最大高度为380px*/
}
h-500 {
  max-height: 500px; /*最大高度为500px*/
}

區塊編輯器冇好似經典編輯器咁可以手動輸入高度，係用固定類嘅方式，?可能係小編啱啱接觸區塊編輯器嘅原因啦，之後睇吓可唔可以喺代碼區塊工具欄加返個手動輸入高度嘅功能，示範如下：

<?php
/**
 * PHP长行代码演示示例
 * 用于测试滚动条效果
 */
 
// 基本变量定义
$testString = "这是一个普通的字符串变量，用于演示PHP的基本语法特性";
$numberValue = 123456;
$arrayData = [
    'name' => '测试数据',
    'type' => '演示',
    'values' => [10, 20, 30, 40, 50]
];
 
// 这是一行很长的代码，包含了多个函数调用和字符串拼接，目的是测试滚动条效果。这里我们模拟一个复杂的数据处理过程，包含字符串操作、数组处理和数学计算等多种操作的组合。这段代码会将多个不同类型的数据进行转换和组合，生成一个复杂的结果字符串。
$longLine1 = "处理结果: " . strtoupper(trim(json_encode(array_merge($arrayData, ['timestamp' => time(), 'random' => rand(1000, 9999), 'status' => 'completed', 'message' => '这是一条很长的消息，用于增加字符串长度，测试滚动效果。这里继续添加一些内容，让这行代码变得足够长，以便在显示时需要滚动条才能完全查看。']), " \t\n\r\0\x0B"))) . " | 计算结果: " . (sqrt(pow($numberValue, 2) + pow($numberValue / 2, 2)) * 1.5) . " | 状态信息: 操作已完成，耗时 " . microtime(true) . " 毫秒，内存使用: " . memory_get_usage() . " 字节";
 
// 另一个长行代码，演示条件判断和函数嵌套的复杂情况
if (strlen($testString) > 10 && is_array($arrayData) && count($arrayData['values']) > 3 && $numberValue > 100000 && strpos($testString, 'PHP') !== false && (time() % 2 == 0)) {
    $longLine2 = "满足所有条件 | 数组信息: " . print_r($arrayData, true) . " | 字符串长度: " . strlen($testString) . " | 随机数: " . rand(1, 1000) . " | 当前时间: " . date('Y-m-d H:i:s') . " | 这是为了测试滚动条而添加的额外内容，继续增加长度直到足够长，确保在大多数编辑器或显示窗口中都需要滚动才能看到完整内容。这里再添加一些文字，让这行代码变得更长一些，以达到测试目的。";
} else {
    $longLine2 = "不满足所有条件的默认值";
}
 
// 函数定义
function processData($input) {
    if (!is_array($input)) {
        return "无效输入: 必须提供数组类型";
    }
    
    // 处理数据的逻辑
    $result = [];
    foreach ($input as $key => $value) {
        $result[strtoupper($key)] = is_string($value) ? strrev($value) : $value;
    }
    
    return $result;
}
 
// 类定义
class DemoClass {
    private $property1;
    protected $property2;
    public $property3;
    
    public function __construct($param1, $param2) {
        $this->property1 = $param1;
        $this->property2 = $param2;
        $this->property3 = "默认值: " . $param1 . " - " . $param2;
    }
    
    public function getCombined() {
        return $this->property1 . "|" . $this->property2 . "|" . $this->property3;
    }
}
 
// 执行演示
echo "PHP长行代码测试演示\n";
echo "=====================\n";
echo "1. 长行字符串1: " . $longLine1 . "\n\n";
echo "2. 长行字符串2: " . $longLine2 . "\n\n";
echo "3. 处理后的数据: " . print_r(processData($arrayData), true) . "\n\n";
 
$demoObj = new DemoClass("参数1", "参数2");
echo "4. 对象信息: " . $demoObj->getCombined() . "\n";
?>

有高度嗰陣，工具欄會顯示展開同摺埋嘅掣。

區塊編輯器代碼冇高度嗰陣

如果唔需要高度或者代码好少嘅情况下，就唔使再设置高度类名，冇高度嗰阵，工具栏唔会显示展开同折叠按钮，示範如下

<?php
// 简单的PHP类示例
class Greeting {
    private $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
    
    public function sayHello() {
        return "Hello, " . $this->name . "!";
    }
}
 
$greeter = new Greeting("World");
echo $greeter->sayHello();
?>

之后会更新需求更新插件，如果插件有咩问题请加QQ群1398231反映！