hcard-faq

(Difference between revisions)

Jump to: navigation, search
m (How do you create non English tooltips: Typo)
m (How do you create non English tooltips: Typo)
Line 249: Line 249:
* "N" can be implied from "FN" when the content of "FN" is broken into two "words" separated by whitespace. For this purpose, a "word" is any sequence of non-whitespace characters including but not limited to low- and high-range alphanumerics and punctuation. A "word" can be characterised by the following regular expression: <pre><nowiki>/\S+/</nowiki></pre>
* "N" can be implied from "FN" when the content of "FN" is broken into two "words" separated by whitespace. For this purpose, a "word" is any sequence of non-whitespace characters including but not limited to low- and high-range alphanumerics and punctuation. A "word" can be characterised by the following regular expression: <pre><nowiki>/\S+/</nowiki></pre>
-
=== How do you create non-English tooltips ===
+
=== How do you create non English tooltips ===
''My website is not in English and I want the tooltips to be in my native language''
''My website is not in English and I want the tooltips to be in my native language''
* Properties such as class="type" require an enumerated list of English words. It is possible to use your native language for the displaying tooltip, but still use the English work for the class="type" without it being shown.
* Properties such as class="type" require an enumerated list of English words. It is possible to use your native language for the displaying tooltip, but still use the English work for the class="type" without it being shown.

Revision as of 21:23, 7 April 2007

Contents

hCard FAQ

This page is for documenting Q&A about hCard. If you have a new question to ask, please consider first asking your question on the microformats-discuss mailing list. New questions and answers should be added to the end of the list. If you have a new question but not an answer, please add it to hCard issues.

Editing this Page

Please do not use "?" or other punctuation in the headers - it helps to keep the URLs to their fragment identifiers shorter and easier to read, copy/paste etc. See how-to-play for more wiki editing guidelines.

Q&A

How do I convert hCards to vCards for download on a site

Is there any live way to convert hCards to vCards for download on a site? In other words, I have added hCard to my page, but i'd like my users to have a 'download vCard' button.

<a href="http://feeds.technorati.com/contacts/YOURURLHERE">download vCard</a>

Consider using more user-friendly text as well, like Add to Address Book. There are many examples of this in the hCard Examples in the Wild page. Note that the Technorati Contacts Feed service is based on the open source XSLT "X2V" by Brian Suda and others. If you want, you can install X2V yourself and run your own local converter.

Should I use ADDRESS for hCards

Should I use the more semantic <address> element for my hCards?

Why is adr property necessary

What is the point of class="adr" when we have the <address> element?.- 2006-12-04 asked by Joshie Surber.

Why is url property necessary

Why is it necessary to put class name "url" on URL elements in the hCard when those hyperlinks already start with "http://", and that is enough to distinguish them from email links?

How do I support an existing vCard URL

I already have a vCard that I keep up-to-date. I don't want to change any references to it because it might break something else, what can I do?

RewriteRule ^path/to/old.vcf http://suda.co.uk/projects/X2V/get-vcard.php\?uri=http://example.com/hCard_encoded.htm&filename=old.vcf

Now you shouldn't have to do anything else, all links to the "old.vcf" are redirected to the webservice and will return a new vCard that is dynamially generated from your page.

I think that using 'Redirect' is better than using mod_rewrite (is not enabled on some hosts) --Robert Bachmann

Redirect /path/to/old.vcf http://suda.co.uk/projects/X2V/get-vcard.php?uri=http://example.com/hCard_encoded.htm&filename=old.vcf

What are plural hCard properties

Is there a list of all hCard properties which can be plural?
Is there a list of all the properties which can have multiple instances?

Old previous answer:

What does FN stand for

What does FN stand for?

Type purpose: To specify the formatted text corresponding to the name of the object the vCard represents.

How is gender represented

How do you represent gender in hCard?

<span class="honorific-prefix">Mr.</span>

or

<span class="honorific-prefix">Ms.</span>

This approach does have the limitation that "Mr." and "Ms." (or "Miss"/ "Mrs.") may conflict with a higher-ranking, gender-neutral honorific, such as "Dr." or "Rev." for the person, as it is unusual to refer to someone as "Mr. Dr." or "Mrs. Rev." for example. See hcard-issues.

Note that there is also a page on MSDN that mentions vCard and "gender". Not sure what to make of that. Note also Google search for "vCard.Gender".

Gender could be represented with a genealogical microformat, but that seems like overkill.

Instead, you could use tags/categories to tag people's hCards with their gender, "male", "female", or any other tag you feel is appropriate. See gender identity for more on the topic.

See also vcard-suggestions#Gender.

Can a hCard contain extra elements

Is it OK for an hCard node to contain extra elements?

Can a GEO be inferred from an ADR in an hCard

Can I automatically add GEO from an address when transforming an hCard to vCard if it is not present?

X2V does not convert email with name as plain text

X2V doesn't convert my email address correctly, it is in the form href="FirstName LastName <Email@example.com>"

One possible valid hCard markup would be:

<span class="vcard">
  <span class="fn">Firstname Lastname</span>
 &lt;<a class="email" href="mailto:Email@example.com">Email@example.com</a>&gt;
