diff --git a/book.xml b/book.xml index ee0164d..010b597 100644 --- a/book.xml +++ b/book.xml @@ -11,6 +11,10 @@ ph-Bookshelf Wiki + + autolinker + + the ph-Bookshelf @@ -20,8 +24,8 @@ 页面选项 - 代码高亮 - RegEx 高亮着色 + Prism 代码高亮]]> + RegEx 高亮着色 站点配置选项 diff --git a/tools/code-highlight.md b/tools/code-highlight.md index cf23ad3..c9038a1 100644 --- a/tools/code-highlight.md +++ b/tools/code-highlight.md @@ -1,5 +1,5 @@ --- -title: 代码块高亮 +title: 代码高亮 --- # 基于 Prism 的 代码块高亮支持 @@ -20,6 +20,18 @@ Prism 不会自动为所有代码块着色,所以不指定 `language-xxx` 即 // todo +## 添加 Prism 插件 + +ph-Bookshelf 还添加了可以方便的引入 Prism 的官方扩展插件的支持,你可以借此扩展代码高亮/代码块的使用方式。 + +只需要使用配置字段 `prism.plugins` 声明你需要的插件,每个语言名称之间通过 `;` 来分隔, ph-Bookshelf 即会自动加载这些插件。 + +ph-Bookshelf 可以合并不同位置的配置字段:所以在 *book.xml* 设置了 `line-numbers; autolinker`,在页面内设置了 `command-line` 后,最后在这个页面内,将会导入 `line-numbers` `autolinker` `command-line` 三个。 + +> 通过 `prism.plugins` 导入的插件最终将会向页面导入 `https://cdn.jsdelivr.net/npm/prismjs@v1.x/plugins/{$plugin}/prism-{$plugin}.min.js`{.lang-url} 和 `https://cdn.jsdelivr.net/npm/prismjs@v1.x/plugins/{$plugin}/prism-{$plugin}.min.css`{.lang-url} 两个文件。这在导入 Prism 官方插件的一般情况下都可以使用。 +> +> 目前还没有支持从自定义 url 导入。 + --- ## 你知道吗 diff --git a/web-server.md b/web-server.md index dfcdcaa..5a37fcc 100644 --- a/web-server.md +++ b/web-server.md @@ -1,3 +1,8 @@ +--- +configurations: + prism.plugins: 'command-line' +--- + # Web Server [Apache]: https://httpd.apache.org/ @@ -14,9 +19,17 @@ ph-Bookshelf 原始版本是在 [Apache Web Server][Apache] 环境下开发的 确认 [mod_rewrite] 已经打开。这一般可以通过以下简单的命令确认: -```shell-session -# a2enmod rewrite -``` +
a2enmod rewrite
+Enabling module rewrite.
+To activate the new configuration, you need to run:
+  service apache2 restart
+a2enmod rewrite
+Module rewrite already enabled
> 如果你使用的是旧版 Apache一般存在于会被叫做 httpd 的 apache,module 配置或许会在服务器里,这时候,大概你的 Apache 的配置文件(通常为 `/etc/apache2/httpd.conf`{.lang-url} 或者 `/etc/httpd/httpd.conf`{.lang-url}),找到以下行并取消注释它: >