vCard : a file format standard for electronic business cards
http://zh.wikipedia.org/wiki/VCard
vCard是电子名片的文件格式标准。它一般附加在电子邮件之后,但也可以用于其它场合(如在互联网上相互交换)。
vCard可包含的信息有:姓名、地址资讯、电话号码、URL,logo,相片等。
历史
vCard(或称做Versitcard)最早是由Versit联盟于1995年提出的,当时联盟成员包括
苹果公司,AT&T科技(后来的朗讯),IBM及西门子。
在1996年十二月,格式的拥有权移至互联网邮件联盟(IMC),此联盟是由一些关注互联网电子邮件的公司所组成。
与vCard一同提出的用于数据交换的标准还有vCalendar,但现在被iCalendar所取代。
互联网邮件联盟已经声明它希望“所有的vCalendar开发者利用这些新的开放标准,并使软件能够同时兼容vCalendar 1.0和iCalendar。”
vCard标准的2.1版被电子邮件客户端广泛支持。
3.0版是一个包含在RFC 2425和RFC 2426中的IETF标准跟踪提案。
vCard的常用文件扩展名是.vcf。
不同的程序对vCard标准实现亦不同。
Mac OS X中的Address Book允许把所有联系人导出到一个vcf文件,
而Microsoft Outlook只能每人一个文件。
Linux中KDE的Kontact允许每个文件导入或导出一人或多人。
vCard文件样例
BEGIN:VCARD
VERSION:2.1
N:Gump;Forrest
FN:Forrest Gump
ORG:Gump Shrimp Co.
TITLE:Shrimp Man
TEL;WORK;VOICE:() -
TEL;HOME;VOICE:() -
ADR;WORK:;; Waters Edge;Baytown;LA;;United States of America
LABEL;WORK;ENCODING=QUOTED-PRINTABLE: Waters Edge=0D=0ABaytown, LA =0D=0AUnited States of America
ADR;HOME:;; Plantation St.;Baytown;LA;;United States of America
LABEL;HOME;ENCODING=QUOTED-PRINTABLE: Plantation St.=0D=0ABaytown, LA =0D=0AUnited States of America
EMAIL;PREF;INTERNET:forrestgump@walladalla.com
REV:20080424T195243Z
END:VCARD
http://en.wikipedia.org/wiki/VCard
BEGIN:VCARD
VERSION:2.1
N:Gump;Forrest
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;GIF:http://www.example.com/dir_photos/my_photo.gif
TEL;WORK;VOICE:() -
TEL;HOME;VOICE:() -
ADR;WORK:;; Waters Edge;Baytown;LA;;United States of America
LABEL;WORK;ENCODING=QUOTED-PRINTABLE: Waters Edge=0D=0ABaytown, LA =0D=0AUnited States of America
ADR;HOME:;; Plantation St.;Baytown;LA;;United States of America
LABEL;HOME;ENCODING=QUOTED-PRINTABLE: Plantation St.=0D=0ABaytown, LA =0D=0AUnited States of America
EMAIL;PREF;INTERNET:forrestgump@example.com
REV:20080424T195243Z
END:VCARD
BEGIN:VCARD
VERSION:3.0
N:Gump;Forrest;;Mr.
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;VALUE=URL;TYPE=GIF:http://www.example.com/dir_photos/my_photo.gif
TEL;TYPE=WORK,VOICE:() -
TEL;TYPE=HOME,VOICE:() -
ADR;TYPE=WORK:;; Waters Edge;Baytown;LA;;United States of America
LABEL;TYPE=WORK: Waters Edge\nBaytown, LA \nUnited States of America
ADR;TYPE=HOME:;; Plantation St.;Baytown;LA;;United States of America
LABEL;TYPE=HOME: Plantation St.\nBaytown, LA \nUnited States of America
EMAIL;TYPE=PREF,INTERNET:forrestgump@example.com
REV:--24T19::43Z
END:VCARD
BEGIN:VCARD
VERSION:4.0
N:Gump;Forrest;;;
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;MEDIATYPE=image/gif:http://www.example.com/dir_photos/my_photo.gif
TEL;TYPE=work,voice;VALUE=uri:tel:+---
TEL;TYPE=home,voice;VALUE=uri:tel:+---
ADR;TYPE=work;LABEL="100 Waters Edge\nBaytown, LA 30314\nUnited States of America"
:;; Waters Edge;Baytown;LA;;United States of America
ADR;TYPE=home;LABEL="42 Plantation St.\nBaytown, LA 30314\nUnited States of America"
:;; Plantation St.;Baytown;LA;;United States of America
EMAIL:forrestgump@example.com
REV:20080424T195243Z
END:VCARD
<?xml version="1.0" encoding="UTF-8"?>
<vcards xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<vcard>
<tel>
<parameters>
<type>
<text>work</text>
</type>
</parameters>
<uri>tel:+1-111-555-1212</uri>
</tel>
<adr>
<parameters>
<type><text>work</text></type>
<label><text>100 Waters Edge
Baytown, LA 30314
United States of America</text></label>
</parameters>
</adr>
<email><text>forrestgump@example.com</text></email>
</vcard>
</vcards>
["vcard",
[
["version", {}, "text", "4.0"],
["n", {}, "text", ["Gump", "Forrest", "", "", ""]],
["fn", {}, "text", "Forrest Gump"],
["org", {}, "text", "Bubba Gump Shrimp Co"],
["title", {} ,"text", "Shrimp Man"],
["photo", {"mediatype":"image/gif"}, "uri", "http://www.example.com/dir_photos/my_photo.gif"],
["tel", {"type":["work", "voice"]}, "uri", "tel:+1-111-555-1212"],
["tel", {"type":["home", "voice"]}, "uri", "tel:+1-404-555-1212"],
["adr",
{"label":"100 Waters Edge\nBaytown, LA 30314\nUnited States of America", "type":"work"},
"text",
["", "", "100 Waters Edge", "Baytown", "LA", "", "United States of America"]
],
["adr",
{"label":"42 Plantation St.\nBaytown, LA 30314\nUnited States of America", "type":"home"},
"text",
["", "", "42 Plantation St.", "Baytown", "LA", "", "United States of America"]
],
["email", {}, "text", "forrestgump@example.com"],
["rev", {}, "timestamp", "2008-04-24T19:52:43Z"]
]
]
hCard is a microformat that allows a vCard to be embedded inside an HTML page.
It makes use of CSS class names to identify each vCard property.
Normal HTML markup and CSS styling can be used alongside the hCard class names without affecting the webpage's ability to be parsed by a hCard parser.
<html>
<head>
<link rel="profile" href="http://microformats.org/profile/hcard" />
</head>
<body>
<div class="vcard">
<img class="photo" src="http://www.example.com/dir_photos/my_photo.gif" align="left" />
<h1 class="fn">Forrest Gump</h1>
<div class="email">
<span class="type">Internet</span> Email (<span class="type">pref</span>erred):
<a class="value" href="mailto:forrestgump@example.com">forrestgump@example.com</a>
</div>
<div class="n">
First Name: <span class="given-name">Forrest</span><br>
Last Name: <span class="family-name">Gump</span>
</div> <div class="label" style="display:none">
<span class="type">home</span>
42 Plantation St.<br>Baytown, LA 30314<br>United States of America
</div>
<div class="adr">
<span class="type">Home</span> Address:<br>
<span class="street-address">42 Plantation St.</span><br>
<span class="locality">Baytown</span>, <span class="region">LA</span>
<span class="postal-code">30314</span><br>
<span class="country-name">United States of America</span>
</div>
<div class="tel">
<abbr class="type" title="voice"></abbr>
<span class="type">Home</span> Phone: <span class="value">+1-111-555-1212</span>
</div> <div>
Organization: <span class="org">Bubba Gump Shrimp Co.</span><br>
Title: <span class="title">Shrimp Man</span>
</div> <div class="label" style="display:none">
<span class="type">work</span>
100 Waters Edge<br>Baytown, LA 30314<br>United States of America
</div>
<div class="adr">
<span class="type">Work</span> Address:<br>
<span class="street-address">100 Waters Edge</span><br>
<span class="locality">Baytown</span>, <span class="region">LA</span>
<span class="postal-code">30314</span><br>
<span class="country-name">United States of America</span>
</div>
<div class="tel">
<abbr class="type" title="voice"></abbr>
<span class="type">Work</span> Phone: <span class="value">+1-404-555-1212</span>
</div> <em>vCard last updated:</em>
<time class="rev" datetime="2008-04-24T19:52:43Z">April 24, 2008 at 7:52 PM GMT</time>
</div>
</body>
</html>
Properties
vCard defines the following property types.
All vCards begin with BEGIN:VCARD
and end with END:VCARD
.
All vCards must contain the VERSION
property, which specifies the vCard version.
VERSION
must come right after BEGIN
(except in the vCard 2.1 standard, which allows it to be anywhere in the vCard).
Otherwise, properties can be defined in any order.
Name | Versions | Description | Example | ||
---|---|---|---|---|---|
2.1 | 3.0 | 4.0 | |||
ADR |
![]() |
![]() |
![]() |
A structured representation of the physical delivery address for the vCard object. | ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA |
AGENT |
![]() |
![]() |
Information about another person who will act on behalf of the vCard object. Typically this would be an area administrator, assistant, or secretary for the individual. Can be either a URL or an embedded vCard. | AGENT:http://mi5.gov.uk/007 |
|
ANNIVERSARY |
![]() |
Defines the person's anniversary. | ANNIVERSARY:19901021 |
||
BDAY |
![]() |
![]() |
![]() |
Date of birth of the individual associated with the vCard. | BDAY:19700310 |
BEGIN |
![]() |
![]() |
![]() |
All vCards must start with this property. | BEGIN:VCARD |
CALADRURI |
![]() |
A URL to use for sending a scheduling request to the person's calendar. | CALADRURI:http://example.com/calendar/jdoe |
||
CALURI |
![]() |
A URL to the person's calendar. | CALURI:http://example.com/calendar/jdoe |
||
CATEGORIES |
![]() |
![]() |
![]() |
A list of "tags" that can be used to describe the object represented by this vCard. | CATEGORIES:swimmer,biker |
CLASS |
![]() |
Describes the sensitivity of the information in the vCard. | CLASS:public |
||
CLIENTPIDMAP |
![]() |
Used for synchronizing different revisions of the same vCard. | CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b |
||
EMAIL |
![]() |
![]() |
![]() |
The address for electronic mail communication with the vCard object. | EMAIL:johndoe@hotmail.com |
END |
![]() |
![]() |
![]() |
All vCards must end with this property. | END:VCARD |
FBURL |
![]() |
Defines a URL that shows when the person is "free" or "busy" on their calendar. | FBURL:http://example.com/fb/jdoe |
||
FN |
![]() |
![]() |
![]() |
The formatted name string associated with the vCard object. | FN:Dr. John Doe |
GENDER |
![]() |
Defines the person's gender. | GENDER:F |
||
GEO |
![]() |
![]() |
![]() |
Specifies a latitude and longitude. | 2.1, 3.0: GEO:39.95;-75.1667 4.0: GEO:geo:39.95,-75.1667 |
IMPP |
![]() |
![]() |
Defines an instant messenger handle.
* This property was introduced in a separate RFC when the latest vCard version was 3.0. Therefore, 3.0 vCards may use this property, even though it's not part of the 3.0 specs. |
IMPP:aim:johndoe@aol.com |
|
KEY |
![]() |
![]() |
![]() |
The public encryption key associated with the vCard object. It may point to an external URL, may be plain text, or may be embedded in the vCard as a Base64 encoded block of text. | 2.1: KEY;PGP:http://example.com/key.pgp 2.1: KEY;PGP;ENCODING=BASE64:[base64-data] 3.0: KEY;TYPE=PGP:http://example.com/key.pgp 3.0: KEY;TYPE=PGP;ENCODING=B:[base64-data] 4.0: KEY;MEDIATYPE=application/pgp-keys:http://example.com/key.pgp 4.0: KEY:data:application/pgp-keys;base64,[base64-data] |
KIND |
![]() |
Defines the type of entity that this vCard represents: 'application', 'individual, 'group', 'location' or 'organization'; 'x-*' values may be used for experimental purposes. cf.http://tools.ietf.org/html/rfc6350#section-6.1.4, http://tools.ietf.org/html/rfc6473 ('application' value) | KIND:individual |
||
LABEL |
![]() |
![]() |
![]() |
Represents the actual text that should be put on the mailing label when delivering a physical package to the person/object associated with the vCard (related to the ADR property).
* Not supported in version 4.0. Instead, this information is stored in the |
LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA |
LANG |
![]() |
Defines a language that the person speaks. | LANG:fr-CA |
||
LOGO |
![]() |
![]() |
![]() |
An image or graphic of the logo of the organization that is associated with the individual to which the vCard belongs. It may point to an external URL or may be embedded in the vCard as a Base64 encoded block of text. | 2.1: LOGO;PNG:http://example.com/logo.png 2.1: LOGO;PNG;ENCODING=BASE64:[base64-data] 3.0: LOGO;TYPE=PNG:http://example.com/logo.png 3.0: PHOTO;TYPE=PNG;ENCODING=B:[base64-data] 4.0: LOGO;MEDIATYPE=image/png:http://example.com/logo.png 4.0: PHOTO:data:image/png;base64,[base64-data] |
MAILER |
![]() |
![]() |
Type of email program used. | MAILER:Thunderbird |
|
MEMBER |
![]() |
Defines a member that is part of the group that this vCard represents. Acceptable values include:
The |
MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af |
||
N |
![]() |
![]() |
![]() |
A structured representation of the name of the person, place or thing associated with the vCard object. | N:Doe;John;;Dr; |
NAME |
![]() |
Provides a textual representation of the SOURCE property. |
|||
NICKNAME |
![]() |
![]() |
One or more descriptive/familiar names for the object represented by this vCard. | NICKNAME:Jon,Johnny |
|
NOTE |
![]() |
![]() |
![]() |
Specifies supplemental information or a comment that is associated with the vCard. | NOTE:I am proficient in Tiger-Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword. |
ORG |
![]() |
![]() |
![]() |
The name and optionally the unit(s) of the organization associated with the vCard object. This property is based on the X.520 Organization Name attribute and the X.520 Organization Unit attribute. | ORG:Google;GMail Team;Spam Detection Squad |
PHOTO |
![]() |
![]() |
![]() |
An image or photograph of the individual associated with the vCard. It may point to an external URL or may be embedded in the vCard as a Base64 encoded block of text. | 2.1: PHOTO;JPEG:http://example.com/photo.jpg 2.1: PHOTO;JPEG;ENCODING=BASE64:[base64-data] 3.0: PHOTO;TYPE=JPEG:http://example.com/photo.jpg 3.0: PHOTO;TYPE=JPEG;ENCODING=B:[base64-data] 4.0: PHOTO;MEDIATYPE=image/jpeg:http://example.com/photo.jpg 4.0: PHOTO:data:image/jpeg;base64,[base64-data] |
PRODID |
![]() |
![]() |
The identifier for the product that created the vCard object. | PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN |
|
PROFILE |
![]() |
![]() |
States that the vCard is a vCard. | PROFILE:VCARD |
|
RELATED |
![]() |
Another entity that the person is related to. Acceptable values include:
|
RELATED;TYPE=friend:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af |
||
REV |
![]() |
![]() |
![]() |
A timestamp for the last time the vCard was updated. | REV:20121201T134211Z |
ROLE |
![]() |
![]() |
![]() |
The role, occupation, or business category of the vCard object within an organization. | ROLE:Executive |
SORT-STRING |
![]() |
![]() |
![]() |
Defines a string that should be used when an application sorts this vCard in some way.
* Not supported in version 4.0. Instead, this information is stored in the |
SORT-STRING:Doe |
SOUND |
![]() |
![]() |
![]() |
By default, if this property is not grouped with other properties it specifies the pronunciation of the FN property of the vCard object. It may point to an external URL or may be embedded in the vCard as a Base64encoded block of text. |
2.1: SOUND;OGG:http://example.com/sound.ogg 2.1: SOUND;OGG;ENCODING=BASE64:[base64-data] 3.0: SOUND;TYPE=OGG:http://example.com/sound.ogg 3.0: SOUND;TYPE=OGG;ENCODING=B:[base64-data] 4.0: SOUND;MEDIATYPE=audio/ogg:http://example.com/sound.ogg 4.0: SOUND:data:audio/ogg;base64,[base64-data] |
SOURCE |
![]() |
![]() |
![]() |
A URL that can be used to get the latest version of this vCard. | SOURCE:http://johndoe.com/vcard.vcf |
TEL |
![]() |
![]() |
![]() |
The canonical number string for a telephone number for telephony communication with the vCard object. | TEL;TYPE=cell:(123) 555-5832 |
TITLE |
![]() |
![]() |
![]() |
Specifies the job title, functional position or function of the individual associated with the vCard object within an organization. | TITLE:V.P. Research and Development |
TZ |
![]() |
![]() |
![]() |
The time zone of the vCard object. | 2.1, 3.0: TZ:-0500 4.0: TZ:America/New_York |
UID |
![]() |
![]() |
![]() |
Specifies a value that represents a persistent, globally unique identifier associated with the object. | UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b |
URL |
![]() |
![]() |
![]() |
A URL pointing to a website that represents the person in some way. | URL:http://www.johndoe.com |
VERSION |
![]() |
![]() |
![]() |
The version of the vCard specification. In versions 3.0 and 4.0, this must come right after the BEGIN property. |
VERSION:3.0 |
XML |
![]() |
Any XML data that is attached to the vCard. This is used if the vCard was encoded in XML (xCard standard) and the XML document contained elements which are not part of the xCard standard. | XML:<b>Not an xCard XML element</b> |
vCard
http://baike.baidu.com/view/495045.htm
vCard 规范容许公开交换个人数据交换 (Personal Data Interchange PDI) 信息,在传统纸质商业名片可找到这些信息。
规范定义电子名片(或叫vCard)的格式。 vCard 规范可作为各种应用或系统之间的交换格式。
定义的格式与传送的方法无关。传送交换可能是文件系统,点对点交换的公共电话网络,以有线网络或无线传送的方式。
用户能在互联网上直接利用vCard。电子邮件能转发在vCard中人信息。网页上很多用户填写的表格可自动使用vCard。
类型
标准通信薄基本格式
MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, CATEGORIES,
NOTE,PRODID, REV, SORT-STRING, SOUND, URL, UID, VERSION, CLASS, KEY
预定义的参数:ENCODING, VALUE, CHARSET, LANGUAGE, CONTEXT
标识类型
ADR 类型定义
目的:是一个组合,用来表示一个地址信息,值类型是一个用分号分开的文本值
例子:
ADR;TYPE=dom,home,postal,parcel:;;123 Main Street;Any Town;CA;91921-1234;A
电话通信地址类型
地理类型
组织类型
解释类型
Security 类型
扩展类型
44
vCard : a file format standard for electronic business cards的更多相关文章
- The Portable Executable File Format from Top to Bottom(每个结构体都非常清楚)
The Portable Executable File Format from Top to Bottom Randy KathMicrosoft Developer Network Technol ...
- VMWare File Format Learning && Use VHD File To Boot VMWare && CoreOS Docker Configuration And Running
目录 . Virtual Machine Introduce . Vmware Image File Format . VHD File Format . Convert VHD File Into ...
- JVM Specification 9th Edition (4) Chapter 4. The class File Format
Chapter 4. The class File Format Table of Contents 4.1. The ClassFile Structure 4.2. Names 4.2.1. Bi ...
- .NET Assembly File Format
https://docs.microsoft.com/en-us/dotnet/standard/assembly/file-format .NET defines a binary file for ...
- 3ds Max File Format (Part 1: The outer file format; OLE2)
The 3ds Max file format, not too much documentation to be found about it. There are some hints here ...
- could not read symbols: File format not recognized
arm-linux-gnueabi-readelf工具解决问题 编译一个32位平台的内核时,出现如下错误提示: libschw.a: could not read symbols: File form ...
- Java class file format specfication
Java class file format spec Link: https://docs.oracle.com/javase/specs/jvms/se7/html/jvms-4.html Her ...
- Does the OpenSceneGraph have a native file format?
From OpenSceneGraph-3.0 onwards we have new native file formats based on generic serializers that ar ...
- 配置tomcat连接器后,启动服务报错“No Certificate file specified or invalid file format"异常
1:原来的配置是 <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true&quo ...
随机推荐
- nginx同域名动静态分离
公司需求是如果是app加载静态页面的话要通过应用服务直接请求指定的服务 由于机房迁移 不得不将该文件迁移到一个指定的地方 需要通过nginx配置检测到是访问该静态页面的就转到该静态页面上面进行加 ...
- rpmdb: Thread/process 9180/139855524558592 failed: Thread died in Berkeley DB library
使用yum安装出现问题:rpmdb: Thread/process 9180/139855524558592 failed: Thread died in Berkeley DB library 解决 ...
- 删除/添加/调用WordPress用户个人资料的联系信息
如果你要折腾主题或者将WordPress站点开放注册,你可能需要自定义WordPress用户个人资料信息.下面倡萌将简单说一下如何删除.添加和调用自定义用户信息字段. 添加或删除字段,可以在主题的 f ...
- Java学习(API及Object类、String类、StringBuffer字符串缓冲区)
一.JAVA的API及Object类 1.API 概念: Java 的API(API: Application(应用) Programming(程序) Interface(接口)) Java API就 ...
- Codeforces Round #492 (Div. 2) [Thanks, uDebug!]
这次的题好奇怪哦... C - Tesla 思路:先把跟停车位相邻的车停进去,然后开始转圈... #include<bits/stdc++.h> #define LL long long ...
- vue-router history 模式 iis 配置
首先需要安装 url rewrite模块到IIS点我安装 然后在web.config文件中添加如下配置 <?xml version="1.0" encoding=" ...
- HTML 如何显示英文单、双引号
// 过滤英文引号替换成中文引号 function pregstring($str){ return preg_replace('/"([^"]*)/','"${1 ...
- CodeForces 803D Magazine Ad
二分. 首先把字符串处理成一个数组,二分答案,判断一下即可. #include <cstdio> #include <cmath> #include <set> # ...
- Unity 游戏开发技巧集锦之创建部分光滑部分粗糙的材质
Unity 游戏开发技巧集锦之创建部分光滑部分粗糙的材质 创建部分光滑部分粗糙的材质 生活中,有类物体的表面既有光滑的部分,又有粗糙的部分,例如丽江的石板路,如图3-17所示,石板的表面本来是粗糙的, ...
- sql 和xml
一·常用基本功能 表结果: 1. 1 <row> 2 <ID>1035</ID> 3 <Rate>6.12</Rate> 4 <Dat ...