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工作的圖像，我已經使用this image。

要了解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標籤。

不時是需要這個功能在我的書，但我最終圖像中puting標籤（如mapa_a.png而這其中mapa_b.png），並把它們並排在一個表inline image。你可以看到內嵌圖片in this file，找到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.