image - asciidoc：如何将标注 asciidoc 添加到图像

Question

如何向docbook中的图像添加标注？在此处查看示例：http: //norman.walsh.name/2006/06/10/imageobjectco

标注点可以绘制在图像上，但是当我尝试从中生成文档时：

image::img/stg.png[width=400,align="center"]
<1> Blabla.
<2> Foobar.
<3> Aknathnaratnathgarat.

...它会抛出一个错误：

asciidoc: WARNING: manual.adoc: line 580: no callouts refer to list item 1
asciidoc: WARNING: manual.adoc: line 581: no callouts refer to list item 2
asciidoc: WARNING: manual.adoc: line 582: no callouts refer to list item 3

Answer 1

了解 asciidoc 使用 docbook 很重要，在 docbook 中查找它我刚刚发现了如何执行此操作：

++++
<mediaobjectco> 
  <imageobjectco>  
    <areaspec id="map1"  
              units="calspair">  
      <area linkends="callout1"  
            coords="1000,5000 6000,8000"  
            id="area1"/>  
    </areaspec>
    <imageobject>
      <imagedata fileref="images/notredame.png" />
    </imageobject>
    <calloutlist>
      <callout arearefs="area1" 
               id="callout1">  
        <para>My only callout</para>
      </callout>
    </calloutlist>
  </imageobjectco>
</mediaobjectco>
++++

您可以复制并粘贴到 asciidoc 中，它会起作用（++++操作员让您将 docbook 代码放入 asciidoc）。当然，您必须拥有该图像images/notredame.png才能工作，我已使用此图像。

要了解更多信息，请查看 docbook 文档：

• http://www.sagehill.net/docbookxsl/Imagemaps.html（这个例子是从那里提取的）
• http://www.docbook.org/tdg/en/html/callout.html
• http://www.sagehill.net/docbookxsl/PrintIcons.html

注意：Asciidoc 使用 docbook 4.5，查看文档时跳过 5.0 标签。

我的书中不时需要这个功能，但我最终在图像中放置了一个标签（如mapa_a.png和这个mapa_b.png），并将它们并排放在带有内联图像的表格中。您可以在此文件中看到内嵌图像，查找image:images/cap4)。

Answer 2

这不是一个真正的解决方案，但部分类似于原始标注：

:callouts: /usr/share/xml/docbook/stylesheet/docbook-xsl/images/callouts/

image::img/stg.png[width=400,align="center"]
image:{callouts}/1.svg[] Blabla.               +
image:{callouts}/2.svg[] Foobar.               +
image:{callouts}/3.svg[] Aknathnaratnathgarat.