Wikipedia:COinS - Revision history

Tachyony: ←Replaced content with ''

2022-04-04T09:32:57Z

←Replaced content with ''

Tachyony: ←Created page with '{{redirect|WP:COINS|the WikiProject on coins|Wikipedia:WikiProject Numismatics}} {{for|ContextObjects in Spans other than on Wikipedia|COinS}} {{information page...'

2022-04-04T09:32:35Z

←Created page with '{{redirect|WP:COINS|the WikiProject on coins|Wikipedia:WikiProject Numismatics}} {{for|ContextObjects in Spans other than on Wikipedia|COinS}} {{information page...'

New page

{{redirect|WP:COINS|the WikiProject on coins|Wikipedia:WikiProject Numismatics}}
{{for|ContextObjects in Spans other than on Wikipedia|COinS}}
{{information page|WP:COINS}}
[[Image:Zotero and OpenURL referrer example showing available references.png|thumb|300px|In this example, Zotero is displaying the references it can retrieve. The OpenURL referrer is responsible for the ''Find in a library'' links.]]
'''ContextObjects in Spans''' ('''COinS''') is a method of embedding latent [[OpenURL]] [[COinS|ContextObject]]s in web pages. This allows client software to retrieve [[bibliographic]] [[metadata]] and to use an [[OpenURL]] [[Resolver (DNS)|resolver]] to find a mediated link. A principal advantage of using COinS, rather than giving a static OpenURL, is that the client can determine which resolver to use. This allows, for instance, searching for a copy of a book in one's own library.

COinS have been added to various parts of Wikipedia. They are basically just a chunk of [[bibliographic]] information stored in a way that machines can read. This has two applications:

