f:mediaobject-amend-uri

f:mediaobject-amend-uri — Amend the URI for media objects.

Function:
{http://docbook.org/ns/docbook/functions}mediaobject-amend-uri#1
Defined in:
modules/objects.xsl
Used in:
main.xsl

Synopsis

f:mediaobject-amend-uri($uri as xs:string) as xs:string

Description

After the media object URI has been calculated, f:mediaobject-amend-uri() is called. This is an opportunity to update the URI so that the media object will be found.

The default version of this function returns the URI unchanged unless $mediaobject-grouped-by-type is true. If media objects are grouped by type, the media object type is added to the URI. The media object type is determined by calling f:mediaobject-type().

Suppose, for example, that the calculated URI is file:///path/to/image.jpg and the f:mediaobject-type() returns “jpeg”. In that case, the URI returned will be file:///path/to/jpeg/image.jpg.

Important

Consider how this function interacts with the m:mediaobject-output-adjust mode. In particular, beware that the value processed in the m:mediaobject-output-adjust mode will already have been updated by f:mediaobject-amend-uri().