</span>


This might be displayed as:

Firstname Lastname <email@example.com>

What hCard properties are required

What properties are required in an hCard?

Does N property require all sub-properties

If I use the 'n' property, do I have to use ALL of the sub-properties?

Do FN and N need to be on same element

Do the 'fn' and 'n' properties have to be on the same element?

<p class="vcard">My name is
<span class="n">
<span class="honorific-prefix">Mr.</span>
<span class="given-name">John</span>
<span class="additional-name">Q</span>
<span class="family-name">Public</span>
</span>
but you can just call me
<span class="fn">Johnny</span>
</p>

How do you convert a vCard to an hCard

Is there a way to convert a vCard to an hCard?

Are descendant elements recognized in a microformat

Are descendants recognized in a microformat property?

<span class="country-name">United States <small>of</small> America</span>

The output would be "United States of America".

Do properties like TEL use all descendants

Do properties like TEL use all descendants? e.g.
<span class="tel"><span class="type">Home</span>:<span class="value">+1.234.567.8900</span></span>

Shouldn't that output be "TEL:Home: +1.234.567.8900"?

Can you have multiple value elements

Can you have multiple class="value" elements inside a property and what happens to them?

<span class="tel"><span class="type">Home</span>:<span class="value">+1</span>.<span class="value">234</span>.<span class="value">567</span>.<span class="value">8900</span></span>
would output: "+12345678900".

Can you mix properties and the root class name

Can you put properties on the same element as the root class for a microformat? E.g. class="vcard fn"?

Can you mix a property and its sub-properties

Can singular sub-properties be mixed with parents?

Can you use query strings on email

What happened to the Query String on my email address?

Are ADR and TEL types case sensitive

Is the list of possible types for an ADR and TEL case sensitive?

How does GEO work with ABBR

What happens to the GEO sub-properties when GEO is used with ABBR?


<span class="geo">
<span class="latitude">123.45</span>
<span class="longitude">67.89</span>
</span>

<abbr class="geo" title="123.45;67.89">My House</abbr>

When used with an <abbr> element the latitude and longitude are separated by a semicolon.

Why does hCard use vcard as the root class name

hCard maps the properties and values of the vCard standard (RFC2426), hence the use of the vcard class name inside the HTML markup. More background on the reasons behind that decision here: hCard Parsing: Root Class Name.

How do you mark up a phone extension

How do I mark up a phone extension in hCard? There doesn't seem to be a way to declare a telephone extension in the vCard RFC 2426 spec, the suggested way is currently:

<span class="tel">
    <span class="type">work</span>: <span class="value">800 555-1212 x 1234</span>
</span>

RFC 3966 suggests that an extension be indicated with ";ext=" for example:

<span class="tel">
    <span class="type">work</span>: <span class="value">800 555-1212;ext=1234</span>
</span>

although that is more relevant when used as a URI:

<span class="tel">
    <span class="type">work</span>: <a class="value" href="tel:+18005551212;ext=1234">800 555-1212;ext=1234</a>
</span>

ITU-T Recommendation E.123 1.6 specifies the use of the word "extension" or abbreviation thereof:

   Telephone International +22 607 123 4567 ext. 876

The above example may be better as:

<span class="tel">
    <span class="type">work</span>: <a class="value" href="tel:+18005551212;ext=1234">800 555-1212 ext. 1234</a>
</span>

How do you encode IM accounts

How do I encode my IM account in hCard?

Can you hCard the deceased

How do you make an hCard for the deceased?

Any plans for xparams

Are there plans to include x-parameters in future versions of hCard?

What is a word in implied optimizations

What constitutes a "word" for the purpose of 'implied-n optimization'?

How do you create non English tooltips

My website is not in English and I want the tooltips to be in my native language

<abbr class="type" title="home">
 <span title="[your native word for home here]">
  to my home
 </span>
</abbr>

Having an span with a title attribute inside the abbr element will only display the title on the span, where you have the text (your native word for home here).

How do you add categories to an hCard

How do you add categories to an hCard?

<a class="category" rel="tag" 
   href="http://en.wikipedia.org/wiki/microformats">microformats</a>

Why not put type for tel or adr into class

Why not put the 'type' value for the 'tel' or 'adr' properties into the class name? E.g. <span class="fax">(415) 555-1212</span>

How do I markup multiple addresses

How do I markup separate addresses, like for home and work?

<div class="adr">
 <span class="type">home</span> address:
 <div class="street-address">123 Main Street</div>
 <span class="locality">Any Town</span>, <span class="region">CA</span>, 
 <span class="postal-code">91921-1234</span>
</div>
<div class="adr">
 <span class="type">work</span> address:
 <div class="street-address">789 Main Street</div>
 <span class="locality">Any Town</span>, <span class="region">CA</span>, 
 <span class="postal-code">91921-1234</span>
</div>

As a result, note that each element with class name "adr" is treated as a separate address with its own subproperties and values.


Related Pages

The hCard specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.

hcard-faq was last modified: Wednesday, December 31st, 1969

Views