Microformats Wiki - User contributions [en]

species

2008-03-05T17:14:39Z

PeterR: /* Examples in the wild */

=Species=

:'''For the latest ideas, and to make comments, please see [[species-brainstorming]].'''

:'''Note: the original name of the proposed microformat, "species", is likely to change, probably to "biota" or "taxon". The former has been retained here, to avoid having to make many repetitive and perhaps redundant edits'''

:'''{{UpdateMarker}} The new [http://www.kaply.com/weblog/2007/02/16/operator-07a-is-available/ beta of Operator] detects ''Species''. [http://www.westmidlandbirdclub.com/records/lists-2004uf.htm A test page is available]. Work on both continues!'''

==Introduction==

People use the vernacular AND taxonomic names of species in everyday speech and writing - just read or watch any populist gardening magazine or television programme.

*Consider this list: "'''Blackbird'''", "'''poodle'''", "'''T Rex'''", "'''potato'''", "'''French Marigold'''", "'''Wisteria'''", "'''E. Coli'''", "'''HIV'''", "'''Rubella'''" and "'''human being'''".

:"'''T Rex'''" is "''Tyrannosaurus rex''"; "'''E. Coli'''" is "''Escherichia coli''"; "'''HIV'''" is "''Human immunodeficiency virus''" and "'''Rubella'''" is "''Rubella virus''". All are the taxonomic (or scientific) names of unique species.

:"'''''Wisteria'''''" is a taxonomic genus.

:"'''Blackbird'''"; "'''poodle'''"; "'''potato'''"; "'''French Marigold'''" and "'''human being'''" (arguments about Neanderthals not withstanding) are vernacular (or common) names, but still refer to individual species.

*The scientific naming of organisms is a part of [http://www.calacademy.org/research/informatics/sblum/pub/biodiv_informatics.html biodiversity informatics] - "the application of information technology to the domain of biodiversity".

*The proposal aligns with [http://www.ted.com/tedprize/2007/wilson.cfm E.O Wilson's wish]:

<blockquote>...that we will work together to help create the key tool that we need to inspire preservation of Earth's biodiversity: the Encyclopedia of Life [...] an encyclopedia that lives on the Internet, with an ever-evolving page for every species [and which]
does not duplicate existing efforts, but instead incorporates them through linking [with a] search technology that can aggregate existing biological information and make it easily accessible.</blockquote>

*As long ago as April 1998 on [http://www.w3.org/MarkUp/future/papers/rothenburg-19980412.html Robert Rothenburg's paper on Dictionaries] (''Note 4'') said:

<blockquote>What is missing [from HTML] is an element for marking up "proper names" (names of people, geographic locations, institutions, or even '''scientific names such as genus/species''').</blockquote>

:It's interesting that microformats have given us the first three missing items - and we're now debating the fourth!

==Proposal==
Imagine viewing a web page with a reference to a species - and being able to use an add-on to you browser to be taken directly to information about that species, on, say, Wikipedia, or Wikispecies, or Google Images, or another site, such as in an academic database, of your choosing.

Your software would automatically know to search site A if the scientific name referred to a moth, site B for a bird, and site C for a plant - and you could set your preferences as to which sites those were to be, and in which order two or more were to be searched (e.g. for moths, try [http://ukmoths.org.uk/ UK Moths] first, if not found try [http://www.nhm.ac.uk/research-curation/projects/lepindex/index.html The Global Lepidoptera Names Index]).

Or supposing someone writes a long, chronologically-ordered web page about all the birds, insects, mammals and plants they saw on a wildlife safari, with lots of prose description about the paces where they saw them and the people they were with, but you want to extract a list of species, sorted into alphabetical order within taxonomic class (birds first, then insects then...) or in taxonomic order.

Those are just two of the things a "species" microformat might do for you.

Your software, or a search engine, would be able to differentiate between a pages discussing HMS Beagle, the ship, and a Beagle dog; or birds that fly as opposed to a slang term for women.

Another benefit would be that user-agents could be instructed to treat text marked up in this way as not being in the base language of the document or element in which they occur - pronunciation should be as for Latin, they should not be translated (e.g. where a component word happens also to be a valid word in that language, such as the genus '''''Colon''''', '''''Circus''' cyaneus'', ''Hesperia '''comma''''', or anything with ''major'' or ''minor'' on an English-language page) and should not be spell-checked, or be spell-checked with a specialised dictionary (a need identified in this [http://www.alvestrand.no/pipermail/ietf-languages/2003-February/000590.html 2003 ietf-languages discussion of language values for taxonomic names]).

A further benefit the species microformat would bring is in the enriching and enhancement of species checklists, which are commonly found on the web. Broadly speaking, a species checklist is a list of taxa, usually for a particular group of similar organisms such as birds or vascular plants, found within a particular geographical region (a country, [http://www.westmidlandbirdclub.com/records/lists.htm a region], a county, or a specific site, large or small). A typical example of a species checklist is the [http://www.coleopterist.org.uk/checklist.htm Checklist of Beetles of the British Isles] which, as the name suggests, lists beetles known to be found within the British Isles. A [http://www.google.com/search?q=species+checklist Google Search for "species checklist"] will reveal many other such examples. Species checklists are presented in a broadly consistent manner but are usually unable to be parsed and utilised by computers due to the lack of a common standard for marking them up in HTML. The species microformat would provide that common standard. A fully microformat enabled checklist would be parsable by computers and thus would provide developers with a means by which to aggregate and otherwise make use of this invaluable content beyond the current, rather limited, use of simple online viewing.

A specific example of checklist use might be in enabling [http://www.aditsite.co.uk/html/choosing_recording_software.html biological recording software] to parse and aggregate checklists in order to include them in their own species dictionaries. Typically there are waits of many months or even years while humans collate checklist changes manually for inclusion in recording software; automated checklist parsing and aggregation would greatly expedite and increase the efficiencies of this process.

==Existing taxonomies==
The proposal respects all existing biological taxonomies, and is not intended to change or supplant any of them - it is intended merely to provide webmasters (from personal hobby sites to major academic databases; from news outlets to retail organisations) with a method of either:

# marking-up a taxonomical name (or taxon-common name pair) in such a way that its components can be recognised by computers '''or'''
# marking up a common name, so as to associate with it a taxonomical name, in such a way that the latter's components can be recognised by computers.

==Embedding within other microformats==
The proposed [[plant]] microformat (with care regime, supplier, etc.), [[hlisting]], [[recipe]] or [[hReview]] (and possibly others) could contain a scientific name microformat, in the same way that an [[hCalendar]] can contain an [[hCard]].

See also: [[species-brainstorming#Future development]]

==References==

====General taxonomy====
* [http://en.wikipedia.org/wiki/Scientific_classification Wikipedia: Scientific classification]
**[http://en.wikipedia.org/wiki/Binomial_nomenclature Wikipedia: Binomial nomenclature]
**[http://en.wikipedia.org/wiki/Binomen Wikipedia: Binomen]
**[http://en.wikipedia.org/wiki/Trinomial_nomenclature Wikipedia: Trinomial nomenclature]
**[http://en.wikipedia.org/wiki/Trinomen Wikipedia: Trinomen]
**[http://en.wikipedia.org/wiki/Taxon Wikipedia: Taxon]
**[http://en.wikipedia.org/wiki/Rank_%28zoology%29 Wikipedia: Rank (zoology)]
**[http://en.wikipedia.org/wiki/Rank_%28botany%29 Wikipedia: Rank (botany)]
**[http://en.wikipedia.org/wiki/Cultivar Wikipedia: Cultivars]
**[http://en.wikipedia.org/wiki/Variety_%28biology%29 Wikipedia: Varieties]
**[http://en.wikipedia.org/wiki/Subvariety Wikipedia: Sub-varieties]
**[http://en.wikipedia.org/wiki/Form_%28botany%29 Wikipedia: forms]
**[http://en.wikipedia.org/wiki/Synonym_%28taxonomy%29 Wikipedia: Synonyms]
**[http://en.wikipedia.org/wiki/Wikipedia:How_to_read_a_taxobox How to read a taxobox]

====Taxonomic codes====
* [http://en.wikipedia.org/wiki/Nomenclature_Codes Wikipedia: Nomenclature Codes]
* [http://www.iczn.org/ http://www.iczn.org/ International Commission on Zoological Nomenclature] (ICZN)
** [http://en.wikipedia.org/wiki/International_Code_of_Zoological_Nomenclature Wikipedia: International Code of Zoological Nomenclature]
**[http://en.wikipedia.org/wiki/International_Commission_on_Zoological_Nomenclature Wikipedia: International Commission on Zoological Nomenclature]
* [http://ibot.sav.sk/icbn/main.htm International Code of Botanical Nomenclature] (ICBN)
** [http://en.wikipedia.org/wiki/International_Code_of_Botanical_Nomenclature Wikipedia: International Code of Botanical Nomenclature]
* [http://www.the-icsp.org/ International Committee on Systematics of Prokaryotes] (ICSP)
**[http://en.wikipedia.org/wiki/International_Code_of_Nomenclature_of_Bacteria Wikipedia: International Code of Nomenclature of Bacteria] (ICNB)
* [http://www.ictvonline.org/ International Committee on Taxonomy of Viruses]
**[http://en.wikipedia.org/wiki/International_Committee_on_Taxonomy_of_Viruses Wikipedia: International Committee on Taxonomy of Viruses]

====Other references====

*[http://www.rhs.org.uk/rhsplantfinder/plantnaming.asp RHS Plant Finder: The naming of plants]
*[http://www.ishs.org/sci/icracpco.htm International Code of Nomenclature for Cultivated Plants]
*[http://www.tdwg.org/index.html Taxonomic Databases Working Group]
*[http://www.hortax.org.uk/ Hortax] - The Names of Garden Plants
*[http://www.bgbm.fu-berlin.de/iapt/nomenclature/code/SaintLouis/0000St.Luistitle.htm www.bgbm.fu-berlin.de/iapt/nomenclature/code/SaintLouis/0000St.Luistitle.htm]
*[http://species.wikimedia.org/wiki/Main_Page WikiSpecies]
*[http://en.wiktionary.org/wiki/taxonomy Wiktionary: Taxonomy]
*[http://jbi.nhm.ku.edu/index.php/jbi/article/view/25 Biodiversity Informatics: Taxonomic names, metadata, and the Semantic Web]
*[http://en.wikipedia.org/wiki/Virus_classification Wikipedia: Virus classification]

==Contributors & Supporters==
*[[User:AndyMabbett|Andy Mabbett]] (proponent)
*[[User:RogerHyam|Roger Hyam]] (interested party?)
*[[User:SXBRC|Charles Roper]], [http://www.sxbrc.org.uk/ Sussex Biodiversity Record Centre] (proponent)
*[[User:SteveMcBill|Steve McWilliam]], [http://www.rECOrd-LRC.co.uk/ rECOrd - The Biodiversity Information System for the Cheshire region] (supporter)
*[[User:KierenPitts|Kieren Pitts]], [http://www.ilrt.bris.ac.uk/ ILRT - Institute for Learning and Research Technology] and the [http://www.amentsoc.org/ Amateur Entomologists' Society] (supporter)
*[[User:CyndyParr|Cyndy Parr]], [http://spire.umbc.edu Spire project] (interested party)
*[[User:AnimalDiversity|Animal Diversity Web]], [http://animaldiversity.org] (interested party)
*[[User:Christoph|Christoph Champ]], [http://www.christophchamp.com/] (supporter with a background in biochemistry, biophysics, and bioinformatics)
*[[User:David Stang|David Stang]], [http://ZipcodeZoo.com] (interested party)

==See also==
Here's some work-in-progress:
{{species}}
*[https://addons.mozilla.org/firefox/169/ Biobar] - A customisable Firefox Extension providing a toolbar and content menu options for browsing biological data and databases, which shows what a user-agent could do, with data extracted from a species microformat

==Examples in the wild==

*Social network for gardeners marking up plant names with microformats [http://www.growsonyou.com/plant/Cosmos_bipinnatus Grows on You].
*A "proof-of-concept" example, with binomial and sub-family, but no other ranks, has been added to the Wikispecies entry for [http://species.wikimedia.org/wiki/Glaucidium_sanchezi Glaucidium sanchezi]; and to its subfamily, [http://species.wikimedia.org/wiki/Surniinae Surniinae]. See [http://species.wikimedia.org/wiki/Wikispecies:Microformat Wikispecies:Microformat] for related discussion.
*The current "[[species-brainstorming#Straw man proposal|straw man]]" for the Species microformat has been deployed, in part, on Wikipedia. '''''All''''' Wikipedia articles with "[http://en.wikipedia.org/wiki/Template:Taxobox taxoboxes]" (information panels on living things; and there are '''37,140''' as at the time of posting) now emit a species microformat. For example [http://en.wikipedia.org/wiki/Southern_Tamandua Southern_Tamandua] (a species) and [http://en.wikipedia.org/wiki/Anteater Anteater] (a family of species).
* A [http://www.westmidlandbirdclub.com/records/lists-2004uf.htm West Midland Bird Club test page] is available.

==Implementations==
*[https://addons.mozilla.org/firefox/4106/ Operator] has a user-script for parsing ''Species''.

===Implementations (pending)===
*[http://www.spacefornature.co.uk/biorec/taxoncheck.htm Taxon Checker] - a software tool which, given a common name, searches for the relevant taxonomic data and outputs the selected species' details as (among other options) an HTML fragment. It is intended to provide templates for outputting such fragments with "species" microformat markup, once this proposal is implemented.
*[http://en.wikipedia.org/wiki/User:Beastie_Bot Wikpedia's Beastie Bot] can be used to update the "taxoboxes" of articles about living things/

species-brainstorming

2008-02-21T22:18:55Z

PeterR: /* Species Brainstorming */

=Species Brainstorming=

:'''Note: the original name of the proposed microformat, "species", is likely to change, probably to "biota" or "taxon". The former has been retained here, to avoid having to make many repetitive and perhaps redundant edits'''

:'''{{UpdateMarker}} The [http://www.kaply.com/weblog/2007/02/16/operator-07a-is-available/ Operator] extension now detects ''Species''. [http://www.westmidlandbirdclub.com/records/lists-2004uf.htm A test page is available]. Work on both continues!'''

==Andy Mabbett==
===Proposal===

There should, I believe, be a "'''[[species]]'''" microformat for the markup of plant and animal names, to include their scientific names. Consider:

:<pre><nowiki><abbr class="species" title="Anas platyrhynchos">Mallard</abbr></nowiki></pre>
or
:<pre><nowiki><span class="species">Anas platyrhynchos</span></nowiki></pre>

The microformat would allow user agents to be configured to perform look-ups on on-line databases of species, according to user preferences. Specification of the taxonomic class would help user agents to know which such databases were applicable (i.e., use database A for plants, but database B for mammals and database C for insects.)

It would also allow for more specific searching (do I mean "crow" or do I mean "Corvus corone"?).

The specification should encourage, but not mandate, the correct capitalisation of scientific names, so "''Anas platyrhynchos'''" not "''anas platyrhynchos''" nor (except historically) "''Anas Platyrhynchos''". A reminder that such names should be styled with italics will also be included.

===Straw man proposal===

See : [[species-strawman-01]]

==Bill Hull==
[http://www.mangoverde.com/ My website] has 17000+ photos of 4700+ bird species. There are also a handful of butterflies (organized very poorly as I am unaware of any published butterfly world taxonomies) and shortly will have a number of dragon/damselflies. The site is made up of static pages but is built from a database so it is easy for me to add it new HTML tags to the pages. If you are interested in some prototyping at some point I can probably build stuff into the pages. - Bill Hull

==Roger Hyam==
===Taxonomic Databases Working Group===

[http://www.tdwg.org/index.html TDWG] is the organisation for standardisation in exchange of biodiversity data. The organisation has now (November 2007) undergone some re-organization. It has a new collaborative development environment, standards process, standards architecture and it has formed alliances with major organizations in the domains of geospatial and ecological data.

Central to the TDWG standards architecture are the [http://wiki.tdwg.org/twiki/bin/view/TAG/LsidVocs LSID vocabularies]. The role of these vocabularies is to define URIs for the nuts-and-bolts concepts that occur in the biodiversity informatics domain. See [http://wiki.tdwg.org/twiki/bin/view/TAG/WhatIsTheOntology a description of what the TDWG ontology is] for details. Although the vocabularies are defined in OWL the intention is for their URIs to be used as namespaces across different XML and non-XML based technologies. They can act as a central mapping point for those hard pressed developers who want to combine data presented to them in many formats.

The species microformats that are proposed here are a good thing. The only danger is that they re-define any of the central terms defined in the TDWG vocabularies. If they do that then they are creating another language instead of extending HTML to embrace existing semantics - which I don't think is their intent. It would be nice to have the data in web pages in a form that can be combined with the hundreds of millions of records marked up with the TDWG URIs.

If there is enough belief in the need for a Species Microformat why not propose a TDWG Applicability Statement and take it through a peer review process. The [http://www.tdwg.org/about-tdwg/process/ TDWG process] is quite simple and free (unless you count blood, sweat and tears). You would need to form a Task Group with a charter saying what you intended to do. As convener of the TAG Interest Group I would willingly host the Task Group. You could then propose a standard and have it reviewed by a range of biologists and IT people before it becomes ratified and recommended for adoption. RogerHyam 2007-11-5

==Malcolm Storey==
(extracted from e-mails to Andy Mabbett, by kind permission)

* "Hopefully I'll have more time for things like this in the New Year, but expect it all be done and dusted by then!!" - Malcolm Storey, [http://www.bioimages.org.uk/ BioImages]

===ICZN, ICBN et al===
You don't cover the full set of levels of taxonomic hierarchy defined by the relevant body ICZN or ICBN (plus the others - one each for garden plant varieties, bacteria, viruses. Don't know about mycoplasmas, diseases, BSE factors etc.

ICBN Ranks listed [http://www.bgbm.org/iapt/nomenclature/code/SaintLouis/0007Ch1Art003.htm], [http://www.bgbm.org/iapt/nomenclature/code/SaintLouis/0008Ch1Art004.htm]

AIUI ICBN only goes down to species.

ICZN isn't so easy: [http://www.nhm.ac.uk/hosted_sites/iczn/]

:1.2.2. The Code regulates the names of taxa in the family group, genus group, and species group. Articles 1-4, 7-10, 11.1-11.3, 14, 27, 28 and 32.5.2.5 also regulate names of taxa at ranks above the family group. (But none of the above articles list the taxonomic ranks.)

ICZN Only goes down to subspecies (art 1.3.4)

Note also:

:1.4. Independence. Zoological nomenclature is independent of other systems of nomenclature in that the name of an animal taxon is not to be rejected merely because it is identical with the name of a taxon that is not animal (see Article 1.1.1)

(eg Trichia, Oenanthe, Melanotus)

Myxomycetes are the exception - they're in kingdom protozoa which falls under ICZN but they fall under the ICBN name space. (Hence "Trichia").

===DNA===
You may want to consider refs to DNA sequences. They're not part of taxonomy, but they can be considered the bottom rung of the taxonomic hierarchy and they will be of increasing significance.

===Typography===
what about ''Adalia 2-punctata'', and ''Adalia bipunctata'' (not to mention those with hyphens [or apostrophes] which may get left out. And what about accented characters)?

:''Adalia 2-punctata'' is an abbreviation of ''Adalia bipunctata'', so:

:<pre><nowiki><abbr class="binominal" title="Adalia bipunctata">Adalia 2-punctata</abbr></nowiki></pre>
[[User:AndyMabbett|AndyMabbett]] 09:55, 21 Oct 2006 (PDT)

===Gaps===
The hierarchy is not always fully populated. Not every species belongs to a class. Maybe this was where fungi are different. In Paul Kirk's databases (which are the official ones used to drive the checklists and NBN) he has fixed fields for the higher level taxa which means that only certain ranks can be used. The blanks he fills in (mostly!!) with "insertae sedis" (think it's Latin for "unknown seat"). In my database I use a self-join which gives much more flexibility. Anyway there are lots of "insertae sedis" in Paul's database!

===Homonyms===
''Apion carduorum'' sensu Morris 1990 is ''Apion gibbirostre'' (Gyllenhal, 1813). ''Apion carduorum'' Kirby, 1808 is a different species.

:You'd mark the former up as something like
:<pre><nowiki><abbr class="binominal" title="Apion gibbirostre">''Apion carduorum'' sensu Morris 1990</abbr></nowiki></pre>

:[[User:AndyMabbett|AndyMabbett]] 12:21, 5 Oct 2006 (PDT)

===Citations for authorites===
If people are citing the authority in full they would include the literature reference, not just the date e.g.
:''Cuphophyllus niveus'' (Scop.) Bon, ''Doc. Mycol.'' 14(56): 11 (1985)[1984]

::Perhaps we should allow for the inclusion of an [[hcitation|hCitation]]? [[User:AndyMabbett|Andy Mabbett]] 15:08, 28 Feb 2007 (PST)

==Hyppo==
===Nomenclatural challenge===
You asked for comments. One challenge I see is the difference in Nomenclature for Animalia and Plantae (coming from the old 2 kingdom system). For Plantae the International Code of Botanical Nomenclature[http://www.bgbm.org/iapt/nomenclature/code/SaintLouis/0000St.Luistitle.htm] is used and for Animalia the code from [http://www.iczn.org/ http://www.iczn.org/]. Animalia code is not officially accepted but ICZN tries to be authoritive starting from 2008.

The two different nomenclatural systems differ in a few areas, and they affect markup.

*Subgenus (Plantae): ''Dendroceros'' subg. ''Apoceros''
*Subgenus (Animalia): ''Sula (Morus)''

*Subspecies (Plantae): ''Begonia grandis'' ssp. ''evansiana''
*Subspecies (Animalia): ''Gorilla beringei graueri''
:--[[User:Hyppo|Hyppo]] 14:23, 9 Oct 2006 (PDT)

:I would mark those up as:

:<pre><nowiki><span class=genus">Dendroceros</span> subg. <span class="subgenus">Apoceros</span></nowiki></pre>

:<pre><nowiki><span class=genus">Sula</span> <span class="subgenus">Morus</span></nowiki></pre>

:<pre><nowiki><span class="binominal">Begonia grandis</span> ssp. <span class="subspecies">evansiana''</span></nowiki></pre>

:<pre><nowiki><span class="binominal">Gorilla beringei</span> <span class="subspecies">graueri</span></nowiki></pre>

:With wrapping class="biota" and possibly kingdom, attributes.

:[[User:AndyMabbett|AndyMabbett]] 11:37, 10 Oct 2006 (PDT)

==Cyndy Parr==

The ideas expressed here are promising. Below are my comments on all the preceding -- as I have time I'll organize, elaborate, and try to move parts into the right discussion threads above.

In the [http://spire.umbc.edu Spire project] we have been developing ontologies in OWL for taxonomic names and hierarchies. Ideally, we'd like to have a microformat where people can tag a scientific name and an application can then check an ontology of their choice for more information (richer semantics).

We would discourage full expression of the Linnaean hierarchy except for those who are maintaining such classifications (such as uBio). The rest of the hierarchy can be retrieved ontologically as necessary.

Better to tie the scientific name (taxon name) to the authority or ontology from which it came. I.e. for those who are able to provide information on taxonomic concepts, support for TCS (Taxonomic Concept Schema) fields would be important.

I prefer "taxon" or "taxon-name" or TaxonName over biota (which is plural, and too close to biotic which has a far larger scope than taxa). Would prefer "binomial" to "binominal"
*I also favour "taxon" over "biota" simply because it the more commonly used term. I also prefer "binomial". I did a quick straw poll of various experts and all favoured binomial. Neither is technically incorrect, but binomial is more commonly used. Indeed, a Google search for binomial returns 6,580,000 results while binominal returns 342,000 and a "did you mean: binomial" prompt. --[[User:CharlesRoper|Charles Roper]] 04:12, 9 Jan 2007 (PST)
**This [http://www.googlebattle.com/index.php?domain=%22binomial+name%22+-equation&domain2=%22binominal+name%22+-equation&submit=Go%21 binomial vs. binominal Google battle] seems even more conclusive. [[User:AndyMabbett|Andy Mabbett]] 06:17, 9 Jan 2007 (PST)
"class" is difficult not only because of the confusion with the programming concept of classes, but because it is a taxonomic rank. However, most of us have figured out the difference by now so this is not critical.

"cname" should be "comname" or "common-name" or "vernacular" to make it more obvious what the information is. A sub-component would be the language for which that common name is used ( something like an HTML attribute lang="en")
*I also favour "common-name" or "vernacular" --[[User:CharlesRoper|Charles Roper]] 04:12, 9 Jan 2007 (PST)

There are known conflicts between names across kingdoms (as current codes of nomenclature allow these). Thus specification of kingdom may be encouraged. Disambiguation could be handled by applications outside the microformats (this could be difficult), or they could be dealt with in the core microformat: e.g. plant-taxon or fungal-taxon or animal-taxon.

A sightings microformat is a good idea and I would be interested in being involved in that. We've been toying with this in OWL and also using structured blogging over at http://fieldmarking.reger.com

Your terms such as gender (better: sex), age bracket (better: life stage), count, type (better: depending on the meaning, caste or morph) all belong in a specimen or sighting microformat and used in combination with the taxon microformat, not be part of it.

===Response by Andy Mabbett===
Thank you very much for your detailed contribution. I have a few responses:

*We would discourage full expression of the Linnaean hierarchy except for those who are maintaining such classifications (such as uBio).
** Why? Also, I'm not aware of any microformat which is restricted to a subset of users, nor how this would be done. How would you suggest that someone mark up this: "Not all of the Passeriformes sing"?
*** I would prefer express this something like so:
<pre><nowiki>
<span class="taxon lsidres:urn:lsid:ubio.org:namebank:21833">
<i class="sci-name">Passeriformes</i>
</span>
</nowiki></pre>
Or, to simplify further:
<pre><nowiki>
<i class="taxon sci-name lsidres:urn:lsid:ubio.org:namebank:21833">Passeriformes</i>
</nowiki></pre>
Or, at the simplest level:
<pre><nowiki>
<i class="taxon">Passeriformes</i>
</nowiki></pre>
Simply marking up the word as a taxon would lighten the load of any parser, making its job much simpler. --[[User:CharlesRoper|Charles Roper]] 10:50, 8 Jan 2007 (PST)
***Your first example requires the author of that page to find LSID, even assuming that they know such a thing exists. How is that "paving the cowpaths"? Your latter example removes semantic detail which is included in the straw-man proposal. It is akin to removing all the children of "adr" in hCard. I think your parser-load issue is a red herring. [[User:AndyMabbett|Andy Mabbett]] 11:07, 8 Jan 2007 (PST)
**** I would argue that finding and using an LSID would not be a difficult task for any author who is using a microformat. I don't see how it is any more difficult - in fact I see it as being easier - than manually marking up ranks. Why is parser-load a red herring? --[[User:CharlesRoper|Charles Roper]] 12:26, 8 Jan 2007 (PST)
***Nice example (having done my doctoral work on a Passerine that may or may not be singing...). Absolutely I'd recommending marking up "Passeriformes" but no need to go on to specify "Aves." I'm still grokking microformats so I don't think we've got a conflict. [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)
****''Aves'' is available for use, but not required, so indeed, we don't have conflict ;-) [[User:AndyMabbett|Andy Mabbett]] 10:42, 10 Jan 2007 (PST)
*The rest of the hierarchy can be retrieved ontologically as necessary.
**That's a use-case once the uF is published, certainly. the proposal doesn't require that the hierarchy be marked-up, it merely allows for it, in cases where it is '''already published'''.
***I've yet to see any consistent examples of a hierarchy being marked-up using class names resembling those found in the proposal. A microformat is supposed take (and perhaps tweak, or clean up) mark-up practises that are '''already in use''', not invent new ones. In other words, microformats should pave the cowpaths. While allowing for the marking-up of the hierarchy is fair enough (I understand the reasons for wanting that option), I believe the vast majority of authors do not need that facility, or (from my own experience) do not have time or energy to make use of anything more complex than simply marking-up a piece of text as a taxonomic name. In its current state, I don't believe the current species microformat proposal fulfils any of the "philosophy of microformats" points raised in [http://ifindkarma.typepad.com/relax/2004/12/microformats.html this article]. I believe the added complexity acts as a disincentive potential users and is also clearly confusing. With taxonomic intelligence (hierarchies, synonymy, etc) being available from elsewhere (e.g. uBio), why have it embedded in the microformat? What examples of this kind of usage are there and what leads you to believe authors '''will''' use it, if it's available? [[rel-license]] is an example of a microformat that is simple and holds intelligence elsewhere. I believe simplicity is the key to a successful species microformat. --[[User:CharlesRoper|Charles Roper]] 10:50, 8 Jan 2007 (PST)
****''I've yet to see any consistent examples of a hierarchy being marked-up using class names resembling those found in the proposal.'' Perhaps not but, unlike other uFs, in taxonomy there exist clearly defined standards for the names of the components of taxonomic names. This is akin to the pre-existing class names from vCard, as used in hCard.
*****Not so: vCard is widely used standard already and thus it was a natural progression to develop hCard. There is no software based vCard equivalent of the taxonomic hierarchy in common use that I am aware of.
****''A microformat is supposed take (and perhaps tweak, or clean up) mark-up practises that are '''already in use''''' Taxonomic classes ''''are '''' already in use.[[User:AndyMabbett|Andy Mabbett]]
*****My concern still stands that there is no consistent mark-up usage that I can find.
***Fair enough [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)
****''I believe the vast majority of authors [...] do not have time or energy to make use of anything more complex than simply marking-up a piece of text as a taxonomic name''' and - as has been pointed out previously, they will be able to do the latter, and nobody will force them to do the former. Why should they not, though, be able to do the latter should they wish?
*****As I say, I find the concept of allowing the full suite of ranks to be fair - I understand your desire to have them in there. I just feel that the complexity they add to the specification will put off authors and confuse them. I also maintain that very few authors will make use of this extra complexity. Should we have some sort of poll to try and determine how many people would be able to make use of the full proposal? I'm not totally against having all of the ranks in the Species microformat, I've just yet to be convinced they are necessary or conducive to adoption of the standard. --[[User:CharlesRoper|Charles Roper]] 12:26, 8 Jan 2007 (PST)
****''What examples of this kind of usage are there'' Those on [[species-examples]], e.g. Wikipedia.
*****I've yet to find any consistent mark-up usage.--[[User:CharlesRoper|Charles Roper]] 12:26, 8 Jan 2007 (PST)
****''[[rel-license]] is an example of a microformat that is simple and holds intelligence elsewhere'''' It holds no intelligence elsewhere, which was not already on the pre-microformatting page.[[User:AndyMabbett|Andy Mabbett]] 11:07, 8 Jan 2007 (PST)
*****The license on the end of the rel-license link is the intelligence. To look at it from a different angle, why not embed the license information within class attributes? Why not have a full license microformat, just in case some author needs it? Rel-license as it stands serves the needs of most authors most of the time, which is a fundamental philosophy of microformats.
*Better to tie the scientific name (taxon name) to the authority or ontology from which it came.
**That would require the publisher to add extra data, which they might not wish to publish, nor, indeed, have to hand. Microformats are about recognising what data is '''already''' published and then enabling people to add semantics which identify the type of data on their pages.
***I'm just suggesting support for such authority or ontology for those of us who think it important [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)
****Again, the option to do so is in the current proposal. [[User:AndyMabbett|Andy Mabbett]] 10:42, 10 Jan 2007 (PST)
*[common names] A sub-component would be the language for which that common name is used (something like an HTML attribute lang="en")
**Indeed, but that's already available, and (on properly constructed pages) should already be on the parent container. [[User:AndyMabbett|Andy Mabbett]]
***Fair enough [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)
*conflicts between names across kingdoms (as current codes of nomenclature allow these). Thus specification of kingdom may be encouraged.
**already in the proposal! [[User:AndyMabbett|Andy Mabbett]]
***but perhaps the proposal could be more explicit about the importance of kingdom given its important role in disambiguating species names (using a name of any other rank is less desirable given instability and required application overhead). I realize that I'm going beyond the microformat itself to "best practices" but please forgive me; I've been wrangling with taxonomic databases for a long time. [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)
*Disambiguation could be handled by applications outside the microformats
**Not sure what you mean here, since all parsing is done "outside microformats". [[User:AndyMabbett|Andy Mabbett]]
***Thanks for the clarification [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)
***Another reason to make use of nameservers, rather than embedding the information within the microformat. --[[User:CharlesRoper|Charles Roper]] 10:50, 8 Jan 2007 (PST)
**** And how is enforcing the use of nameservers "paving the cowpaths"? [[User:AndyMabbett|Andy Mabbett]] 11:07, 8 Jan 2007 (PST)
*****The use of nameservers isn't enforced; it's optional (if disambiguation or further taxonomic intelligence is required). --[[User:CharlesRoper|Charles Roper]] 12:26, 8 Jan 2007 (PST)
******Agreed [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)

(I'm either in agreement with your other points, or ambivalent.)

Thank you again - do stick around. Are you on the [[mailing-lists#microformats-discuss|mailing list]]?

[[User:AndyMabbett|Andy Mabbett]] 11:06, 5 Jan 2007 (PST)

*I am now! [[User:CyndyParr|CyndyParr]] 10:20, 10 Jan 2007 (PST)

==Pengo==

Unfortunately scientific names seem to change as often as common names. I have some examples and use cases this microformat needs to address, around the problems of ambiguity:

Ambiguity 1. Ambiguous scientific names.. ''[http://en.wikipedia.org/wiki/Sousa_chinensis Sousa chinensis]'' may either refer to '''Chinese White Dolphin''' (also known as ''Sousa chinensis chinensis'') or Humpback dolphin, also known as '''''Sousa''''' (genus) which includes up to five species or subspecies of dolphin including the Chinese White Dolphin. I don't care whether the Chinese White Dolphin is a species or subspecies, but the microformat needs to allow the user to be specific about which system is being addressed.

Ambiguity 2. Another example is the [http://en.wikipedia.org/wiki/Orangutan Orangutan]... or Orangutans. Organutans were once believed to be a single species, but are now considered two separate species. The problem is that the new scientific name for just the Bornean species (''Pongo pygmaeus'') is the same as the old scientific name which encompassed both species (''Pongo pygmaeus''). Meanwhile the new scientific name for the Sumatran Orangutan (''Pongo abelii'') is always unambiguous.

Ambiguity 3. ''[http://en.wikipedia.org/wiki/Doronomyrmex_pocahontas Doronomyrmex pocahontas]'' is an ant species that probably doesn't belong in the genus ''Doronomyrmex'', but rather ''Leptothorax''. But, until a full taxonomic study of the known species of ''Doronomyrmex'' and ''Leptothorax'' is carried out, it will stay there. Meanwhile the the term "''Leptothorax'' ([http://en.wiktionary.org/wiki/sensu_stricto sensu stricto])" is used to mean "in the sense of the original author".

Use cases:
So how do we:
# tag species in new documents, where we are using the most current nomenclature in the tags, to indicate that we don't mean the old nomenclature
# tag species allowing for new nomenclature to arise which may obsolete what we're using
# tag species in old documents, where we have updated the nomenclature in the tag, but the taxt may be referring to the old nomenclature, and we want to indicate that the updated nomenclature is being used.
# tag species in [others'] documents that are tagged automatically and where the specific nomenclature being used is unknown or ambiguous
# address issues where competing nomenclatures exist side-by-side, or transition periods
# tag species that have some clues as to which nomenclature is being used, e.g. the date of publication, and the author.
# tag a taxon which is now considered paraphyletic
# decide what's out of the scope of this microformat

Brainstorm solutions:
* Allow an "old-synonym" field, which strictly lists the previous name of the species (and never a newer name). So, e.g.
<pre><nowiki><span species="Pongo pygmaeus" old-synonym="Pongo pygmaeus pygmaeus">Bornean Orangutan</span></nowiki></pre>
* Allow the English common name to be included, when it clears ambiguity. E.g. the "Chinese White Dolphin" has always been called that, regardless of whether it was considered a species or subspecies.
* Allow a taxonomy-year field for what year the taxonomy used in the tag comes from.
* Use a UID as described by others above.
* Have an ad-hoc "disambiguation" field which could include anything to disambiguate, such as years, synonyms, "sensu stricto", common names, authors (i.e. "in the sense of this author") etc. What goes in it for a particular taxon will develop from usage.
* Have a taxonomy-uncertain="true" field to indicate it has been (for example) automatically tagged and may not be accurate, so that other suggestions can be given by 3rd party software.

Basically I don't synonyms are necessary unless they are to show that the species was previously called something else, which may help to give a more exact meaning.

Comments? Are there already existing solutions to this problem in the real world?
[[User:PeNGo|Pengo]] 19:49, 28 Jan 2007 (PST)

===Response to Pengo by Andy Mabbett===
Thank you for your expert contribution. Of your proposed solutions, the common (or vernacular) name, UID and author/ year are already in the current proposal. It may be sensible to have a "synonym" property (as used on http://en.wikipedia.org/wiki/Doronomyrmex_pocahontas), but I don't think "old-synonym" is particularly well named. Perhaps, if it's needed at all, "formerly" would be better? It is worth remembering, though, that the microformat is meant for labelling what people '''''already''''' publish and, for instance, http://en.wikipedia.org/wiki/Bornean_Orangutan refers to ''Pongo pygmaeus'', not any previous name. [[User:AndyMabbett|Andy Mabbett]] 02:20, 30 Jan 2007 (PST)
* Then most effective way to disambiguate is to use a UID. I feel other solutions would over-complicate the specification. I think we need to put some effort into populating the examples regrouped page with specific examples of publishing styles, e.g., plain binomials, plain common names, scientific names with common names, scientific names with synonyms, binomial with subspecies, etc. [[User:CharlesRoper|Charles Roper]] 05:25, 2 Feb 2007 (PST)
**There are very few exmples of UIDs being published in-the-wild. [[User:AndyMabbett|Andy Mabbett]] 06:00, 2 Feb 2007 (PST)
***I found a good source of synonym usage; see the Coleopterist's Checklist of Beetles of the British Isles: http://www.coleopterist.org.uk/checklist.htm. Look for the indented specific epithet names, e.g. in the family [http://www.coleopterist.org.uk/haliplidae-list.htm HALIPLIDAE], ''pallens'' Fowler, 1887 and ''halberti'' Bullock, 1928 are examples of synonyms, with the favoured specific epithet being ''confinis'' Stephens, 1828. On a more general note, checklists such as this are ripe for microformatting and are an excellent example of common markup practice. The species microformat could be used to great effect with content such as this, creating minable dictionaries of species names which are, in turn, essential tools in for use in biodiversity informatics. [[User:CharlesRoper|Charles Roper]] 14:43, 24 Feb 2007 (PST)
***Re. UIDs: yes, we have an interesting chicken & egg situation here. Without a reliable way to publish a UID (other than making them human readable text, which is undesirable) how are we supposed to be able to make use of them? A microformat would be a good means with which to deploy UIDs, but it is frowned upon to implement a pattern that isn't already being practised. Judging by the messages here, on the discussion list and elsewhere, there is clearly a desire for linking taxon names with UIDs, particularly LSIDs, which look set to become the standard UID for taxonomic naming. [[User:CharlesRoper|Charles Roper]] 10:41, 2 Feb 2007 (PST)
****Well, the proposal allows for the inclusion of UIDs (as with all the suggested attributes, some work on the exact format might need to be done), should people to chose to publish them; whether or not they do is not something for uFs to push for. [[User:AndyMabbett|Andy Mabbett]] 13:13, 2 Feb 2007 (PST)

==Charles Roper==
===Synonyms===
I found an interesting [http://collections2.eeb.uconn.edu/collections/insects/CTBnew/duodecimguttata.html example of synonym usage] in the [http://collections2.eeb.uconn.edu/collections/insects/CTBnew/checklist.htm Tiger Beetles of Connecticut checklist]. In the particular example cited, the synonyms refer to, or are associated with, the species name - ''Cicindela duodecimguttata'' Dejean 1825. Synonyms are often mentioned alongside or near preferred scientific names; how should we tie them together, especially when, as in this case, the name and the synonym are not positioned close to one another, but are still clearly associated? As a segue to this question, how should multiple synonymous common names be represented? How about common names in different languages? For example, the [http://names.ubio.org/browser/details.php?names=on&authors=on&sci=on&vern=on&namebankID=2478269 Otter has many different common names].

:I take it you refer to the text which may be paraphrased (by omitting some prose) as:

::'''''Cicindela duodecimguttata'' is known from 23 localities. ''Cicindela duodecimguttata'', once classified as a subspecies of ''C. repanda'', shares many traits with ''C. repanda''. Where ''C. duodecimguttata'' occurs, the more common ''C. repanda'' is usually found.'''

::'''Synonomies: ''Cicindela proteus'' Kirby 1837:9. ''Cicindela bucolica'' Casey 1913:28. ''Cicindela hudsonica'' Casey 1916:29. ''Cicindela edmontonensis'' Carr 1920:21'''

:The problem would seem to be that ''C. repanda'' is referred to both as a species in its own right, and as a past synonym of ''C. duodecimguttata''. If the whole thing is wrapped in one <code>div class="biota"</code>, allowing the other listed synonyms to be included, then how is ''C. repanda'' to be marked up as a species in its own right?

:I would mark up the first occurrence of each, then use the include-pattern to "attach" the other listed synonyms with the former (I've only included one synonym in the following, for clarity):

:<pre><nowiki>
<span class="biota">
<span class="binominal">Cicindela duodecimguttata</span>
<object class="include" data="#C-proteus"></object>
</span>

is known from 23 localities. Cicindela duodecimguttata, once classified as a subspecies of

<span class="biota">
<span class="binominal">C. repanda</span>
</span>

, shares many traits with C. repanda. Where C. duodecimguttata occurs, the more common C. repanda is usually found.

Synonomies:
<span class="synonym" id="C-proteus">
<span class="binominal">Cicindela proteus</span> [or maybe "synonym-binominal" ?]
<span class="authority">Kirby</span>
<span class="year">1837</span>:9.</span>
Cicindela bucolica Casey 1913:28. Cicindela hudsonica Casey 1916:29. Cicindela edmontonensis Carr 1920:21
</nowiki></pre>

:I might then use the its entry on the "shares many traits" line to mark up ''C. repanda'' as an synonym, and include it in the same way.

:Multiple and foreign-language common names would be catered for by allowing the common name attribute to be "0 or many" (the first such occurrence having precedence), and using a <code>lang</code> attribte where appropraite.

:[[User:AndyMabbett|Andy Mabbett]] 14:42, 28 Feb 2007 (PST)

== Other use cases ==
Please add your suggestions!

'Species' microformats could be used to:
*...

==See also==
{{species}}

User:PeterR

2008-02-21T22:09:19Z

PeterR:

I'm a web developer currently working on a social network for gardeners, [http://www.growsonyou.com Grows on You].

We have a plants database and I am particularly interested in the species microformat. We have no need to use it, but I am very much like the concept of microformats and am keen to use them where I can.

<div id="ccpublicdomainrelease" style="background: #f7f8ff; border: 1px solid #88a; padding: 5px; font-size: 80%;"><span style="float:left;margin:4em 0">http://creativecommons.org/images/public/norights-a.gif</span><span style="float:right;margin:4em 0">http://creativecommons.org/images/public/norights-a.gif</span>
<div style="background:#fff;margin:0 88px;padding:2px"><div style="text-align: center; background: #ccf;">'''Released into public domain'''</div><p>I agree to release all my text and image contributions (past, present and future), into the [[#public-domain|public domain*]]. Please be aware that other contributors might not have done the same, so if you want to use pages with my contributions under public domain terms, please check past contributors' user pages.</p><p id="public-domain">"^ [http://creativecommons.org/licenses/publicdomain/ Creative Commons Public Domain License], the original at http://creativecommons.org/licenses/publicdomain/ or any later version published by Creative Commons; with either a waiver of rights, or an assertion that no rights attach to a particular work."</p></div></div>
[[Category:public domain license|{{PAGENAME}}]]

User:PeterR

2008-02-21T21:51:03Z

PeterR:

adr

2008-01-22T13:38:22Z

PeterR: /* Examples in the wild */

= adr =
{{TOC-right}}
http://rbach.priv.at/2006/buttons/adr.png

'''adr''' (pronounced "adder"; FAQ: [[hcard-faq#Should_I_use_ADDRESS_for_hCards|"why 'adr'?"]]) is a simple format for marking up address information, suitable for embedding in HTML, XHTML, Atom, RSS, and arbitrary XML. '''adr''' is a 1:1 representation of the ''adr'' property in the vCard standard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) in HTML, one of several open [[microformats|microformat]] standards. It is also a property of [[hCard]].

== Draft Specification ==
; Editor/Author
: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])

=== Copyright ===
Per the public domain release on [[User:Tantek|my user page]], this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

=== Patents ===
{{MicroFormatPatentStatement}}

=== Inspiration and Acknowledgments ===
Thanks to everyone who participated in the [[geo-bof-2005-06-30|Geo Microformat BOF at O'Reilly's Where 2.0 conference]], and in particular to [http://radar.oreilly.com/nat/ Nat Torkington] and Vee McMillen of [http://oreilly.com O'Reilly] for [http://conferences.oreillynet.com/cs/where2005/view/e_sess/7476 arranging and hosting the BOF].

== Introduction and Background ==
The vCard standard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]), has been broadly and interoperably implemented (e.g. Apple's Address Book application). The [[hcard|hCard]] microformat has similarly received significant adoption, from numerous sites publishing the format, to hCard to vCard proxies, to clientside javascript parsers.

At the [http://conferences.oreillynet.com/where/ Where 2.0 conference] in June 2005, there was widespread recognition that the community needed a way to simply and easily publish visible, extractable, address information on the Web, given how often bloggers, and numerous other sites publish address information. The [[geo-bof-2005-06-30|geo microformat BOF]] discussed this very topic, and concluded with a consensus decision to just try using ''adr'' from vCard/hCard.

This specification introduces the '''adr''' microformat, which is a 1:1 representation of the aforementioned ''adr'' property from the vCard standard, by simply reusing the ''adr'' property and sub-properties as-is from the [[hcard|hCard]] microformat.

Publishers can both embed '''adr''' addresses directly in their web pages and feeds, as well as markup existing addresses in the context of the rest of the information in their web pages and feeds.

If the publisher knows and is publishing the ''name'' of the location in addition to its address, then the publisher MUST use [[hcard|hCard]] instead of just '''adr''' to publish the name and address of the location.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Format ==
=== Singular Properties ===

Note that all the properties in '''adr''' are singular properties, and thus the first descendant element with that class should take effect, any others being ignored.

=== Human vs. Machine readable ===

If an <code><abbr></code> element is used for a property, then the <code>title</code> attribute of the <code><abbr></code> element is the value of the property, instead of the contents of the element, which instead provide a human presentable version of the value.

Similarly, if an <code><img></code> element is used for one or more properties, it must be treated as follows:
# For the <code>PHOTO</code> property and any other property that takes a <abbr title="Uniform Resource Locator">URL</abbr> as its value, the <code>src</code> attribute provides the property value.
# For other properties, the <code><img></code> element's <code>alt</code> attribute is the value of the property.

=== Value excerpting ===

Sometimes only part of an element which is the equivalent for a property should be used for the value of the property. For this purpose, the special class name <code>value</code> is used to excerpt out the subset of the element that is the value of the property. See [[hcard|hCard]] for details on this.

=== Root Class Name ===

The root class name for an '''adr''' address is <code>adr</code>.

=== Property List ===

This is the list of properties in '''adr''', taken from [[hcard|hCard]]:

* <code>post-office-box</code>
* <code>extended-address</code>
* <code>street-address</code>
* <code>locality</code>
* <code>region</code>
* <code>postal-code</code>
* <code>country-name</code>

The <code>type</code> sub-property is omitted because without the context of a type of address for ''whom'', it doesn't make much sense.

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their RFC 2426 definitions.

=== Parsing Details ===
See [[hcard-parsing|hCard parsing]], with the only difference being that "adr" is the root class name, rather than "vcard".

== Examples ==
This section is informative.

=== Sample adr ===

Here is a sample <code>adr</code>:

<pre><nowiki>
<div class="adr">
<div class="street-address">665 3rd St.</div>
<div class="extended-address">Suite 207</div>
<span class="locality">San Francisco</span>,
<span class="region">CA</span>
<span class="postal-code">94107</span>
<div class="country-name">U.S.A.</div>
</div>
</nowiki></pre>

which might be displayed as:

<div class="adr">
<div class="street-address">'''665 3rd St.'''</div>
<div class="extended-address">'''Suite 207'''</div>
<span class="locality">'''San Francisco'''</span>,
<span class="region">'''CA'''</span>
<span class="postal-code">'''94107'''</span>
<div class="country-name">'''U.S.A.'''</div>
</div>

Note that this is a '''live''' <code>adr</code> microformat, which will be found on this page by parsers.

=== More Examples ===

See [http://microformats.org/wiki/hcard-examples#3.2.1_ADR_Type_Definition hCard example ADR] for more examples.

See [http://microformats.org/wiki/adr-examples adr examples] for additional uses of ADR.

== Examples in the wild ==
This section is '''informative'''.

The following sites have published adrs, outside their normal context of hCards, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc., in addition to [[hcard|hCard]] examples in the wild. If you find adrs outside of hCards anywhere else, feel free to add them to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://www.growsonyou.com/visit Grows on You] uses the microformat to mark up the addresses of open gardens.
* [http://www.stems-florist.co.uk/ Stems Florist] uses the microformat on the front page to markup up the two store addresses
* ...

(See also [[hcard-examples-in-wild]])

== Implementations ==
This section is '''informative'''.

The following implementations have been developed which either generate or parse adrs outside the context of hCards. If you have an adr implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.

* [http://code.highearthorbit.com/greaseroute/index.php GreaseRoute] is a GreaseMonkey user script (also available as a simple Firefox Extension) which will add icons for displaying the location, or route to, an [[adr]] using a MapQuest map. The route is displayed from the starting location based on the viewer's IP-Address as determined by the [http://hostip.info HostIP] geolocation service.

* [http://code.highearthorbit.com/greaseroute/index.php GreaseRouteEmbed] is another GreaseMonkey user script that will actually embed a route image in the webpage when the user clicks the "route" link.

* [http://georss.org/geopress GeoPress] is a [http://wordpress.org WordPress] plugin that supports embedding adrs, geo, maps (dynamically switchable between Google-Yahoo-Microsoft Maps), and [http://georss.org GeoRSS] feeds.

* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf] is a plugin for [http://textpattern.com/ Textpattern] that supports embedding adrs and other microformats in templates and blog posts. Written by [http://placenamehere.com/ Chris Casciano].

* The [http://tantek.com/microformats/hcard-creator.html hCard creator], though it creates complete hCards, can also be used simply to create adrs by filling out the address portion and simply copy and pasting the <div class="adr"> element and its contents.

== References ==
=== Normative References ===
* [[hcard|hCard]]

=== Informative References ===
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426] ([http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426])
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]

=== Similar Work ===
* [[geo]]
* [[hcalendar|hCalendar]]
* [[XOXO]]

== Work in progress ==
This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added.

== Discussions ==

* See [http://www.technorati.com/cosmos/referer.html blogs discussing this page].

=== Q&A ===
* If you have any questions about hCard, check the [[hcard-faq|hCard FAQ]] first, and if you don't find answers, add your questions! (Odds are that any '''adr''' question will apply to [[hCard]] as well).
* See also [http://microformats.org/discuss/ for other methods of feedback].

=== Issues ===
* Please add any issues with the specification to the separate [[hcard-issues|hCard issues]] document. Ditto.

== Related Pages ==
{{adr}}