Documentation for version 0.32 of bmc dtd

 

tag

is found in these tags

can contain these tags

can contain these attributes

notes on usage

examples

a

cpyrt date %fdata

%fdata

href

anchor - used as a normal html anchor tag (a href=…)
Note:
see also URL tag below, which is generally the preferred method of indicating web links

 

abbr

p abbrgrp

 %fdata

bid

bibliographic reference - used in text for crossreferencing to a specific bibl within a refgrp, identified by bid=”#”, where # is the bibl id.
Note:

When <abbr>s are used without being enclosed in an <abbrgrp> tag, any necessary bracketing/punctuation must be part of the XML.

E.g. the example on the right, which is rendered as [1,2,3,4,8]

[<abbr bid="B1">1</abbr>, <abbr bid="B2">2</abbr>, <abbr bid="B3">3</abbr>, <abbr bid="B4">4</abbr>, <abbr bid="B8">8</abbr>]

abbrgrp

p note

abbr

 

bibliographic reference group - this newly introduced tag is used to group a set of associated <abbr> tags, so as to allow  the renderer to automatically punctuate and display the list.
Note:

The use of <abbrgrp> is now strongly encouraged. <abbr>s outside of <abbrgrp>s are supported only for backwards compatibility with old data.

E.g.The example <abbrgrp> given on the right would be rendered as: [1-4,8]  (if the renderer is capable of this, or can alternately be rendered more simply as [1,2,3,4,8] using a simpler rendering logic.

<abbrgrp><abbr bid="B1">1</abbr><abbr bid="B2">2</abbr><abbr bid="B3">3</abbr><abbr bid="B4">4</abbr><abbr bid="B8">8</abbr></abbrgrp>

abs

fm

sec

 

abstract - to code for an abstract at the start of  an article

<abs>

….

…</abs>

acc

history

date

 

accepted - date article was accepted for publication

<acc>….

….

</acc>

ack

bm

sec

 

acknowledgement - authors acknowledgements at end of article before references

 

aff

p

 

id

-[reserved for internal use]

not currently used, but  reserved  a tag reserved for identifying companies mentioned within the text, and tying them to a standard identifier.


 

art

 

ui ji fm meta bdy bm

 

article - top level tag around entire article

<art>… …

</art

au

aug

snm mi fnm cnm insr email

id ca ce pa da type

author – id=”A1”,”A2”…etc ca=”yes” for corresponding author

ce=”yes” if author contributed equally

pa=”yes” for presenting author (of meeting abstracts)

da=”yes” to indicate author deceased

type=”on_behalf” to indicate an author (group) who has been written on behalf of

<au id="A1" ca="yes" ce="yes" pa=”yes” da=”yes” type=”on_behalf”>

…

</au>

aug

bibl

au etal

 

author group – contains authors in bibls

<aug>

…

…</aug>

b

kwd a note p sup sub smcaps b it %fdata

%fdata

 

bold - bold tag

 

bdy

art

sec

 

body - contains body of article

<bdy>… … </bdy>

bibl

fm bibl refgrp sec

title aug insg source publisher editor edition series supplement conference section issn isbn pubdate volume issue fpage lpage url inpress note xrefbib bibl

id, rating

bibliographic item - contains bibliographic information in the header and references.

id=”B1” for first reference “B2”,”B3” etc…

rating=”1” for one star

rating=”2” for two stars

<bibl id="B1" rating="2" >

…

…

</bibl>

bm

art

ack refgrp sec

 

backmatter - contains backmatter of article

<bm>

…

</bm>

c

r

hr p

cspan, rspan, indent, width, ca

cell – cell of table. cspan=”2” for spanning 2 columns

rspan=”2” for spanning 2 rows indent=”1” for a single indent

ca=”left” to align text to the left of cell (can use left/right/top/center/bottom)

<c ca="left" cspan="2" rspan=”2” >

 

caption

tbl fig suppl

p

 

caption – descriptive text to go below figure/table/supplement thumbnail/sidebar link

<caption><p>…

</p></caption>

classification

classifications

 

type, subtype, id

classification – generic tag for marking up classifications for the article. This provides useful metadata for browsing / searching / categorization.

 

<classifications>

<classification type="BMC" subtype="man_spc_id" id="1001">Biochemistry</classification> 

</classifications>

 

See separate document for more details

classifications

meta

classification

 

classifications – contains <classification>s

 

cnm

au

 it

 

collective name - tag to be used in place of fnm,mi,snm for groups of authors

<cnm><it>Drosophila</it> Research Group</cnm>

collab

cpyrt

 

 

collaboration - the copright holder(s)

<collab>Smith on behalf of BioMed Central Ltd.</collab>

conference

bibl

title location date-range url

 

conference – contains information about conference

<conference><title><p>22nd European Workshop for Rheumatology Research</p></title><location>Vienna, Austria</location><date-range>1-4 March 2002</date-range><url>http://www.conference-url.org</url></conference>

cpyrt

fm

year collab note

 

copyright - contais copyright information

<cpyrt><year>…</year><collab>…</collab><note>…</note></cpyrt>

date

rec revreq revrec acc pub

day month year

 

date - contains date information

<date><day>…</day><month>…</month><year>…</year>

date-range

conference

 

 

Date range -  for non-structured date or date-range data

<date-range>1-4 March 2002</date-range>

day

date

 

 

day - the numeric day of the month

 

dochead

fm

 

 

document header - the article type

<dochead>Primary research</dochead>

edition

bibl

 

 

edition – edition of book

 

editor

bibl series

 

 

editor – editor of book series

 

email

au

 

 

email  - email address for author

<email>tom.mowlam@current-science.com</email>

etal

aug

 

 

et al - for inserting et al into reference

<etal/>

fig

sec

title caption text graphic

id

figure - contains figure

 

figr

p

figr

fid

figure reference – links to a figure

<figr fid="F1">1</figr>

file

suppl

p

name

file - file name should be <ui>-s1 and include extension

<file name=”bcr-1-1-001-s1.doc”>click here for word file</file>

fm

art

dochead bibl history cpyrt shorttitle shortabs kwdg abs

 

frontmatter – contains article frontmatter

 

fn

sec

p

id

footnote – for footnotes to a section of the article

 

fnm

au

 

 

first name – all initials and names up to and including the firstname

<fnm>AB Johan</fnm>

fpage

bibl

 

 

first page – firstpage of article

 

graphic

sec p fig

 

file, hint_layout, hint_detail

graphic –  include extension when outside <fig> tag – ie for inline graphics

hint_layout – hint for PDF layout: single (single column), double (double column), landscape (landscape orientation)

hint_detail – ‘high’ if there is a high resolution image available.

<graphic file=”bcr-2-1-001-1/>

inline graphic:

<graphic file=”bcr-2-1-001-i1.gif/>

history

fm

rec revreq revrec acc pub

 

history – contains review and publication dates

 

html

sec

 

 

HTML – for HTML islands within the XML… designed only to be used for conversion of body-data from old HTML articles into the BMC XML format

 

hr

c

 

 

horizontal rule – for lines in tables

<c cspan=”3”><hr/></c> would be a line spanning 3 columns

inpress

bibl

 

 

in press – to indicate an article without a page.

may not use <inpress/> alongside <volume><issue><fpage><lpage> tags in the <bibl> in <fm>

<inpress/>

ins

insg

p

id

institute – address details of institute

<ins id="I1" > <p>Biomed Central, London, UK.</p> </ins>

 

insg

bibl

ins

 

institute group – contains institutes

<insg><ins id=”I1”>…</ins>

<ins id=”I2”>…</ins></insg>

insr

au

 

iid

institute reference – author affiliation, authors can have multiple <insr>

…<snm>Smith</snm><insr iid=”I1”/><insr iid=”I3”/>

isbn

bibl

 

 

International Standard Book Number – for use in place of <issn> in the case of books

 

issn

bibl

 

 

International Standard Serial Number – only used in <fm><bibl>.

each journal has 8 figure issn, seperated by hyphen

<issn>1471-2202</issn>

issue

bibl

 

 

issue – the article’s issue. bmc articles are always issue 1

<issue>1</issue>

it

kwd a note p sup sub smcaps b it %fdata

%fdata

 

italics – tag to italicise text

 

ji

art

 

 

journal identifier – unique id for journal

<ji>ARJ</ji>

kwd

kwdg

%fdata

 

Keyword – contains keyword, do not need <p>

 

kwdg

fm

kwd

 

Keyword group – contains keyword tags

 

lpage

bibl

 

 

lastpage - the full last page; ie including all digits

<fpage>205</fpage><lpage>206</lpage>

meta

art

classifications

 

metadata – markup various forms of metadata

 

mi

au

 

 

middle initial – middle initial(s) of author – do not include full stop after initial – cannot contain lowercase letters

<fnm>Tom</fnm><mi>D</mi><snm>...

mnm

au

 

 

middlename – middlename of author – must contain at least one lowercase letter

<fnm>Tom</fnm><mnm>Drake</mnm><snm>…..

monospace

p

 

 

monospace – for text which needs to be displayed in a non-proportional font (eg courier)

<monospace>AACTGA..A</monospace>

month

date

 

 

month – numeric month

 <month>3</month>

note

bibl

%fdata abbrgrp

 

note – text to accompany bibliography. does not require <p>… when in ‘cpyrt’ – contains Open Access information

 

p

sec st title ins fn c tblfn caption text file monospace xrefart xfigr xtblr xsupplr

%fdata aff abbr abbrgrp tblr figr supplr graphic

 

paragraph – contains displayed text in <bdy>.

in <sec> will put text on a new line and with a space from the previous <p>

 

pub

history

date

 

published - contains the date of publication

 

pubdate

bibl

 

 

published date – 4 digit year of publication

 

pubid

xrefbib pubidlist

 

idtype,

link

publisher id – the unique id of an article in an external database (database determined by ‘idtype’), the ‘link’ attribute determines whether a (pubmed) link is to fulltext.

<pubid idtype="pmpid" link="fulltext">9521318</pubid> 

pubidlist

xrefbib

pubid

 

publisher id list – allows for a list  (group) of  publisher ids in the xrefbib

<pubidlist>

<pubid idtype="pmpid">12464159</pubid>

<pubid idtype="doi">10.1186/1472-6793-2-18</pubid>

</pubidlist>

 

publisher

bibl

 

 

Publisher – publisher of book

 

r

tblbdy

c

ra

row – used in tables, ra (row align) can be “top or “bottom”

 

rec

history

date

 

received - contains the date of article receipt

 

refgrp

bm

bibl title

 

reference group – contains the reference list at the end of an article (which consists of <bibls>

 

revrec

history

date

 

revisions received - contains the date article revisions were received

 

revreq

history

date

 

revisions requested - contains the date article revisions were requested

 

sec

bdy bm shortabs abs sec ack

st p sec tbl fig suppl fn graphic html

num

section – identifies a new section of text num= allows the numbering of a section

 

section

bibl

title editor

 

issue section – for describing which issue section an article is a part of

 

series

bibl

title editor

 

series -  title of a book series

 

shortabs

fm

p

 

short abstract – an alternative to the long abstract, for use on browse pages, email alerts etc

 

shorttitle

fm

p

 

short title – an alternative to the long title, for use on browse pages, email alerts etc

 

smcaps

kwd a note p sup sub smcaps b it %fdata

%fdata

 

small capitals – used to make small capital letters (prob does not render yet!)

 

snm

au

 

 

surname – author last name

 

source

bibl

 

 

source – source of article (ie Journal name, book name)

 

sponsor

supplement

note

 

sponsor – contains information about sponsor

<sponsor><note>Funded by an unrestricted educational grant from Abbot Immunology</note></sponsor>

st

sec

p

 

section title – title nust be in <p>. Section titles will be rendered differently depending on how nested the sections are (and depending on the renderer), but generally:

1st nesting: - Bold and large

2nd nesting – Bold and smaller

3rd nesting – Italics and same size as main text

 

sub

kwd a note p sup sub smcaps b it %fdata

%fdata

 

subscript

O<sub>2</sub>

suf

au

 

 

suffix – Do not include honorific titles ( egPhd, MD)

<fnm>Edwin</fnm><snm>Hector</snm><suf>Jnr</suf>

sup

kwd a note p sup sub smcaps b it %fdata

%fdata

 

superscript

2 x 10<sup>-5</sup>

suppl

Sec

title caption text file

id

supplementary  - contains supplementary material

<suppl id="S1" >

...

...

 </suppl>

 

supplement

bibl

title

 

supplement – contains information about supplement

<supplement>

<title><p>The Scientific Basis of Rheumatology</p></title>

<editor>Mark Feldman, Hideake Nagase, Jeremy Saklatvala, Mark Walport</editor>

<sponsor><note>Funded by an unrestricted educational grant from Abbot Immunology</note></sponsor>

<note>Proceedings of a round table meeting</note>

supplr

P

 %fdata

sid

supplementary reference – a reference from within the text to a supplementary file

<p> See accompanying <supplr sid="S1" >video</supplr> for more info. </p>

tbl

sec

title caption tblbdy tblfn

id

hint_layout

table – contains table. should be inserted into XML after the paragraph where the table is first referenced

 <tbl id=”T1” hint_layout=”double”>

tblbdy

tbl

r

ra, ca, cols

table body – contains the data presented

 

tblfn

tbl

p

 

table footnote – is the tex t below the table

 

tblr

p

 

tid

table reference – for referering from text to table (eg: see <tblr tid=”T1”>Table 1</tblr>…)

 

text

fig suppl

p

 

text – text to go below supplementary file link, or to go below full size figure

 

title

bibl series tbl fg suppl refgrp

p

 

title – title of paper (when in <bibl>), series, table, figure, supplementary file, title of reference section (when in <refgrp>)

 

ui

art

 

 

unique id – of the article

 

ul

%fdata

 

 

underline – to indicate underlined text

 

url

bibl kwd a note p sup sub smcaps b it %fdata

 

 

url – the preferred method of tagging urls, the url will be rendered as a link

<url>http://www.diomedcentral.com</url>

volume

bibl

 

 

volume – volume of artilcle

<volume>2</volume>

xfigr

p

%fdata

art,

fid

External figure reference – for referencing figures in other articles – designed for use within the BMC database

see <xfigr art=”1471-2121-3-1” fid=”F1”>figure in other paper</xfigr>

xtblr

p

%fdata

art,

tib

External table reference – for referencing tables in other articles – designed for use within the BMC database

see <xtblr art=”1471-2121-3-1” tid=”T1”>table in other paper</xtblr>

xsupplr

p

%fdata

art,

sid

External supplementary file reference – for referencing supplementary files in other articles – designed for use within the BMC database

see <xsupplr art=”1471-2121-3-1” sid=”S1”>supplementary file in other paper</xsupplr>

xrefart

p

%fdata

art

external article reference – for referencing other articles – designed for use within the BMC database

see <xrefart art=”1471-2121-3-1”>other paper</xrefart>

xrefbib

bibl

pubid publist

 

bibliographic cross reference

<xrefbib>

<pubid>10213783</pubid>

</xrefbib>

year

cpyrt date

 

 

year - full 4-digit year

<year>2001</year>

%fdata

 

#PCDATA it b sub sup smcaps url a

 

%fdata – is shorthand for: #PCDATA it b sub sup smcaps url a