currency-brainstorming: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (Reverted edit of XgtS0q, changed back to last version by AndyMabbett)
No edit summary
Line 14: Line 14:
   </p>
   </p>
</div></pre>
</div></pre>
<p>&quot;figure&quot; is there to both explicitly associate the code, sign and amount but also allow the potential for more than one currency figure to be placed within the container. It does anticipate further development though and is the most easily dropped item at the early stage.</p>
<p>
 
<p>Without figure:</p>
<pre><div class="currency">
    <span class="code">code</span>
    <span class="sign">symbol</span>
    <span class="amount">12345</span>
</div></pre>
 
<p>Super shortened, relying on the parser to identify everything via implied order/structure:</p>
 
<pre><div class="currency">ABC12345$</div></pre>
 
<p>Although the simplest solution, it has a notable vulnerability: some currencies have/had three-letter abbreviations for their currency sign, instead of a symbol. This would make it very difficult for a parser to accurately identify such a currency.</p>
<p>In addition, it should be noted that the order alone cannot be used to identify which parts are code, sign and amount; since many currencies are denoted with the sign <em>after</em> the number.</p>
 
<p>Super shortened, but specifying a currency code as a class:</p>
 
<pre><div class="currency ABC">12345$</div></pre>
 
<p>It defines...</p>
 
<ol type="a">
  <li>we're talking about money - ISO standard implied,</li>
  <li>we're talking about the USD variety,</li>
  <li>we're talking fifty units of that money,</li>
  <li>a parser could work out the numbers and the symbol.</li>
</ol>
 
<p>The biggest limitation I can see for that shorthand is that the currency code is not displayed visibly to human readers. The currency code is useful information to viewers and ideally should be displayed.</p>
 
