444 lines
10 KiB
Plaintext
444 lines
10 KiB
Plaintext
head 1.11;
|
|
access ;
|
|
symbols;
|
|
locks; strict;
|
|
comment @@;
|
|
|
|
1.11
|
|
date 2006.08.30.01.48.41; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.10;
|
|
1.10
|
|
date 2006.07.25.02.30.48; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.9;
|
|
1.9
|
|
date 2006.07.18.00.43.53; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.8;
|
|
1.8
|
|
date 2006.07.10.04.43.23; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.7;
|
|
1.7
|
|
date 2006.07.10.02.12.03; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.6;
|
|
1.6
|
|
date 2006.07.06.06.00.45; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.5;
|
|
1.5
|
|
date 2006.07.04.02.02.23; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.4;
|
|
1.4
|
|
date 2006.06.28.06.54.55; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.3;
|
|
1.3
|
|
date 2006.06.09.05.49.42; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.2;
|
|
1.2
|
|
date 2006.06.08.04.59.32; author DonovanSharp; state Exp;
|
|
branches;
|
|
next 1.1;
|
|
1.1
|
|
date 2006.06.05.04.07.54; author DonovanSharp; state Exp;
|
|
branches;
|
|
next ;
|
|
|
|
|
|
desc
|
|
@@
|
|
|
|
|
|
1.11
|
|
log
|
|
@@
|
|
text
|
|
@%META:TOPICINFO{author="DonovanSharp" date="1156902521" format="1.1" version="1.11"}%
|
|
%META:TOPICPARENT{name="SddContents"}%
|
|
---++SDD Part 0: Introduction and Primer to the SDD Standard
|
|
|
|
---+++3.12 Attaching Media to SDD Items
|
|
|
|
---++++3.12.1 Media resources in SDD.
|
|
|
|
|
|
The location of media in an SDD instance document is represented by a simple resource list. Media may include images (.jpeg, .png etc.), sound, video and web resources. SDD allows external references, embedded resource data, and provides for a multilingual caption.
|
|
|
|
Media items are defined within the <MediaObjects> element and simply referenced each time they are used elsewhere in an SDD instance document.
|
|
|
|
Simple SDD code for associated media has the basic structure shown below and in Example 3.12.1.1.
|
|
|
|
%ATTACHURL%/media.gif
|
|
|
|
---++++Example 3.12.1.1 - A simple SDD media dialog
|
|
|
|
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
|
|
|
|
<tr>
|
|
<td>
|
|
|
|
|
|
<verbatim>
|
|
<MediaObjects>
|
|
<MediaObject id="m1">
|
|
<Representation>
|
|
<Label>Image description, e. g., to be used for alt-attribute in html.</Label>
|
|
</Representation>
|
|
<Type>Text</Type>
|
|
<Data href="file:/Media/Html/Gleditsia_triacanthos.htm"/>
|
|
</MediaObject>
|
|
<MediaObject id="m2">
|
|
<Representation>
|
|
<Label>No caption</Label>
|
|
</Representation>
|
|
<Type>Image</Type>
|
|
<Data href="file:/Media/Images/Gleditsia triacanthos.jpg"/>
|
|
</MediaObject>
|
|
</MediaObjects>
|
|
</verbatim>
|
|
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
The location of locally stored media objects is defined relative to the SDD instance document.
|
|
|
|
The <Representation> element provides a label for the media object. This may be useful if the instance document includes multiple descriptions for different purposes, or is intended for publication in multiple languages (see the topic [[SddLanguage][Language support in SDD]].
|
|
|
|
<Owners> refers to a person, persons or institution defined in the SDD [[SddAgents][<Agents>]] element.
|
|
|
|
<IPRStatements> records the original source of media (for example the full citation for a publication). and any restrictions on useage. May contain URL to IPR statements external to the SDD instance document.
|
|
|
|
Media items are defined once and referenced for each useage. Multiple media items of different types may be referenced for an item.
|
|
|
|
---++++Example 3.12.1.2 - Referencing media
|
|
|
|
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
|
|
|
|
<tr>
|
|
<td>
|
|
|
|
|
|
<verbatim>
|
|
<Dataset>
|
|
|
|
<TaxonNames>
|
|
<TaxonName id="t1">
|
|
<Representation>
|
|
<Label>Gleditsia triacanthos</Label>
|
|
<MediaObject ref="m1"/>
|
|
<MediaObject ref="m2"/>
|
|
</Representation>
|
|
</TaxonName>
|
|
</TaxonNames>
|
|
<Characters>
|
|
<CategoricalCharacter id="c1">
|
|
<Representation>
|
|
<Label>Armature</Label>
|
|
</Representation>
|
|
<States>
|
|
<StateDefinition id="s1">
|
|
<Representation>
|
|
<Label>armed</Label>
|
|
<MediaObject ref="m3"/>
|
|
<MediaObject ref="m4"/>
|
|
</Representation>
|
|
</StateDefinition>
|
|
</States>
|
|
</CategoricalCharacter>
|
|
</Characters>
|
|
<MediaObjects>
|
|
... media dialog goes here
|
|
</MediaObjects>
|
|
|
|
</Dataset>
|
|
|
|
</verbatim>
|
|
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
Associated information may include captions, web addresses and translations. Media may be directly embedded in the SDD code instead of referenced with a URL.
|
|
|
|
---++++Example 3.12.1.3 - Associated information for embedded media
|
|
|
|
<table bgcolor="#ddddff" border="0" width="100%" cellpadding="5" cellspacing="5" style="border-collapse: collapse" bordercolor="#111111">
|
|
|
|
<tr>
|
|
<td>
|
|
|
|
|
|
<verbatim>
|
|
<MediaObjects>
|
|
<MediaObject id="m1" uri="urn:lsid:local:local:129739128">
|
|
<Representation>
|
|
<Label>Image description, e. g., to be used for alt-attribute in html.</Label>
|
|
</Representation>
|
|
<Owners>
|
|
<Agent ref="a1" role="own "/>
|
|
</Owners>
|
|
<Type>Image</Type>
|
|
<Data href="http://test.edu/test.jpg"/>
|
|
</MediaObject>
|
|
<MediaObject id="m2">
|
|
<Representation>
|
|
<Label>Morning call of Homo sapiens</Label>
|
|
</Representation>
|
|
<Type>Sound</Type>
|
|
<Data href="http://test.edu/123.mp3"/>
|
|
</MediaObject>
|
|
<MediaObject id="m3">
|
|
<Representation>
|
|
<Label>Melampsora evonymi-caprearum</Label>
|
|
<!-- Details like Caption are optional -->
|
|
<Detail role="Caption" xml:lang="fr"><i>Melampsora evonymi-caprearum</i> Kleb., stade II sur <i>Salix caprea</i>L.</Detail>
|
|
<Detail role="Caption" xml:lang="de"><i>Melampsora evonymi-caprearum</i> Kleb., Sporenstadium II auf <i>Salix caprea</i> L.</Detail>
|
|
<Detail role="Caption" xml:lang="en"><i>Melampsora evonymi-caprearum</i> Kleb., spore stage II on <i>Salix caprea</i> L.</Detail>
|
|
</Representation>
|
|
<Type>Image</Type>
|
|
<!-- Optionally Resources may be included rather than referencenced through URIs.
|
|
An additional href specifying the source of the encoded resource is optional (in addition to the encoded content) -->
|
|
<EncodedData ContentType="image/png" href="http://test.edu/Melampsora_evonymi-caprearum.png">R0lGODlhcgGSALMAAAQCAEMmCZtuMFQxDS8b</EncodedData>
|
|
</MediaObject>
|
|
</MediaObjects>
|
|
</verbatim>
|
|
|
|
</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
Available "roles" within the <Detail> element are; Abstract, Caption, Coverage, Description, Normative and <noautolink>UnknownDetailRole</noautolink>.
|
|
|
|
If resources are included within the SDD instance document they should be directly encoded, i.e. not wrapped into a MIME object first.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-- Main.DonovanSharp - 05 Jun 2006
|
|
|
|
%META:FILEATTACHMENT{name="media.gif" attachment="media.gif" attr="" comment="" date="1152497523" path="media.gif" size="17991" stream="media.gif" user="Main.DonovanSharp" version="2"}%
|
|
@
|
|
|
|
|
|
1.10
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1153794648" format="1.1" version="1.10"}%
|
|
d5 1
|
|
a5 1
|
|
---+++4.2 Attaching Media to SDD Items
|
|
d7 1
|
|
a7 1
|
|
---++++4.2.1 Media resources in SDD.
|
|
d14 1
|
|
a14 1
|
|
Simple SDD code for associated media has the basic structure shown below and in Example 4.2.1.1.
|
|
d18 1
|
|
a18 1
|
|
---++++Example 4.2.1.1 - A simple SDD media dialog
|
|
d60 1
|
|
a60 1
|
|
---++++Example 4.2.1.2 - Referencing media
|
|
d111 1
|
|
a111 1
|
|
---++++Example 4.2.1.3 - Associated information for embedded media
|
|
@
|
|
|
|
|
|
1.9
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1153183433" format="1.1" version="1.9"}%
|
|
d159 1
|
|
a159 1
|
|
Available "roles" within the <Detail> element are; Abstract, Caption, Coverage, Description, Normative and UnknownDetailRole.
|
|
@
|
|
|
|
|
|
1.8
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1152506603" format="1.1" reprev="1.8" version="1.8"}%
|
|
d5 1
|
|
a5 1
|
|
---+++4.2 Media in SDD
|
|
@
|
|
|
|
|
|
1.7
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1152497523" format="1.1" reprev="1.7" version="1.7"}%
|
|
d14 2
|
|
d30 1
|
|
a30 1
|
|
<Label>No caption</Label>
|
|
d50 8
|
|
d125 3
|
|
d147 2
|
|
a148 2
|
|
<!-- Optionally Resources may be included rather than referencens through URIs.
|
|
An additional href specifying the source of the encoded is optional (in addition to the encoded content) -->
|
|
d158 9
|
|
@
|
|
|
|
|
|
1.6
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1152165645" format="1.1" version="1.6"}%
|
|
d12 1
|
|
a12 1
|
|
%ATTACHURL%/media.jpg
|
|
d14 2
|
|
d148 1
|
|
a148 1
|
|
%META:FILEATTACHMENT{name="media.jpg" attachment="media.jpg" attr="" comment="" date="1151477694" path="media.jpg" size="34150" stream="media.jpg" user="Main.DonovanSharp" version="2"}%
|
|
@
|
|
|
|
|
|
1.5
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1151978543" format="1.1" reprev="1.5" version="1.5"}%
|
|
d16 6
|
|
a21 1
|
|
|
|
d41 2
|
|
a42 1
|
|
|
|
d44 2
|
|
d50 6
|
|
a55 1
|
|
|
|
d92 2
|
|
a93 1
|
|
|
|
d95 2
|
|
d101 6
|
|
a106 1
|
|
|
|
d139 4
|
|
@
|
|
|
|
|
|
1.4
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1151477695" format="1.1" version="1.4"}%
|
|
d5 1
|
|
a5 1
|
|
---+++3.6 Media in SDD
|
|
d7 1
|
|
a7 1
|
|
---++++3.6.1 Media resources in SDD.
|
|
d14 1
|
|
a14 1
|
|
---++++Example 3.3.1 - A simple SDD media dialog
|
|
d38 1
|
|
a38 1
|
|
Media items are referenced for each useage
|
|
d40 1
|
|
a40 1
|
|
---++++Example 3.3.1 - Referencing media
|
|
d81 1
|
|
a81 1
|
|
Associated information may include captions, web addresses and translations.
|
|
d83 1
|
|
a83 1
|
|
---++++Example 3.3.1 - Associated information for embedded media
|
|
@
|
|
|
|
|
|
1.3
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1149832182" format="1.1" reprev="1.3" version="1.3"}%
|
|
d121 1
|
|
a121 1
|
|
%META:FILEATTACHMENT{name="media.jpg" attachment="media.jpg" attr="" comment="" date="1149742771" path="media.jpg" size="12431" stream="media.jpg" user="Main.DonovanSharp" version="1"}%
|
|
@
|
|
|
|
|
|
1.2
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1149742772" format="1.1" reprev="1.2" version="1.2"}%
|
|
d7 1
|
|
a7 1
|
|
---++++3.6.1 Madia resources in SDD.
|
|
d10 1
|
|
a10 1
|
|
The location of media in an SDD instance document is represented by a simple resource list. Media may include images (.jpeg, .png etc.), sound, video and web resources, both local and external.
|
|
@
|
|
|
|
|
|
1.1
|
|
log
|
|
@@
|
|
text
|
|
@d1 1
|
|
a1 1
|
|
%META:TOPICINFO{author="DonovanSharp" date="1149480474" format="1.1" version="1.1"}%
|
|
a2 1
|
|
d12 2
|
|
d21 1
|
|
a21 1
|
|
<Label xml:lang="en-us">No caption</Label>
|
|
d28 1
|
|
a28 1
|
|
<Label xml:lang="en-us">No caption</Label>
|
|
d44 1
|
|
a44 1
|
|
<Dataset xml:lang="en-us">
|
|
d49 1
|
|
a49 1
|
|
<Label xml:lang="en-us">Gleditsia triacanthos</Label>
|
|
d58 1
|
|
a58 1
|
|
<Label xml:lang="en-us">Armature</Label>
|
|
d63 1
|
|
a63 1
|
|
<Label xml:lang="en-us">armed</Label>
|
|
d120 3
|
|
@
|
|
|