asciidoc：如何向图像添加标注asciidoc [英] asciidoc: how to add callouts asciidoc to image

问题描述

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

How can i add callouts to images like in docbook? See an example here: http://norman.walsh.name/2006/06/10/imageobjectco

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

The callout points can be drawn on the image, but when i try to generate document from this:

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

...它丢失了一个错误：

... it drops an error:

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

推荐答案

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

It's important to understand that asciidoc uses docbook, looking for it in docbook I just found out how to do this:

++++
<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 才能工作，我用此图片。

You can copy and paste in asciidoc and it will work (the ++++ operator let you put docbook code inside asciidoc). Of course you will have to have the image at images/notredame.png to work, I have used this image.

了解更多内容以查找docbook文档：

To understand more look for docbook documentation:

• http：// www.sagehill.net/docbookxsl/Imagemaps.html （这个例子是从那里提取的）


• http://www.docbook.org/tdg/en/html/callout.html


• < a href =http://www.sagehill.net/docbookxsl/PrintIcons.html =nofollow> http://www.sagehill.net/docbookxsl/PrintIcons.html

• http://www.sagehill.net/docbookxsl/Imagemaps.html (this example was extracted from there)
• http://www.docbook.org/tdg/en/html/callout.html
• http://www.sagehill.net/docbookxsl/PrintIcons.html

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

NOTE: Asciidoc uses docbook 4.5, when looking at documentation skip 5.0 tags.

从时间时间在我的书中需要这个功能，但我最终在图像中添加了一个标签（如 mapa_a.png 这一个 mapa_b.png ），并将它们并排放置在内联图片的表格中。您可以在此文件中查看内联图片，找到图片：images / cap4 ）。

From time to time is need this feature in my books, but I end up puting a label in the image (like mapa_a.png and this one mapa_b.png), and put them side by side in a table with inline image. You can see inline images in this file, find for image:images/cap4).

这篇关于asciidoc：如何向图像添加标注asciidoc的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！