<p>Shortened (including dropping 'figure', but explicitly defining and displaying the currency code. This would allow a parser to treat any remaining numbers as the amount; and any remaining a-z or symbol as the sign:</p>
 
<pre><div class="currency">
  <span class="code">ABC</span>12345$</p>
</div></pre>
 
===Charles Iliya Krempeaux===
<p>Maybe something like...</p>
 
<pre>Pay me <abbr class="currency" title="CAD">$</abbr>5.00 now!</pre>
 
<p>Although something like the the following might be better...</p>
 
<pre>Pay me <span class="money"><abbr class="currency" title="CAD">$</abbr>5.00</span> now!</pre>
 
<p>But it might be more semantic salt than is considered necessary.  Just having the abbr with the class-currency near a number might be good enough.  But that's open for discussion though.</p>
 
=== Ben Ward ===
<p>Could pure HTML be sufficient?</p>
<pre><html lang="en-gb">
<p>My new T-Shirts cost £30, but it cost my friend in Canada <span lang="en-ca">$34</span></p>
</html></pre>
 
===Arve Bersvendsen ===
<pre><p lang="nb">Den kanadiske prisen på t-skjorten var <span class="currency CAD">34 $</span>.</p></pre>
 
=== Mike Stickel ===
<pre><span class="money"><abbr class="currency" title="CAD eng">$</abbr><span class="amount">5.00</span></span></pre>
<p>In this format the wrapping would be "money" or something similar followed by either the actual "amount" or the "currency", depending on what rules your country/language follows in regards to the order. 
Since there can be a difference between different languages within countries I thought it might be a good idea to include that in the "currency" definition of the formating, eg., "CAD eng" or "CAD fr". 
It could also give sites that list multiple languages a way to differentiate when they show multiple prices.</p>
 
:Good idea, but shouldn't a Microformat use existing markup for language attributes, eg.
 
:<pre><span class="money"><abbr class="currency" title="CAD" lang="en">$</abbr><span class="amount">5.00</span></span></pre>
 
:Reference [http://www.w3.org/TR/html4/struct/dirlang.html#h-8.1 w3.org: 8.1 Specifying the language of content: the lang attribute]
:[[User:Bob Jonkman|Bob Jonkman]] 22:26, 12 Oct 2006 (PDT)
 
=== Ciaran McNulty ===
<p>The only microformat that I've noticed currency units in is [[hlisting-proposal|hListing]], and that deliberately shies away from parsing the actual values because it's too free-form in most existing Listing formats.</p>
 
<p>My own preference would be for something like:</p>
<pre><p class="money">This item costs
  <span class="currency">GBP</span>
  <span class="amount">10.00</span>
</p></pre>
 
<p>Which with similar parsing rules to existing formats would also allow things like:</p>
<pre><p class="money">
  It'll cost you
  <abbr class="currency" title="50.00">fifty</abbr>
  <abbr class="amount" title="GBP">quid</abbr>
  , mate!
</p></pre>
<p>Or, a more complex example with multiple languages:</p>
<pre>
<p lang="en">Price:
<span class="money">
  <abbr class="currency" title="GBP">&pound;</abbr> 
  <span class="amount">1,250.00</span>
</span>
<span lang="fr" class="money">
  (Prix:
  <span class="amount">1600,00</span>
  <abbr class="currency" title="EUR">&euro;</abbr>
  )
</span>
</p></pre>
 
===Andy Mabbett===
 
====Straw man proposal====
 
(this reflects Ciaran McNulty's proposals, above)
 
In order to use currency as a sub-class, the parent should be named 'money'
 
*money - class (required) '''[or "currency"?]'''
**currency - class (required; uses ISO 4217) '''[or "type"?]'''
**amount - class (required) '''[or "value"?]'''
**year - class (optional - for historic values only) (better "'''date'''", in [[datetime-design-pattern]]. Consider inflation in Germany in 1930s!)
**symbol - class (optional - so that we know whether the symbol is present; or whether it needs to be generated by the user agent; it will also help user agents to ignore $ and other such symbols, when used for purposes other than to indicate a currency, or to  remove them, when translating to a different currency.)
**unit - class (subdivison of currency; use as "symbol")
**equivalence - class (optional; conversion should be done by the user agent. Do we need this? Does it need a numeric value?)
 
All classes may occur only once, apart from ''symbol'' (to allow for "£14 6s 2d") and ''unit'' (to allow for "five pounds 23 pence").
 
=====Examples=====
Thus:
 
<pre><nowiki>
<span class="money">A widget costs
<abbr class="currency symbol" title="USD">$</abbr>
<span class="amount">12.57</span>
</span>
</nowiki></pre>
 
<pre><nowiki>
<tr>
<th>Spaghetti-knitter</th>
<td class="money">
<abbr class="currency" title="USD">
<span class="amount">42.67</span>
</abbr>
</td>
</tr>
</nowiki></pre>
 
<pre><nowiki>
<span class="money">
Can you spare
<abbr class="amount" title="10">ten</abbr>
<abbr class="currency" title="USD">
<span class="unit">dollars</span>
</abbr>?
</span>
</nowiki></pre>
 
<pre><nowiki>
<span class="money">
It was worth
<abbr class="amount" title="0.5">50</abbr>
<abbr class="currency" title="GBP">
<span class="unit">pence</span>.
</abbr>
</span>
</nowiki></pre>
(note, in the above, that "unit" does not relate directly to the amount in the amount's title abttibute - it's 0.5 pounds, not 0.5 pence.)
 
<pre><nowiki>
<span class="money">In
<span class="year">1857</span>
a Dickens novel cost
<abbr class="amount" title="0.05">1</abbr>
<abbr class="currency" title="GBP">
<abbr class="symbol unit" title="shilling">/</abbr>
</abbr>
</span>
</nowiki></pre>
 
(The above might be rendered as "... 1/ (worth £4.50 in modern terms" (or whatever the value would be).)
 
<pre><nowiki>
<span class="money">
<abbr class="amount" title="14.32">
<abbr class="currency" title="GBP">
<abbr class="symbol" title="pound">£</abbr>14
</abbr>
6<abbr class="unit" title="shilling">s</abbr>
4<abbr class="unit" title="old-penny">d</abbr>
</abbr>
</span>
</nowiki></pre>
 
<pre><nowiki>
<span class="money">
<abbr class="equivalence" title="EUR">
<abbr class="currency" title="FFR">10</abbr>
</abbr>
</span>
</nowiki></pre>
 
The following, simplified for clarity, from [http://en.wikipedia.org/wiki/1922_in_Germany#Inflation_and_Repercussions]:
 
<pre><nowiki>
    On
    <span class="currency">
<abbr class=date" title="1922-08-01>August 1</abbr>,
the US Dollar still stood at
<span class="value">643</span>
<abbr class="type="GDM">Marks</abbr>
    </span>
    to the Dollar. But on
    <span class="currency">
<abbr class=date" title="1922-09-05>September 5</abbr>
the dollar had already risen to
<span class="value">1,440</span>
<abbr class="type="GDM">Marks</abbr></span>
    </span>
</nowiki></pre>
 
Is there anything sensible which ''can't'' be done with the above?
 
=====Assumptions=====
 
*Working out values in secondary currencies is a (real-time or daily) job for server-side scripting or user agents.
 
*If "&pound;" is an abbreviation, then its title is "pounds sterling"; though note that "&pound;5" is pronounced as "five pounds sterling" (commonly just "five pounds") and not: "pounds sterling five" in the same way that "$5" is pronounced as: "five dollars" and not "dollars five"
 
=====Issues=====
 
*There will be complications where the entire currency has disappeared, (such as the last example; French Francs into Euros).
 
* Where no symbol or unit is involved (chiefly in tables, where they will be in the header cell), should we allow:
 
<pre><nowiki>
<tr>
<th>Spaghetti-knitter</th>
<td class="money USD amount">42.67</span></td>
</tr>
</nowiki></pre>
 
====HTML Entities====
 
*The following currency entities exist:
**<code>&curren;</code> - <code>& curren;</code> - currency
**<code>&cent;</code> - <code>& cent;</code> - cent
**<code>&pound;</code> - <code>& pound;</code> - pound
**<code>&yen;</code> - <code>& yen;</code> - yen
**<code>&euro;</code> - <code>& euro;</code> - Euro
 
===Guillaume Lebleu ===
 
In the context of a hListing's price, without a unit:
 
<pre>
<span class="price"><abbr class="currency" title="EUR">&euro;</abbr>100</span>
</pre>
 
Rendered view:
 
<span class="price"><abbr class="currency" title="EUR">&euro;</abbr>100</span>
 
In the context of a hListing's price, with a unit:
 
<pre>
<span class="price currencyamount"><abbr class="currency" title="USD">$</abbv><span
class="amount">25</span> <span class="unit" title="BLL">per
barrel</span></span>
</pre>
 
<pre>
<span class="price currencyamount"><span class="amount">25</span> <abbr class="currency"
title="USD">$</abbr><abbr class="unit" title="BLL">/bbl</abbr></span>
</pre>
 
Note: the class "amount" may not always be required, but it is useful when the amount is represented as text, or when the amount is mixed within text. See historical example below.
 
Rendered view:
 
<span class="price currencyamount"><abbr class="currency" title="USD">$</abbr><span
class="value">25</span> <span class="unit" title="BLL">per
barrel</span></span>
 
<span class="price currencyamount"><span class="amount">25</span> <abbr class="currency"
title="USD">$</abbr><abbr class="unit" title="BLL">/bbl</abbr></span>
 
Outside of the context of a hListing (not all currency amounts are prices, for instance sales numbers):
 
<pre>
<span class="currencyamount"><abbr class="currency" title="EUR">&euro;</abbr>100</span>
</pre>
 
Historical price (here currency rate):
 
<pre>
<span class="price currencyamount">On <abbr class="datetime"
title="1998-03-12T08:30:00-05:00">August 1</abbr>, the US Dollar still
stood at <span class="amount">643 <abbr class="currency"
title="DEM">Marks</abbr></span> to the <span class="unit currency"
title="USD">Dollar</span>.</span>
</pre>
 
In a table:
 
<pre>
<table>
  <tr>
      <th class="currencyamount price">Price (<abbr class="currency" title="CAD">C$</abbr>)</th> 
  </tr>
  <tr>
      <td>100</td>
  </tr>
</table>
</pre>
 
Rendered view:
 
<table>
  <tr>
      <th class="currencyamount price">Price (<abbr class="currency" title="CAD">C$</abbr>)</th> 
  </tr>
  <tr>
      <td>100</td>
  </tr>
</table>
 
=== Gary Jones ===
 
<pre><nowiki>
<span class="currency">
  <abbr class="type" title="CAD">$</abbr>
  <span class="value">5.00</span>
</span>
</nowiki></pre>
 
Renders as:
 
<span class="currency"><abbr class="type" title="CAD">$</abbr><span class="value">5.00</span></span>
 
If the formatting of a currency is such that the type symbol comes after the value, then simply swap the order of the elements containing the type and value classes.
 
I do think that the use of "type" and "value" classes would be better than variations of "currency_symbol" and "amount". It follows the same principles as some other elemental formats ([http://microformats.org/wiki/hcard#Value_excerpting value excerpting]), meaning it's [http://microformats.org/wiki/naming-principles#Minimal_Vocabulary easier to remember]  and implement, and even ISO4217 has codes for "currencies" that don't use symbols:
 
<pre><nowiki>
<span class="currency">
  <span class="value">23</span> ounces of
  <abbr class="type" title="XAG">gold</abbr>
</span>
</nowiki></pre>
 
Renders as:
 
<span class="currency"><span class="value">23</span> ounces of <abbr class="type" title="XAG">gold</abbr></span>
 
Following on from this, the use of a "money" class should not be used; currency does not ''have'' to be money, and having a "metal" class starts to make it convoluted. Currency is the parent of money, not the other way around.
 
===Mike Schinkel===
I'm taking Andy Mabbett's post and applying my thoughts to his.
 
Rather than:
 
<pre><nowiki>
<span class="money">A widget costs
<abbr class="currency symbol" title="USD">$</abbr>
<span class="amount">12.57</span>
</span>
</nowiki></pre>
 
Why not just:
 
<pre><nowiki>
A widget costs <span class="currency" title="USD">$12.57</span>
</nowiki></pre>
 
In the above, a number is assumed because their is not an "amount", and the number digit is the currency symbol.  I guess what I'm saying is if there is a number in the HTML and it is the correct number (which I think will be the 80 percentile case, give or take, then why require additional markup for it?)
 
Rather than:
 
<pre><nowiki>
<tr>
<th>Spaghetti-knitter</th>
<td class="money">
<abbr class="currency" title="USD">
<span class="amount">42.67</span>
</abbr>
</td>
</tr>
</nowiki></pre>
 
Just:
 
<pre><nowiki>
<tr>
<th>Spaghetti-knitter</th>
<td class="currency" title="USD">42.67</td>
</tr>
</nowiki></pre>
 
Or:
 
<pre><nowiki>
<tr>
<th>Spaghetti-knitter</th>
<td>
<span class="currency" title="USD">42.67</span>
</td>
</tr>
</nowiki></pre>
 
In this case, which is a little more complicated:
 
<pre><nowiki>
<span class="money">
Can you spare
<abbr class="amount" title="10">ten</abbr>
<abbr class="currency" title="USD">
<span class="unit">dollars</span>
</abbr>?
</span>
</nowiki></pre>
 
Why not use the following:
 
<pre><nowiki>
Can you spare
<span class="currency" title="USD">
<abbr class="amount" title="10">ten</abbr>
<span class="unit">dollars</span>
</span>?
</nowiki></pre>
 
Here:
 
<pre><nowiki>
<span class="money">
It was worth
<abbr class="amount" title="0.5">50</abbr>
<abbr class="currency" title="GBP">
<span class="unit">pence</span>.
</abbr>
</span>
</nowiki></pre>
 
Why not?
 
<pre><nowiki>
It was worth
<span class="currency" title="GBP">
<abbr class="amount" title="0.5">50</abbr>
<span class="unit">pence</span>
</span>?
</nowiki></pre>
 
I'm not going to try to mark up the following two since, thus far, [http://www.vizu.com/poll-vote.html?n=15067 no one has voted for dated money amounts or non-numerical representations] (those might be better expressed in their own microformat: ''hHistoricalCurrency''?):
 
<pre><nowiki>
<span class="money">In
<span class="year">1857</span>
a Dickens novel cost
<abbr class="amount" title="0.05">1</abbr>
<abbr class="currency" title="GBP">
<abbr class="symbol unit" title="shilling">/</abbr>
</abbr>
</span>
</nowiki></pre>
 
 
<pre><nowiki>
<span class="money">
<abbr class="amount" title="14.32">
<abbr class="currency" title="GBP">
<abbr class="symbol" title="pound">£</abbr>14
</abbr>
6<abbr class="unit" title="shilling">s</abbr>
4<abbr class="unit" title="old-penny">d</abbr>
</abbr>
</span>
</nowiki></pre>
 
I don't understand what this is trying to accomplish (it seems incomplete), so I can't mark it up.
 
<pre><nowiki>
<span class="money">
<abbr class="equivalence" title="EUR">
<abbr class="currency" title="FFR">10</abbr>
</abbr>
</span>
</nowiki></pre>
 
Again, I'm not going to try to mark up given [http://www.vizu.com/poll-vote.html?n=15067 the lack of interest in dated money amounts]:
 
<pre><nowiki>
    On
    <span class="currency">
<abbr class=date" title="1922-08-01>August 1</abbr>,
the US Dollar still stood at
<span class="value">643</span>
<abbr class="type="GDM">Marks</abbr>
    </span>
    to the Dollar. But on
    <span class="currency">
<abbr class=date" title="1922-09-05>September 5</abbr>
the dollar had already risen to
<span class="value">1,440</span>
<abbr class="type="GDM">Marks</abbr></span>
    </span>
</nowiki></pre>
 
My efforts attempt to minimize the disruption in the HTML file and only use additional markup when absolutely required. I believe some high volume websites still try to minimize the markup they serve, and this is bloated as it it. They may decide just to serve up a few digits rather than 50 character per price, especially on pages with lots of prices.
 
*The claimed "lack of interest" in dated amounts ignores the [[currency-examples|evidence that such figures are widely published on the web]]. Most of your preceding "why not"s ignore the [[abbr-design-pattern]]. [[User:AndyMabbett|Andy Mabbett]] 07:30, 2 Jan 2007 (PST)
 
==References==
* [http://www.iso.org/iso/en/prods-services/popstds/currencycodeslist.html The official list of ISO-4217 alphabetic and numeric codes]
* [http://en.wikipedia.org/wiki/ISO_4217 Wikipedia: ISO 4217]
*[http://en.wikipedia.org/wiki/List_of_circulating_currencies Wikipedia: List of circulating currencies]
 
==Related pages==
{{currency-related-pages}}

Revision as of 06:32, 23 June 2007

Brainstorming

Brainstorming for the proposed currency microformat.


Ben Buchanan

Verbose but extensible and explicitly defines all values (without breaking DRY):

<div class="currency">
  <p class="figure">
     <span class="code">code</span>
     <span class="sign">symbol</span>
     <span class="amount">12345</span>
  </p>
</div>