如何添加标注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:

: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.