The following examples apply to the use of related, link and externallink elements.
Links within a document use the link element. See the Special Topic on Prefixes for ID values for the correct prefixes to use in ID numbering. Example of links within the same document are:
| Link type | Sample code | |
|---|---|---|
| Figure link | See <link rid="f1">figure 1</link> | |
| Table link | See <link rid="t1">table 1</link> | |
| Link to a range of figures | See <link rid="f1 f2 f3 f4 f5">figures 1-5</link> | |
| Link to a heading | See <link rid="h5">Materials and Methods</link>
| |
| Harvard reference link | As shown by <link rid="b7">Smith & Anderson</link> | |
| Link to a range of Harvard references | involves members of the mitogen-activated protein kinase (MAPK) family (<link rid="b1 b2">Kyriakis & Avruch, 1996a,b</link>) | |
| Vancouver reference link | (TH)-1-mediated immune response [<link rid="b1">1</link>], natural killer (NK) activity | |
| Link to a range of Vancouver references | transcriptional activation of the IFN-β promoter [<link rid="b27 b28 b29">27–29</link>]. | |
| Author/Affiliation link | <name type="author"><forenames>Richard</forenames><x> </x><surname>Blouin</surname><link rid="a2">*</link></name> | |
| A link to an editorial/production query in a file | originally identified as a transcriptional repressor [<link rid="b19 b20 b21">19–21</link>]<link rid="q1"></link>
|
In this issue links occur in journals where one article refers to another article in the same issue. Where this occurs, it should be tagged as follows:
In this issue (p. <related relationship="sibling" type="sameissue"><externallink type="inthisissuefirstpage" id="117">117</externallink></related>), Frazer-Andrews <i>et al</i>. from the St. John’s Institute of Dermatology in London, used PCR-based analysis of TCR gamma gene rearrrangements to demonstrate ...
A link from one chapter to another should be marked up like this:
Details of cleaning and disinfection are given in <related relationship="sibling" type="samework"><externallink id="10003420_chapter_3.xml" type="file">Chapter 3</externallink></related>.
A link to a specific heading in another chapter should be marked up like this:
For further information, see <related relationship="sibling" type="samework"><externallink id="10003420_chapter_9.xml#h11" type="file">Caveat on mannitol bowel preparation</externallink></related> in chapter 9.
... where the number following the # is the ID number of the heading element in Chapter nine.
A link to a figure in another chapter should be marked up like this:
<related relationship="sibling_object" type="samework"><externallink id="10004933_chapter_2.xml#2.1" type="file"></related>
... where the number following the # is the ID number of the object element in Chapter two.
Reference links (e.g. to PubMed, CrossRef, etc) should be encoded in the XML file as follows:
... <externallink type="doi" id="10.1046/j.1432-1327.2000.01617.x"></externallink> <externallink type="pubmed" id="11012666"></externallink> </reference>
The sequence in which the externallink elements appear within reference is not significant.
HTML links are generated for externallink values as follows:
| type attribute value | Sample XML | Sample HTML |
|---|---|---|
| pubmed | <externallink type="pubmed" id="11012666"></externallink> | <a href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?cmd=Retrieve&db=PubMed&list_uids=11012666&dopt=Abstract">[PubMed link]</a> |
| doi | <externallink type="doi" id="10.1046/j.1432-1327.2000.01617.x"></externallink> | <a href="http://dx.doi.org/10.1046/j.1432-1327.2000.01617.x">[DOI link]</a> |
| ads | <externallink type="ads" id="2001MNRAS.320....1G"></externallink> | <a href="http://adsabs.harvard.edu/cgi-bin/nph-bib_query?bibcode=2001MNRAS.320....1G&db_key=AST">[ADS link]</a> |
| isi | <externallink type="isi" id="000077370100005"></externallink> |
Links (or potential links) out of documents to other web-based resources. These links are defined using externallink's type attribute. The allowable values for the externallink@type attribute are:
| Value | Explanation | Sample XML | Resulting HTML | |
|---|---|---|---|---|
ads | Astrophysics Data System bibcode | [See 'Reference links' above] | - | |
astro-ph | e-Print Astrophysics archive | <externallink type="astro-ph">astro-ph/0110344</externallink> | <a href="http://arXiv.org/abs/astro-ph/0110344">astro-ph/0110344</a> | |
company | company name | <p>The design was that of an open label treatment study of the administration of rhGH (Genotropin®, <externallink type="company">Pharmacia Corporation</externallink>, Stockholm, Sweden) over 44–72 months (median 58)...</p> | <p>The design was that of an open label treatment study of the administration of rhGH (Genotropin®, <a href="http://www.pharmacia.com">Pharmacia Corporation</a>, Stockholm, Sweden) over 44-72 months (median 58)...</p> | |
doi | Digital Object Identifier | [See 'Reference links' above] | - | |
drug_brand | Drug Brand name | <p><externallink type="drug_generic">Sildenafil</externallink> (<externallink type="drug_brand">Viagra</externallink>™), a potent and selective inhibitor of type 5 cGMP phosphodiesterase with utility for the treatment of male erectile dysfunction</p> | ||
drug_generic | Generic drug name | [See 'drug_brand' above] | ||
ec | EC numbers | |||
email | email address | <correspondent id="c1"><i>Correspondence to</i> C.-H. Yang, Seoul University, Seoul 262-742, Korea. Fax: + 82 1 787 7656, E-mail: <externallink type="email">chyang@snu.ac.kr</externallink></correspondent> | <p><i>Correspondence to</i> C.-H. Yang, Seoul University, Seoul 262-742, Korea. Fax: + 82 1 787 7656, E-mail: <a href="mailto:chyang@snu.ac.kr">chyang@snu.ac.kr</a></p> | |
file | A link to another XML document | |||
genbank | GenBank accesion number | <p>... has been registered in Genbank under accession number <externallink type="genbank">AJ276474</externallink>.</p> | <p>... has been registered in Genbank under accession number <a href="http://www.ncbi.nlm.nih.gov/htbin-post/Entrez/query?db=s&form=6&uid=AJ276474&Dopt=g">AJ276474</a>.</p> | |
gridref | A National Grid Reference | were obtained from the following sites: the River Coln, Gloucestershire (NGR: <externallink type="gridref" id="sp087105">SP087105</externallink>) | were obtained from the following sites: the River Coln, Gloucestershire (NGR: <a href="http://www.streetmap.co.uk/streetmap.dll?MfcISAPICommand=Search&name=sp087105&type=LRGrid">SP087105</a>) | |
inthisissuefirstpage | An 'In this issue' link. Value is the first page number of the article being linked to. | <p>In this issue, the findings reported by Rappl <i>et al</i>. (p. <externallink type="url" id="http://www.blackwell-synergy.com/rd.asp?code=jid&vol=116&page=102&goto=abstract">102</externallink>) add to the growing evidence that ... | <p>In this issue, the findings reported by Rappl <i>et al</i>. (p. <a href="http://www.blackwell-synergy.com/rd.asp?code=jid&vol=116&page=102&goto=abstract">102</a>) add to the growing evidence that ... | |
isi | ISI record number | |||
mmdb | NCBI Molecular Modelling Database | |||
pdb | Brookhaven Protein Databank | |||
pirdb | NCBI Protein Database | |||
pubmed | PubMed identifier | [See 'Reference links' above] | - | |
sprot | Swiss-Protein Database | |||
supplementarymaterial | supplementary material | |||
synergyresolver | Synergy resolver URL | |||
url | A URL | <p>... you may want to reach NLM's homepage at <externallink type="url">http://www.nlm.nih.gov</externallink>, which also...</p> | <p>... you may want to reach NLM's homepage at <a href="http://www.nlm.nih.gov">http://www.nlm.nih.gov</a>, which also... | |
|