Help:VCard format
| VCard format |
|---|
| What: |
| Exports data in vCard format. |
| Provided by: |
| Semantic Result Formats |
| Added in version: |
| 1.4.2 |
| Removed in version: |
| still supported |
| Further Requirements: |
| none |
| Format name: |
| vcard |
| Authors: |
| Markus Krötzsch, Denny Vrandecic, Frank Dengler |
| Categories: |
| export |
The result format vcard, part of Semantic Result Formats, is used to produce links for downloading data from a wiki in vCard format.
Contents |
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| limit | Whole number | 20 | The maximum number of results to return |
| offset | Whole number | 0 | The offset of the first result |
| headers | Text | show | Display the headers/property names |
| mainlabel | Text | no | The label to give to the main page name |
| link | Text | all | Show values as links |
| searchlabel | Text | no | The text for the link to results |
Example
{{#ask: [[Category:Person]]
| ?firstname
| ?lastname
| ?url = homepage
| format=vcard
}}
This would display a link to download the vCard. Examples can be found on any person page on semanticweb.org, e.g. http://semanticweb.org/wiki/Markus_Kr%C3%B6tzsch.
Data fields
Properties in printout statements should use one of the following labels, or otherwise are ignored in the resulting vCard. The available fields are: name (displayed full name), prefix (something like "Dr."), suffix (something like "Jr."), firstname, extraname (middle name), lastname, birthday (a date), homepage, note (any other text), email, workphone, cellphone, homephone, organization, workpostofficebox, workextendedaddress, workstreet, worklocality, workregion, workpostalcode, workcountry, homepostofficebox, homeextendedaddress, homestreet, homelocality, homeregion, homepostalcode, homecountry. Most fields including the phone numbers have no special format and will take whatever you give them.
Remarks
Lists of vCards work very well on most address book tools with the notable exception of MS Outlook. Outlook users can only import the first contact in each vCard file, and must therefore import contacts individually from many links, or consider moving to another tool for personal information management, such as Thunderbird. Outlook also is reported to fail at character decoding in some cases, e.g. if names use non-latin letters.
