为什么源荧光笔在asciidoctor中不起作用？
源荧光笔在asciidoctor中可能不起作用的原因有多种可能性，以下是一些常见原因和解决方法：
- 缺少正确的语法高亮插件：asciidoctor默认不支持所有编程语言的语法高亮显示，因此您需要使用适当的插件来实现源代码高亮显示。请确保已正确配置和启用所需的语法高亮插件。
- 错误的标记或用法：在asciidoctor中，为了实现源代码高亮显示，您需要使用正确的语法标记将源代码块标识出来。请确保您正确地使用了适当的标记，如
[source]，以及正确地指定语言类型，例如[source,java]。 - 缺少必要的依赖项：某些语法高亮插件可能需要额外的依赖项才能正常工作。请确保您已经安装和配置了所需的依赖项。
- asciidoctor版本不兼容：源荧光笔可能不起作用是因为您使用的asciidoctor版本与高亮插件不兼容。请检查您正在使用的asciidoctor版本和插件的兼容性，并尝试更新到最新的版本。
如果以上解决方法都无效，您可以尝试在asciidoctor社区或论坛中寻求帮助，以获取更具体的指导和支持。
相关·内容
在Windows上使用asciidoctor-maven-plugin，我们在弹出目标过程-asciidocs时，将得到一个编码不协调错误。
我们已经尝试了0.1.4版本的插件和最新的快照从主。
org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.asciidoctor:asciidoctor-maven-plugin:1.5.0-SNAPSHOT:process-asciidoc (default-cli) on project lgtdev-doc: Execution def
浏览 3提问于2014-04-03得票数 2
回答已采纳
我是从未有过的新手。我希望从java文件中注释的javadoc ( asciidoc格式)生成HTML文档。
例如java文件
/**
* = Asciidoclet
*
* Sample comments that include `source code`.
*
* [source,java]
* --
* public class Asciidoclet extends Doclet {
* private final Asciidoctor asciidoctor = Asciidoctor.Factory.create();
*
* @Suppre
浏览 10提问于2015-01-27得票数 5
2回答
有没有办法从asciidoctor的gradle插件中取出一个文件夹，这样它就不会在里面搜索..adoc了。
下面是我现在在我的build.gradle中拥有的内容：
asciidoctor {
resources {
from(sourceDir) {
include 'img/**'
}
}
}
我试过这样的方法，但没有用：
asciidoctor {
resources {
from(sourceDir) {
include 'img/**
浏览 1提问于2017-09-27得票数 0
回答已采纳
我已经开始使用来满足语法突出显示的需要。
然而，我意识到它在移动设备上不起作用。类似地，它通常在桌面浏览器上不起作用，但有时是这样的。
它通常默认为<pre>样式，因为SyntaxHighlighter不会将<pre>转换为自己的样式<div>
但有时它会做它应该做的事情：
(你可以在我的网站上看到这种效果。)
在脚本调用它之前，我已经确保了包含语法荧光笔的脚本，并且我的脚本在页面加载时运行。
但是，如果我在页面加载后调用SyntaxHighlighter.all()或SyntaxHighlighter.highlight() (使用Ch
浏览 1提问于2015-12-19得票数 0
回答已采纳
我正在使用asciidoctor为我的家乡的一个即将到来的活动生成一个静态站点，我们有一个为外地客人提供的酒店和感兴趣的地方的列表。每个位置在地图上都有一个位置，一个类型(酒店、餐馆等)。以及他们是否是这次活动的赞助商。
我已经阅读了上的文档，这似乎是最好的方法，但我不知道如何用元数据标记标题，这些元数据可以用这种方式处理。
目前，我们对文档中的每个位置都有如下描述
== Locations
[[Fancy_Hotel]]
=== Fancy Hotel
[location, 55, 73, hotel, sponsor]
A nice hotel in the middle of tow
浏览 0提问于2019-08-13得票数 1
如何在asciidoctor-pdf中使用自定义样式(font-size，font-color等)。我已经阅读了主题指南，并尝试在xxx-heme.yml中添加设置，但没有成功。此外，在我的pdf示例中，标记的样式(带有#)也不起作用。
浏览 2提问于2015-11-11得票数 5
我正在用asciidoctor编写我的文档，现在我将用我现有的adoc文件创建一个pdf文件，但是在我使用之后：
asciidoctor -r asciidoctor-pdf -b pdf documentation.adoc
并获得我的pdf我已经与火狐到我的documentation.pdf的网址，但我的格式的代码块在pdf中没有显示üchars，这个字符我使用的内联评论。如果我的输出文件是HTML，我的特殊字符没有错误。
我的PDF文件看起来是这样：
我试着用
ä
但是pdf文件显示了
ä
浏览 2提问于2019-07-23得票数 1
回答已采纳
我在这里的第一个问题很兴奋
在我的ASCIIDOC代码中
Big Name{wj}footnote:[Big because X] is found.
这将完美地呈现到生成html的(一个长的)页面的末尾。
Big Name [1] is found.
<a lot of other text till the end of the one long html page>
--
1. Big because X
但是生成PDF时，它会呈现到文本中：
Big Name [1: Big because X] is found.
为什么PDF一代是不同的？如何控制PDF生成过
浏览 2提问于2017-11-01得票数 2
1回答
我正在使用asciidoctor来创建一个PDF，它运行得很好。但是，当我使用asciidoctor- epub 3将其转换为epub时，它会显示一条警告消息：
asciidoctor:警告:在toc的后端epub3中缺少转换
但是，toc被添加到生成的epub中，我不知道为什么会看到这个警告。
这是再现问题的最小.adoc文件。
= Book title
:doctype: book
:toc: macro
toc::[]
浏览 7提问于2022-04-06得票数 1
回答已采纳
1回答
我看到本身有一个导航(顶部)栏。我猜这个网站是用asciidoctor源文件写的。不管怎样，如何使用asciidoctor添加导航栏？
更新
这可能是不该问的问题。也许正确的方法是使用敬畏、中间人或Jekyll。欢迎提出意见/建议。
浏览 1提问于2015-06-23得票数 2
回答已采纳
如果C++在一个句子中只出现一次，则asciidoctor可以很好地解析字符串。
如果C++出现两次，则在下面的示例中，asciidoctor跨bar匹配。
在上的各种尝试都不起作用。
如何使用asciidoctor在句子中排版两次或两次以上的C++？
. foo C++
. foo C++ bar C++ blah
. foo C\++ bar C++ blah
. foo C+\+ bar C++ blah
. foo C\+\+ bar C++ blah
. foo C+\+ bar C\++ blah
. foo C+\+ bar C+\+ blah
. foo C\\++ bar C
浏览 6提问于2015-06-05得票数 1
回答已采纳
有没有人知道在哪里可以获得Asciidoctor用户手册的离线版本：
奇怪的是，开发人员如何吹嘘Asciidoctor能够导出到PDF，HTML.但同时他们没有提供一个很好的PDF文档供脱机使用..。
浏览 1提问于2020-06-08得票数 0
回答已采纳
我已经将Vega工具的安装添加到docker-asciidoctor Dockerfile中，它们在运行bats测试时存在，但当我运行镜像时，它们不再存在。
我对Docker是个新手。
我还尝试了将目录node_modules添加到路径的一些变体，但都不起作用。
在所有情况下，Vega工具的安装目录都不在映像中。
我像这样添加Vega工具：
...
&& npm install --build-from-source -g vega-cli vega vega-lite vega-embed \
&& echo `which vl2vg` \
...
它
浏览 0提问于2019-05-15得票数 1
我正在尝试创建一个简单的宏，以便在asciidoctor中以红色呈现文本项。以下内容不起作用：
:redtext: [red]#some important text in red that occurs a lot#
{redtext}
或者举一个更简单的例子：
:redcross: [red]#✘#
我不清楚宏可以替换和不能替换的规则。目前，asciidoctor手册中的宏是空白的()。asciidoc手册()也不是很清楚，但可能不适用于asciidoctor。
一个相关的未回答的问题是。一个与此相关的问题建议使用includes，这对此来说过于夸张了。
宏的限制是
浏览 2提问于2016-11-07得票数 1
我正在尝试使用Spring restdocs配置asciidoctor。我正在将它从org.asciidoctor.convert升级到org.asciidoctor.jvm.convert，但得到的错误是它无法找到页面和加载代码片段。根据我得到的错误，它不会对我在gradle构建文件中设置的配置做任何操作。我曾尝试添加asciidoctorExtensions来替换废弃的asciidoctor，但似乎都不起作用。
错误：
jun. 18, 2021 2:56:10 P.M. uri:classloader:/gems/asciidoctor-2.0.10/lib/asciidoctor/su
浏览 1提问于2021-06-18得票数 0
3回答
我有一个有一堆子文件夹的文件夹，这些文件夹有asciidoctor格式的.adoc扩展文件。
每次我对文件进行更改时(通常是这样)，我都需要运行
asciidoctor -q filename.adoc
将其编译成HTML格式。
我正试图使这个过程自动化。到目前为止，我使用的是安特尔：
ls *.adoc | entr asciidoctor -q *.adoc
但仅适用于现有文件夹，而不适用于子文件夹。我尝试过这种变体，但它不起作用：
find . -name '*.adoc' | entr asciidoctor -q *.adoc
有什么想法吗?我如何为所有的子文件夹实现
浏览 0提问于2016-08-31得票数 21
回答已采纳
我有一张桌子：
[width="10%", cols="^", options="header"]
|===
| header
| one
| two
| three
| four
|===
它呈现为：
为了达到无条纹：
我这样做：
[width="10%", cols="^", options="header"]
|===
| Header
| one
{set:cellbgcolor:white}| two
| three
| four
|===
{set:cellbgcol
浏览 6提问于2018-04-01得票数 1
大家下午好，
我一直在尝试让spring-asciidoctor-extensions与我的文档一起工作，但由于某些原因，maven找不到依赖项。
在我尝试构建之后得到的错误：
Failed to execute goal org.asciidoctor:asciidoctor-maven-plugin:1.5.5:process-asciidoc (generate-docs) on project organization: Execution generate-docs of goal org.asciidoctor:asciidoctor-maven-plugin:1.5.5:proc
浏览 0提问于2017-08-30得票数 2
从CLI运行AsciiDoctor将创建一个带有嵌入样式表的HTML文档：
$ asciidoctor mysample.adoc
....
<title>My First Experience with the Dangers of Documentation</title>
<style>
/* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
article, aside, details, figcaption, figure, footer, head
浏览 2提问于2014-02-25得票数 3
回答已采纳
我有一个有很多子文件夹的文件夹，这些文件夹有带有asciidoctor扩展名的.adoc格式文件。
每次我对文件进行更改时(通常是这样)，我都需要运行
asciidoctor -q filename.adoc
将其编译成HTML格式。
我正试图使这个过程自动化。到目前为止，我使用的是安特尔：
ls *.adoc | entr asciidoctor -q *.adoc
但仅适用于现有文件夹，而不适用于子文件夹。我尝试过这种变体，但它不起作用：
find . -name '*.adoc' | entr asciidoctor -q *.adoc
有什么想法吗?我如何为所有的子文件
浏览 0提问于2016-09-01得票数 0
回答已采纳
1回答
我尝试在我的rails应用程序中使用asciidoctor。我将它添加到我的Gemfile中，并制作了bundle install。
现在，我尝试在Controller中使用asciidoctor：
def show
@article.text = Asciidoctor.render(@article.text)
end
但我发现了一个错误：
uninitialized constant ArticlesController::Asciidoctor
怎样才能正确地使用rails来使用asciidoctor-gem？
浏览 5提问于2014-06-17得票数 2
回答已采纳
我正试图在asciidoctor中使用deck.js后端。我遵守了的指示。我得到以下错误：
$ asciidoctor --trace -T asciidoctor-backends/haml deckjs-example.asciidoc
/usr/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require': cannot load such file -- asciidoctor/stylesheets (LoadError)
from /usr/lib/ruby/1.9.1/rubygems/custom_requ
浏览 2提问于2015-04-27得票数 0
回答已采纳
我正在尝试升级asciidoctor，因为在gradle版本7中不再支持旧版本。问题是，我不知道如何从我当前的gradle kotlin代码中升级它。(我只在groovy中找到了一些例子)。我目前拥有的gradle代码看起来有点像以下内容：
plugins {
id("org.asciidoctor.convert") version "2.4.0"
....
kotlin("jvm") version "1.5.0"
kotlin("plugin.spring") version
浏览 3提问于2021-05-17得票数 2
我想使用Spring rest文档生成API文档。但是它不能生成生成的代码片段目录。 pom.xml <dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
浏览 16提问于2020-04-22得票数 0
我使用asciidoctor-maven-plugin和asciidoctor图来生成PlantUML图(更具体地说，是图)。在生成这些图时，这些消息会污染输出。
[Log] "dynamic undefined legend colors" requires PlantUML version >= 1.2021.6, therefore only static assigned colors are used
我追踪到了它的源代码中的asciidoctor(图内嵌)，它是一个相当老的PlantUML ()版本。幸运的是，在asciidoctor图plantuml 类中有
浏览 5提问于2021-09-17得票数 0
我有一个gitlab页面网站，是建立在一个码头容器。我找到了一个基本的图像，包含95%的我想要的东西。使用我的旧ci，我在构建步骤之前安装了额外的软件包。我想用这些软件包创建一个新映像，并使用该映像。我能够构建和运行这个映像，但是它不再在gitlab操作中运行。我不知道为什么。
Git：
CI Config：
image: klakegg/hugo:asciidoctor-ci # old
image: registry.gitlab.com/hybras/hybras.gitlab.io # new
variables:
GIT_SUBMODULE_STRATEGY:
浏览 3提问于2021-09-28得票数 0
我在reactjs应用程序中使用asciidoctor，我想使用highlight.js进行源代码选择，但属性不起作用。 ? ? ?
浏览 18提问于2021-01-30得票数 0
这是我的场景
我有一个POM文件，它使用我们开发的自定义插件，比如说mycutom-plugin，该插件使用另一个名为asciidoctor-maven-plugin的插件
所以我会在这里记下我的担忧
asciidoctor-中有一个参数(asciidoctor.sectnumlevels)作为配置属性，请参见下面的xml，这个参数值是由使用这个插件的父POM传递的。
现在，当我没有从正在使用的插件的父POM传递值时，我想从mycutom- plugin的POM中为${asciidoctor.sectnumlevels}设置一个默认值
<plugin>
浏览 1提问于2018-12-13得票数 0
我正在使用像这样的文档创建..
Lucene.Net.Documents.Field fldContent =
new Lucene.Net.Documents.Field("content", content,
Lucene.Net.Documents.Field.Store.YES,
Lucene.Net.Documents.Field.Index.TOKENIZED,
Lucene.Net.Documents.Field.TermVector.WITH_POSITIONS_OFFSETS);
想要按一个单词执行搜索，
浏览 1提问于2009-09-10得票数 0
1回答
我想要创建一个BlockProcessor，它将打开的块转换成图像。
下面的类是我实际处理器的简化版本：
@Name("foo")
@Contexts({Contexts.OPEN})
@ContentModel(ContentModel.SIMPLE)
public class FooBlockProcessor extends BlockProcessor {
@Override
public Object p
浏览 20提问于2022-03-23得票数 1
我使用asciidoctor和maven和asciidcotor-maven-plugin，我使用asciidoctorJ和asciidoctorJ-diagramm。
现在，我要在文档的src代码中呈现。
plantuml::input.puml[]
通过mvn -X编译，我现在可以在控制台中获得信息:-(
在生成的文档中，我看到src的行完全相同，iaw 没有在所有上呈现。
有什么问题吗？
<plugin>
<groupId>org.asciidoctor</groupId>
<art
浏览 1提问于2019-07-18得票数 1
回答已采纳
给定此示例内联宏：
package some;
import java.util.Map;
import org.asciidoctor.ast.ContentNode;
import org.asciidoctor.extension.InlineMacroProcessor;
public class SomeMacro extends InlineMacroProcessor {
public SomeMacro(String macroName) {
super(macroName);
}
public SomeMacro(String
浏览 0提问于2020-11-26得票数 0
1回答
我有两页，我相信是相同的，在一个引导模式出现。滚动到每页上的venn图。右击图像，就会出现一个模式。
模式不出现。
模式确实出现
我需要弄清楚为什么模态没有出现在第一页。
浏览 2提问于2016-08-29得票数 0
我在JBake中使用asciidoc格式。我使用的是2.4.0版的JBake。
一切运行良好，但我希望对从asciidoc内容生成的HTML进行一些更改。通常，在Asciidoctor中，您可以为自定义后端指定template_dirs选项。
我试图在JBake中通过将以下内容添加到jbake.properties文件中进行相同的操作。
asciidoctor.option.template_dirs=src/custom-asciidoctor-backends/erb/html5
目录src/定制-asciidoctor-后端/erb/html5 5包含原始后端，没有任何更改。
这将给出以
浏览 2提问于2015-12-04得票数 2
回答已采纳
目前，我在中央build.gradle.kts中有所有gradle-Tasks的配置。由于这个文件将变得太长，我计划将至少一些任务扩展到他们自己的文件中。 目前，我的build.gradle.kts看起来有点像下面这样： import org.asciidoctor.gradle.jvm.AsciidoctorTask
val revDate = System.getenv()["revdate"] ?: SimpleDateFormat("yyyy-MM-dd").format(Date())
val revNumber = System.getenv()
浏览 25提问于2020-12-14得票数 1
回答已采纳
我的Maven站点包含serveral文档。我想使用在Maven站点插件的配置中声明的属性，但是看起来它们不会被Asciidoctor过度使用。
<plugin>
<artifactId>maven-site-plugin</artifactId>
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoc
浏览 1提问于2015-09-12得票数 0
回答已采纳
我和maven一起工作
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>2.0.0-RC.1</version>
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<a
浏览 17提问于2019-11-06得票数 0
回答已采纳
我正在尝试如何在角13应用程序中使用Asciidoctor.js。我创建了我的应用程序使用：
ng new Test-Asciidoctor --strict --routing --style=scss
并按照的文档导入Asciidoctor处理器。
import Processor from 'asciidoctor'
const processor = Processor()
但是，它会导致以下错误：
函数原型似乎不允许修改length属性。我如何允许它使Asciidoctor.js在角度上工作呢？
更新
考虑到与这一问题相关的一些联系，这一问题似乎
浏览 4提问于2022-01-01得票数 1
我使用Spring文档和JIB
当我做./gradlew build和java -jar /some/build/libs/app.jar时。我可以在example.com/docs/asciidocname.html上获得由spring文档生成的api文档。
但是带有./gradlew jib的docker映像不包含这个url。
我希望在执行./gradlew jib时获得由Spring生成的Api文档
下面是我的build.gradle的一部分
plugins {
id "org.asciidoctor.convert" version "2.4.0"
浏览 3提问于2020-10-03得票数 3
回答已采纳
我有一个简单的问题(文档似乎没有提供一个简单的答案)。
在运行asciidoctor gradle任务时，我正在尝试复制各种资源(在本例中为图像)。
目录结构不是最好的，这意味着adoc文件和分类的图像没有逻辑地放置，但这是我不能更改的。
我试图找出为什么要这样做，我偶然发现了asciidoctor的资源选项。现在我的主要问题是，我如何正确配置它，以便它遍历基目录中的所有目录，并将任何非.adoc文件复制到目标目录(同时保持相同的文件夹结构)？
浏览 0提问于2017-11-23得票数 0
我在Spring Boot (1.4.1)应用程序中使用Spring Restdocs (1.1.2)。
在Gradle构建文件的jar任务中，我将生成的输出复制到public/docs中：
jar {
dependsOn asciidoctor
from ("${asciidoctor.outputDir}/html5") {
into 'public/docs'
}
}
我在生成的JAR中看到文档在
BOOT-INF/classes/public/docs/api-guide.html
但是，当我运行JAR时，我似乎无法在/docs、/p
浏览 1提问于2016-09-30得票数 1
2回答
我和Hugo和Asciidoctor有一个现有的博客，但是运行hugo server开始失败。我首先添加了附加的安全配置，如中所解释的那样。
但事情还是不起作用，我得到了这样的错误：
ERROR 2022/02/19 17:11:36 blog/2021/12/23/Taming Thymeleaf 2.0 release.adoc: /Users/wdb/.rvm/rubies/ruby-2.7.0/lib/ruby/site_ruby/2.7.0/rubygems.rb:277:in `find_spec_for_exe': can't find gem asciidoct
浏览 21提问于2022-02-19得票数 2
回答已采纳
我有一个项目，它对ascii医生有下面的依赖关系：
dependencies {
// Used by api documentation generator
classpath 'org.asciidoctor:asciidoctor-gradle-jvm:3.3.2'
}
apply plugin: 'org.asciidoctor.jvm.convert'
我已经配置了一个gradle任务来为我的ascii文档生成html报告，如下所示：
asciidoctor {
sourceDir = asciidocOutp
浏览 13提问于2022-01-17得票数 0
1回答
我得到异常时，从ascii文档文件创建pdf文件使用以下库在Spring启动应用程序。
org.asciidoctor:asciidoctorj:1.6.0-alpha.3
org.asciidoctor:asciidoctorj-pdf:1.5.0-alpha.11
org.asciidoctor:asciidoctorj-epub3:1.5.0-alpha.6
我发现了之前报告的类似问题，通过设置类加载器进行了尝试，但没有成功。
显示的例外情况是
org.jruby.exceptions.RaiseException: (LoadError) no such file to load --
浏览 0提问于2016-11-08得票数 0
我不知道任何Ruby，但我喜欢asciidoctor (和gradle插件)。有没有一种简单的方法可以让插件生成图？
我研究了基本的功能，它似乎特定于使用原生/ruby asciidoctor扩展(我没有，也不想安装，因为我喜欢使用gradle插件)。
做得很好的Ruby页面显示，它接受模块的requires选项，但没有任何基于Ruby的选项，我不确定这是否是我所需要的。
我尝试了阻力最小的路径，即：
asciidoctor {
logDocuments = true
separateOutputDirs = false
sourceDir = file("sr
浏览 0提问于2015-03-06得票数 5
asciidoctor在OS (El Capitan)上辜负了我。我正在尝试通过asciidoctor运行MacPorts。
我采取的步骤是：
sudo port install asciidoctor。我随后通过port installed | grep ascii确认已经安装了asciidoctor @1.5.4_0 (active)。
sudo port install rb-rubygems。我现在通过port contents rb-rubygems看到新安装的gems位于/opt/local/bin/gem-1.8。
sudo /opt/local/bin/gem-1.
浏览 3提问于2016-11-22得票数 1
回答已采纳
1回答
我正在尝试在AsciiDoc中使用Gitbook (运行Win10x64，NodeJS 6.9.1和Gitbook v3.2.2) --我对这两个版本都很陌生。
自从v2.0.0和链接到，AsciiDoc就被支持了--我检查了节点包，gitbook依赖于gitbook-asciidoc，而gitbook-asciidoc又依赖于asciidoctor.js。
根据文档，可以使用AsciiDoc角色对图像和表进行样式化。它们引用应用于HTML元素的类，这些类是在默认的AsciiDoctor系统样式表中定义的。
但是，无论我如何尝试应用角色，例如对图像( [.text-center]速记或[rol
浏览 6提问于2017-06-16得票数 1
1回答
我想建立一个带有asciidoc内容的hugo站点，并在netlify中托管它。在我的windows机器中安装了ascii和asciidoctor之后，我能够在本地运行该站点。
gem install asciidoc
gem install asciidoc
在此之前，我的控制台中出现了以下错误，浏览器中没有内容。
ERROR 2018/11/11 03:05:08 asciidoctor / asciidoc not found in $PATH: Please install.
8:35:09 AM: Leaving AsciiDoc content
浏览 1提问于2018-11-11得票数 0
回答已采纳
我正在用Solr搜索引擎开发网页应用程序，并试图了解高亮显示是如何工作的。
在Solr中默认、FastVector和张贴荧光笔之间的区别是什么？
浏览 2提问于2015-01-28得票数 1
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
即时通信 IM
实时音视频活动推荐
腾讯云开发者