* The information can be converted into a full [[OpenURL]] and resolved by a local OpenURL resolver. For instance, with [[LibX]], OpenURL referrer,<ref>{{cite web |url=http://www.openly.com/openurlref/ |title=OpenURL Referrer |website=OCLC |archive-url=https://web.archive.org/web/20161015040903/http://www.openly.com/openurlref/ |archive-date=2016-10-15}}</ref> or a similar extension or bookmarklet installed in Firefox, a link will appear after many of the books and journal articles in a Wikipedia article's ''References'' section. If the extension is configured correctly, the user can click a link after a book to check if his organization's library has a copy. If the organization has the appropriate access, clicking the link after a journal article may bring up a copy of the article.
* The information can be stored by bibliographic tools like [[Zotero]].<ref>{{cite web|url=https://www.zotero.org/support/kb/zotero_and_wikipedia|title=Zotero and Wikipedia / Wikidata |website=Zotero}}</ref> The tool can download the bibliographic information from an article into a personal library for future research and retrieval.
** Zotero also has Wikipedia export,<ref>{{cite web |url=https://www.zotero.org/blog/zotero-wikipedia-perfect-together/ |title=Zotero & Wikipedia: Perfect Together |website=Zotero}}</ref> which allows references to be dragged into a Wikipedia edit box, where they will appear formatted as Wikipedia [[Wikipedia:citation templates|citation templates]].

So far, COinS have been added to:

* [[Wikipedia:Book sources]] – just contains the ISBN
* Many citation templates and infoboxes – see: [[:Category:Templates generating COinS]]
* [[MediaWiki:Citethispage-content]] – generated when you click ''Cite this article''; contains information for [[Wikipedia:Citing Wikipedia|citing Wikipedia]] itself in other documents

==Template==
For use on templates generating COinS:

{{tl|UF-COinS}}

It adds pages to the above category.

==Templates needing COinS==
COinS could, and should, be added to these templates:

* {{tl|Infobox comics character}}
* {{tl|Infobox graphic novel}}

==COinS in citation templates==
The COinS keys used in most {{cs1}} templates are listed at [[Module talk:Citation/CS1/COinS]].

For example:

<div style="overflow:auto;">
{{markup
|<nowiki>{{cite book |last=Bloggs |first=Fred |editor-first=John |editor-last=Doe |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}</nowiki>
|{{cite book |last=Bloggs |first=Fred |editor-first=John |editor-last=Doe |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}
}}
</div>

Which renders the following HTML:

<div style="overflow:auto;">
{{code|
{{cite book |last=Bloggs |first=Fred |editor-first=John |editor-last=Doe |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}
}}
</div>

Picking out the COinS keys:

<div style="overflow:auto;">
{| class="wikitable"
! Key || Data
|-
| rfr_id || info:sid/en.wikipedia.org:
|-
| rft.atitle || Big Compilation Book with Many Chapters and Distinct Chapter Authors
|-
| rft.au || Bloggs, Fred
|-
| rft.aufirst || Fred
|-
| rft.aulast || Bloggs
|-
| rft.btitle || Chapter 2: The History of the Bloggs Family
|-
| rft.date || 2001-01-01
|-
| rft.genre || bookitem
|-
| rft.isbn || 978-1-234-56789-7
|-
| rft.pages || 100-110
|-
| rft.pub || Book Publishers
|-
| rft_val_fmt || info:ofi/fmt:kev:mtx:book
|}
</div>

===Pollution===
{{update|reason=The information about this particular example is factually incorrect and outdated. However, there are other cases, where the metadata still gets polluted, f.e. chemical and math title renderings. The text should therefore be updated to a better example.}}

Incorrect data in fields can pollute the metadata. For example, adding all of the authors into the {{para|authors}} field:

<div style="overflow:auto;">
{{markup
|<nowiki>{{cite book |authors=Smith, John; Johnson, Joe; Green, Ethan |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}</nowiki>
|{{cite book |authors=Smith, John; Johnson, Joe; Green, Ethan |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}
}}
{{code|{{cite book |authors=Smith, John; Johnson, Joe; Green, Ethan |title=Big Compilation Book with Many Chapters and Distinct Chapter Authors |publisher=Book Publishers |date=January 1, 2001 |pages=100–110 |chapter=Chapter 2: The History of the Bloggs Family |isbn=978-1-234-56789-7}}
}}
</div>

This would pollute the metadata, therefore the citation template suppresses the generation of metadata for {{para|authors}}, thereby omitting vital citation data from being submitted.

<div style="overflow:auto;">
{| class="wikitable"
! Key || Data
|-
| rft.au || Smith, John; Johnson, Joe; Green, Ethan
|-
| rft.aufirst || not used
|-
| rft.aulast || Smith, John; Johnson, Joe; Green, Ethan
|}
</div>

==See also==
* The planned [http://microformats.org/wiki/cite citation microformat]

== References ==

{{reflist|30em}}

{{Citation metadata navbox}}

← Older revision		Revision as of 09:32, 4 April 2022
Line 1:		Line 1:
−	~~{{redirect\|WP:COINS\|the WikiProject on coins\|Wikipedia:WikiProject Numismatics}}~~	+	<!--Wikipedia:COinS-->
−	~~{{for\|ContextObjects in Spans other than on Wikipedia\|COinS}}~~
−	~~{{information page\|WP:COINS}}~~
−	[[Image:Zotero and OpenURL referrer example showing available references.png\|thumb\|300px\|In this example, Zotero is displaying the references it can retrieve. The OpenURL referrer is responsible for the ''Find in a library'' links.]]
−	'''ContextObjects in Spans''' ('''COinS''') is a method of embedding latent [[OpenURL]] [[COinS\|ContextObject]]s in web pages. This allows client software to retrieve [[bibliographic]] [[metadata]] and to use an [[OpenURL]] [[Resolver (DNS)\|resolver]] to find a mediated link. A principal advantage of using COinS, rather than giving a static OpenURL, is that the client can determine which resolver to use. This allows, for instance, searching for a copy of a book in one's own library.
−
−	~~COinS have been added to various parts of Wikipedia. They are basically just a chunk of [[bibliographic]] information stored in a way that machines can read. This has two applications:~~
−
−	* The information can be converted into a full [[OpenURL]] and resolved by a local OpenURL resolver. For instance, with [[LibX]], OpenURL referrer,<ref>{{cite web \|url=http://www.openly.com/openurlref/ \|title=OpenURL Referrer \|website=OCLC \|archive-url=https://web.archive.org/web/20161015040903/http://www.openly.com/openurlref/ \|archive-date=2016-10-15}}</ref> or a similar extension or bookmarklet installed in Firefox, a link will appear after many of the books and journal articles in a Wikipedia article's ''References'' section. If the extension is configured correctly, the user can click a link after a book to check if his organization's library has a copy. If the organization has the appropriate access, clicking the link after a journal article may bring up a copy of the article.
−	* The information can be stored by bibliographic tools like [[Zotero]].<ref>{{cite web\|url=https://www.zotero.org/support/kb/zotero_and_wikipedia\|title=Zotero and Wikipedia / Wikidata \|website=Zotero}}</ref> The tool can download the bibliographic information from an article into a personal library for future research and retrieval.
−	** Zotero also has Wikipedia export,<ref>{{cite web \|url=https://www.zotero.org/blog/zotero-wikipedia-perfect-together/ \|title=Zotero & Wikipedia: Perfect Together \|website=Zotero}}</ref> which allows references to be dragged into a Wikipedia edit box, where they will appear formatted as Wikipedia [[Wikipedia:citation templates\|citation templates]].
−
−	~~So far, COinS have been added to:~~
−
−	* [[Wikipedia:Book sources]] – just contains the ISBN
−	* Many citation templates and infoboxes – see: [[:Category:Templates generating COinS]]
−	* [[MediaWiki:Citethispage-~~content]] – generated when you click ''Cite this article''; contains information for [[Wikipedia:Citing~~ Wikipedia~~\|citing Wikipedia]] itself in other documents~~
−
−	~~==Template==~~
−	~~For use on templates generating COinS:~~
−
−	~~{{tl\|UF-COinS}}~~
−
−	~~It adds pages to the above category.~~
−
−	~~==Templates needing COinS==~~
−	~~COinS could, and should, be added to these templates:~~
−
−	* {{tl\|Infobox comics character}}
−	* {{tl\|Infobox graphic novel}}
−
−	~~==COinS in citation templates==~~
−	~~The COinS keys used in most {{cs1}} templates are listed at [[Module talk:Citation/CS1/COinS]].~~
−
−	~~For example:~~
−
−	~~<div style="overflow:auto;">~~
−	~~{{markup~~
−	\|<nowiki>{{cite book \|last=Bloggs \|first=Fred \|editor-first=John \|editor-last=Doe \|title=Big Compilation Book with Many Chapters and Distinct Chapter Authors \|publisher=Book Publishers \|date=January 1, 2001 \|pages=100–110 \|chapter=Chapter 2: The History of the Bloggs Family \|isbn=978-1-234-56789-7}}</nowiki>
−	\|{{cite book \|last=Bloggs \|first=Fred \|editor-first=John \|editor-last=Doe \|title=Big Compilation Book with Many Chapters and Distinct Chapter Authors \|publisher=Book Publishers \|date=January 1, 2001 \|pages=100–110 \|chapter=Chapter 2: The History of the Bloggs Family \|isbn=978-1-234-56789-7}}
−	}}
−	~~</div>~~
−
−	~~Which renders the following HTML~~:
−
−	~~<div style="overflow:auto;">~~
−	~~{{code\|~~
−	{{cite book \|last=Bloggs \|first=Fred \|editor-first=John \|editor-last=Doe \|title=Big Compilation Book with Many Chapters and Distinct Chapter Authors \|publisher=Book Publishers \|date=January 1, 2001 \|pages=100–110 \|chapter=Chapter 2: The History of the Bloggs Family \|isbn=978-1-234-56789-7}}
−	}}
−	~~</div>~~
−
−	~~Picking out the~~ COinS ~~keys:~~
−
−	~~<div style="overflow:auto;">~~
−	~~{\| class="wikitable"~~
−	~~! Key \|\| Data~~
−	\|-
−	~~\| rfr_id \|\| info:sid/en.wikipedia.org:~~
−	\|-
−	~~\| rft.atitle \|\| Big Compilation Book with Many Chapters and Distinct Chapter Authors~~
−	\|-
−	~~\| rft.au \|\| Bloggs, Fred~~
−	\|-
−	~~\| rft.aufirst \|\| Fred~~
−	\|-
−	~~\| rft.aulast \|\| Bloggs~~
−	\|-
−	~~\| rft.btitle \|\| Chapter 2: The History of the Bloggs Family~~
−	\|-
−	~~\| rft.date \|\| 2001-01-01<!-- this (normally invisible) metadata must be in ISO 8601 format and does not need to conform with MOS date format standards -->~~
−	\|-
−	~~\| rft.genre \|\| bookitem~~
−	\|-
−	~~\| rft.isbn \|\| 978-1-234-56789-7~~
−	\|-
−	~~\| rft.pages \|\| 100-110~~
−	\|-
−	~~\| rft.pub \|\| Book Publishers~~
−	\|-
−	~~\| rft_val_fmt \|\| info:ofi/fmt:kev:mtx:book~~
−	\|}
−	~~</div>~~
−
−	~~===Pollution===~~
−	{{update\|reason=The information about this particular example is factually incorrect and outdated. However, there are other cases, where the metadata still gets polluted, f.e. chemical and math title renderings. The text should therefore be updated to a better example.}}
−
−	~~Incorrect data in fields can pollute the metadata. For example, adding all of the authors into the {{para\|authors}} field:~~
−
−	~~<div style="overflow:auto;">~~
−	~~{{markup~~
−	\|<nowiki>{{cite book \|authors=Smith, John; Johnson, Joe; Green, Ethan \|title=Big Compilation Book with Many Chapters and Distinct Chapter Authors \|publisher=Book Publishers \|date=January 1, 2001 \|pages=100–110 \|chapter=Chapter 2: The History of the Bloggs Family \|isbn=978-1-234-56789-7}}</nowiki>
−	\|{{cite book \|authors=Smith, John; Johnson, Joe; Green, Ethan \|title=Big Compilation Book with Many Chapters and Distinct Chapter Authors \|publisher=Book Publishers \|date=January 1, 2001 \|pages=100–110 \|chapter=Chapter 2: The History of the Bloggs Family \|isbn=978-1-234-56789-7}}
−	}}
−	{{code\|{{cite book \|authors=Smith, John; Johnson, Joe; Green, Ethan \|title=Big Compilation Book with Many Chapters and Distinct Chapter Authors \|publisher=Book Publishers \|date=January 1, 2001 \|pages=100–110 \|chapter=Chapter 2: The History of the Bloggs Family \|isbn=978-1-234-~~56789~~-~~7}}~~
−	}}
−	~~</div>~~
−
−	~~This would pollute the metadata, therefore the citation template suppresses the generation of metadata for {{para\|authors}}, thereby omitting vital citation data from being submitted.~~
−
−	~~<div style="overflow:auto;"~~>
−	~~{\| class="wikitable"~~
−	~~! Key \|\| Data~~
−	\|-
−	~~\| rft.au \|\| Smith, John; Johnson, Joe; Green, Ethan~~
−	\|-
−	~~\| rft.aufirst \|\| not used~~
−	\|-
−	~~\| rft.aulast \|\| Smith, John; Johnson, Joe; Green, Ethan~~
−	\|}
−	~~</div>~~
−
−	~~==See also==~~
−	* The planned [http://microformats.org/wiki/cite citation microformat]
−
−	~~== References ==~~
−
−	~~{{reflist\|30em}}~~
−
−	~~{{Citation metadata navbox}}~~