代码之家 › 专栏 › 技术社区 › bimlas

asciidoc:如何将标注asciidoc添加到图像

asciidoc callout image

2

bimlas · 技术社区 · 11 年前

如何向中的图像添加标注 文件记录簿 ? 请参阅此处的示例: 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

2 回复 | 直到 11 年前

1

Eduardo Santana MGA 11 年前

理解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 ).

2

0

bimlas 11 年前

这不是一个真正的解决方案,但部分作用类似于最初的标注:

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