问题标签 [asciidoc]

有没有一种简单的方法可以从 ASCIIDoc 文件生成带有菜单的网站，...？

假设我有几个 ASCII-Doc 文件：

我还有一个网站骨架，其中包含除文件的“主要内容”之外的所有内容

现在我想生成 4 个 html 文件，它们具有渲染的 HTML 命令，它被放置到网站 Skeleton 的副本中（这里替换 CONTENT SHOULD GO HERE）

有没有允许这样的工具？

我正在使用 Atom Editor + 关于 asciidoctor 的两个插件/包。

• asciidoc 预览
• 语言-asciidoc

一切都按预期工作。但我有以下情况：

我有以下目录结构：

哪里findOneXml.adoc（在图形文件夹中）有

通过实时预览，我可以看到图像及其各自的描述

现在findOne.adoc（在url文件夹中）包含以下行：

我认为路径参考是可以的。如果我使用其他，实时预览会显示有关无效或错误路径的错误消息。

但是通过实时预览，我看到图像损坏，但我可以看到描述。

有什么问题或遗漏？

即使include::./../figures/findOneXml.adoc[]失败

注意：在子/子文档中，我需要添加其他数据如何注释、提示（警告），该子文档将被其他父母多次重复使用。所以我只需要参考图像。

谢谢

我使用https://github.com/asciidoctor/asciidoctor-epub3为 Kindle 导出到 kf8。结果看起来很漂亮，但错过了提示、注意和重要提示旁边的小图像。我猜这些文件丢失了，或者 CSS 中有错误。我该如何解决？

我使用这个命令来渲染 kf8 版本：

我有这样的asciidoc文档结构：

我正在尝试从 to 创建交叉doc1引用doc2。

我试过类似的东西：

但它不起作用，有人可以暗示什么是错的吗？

谢谢！

当我*.adoc在 awestruct 的文件中有此代码时：

我得到：

但我希望它像这样很好地格式化：

我尝试了这些，但它们不起作用：

这很奇怪，因为#{rubyVariable.someMethod()}在 adoc 文件中调用 Ruby 方法确实有效。

如果结束反引号 (`) 后跟一个字母，则它不会按预期呈现。

例如，`Link`s 将仅呈现 `Link`s 而不是Links。

Using{empty}解决了像 `Link`{empty}s` 这样的问题，但它非常难看。

有更好的方法来实现这一点吗？

更新：

我正在使用asciidoctor-gradle-plugin.

一个简单的示例项目如下：

https://github.com/izeye/samples-spring-boot-branches/tree/asciidoctor

我正在尝试使用 AsciiDoc 轻量级标记语言创建“可点击”图像Asciidoctor。

我尝试了以下（不工作）： image::<url1>[<url2>[]]

例如：

它应该变成大致如下的html：

如何在 AsciiDoc 中完成此操作而不通过原始 HTML？

我使用 org.asciidoctor.convert 插件为我的团队生成 API 文档。我包括文件：

并希望将其内容放入扰流板或类似内容中。有没有办法以某种方式隐藏动态 asciidoc 元素？我尝试使用

但它没有被处理包含在它里面。任何想法将不胜感激。在不隐藏片段的情况下，我的文档几乎可以无限滚动 :)。如果 ascii doc 没有这样的方式，其他文档格式的建议，我可以在其中包含文件内容并将其放入扰流板中，也值得赞赏。

我正在尝试使用以下命令将我的 AsciiDoc 转换为 html5：

asciidoc -b html5 -a icons -a toc2 -a stylesheet=article.css myPost.adoc

它找不到我的 css 文件，因为它看起来位置不对： asciidoc: WARNING: myPost.adoc: line 1: include file not found: /usr/local/Cellar/asciidoc/8.6.9/etc/asciidoc/article.css

ascii还在生成的html文件中放置了一些css，所以我怎样才能删除它（或将它传递给外部文件），因为我有多个文件要转换并且不想复制它。

有一些 AsciiDoc 有一个像...这样的块

...我希望文本显示为...

...“一些”这个词是粗体的。