From: Thomas Schraitle <tom_schr@web.de>
Date: Fri, 25 Oct 2013 11:04:31 +0000 (+0000)
Subject: Fixed ticket [#1315]: Add possibility to add a link to mediaobjects
X-Git-Tag: release/1.79.1~6^2~145
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7034348dc8d3710720f714dae085f9bd2883bcbc;p=docbook-dsssl

Fixed ticket [#1315]: Add possibility to add a link to mediaobjects
---

diff --git a/xsl/html/graphics.xsl b/xsl/html/graphics.xsl
index ab1230245..669d6732b 100644
--- a/xsl/html/graphics.xsl
+++ b/xsl/html/graphics.xsl
@@ -609,6 +609,18 @@ valign: <xsl:value-of select="@valign"/></xsl:message>
         </object>
       </xsl:when>
       <xsl:otherwise>
+        <xsl:variable name="src">
+          <xsl:choose>
+             <xsl:when test="$img.src.path != '' and
+                             $tag = 'img' and
+                             not(starts-with($output_filename, '/')) and
+                             not(contains($output_filename, '://'))">
+               <xsl:value-of select="$img.src.path"/>
+             </xsl:when>
+           </xsl:choose>
+           <xsl:value-of select="$output_filename"/>
+        </xsl:variable>
+        <xsl:variable name="imgcontents">
         <xsl:element name="{$tag}">
          <xsl:if test="$tag = 'img' and ../../self::imageobjectco">
            <xsl:variable name="mapname">
@@ -635,15 +647,7 @@ valign: <xsl:value-of select="@valign"/></xsl:message>
          </xsl:if>
 
           <xsl:attribute name="src">
-           <xsl:choose>
-             <xsl:when test="$img.src.path != '' and
-                           $tag = 'img' and
-                             not(starts-with($output_filename, '/')) and
-                           not(contains($output_filename, '://'))">
-               <xsl:value-of select="$img.src.path"/>
-             </xsl:when>
-           </xsl:choose>
-            <xsl:value-of select="$output_filename"/>
+            <xsl:value-of select="$src"/>
           </xsl:attribute>
 
           <xsl:if test="@align">
@@ -681,6 +685,18 @@ valign: <xsl:value-of select="@valign"/></xsl:message>
             <xsl:with-param name="viewport" select="$viewport"/>
           </xsl:call-template>
         </xsl:element>
+        </xsl:variable>
+        
+        <xsl:choose>
+          <xsl:when test="$link.to.self.for.mediaobject = 0">
+            <xsl:copy-of select="$imgcontents"/>
+          </xsl:when>
+          <xsl:otherwise>
+            <a href="{$src}">
+              <xsl:copy-of select="$imgcontents"/>
+            </a>
+          </xsl:otherwise>
+        </xsl:choose>
       </xsl:otherwise>
     </xsl:choose>
   </xsl:variable>
diff --git a/xsl/html/param.ent b/xsl/html/param.ent
index a71c8acc1..42f4e1af9 100644
--- a/xsl/html/param.ent
+++ b/xsl/html/param.ent
@@ -149,6 +149,7 @@
 <!ENTITY linenumbering.separator SYSTEM "../params/linenumbering.separator.xml">
 <!ENTITY linenumbering.width SYSTEM "../params/linenumbering.width.xml">
 <!ENTITY link.mailto.url SYSTEM "../params/link.mailto.url.xml">
+<!ENTITY link.to.self.for.mediaobject SYSTEM "../params/link.to.self.for.mediaobject.xml">
 <!ENTITY make.graphic.viewport SYSTEM "../params/make.graphic.viewport.xml">
 <!ENTITY make.single.year.ranges SYSTEM "../params/make.single.year.ranges.xml">
 <!ENTITY make.valid.html SYSTEM "../params/make.valid.html.xml">
diff --git a/xsl/html/param.xweb b/xsl/html/param.xweb
index 9f2f32eb7..966eddabc 100644
--- a/xsl/html/param.xweb
+++ b/xsl/html/param.xweb
@@ -293,6 +293,7 @@ $Id$
 &use.embed.for.svg;
 &make.graphic.viewport;
 &preferred.mediaobject.role;
+&link.to.self.for.mediaobject;
 &use.role.for.mediaobject;
 &ignore.image.scaling;
 </reference>
diff --git a/xsl/params/link.to.self.for.mediaobject.xml b/xsl/params/link.to.self.for.mediaobject.xml
new file mode 100644
index 000000000..8aaeeaf49
--- /dev/null
+++ b/xsl/params/link.to.self.for.mediaobject.xml
@@ -0,0 +1,40 @@
+<refentry xmlns="http://docbook.org/ns/docbook" 
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xi="http://www.w3.org/2001/XInclude" 
+          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+          xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
+          version="5.0" xml:id="link.to.self.for.mediaobject">
+  <refmeta>
+    <refentrytitle>link.to.self.for.mediaobject</refentrytitle>
+    <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
+  </refmeta>
+  <refnamediv>
+    <refname>link.to.self.for.mediaobject</refname>
+    <refpurpose>Include <tag>a</tag> element to image objects itself to go to a full-size, freely-zoomable version</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<src:fragment xml:id="link.to.self.for.mediaobject.frag">
+<xsl:param name="link.to.self.for.mediaobject" select="0"/>
+</src:fragment>
+  </refsynopsisdiv>
+
+  <refsection>
+    <info>
+      <title>Description</title>
+    </info>
+    <para>In some cases, it can be very helpful to be able to click on an embedded <tag>figure</tag>
+      or <tag>informalfigure</tag> to get a full-size, freely-zoomable version of an image, for
+      instance when targeting readers on smartphones. This is implemented for images only, but not
+      for audio or video objects. </para>
+        
+    <para>If non-zero, the image will be wrapped in an <tag>a</tag> element, using the <tag class="attribute">href</tag> 
+      attribute pointing to the image itself: </para>
+    <screen>&lt;a href="source/image">
+   &lt;!-- the image object -->
+&lt;/a></screen>
+
+    <para> If the value of <parameter>link.to.self.for.mediaobject.xml</parameter> is zero
+      (default), then no <tag>a</tag> container is added. </para>
+  </refsection>
+</refentry>
diff --git a/xsl/xhtml-1_1/param.ent b/xsl/xhtml-1_1/param.ent
index 005e4f693..6ec61b8a0 100644
--- a/xsl/xhtml-1_1/param.ent
+++ b/xsl/xhtml-1_1/param.ent
@@ -147,6 +147,7 @@
 <!ENTITY linenumbering.separator SYSTEM "../params/linenumbering.separator.xml">
 <!ENTITY linenumbering.width SYSTEM "../params/linenumbering.width.xml">
 <!ENTITY link.mailto.url SYSTEM "../params/link.mailto.url.xml">
+<!ENTITY link.to.self.for.mediaobject SYSTEM "../params/link.to.self.for.mediaobject.xml">
 <!ENTITY make.graphic.viewport SYSTEM "../params/make.graphic.viewport.xml">
 <!ENTITY make.single.year.ranges SYSTEM "../params/make.single.year.ranges.xml">
 <!ENTITY make.valid.html SYSTEM "../params/make.valid.html.xml">
@@ -308,4 +309,4 @@
 <!ENTITY index.method SYSTEM "../params/index.method.xml">
 <!ENTITY reference.autolabel SYSTEM "../params/reference.autolabel.xml">
 <!ENTITY glossary.sort SYSTEM "../params/glossary.sort.xml">
-<!ENTITY javahelp.encoding SYSTEM "../params/javahelp.encoding.xml">
\ No newline at end of file
+<!ENTITY javahelp.encoding SYSTEM "../params/javahelp.encoding.xml">
diff --git a/xsl/xhtml-1_1/param.xweb b/xsl/xhtml-1_1/param.xweb
index 33d710d4c..94f95d91d 100644
--- a/xsl/xhtml-1_1/param.xweb
+++ b/xsl/xhtml-1_1/param.xweb
@@ -276,6 +276,7 @@ $Id: param.xweb 7583 2007-12-03 17:02:33Z mzjn $
 &use.embed.for.svg;
 &make.graphic.viewport;
 &preferred.mediaobject.role;
+&link.to.self.for.mediaobject;
 &use.role.for.mediaobject;
 &ignore.image.scaling;
 </reference>