Asciidoctor不会突出显示源代码。

Question

我尝试使用Asciidoctor通过Spring文档生成文档。用户手册说:为了突出显示文档中的源代码，我将在.adoc文件头中使用:source-highlighter: highlightjs属性。

这里是我的index.adoc的一个例子

:source-highlighter: highlightjs

= Source code listing

Code listings look cool with Asciidoctor and highlight.js with {highlightjs-theme} theme.

[source,groovy]
----
// File: User.groovy
class User {
    String username
}
----

[source,sql]
----
CREATE TABLE USER (
    ID INT NOT NULL,
    USERNAME VARCHAR(40) NOT NULL
);
----

在此之后，我构建并运行应用程序，下面是一个生成的文档，没有突出显示源代码：

​

我的maven插件配置：

<plugin>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctor-maven-plugin</artifactId>
    <version>1.5.3</version>
    <executions>
        <execution>
            <id>generate-docs</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>process-asciidoc</goal>
            </goals>
            <configuration>
                <backend>html</backend>
                <doctype>book</doctype>
            </configuration>
        </execution>
    </executions>
    <dependencies>
        <dependency>
            <groupId>org.springframework.restdocs</groupId>
            <artifactId>spring-restdocs-asciidoctor</artifactId>
            <version>2.0.2.RELEASE</version>
        </dependency>
    </dependencies>
</plugin>

我做错了什么？

此外，我还尝试在本地安装highlight.js，如用户手册所述，将highlight/highlight.pack.js重命名为highlight/highlight.min.js，将highlight/styles/github.css重命名为highlight/styles/github.min.css等等，但也没有结果。

Answer 1

不幸的是，正如您可能知道的那样，Groovy没有包含在标准的highlight.js语言包中。它只包括“共同”部分中的内容。不过，SQL可以工作。如您在图中所看到的，SQL部件可以直接用于我的安装程序，而不是Groovy。

​

​

要修复Groovy代码，可以使用Java作为语言(对于很多Groovy代码示例来说都可以)，也可以下载自定义的HighlightJS包，并检查Groovy。我猜那就是你要去的地方。

如果您使用的是自定义HighlightJS包，我一开始也遇到了类似的问题。当我在浏览器中使用开发工具时，它显示没有找到highlight.js文件。问题的另一个提示是，所有Spring示例也失去了高亮显示。虽然Asciidoctor手册说要把它放在同一个文件夹中，并且应该自动复制，但是使用Gradle，我仍然必须告诉它使用resources配置选项包括突出显示文件。我不是Maven用户，但也许Maven插件也有类似的设置？

在修复了配置之后，它对Groovy和SQL都有效。

​

​

所以我希望这对你也有帮助。