asciidoc:如何向图像中添加标注

Question

我怎样才能在文档中这样的图像中添加标注呢？参见这里的一个示例：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上获得图像才能工作，我已经使用了这幅图像。

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

• 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标记。

在我的书中不时需要这个特性，但我最终在图像中添加了一个标签(比如a.png和这个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.