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

我的书籍中不时需要此功能，但我最终在图像中添加了标签（如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.

asciidoc：如何向图像添加标注asciidoc

2 个答案: