User:G.Hagedorn/Chromis abyssis
THIS PAGE IS A COPY AS A TEMPLATE FOR TESTING - please do not delete for a while
Wikipedia: http://en.wikipedia.org/wiki/Chromis_abyssus
- Same species from plazi: http://plazi2.cs.umb.edu/GgServer/html?30E2ACE97FCC02A34806994547F8E1F5
Todo: Chromis earina
- Same species from plazi: http://plazi2.cs.umb.edu/GgServer/html?736FA380AD05323C45BA7EA1F2660249
Todo: Anochetus boltoni
- Same species from plazi: http://plazi2.cs.umb.edu/GgServer/html?8AD0DAEF2180649D27DBA7CE08E4FF93
Cooking recipe for a Wikipedia species page (stub)[edit]
Page Name[edit]
First verify the page does not exist in the target wiki: Check for a page with the scientific name, using the wiki API (see http://www.mediawiki.org/wiki/API). For "Chromis abyssus" you search for (use scientific name without authors, replace blank with underscore): http://en.wikipedia.org/w/api.php?action=query&titles=Chromis_abyssus - the result indicates it exists (id is present). For http://en.wikipedia.org/w/api.php?action=query&titles=Chromis_earina the result indicates no such page exists.
If not existing, it is desirable to upload a stub.
G.Sautter: The XML-based check for the pre-existence of the article seems to be simple. But how does uploading a stub work? If it involves clicking a series of buttons or following a sequene of generated links, it's going to be some effort ...
Page HEADER (taxobox)[edit]
The page should start with an expression indicating that the title should be italicized (it is also possible to have more complex expressions for mixed formatting)
followed by a Taxobox with structured information. Taxobox is a flat structure with 135 properties (called "parameters" in mediawiki). It is documented on: http://en.wikipedia.org/wiki/Wikipedia:TAXOBOX
TODO: we need to map the plazi information to the following overview:
PLEASE ADD THE xml elements, e.g. as xpath, or anything suitable to be used in the creation of xslt in the following list. I have loosely marked some elements, without deciding how to reference them in the plazi xml.
{{Taxobox
| color IGNORE
| name common name, example: Deep blue chromis
| status protection/endangered species status
| status_system
| status_ref
| fossil_range IGNORE
| image IGNORE
| image_width IGNORE
| image_alt IGNORE
| image_caption IGNORE
| image2 IGNORE
| image2_width IGNORE
| image2_alt IGNORE
| image2_caption IGNORE
| virus_group IGNORE
| domain IGNORE
| domain_authority IGNORE
| unranked_regnum IGNORE
| unranked_regnum_authority IGNORE
| superregnum IGNORE
| superregnum_authority IGNORE
| regnum EXAMPLE: [[Animalia]]
| regnum_authority IGNORE
| subregnum IGNORE
| subregnum_authority IGNORE
| unranked_phylum IGNORE
| unranked_phylum_authority IGNORE
| superdivisio IGNORE
| superdivisio_authority IGNORE
| superphylum IGNORE
| superphylum_authority IGNORE
| divisio IGNORE
| divisio_authority IGNORE
| unranked_divisio IGNORE
| unranked_divisio_authority IGNORE
| phylum EXAMPLE: [[Chordata]]
| phylum_authority IGNORE
| subdivisio IGNORE
| subdivisio_authority IGNORE
| subphylum IGNORE
| subphylum_authority IGNORE
| infraphylum IGNORE
| infraphylum_authority IGNORE
| microphylum IGNORE
| microphylum_authority IGNORE
| nanophylum IGNORE
| nanophylum_authority IGNORE
| unranked_classis IGNORE
| unranked_classis_authority IGNORE
| superclassis IGNORE
| superclassis_authority IGNORE
| classis CLASS, example: [[Actinopterygii]]
| classis_authority IGNORE
| subclassis IGNORE
| subclassis_authority IGNORE
| infraclassis IGNORE
| infraclassis_authority IGNORE
| unranked_ordo IGNORE
| unranked_ordo_authority IGNORE
| magnordo IGNORE
| magnordo_authority IGNORE
| superordo IGNORE
| superordo_authority IGNORE
| ordo ORDER, example: [[Perciformes]]
| ordo_authority IGNORE
| subordo IGNORE
| subordo_authority IGNORE
| infraordo IGNORE
| infraordo_authority IGNORE
| parvordo IGNORE
| parvordo_authority IGNORE
| zoodivisio IGNORE
| zoodivisio_authority IGNORE
| zoosectio IGNORE
| zoosectio_authority IGNORE
| zoosubsectio IGNORE
| zoosubsectio_authority IGNORE
| unranked_familia IGNORE
| unranked_familia_authority IGNORE
| superfamilia IGNORE
| superfamilia_authority IGNORE
| familia FAMILY, example: [[Pomacentridae]]
| familia_authority IGNORE
| subfamilia
| subfamilia_authority
| supertribus
| supertribus_authority
| tribus
| tribus_authority
| subtribus
| subtribus_authority
| genus GENUS NAME, example ''[[Chromis]]'' (XPath: treatment/subSubSection[./@type = 'nomenclature'][1]/taxonomicName[1]/@genus)
| genus_authority IGNORE
| genus2 IGNORE
| genus2_authority IGNORE
| subgenus (XPath: treatment/subSubSection[./@type = 'nomenclature'][1]/taxonomicName[1]/@subGenus)
| subgenus_authority
| sectio
| sectio_authority
| series
| series_authority
| species_group
| species_group_authority
| species_subgroup
| species_subgroup_authority
| species_complex
| species_complex_authority
| species Abbrev. Genus plus species epithet. Example: '''''C. abyssus''''' (XPath: treatment/subSubSection[./@type = 'nomenclature'][1]/taxonomicName[1]/@species)
| species_authority SPECIES AUTHORITY. Example: Pyle, 2008 (XPath: document/@docAuthor + ', ' + document/@docDate)
| subspecies (XPath: treatment/subSubSection[./@type = 'nomenclature'][1]/taxonomicName[1]/@subSpecies)
| subspecies_authority
| diversity IGNORE
| diversity_link IGNORE
| binomial Example''Chromis abyssus'' (XPath: genusXPath (see above) + speciesXPath (see above))
| binomial_authority
| trinomial
| trinomial_authority
| type_species (For Genera and up)
| type_species_authority
| subdivision
| subdivision_ranks
| type_strain (or specimen, if available)
| range_map IGNORE
| range_map_width IGNORE
| range_map_alt IGNORE
| range_map_caption IGNORE
| binomial2 IGNORE
| binomial2_authority IGNORE
| range_map2 IGNORE
| range_map2_width IGNORE
| range_map2_alt IGNORE
| range_map2_caption IGNORE
| binomial3 IGNORE
| binomial3_authority IGNORE
| range_map3 IGNORE
| range_map3_width IGNORE
| range_map3_alt IGNORE
| range_map3_caption IGNORE
| binomial4 IGNORE
| binomial4_authority IGNORE
| range_map4 IGNORE
| range_map4_width IGNORE
| range_map4_alt IGNORE
| range_map4_caption IGNORE
| synonyms A list of synonyms
}}
Text stub[edit]
Every wikipedia article needs, in addition to to the taxobox, at least an introductory sentence. In the following, I use the {{{parametername}}} convention to show the variable insertions:
{{{common name}}} (''{{{scientific name}}}'')
is a {{{taxonomic rank}}} of {{{genus}}} first
>> OPTIONALLY IF KNOWN: discovered in 1997 and <<
described in {{{publication year}}}.<ref name="original">{{{full
text of the original species publication}}}
Examples for references: <ref>{{cite web | url = http://www.eol.org/pages/209984?category_id=249 | title = Chromis abyssus Pyle, Earle & Greene, 2008 | publisher = [[Encyclopedia of Life]] | author = Richard L. Pyle }}</ref><ref>{{cite web | url = http://www.zoobank.org/?lsid=urn:lsid:zoobank.org:act:8BDC0735-FEA4-4298-83FA-D04F67C3FBEC | title = Chromis abyssus Pyle, Earle & Greene 2008 | publisher = [[ZooBank]] }}</ref>
QUESTION: can we also generate something very brief like: "The 8 centimetres (3.1 in) fish only lives more than 110 metres (361 ft) below the surface of the Pacific Ocean around the coast of the Ngemelis Islands, Palau. Adults have been observed living singly or in pairs whereas juveniles tend to live in groups." ?
G.Sautter: such a summary would be very nice to have. I'm afraid, through, that it is hard to generate automatically ... automated text summarization has not progressed far enough (to my best knowledge) to use it here, as its results would likely be embarrassing and therefore jeopardize our efforts going public. The only two ways to have a summary are to either (a) extract it literally from the treatment, meaning we have only a summary if the treatment contains one, or (b) write it manually, which would be way too much effort for all the treatments we have.
DA I think, we might be able to so, or at least we should aim at being able to. If we mark up to MC we then could (Guido tell me, whether this is something we can do) extract at least the information of the country of occurence, and we should be able to say, when the type has been collected. So we could create a statement like this
"This species has been discovered by UUUU (the author of the paper, or better the one listed in the nomenclature section) in yyyy (the year of the publication) from specimens collected in xxxx (the year from the type specimen). It is known to occur from ZZZZ, ZZZZ, ZZZZ (country where it occurs)." Then I link to the reference at the bottom of the page could be added. From there a link to a place where the original publication is available.
This would be again a motivation to mark up at least to Materials Citation and get the country as well as the type information marked up.
Original description[edit]
Create a new heading and introductory note such as:
== Original description == The following description is cited from the original species publication:
Insert the original description from Plazi.
== Etymology == The name of the species is derived as follows::
Insert the information from Plazi.
DA the question here is whether we want to include the entire treatment, or only part of. May be we should not list the materials citation that would make the treatement very long. Since we will have a link back to Plazi or the original description, this is not neeed. In most publictions, there is a summary of the distribution we normally mark up as subsubsection "distribution".
References, links, categories[edit]
Insert
==References==
{{Reflist}}
== External links ==
{{wikispecies}}
* {{Encyclopedia of Life|209984}}
* {{Catalogue of Life|6190993}}
* ANY FURTHER LINKS: [http://aquatab.net/system/chromis-abyssus AQUATAB.NET]
{{DEFAULTSORT:{{{PLAZI-GENUS-NAME}}} {{{PLAZI-Species-epitheton}}}}}
[[Category:{{{PLAZI-GENUS-NAME}}}]]
and one of:
{{animal-stub}}
{{botany-stub}}
QUESTION: Anything more that you know is present and valuable in Plazi, but has not found a place yet?
- G.Sautter: how about a distribution map plotted from materials citations? Colorful images would surely beef up the appearance of our articles ...
- Gregor: Good idea, but that would require uploading the generated bitmap of svg to wikimedia.commons.org - it is an extra step.
Submitting the generated wiki-code[edit]
It is possible to submit wiki pages both through the index.php and the api.php. The first would simulate a standard edit form, the second would use a more advanced xml syntax (xml for the wrapper, the edited/uploaded content is still plain text with wiki markup). I assume api.php is more suitable to us.
There is one catch: before being able to write to the wiki, one has not only to sign in, but also obtain a so-called edit token which is valid for the duration of the session. This is done so that it is impossible to trick users that are currently logged in in a second window, with a simulated form to do ugly things on wiki.
So the process is approximately the following:
- Do a login: http://www.mediawiki.org/wiki/API:Login
- Obtain an edit token: http://www.mediawiki.org/wiki/API:Edit_-_Create%26Edit_pages, api request like: http://en.wikipedia.org/w/api.php?action=query&prop=info%7Crevisions&intoken=edit&titles=Main%20Page
- Send the new page (Create and Edit again). Note that there is no difference between updating a page and creating a new one - so it is important to have checked prior that the page does not exist yet.
For Java code to handle this, see Bliki, http://www.mediawiki.org/wiki/API:Client_Code#Java