从门/高亮.js

一个简单的基于 Highlight.js 的 WordPress 语法高亮插件。

安装量: 2,043

依赖: 0

推荐者: 0

安全: 0

星标: 3

关注者: 2

分支: 0

开放问题: 0

语言:JavaScript

类型:WordPress 插件

v2.1.0 2023-03-16 12:37 UTC

This package is auto-updated.

Last update: 2024-09-16 15:50:52 UTC


README

Version Status Downloads License

一个简单的基于 Highlight.js 的 WordPress 语法高亮插件。

安装

使用 Composer 安装

composer require tfrommen/highlightjs

或者

  1. 下载 ZIP 文件.
  2. 将内容上传到您的 web 服务器上的 /wp-content/plugins/ 目录。
  3. 通过 WordPress 的 插件 菜单激活该插件。
  4. 查看所有用 <pre><code> 标签包裹的代码片段的语法高亮(例如,一个 core/code 块)。

要求

此插件 需要 PHP 7.4 或更高版本。

使用方法

请参阅 Highlight.js 文档

过滤器

为了自定义插件的某些方面,它提供了一些过滤器。以下为每个过滤器的简短说明以及如何修改默认行为的代码示例。只需将相应的代码片段放入您的主题的 functions.php 文件或 自定义 插件,或放置在其他适当的位置。

\tfrommen\HighlightJs\FILTER_SHOULD_LOAD (highlightjs.should_load)

此过滤器允许您自定义插件加载的条件。默认值是 is_singular( 'post' ) && has_block( 'code' ) 的结果,意味着插件仅对包含至少一个 core/code 块的单个帖子进行加载。

如果您想为所有包含任何块的单个帖子加载插件

<?php
/**
 * Filters the condition for the plugin to load.
 *
 * @param bool $should_load Whether or not the plugin should load.
 */
add_filter( \tfrommen\HighlightJs\FILTER_SHOULD_LOAD, function () {

	return is_singlular( 'post' );
} );

如果您想为所有请求加载插件,可以使用 __return_true WordPress 函数

<?php
/**
 * Filters the condition for the plugin to load.
 *
 * @param bool $should_load Whether or not the plugin should load.
 */
add_filter( \tfrommen\HighlightJs\FILTER_SHOULD_LOAD, '__return_true' );

许可证

版权所有 (c) 2017 Thorsten Frommen

此代码受 MIT 许可证 保护。

包含的 Highlight.js 受 BSD 许可证保护