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 ...
随机推荐
- Vim的分屏功能
本篇文章主要教你如何使用 Vim 分屏功能. 分屏启动Vim 使用大写的O参数来垂直分屏. vim -On file1 file2 ... 使用小写的o参数来水平分屏. vim -on file1 f ...
- Ubuntu连接多台Ubuntu server的问题
如果您用的是虚拟机上安装的几个Ubuntu server进行IP配置 要注意以下几点: <1>虚拟机上安装完成Ubuntu server 默认的网络连接方式是NAT ,应该改成桥接网卡 ( ...
- 配置Tomcat、maven远程部署调试总结。
注意:可以搞两个环境,一个本地tomcat 一个服务器上的tomcat ,然后都采用如下配置.这样就可以 在本地调试,调试好后,再发布到服务器端.非常方便. ==================== ...
- git用法大全
转载自实验楼,之前有更新过两篇git的文章,毕竟内容太少,而git还有很多更丰富的技能,在实验楼上有一系列全的教程,这里做一下备案.需要时查阅. Git 实战教程 目录 一.实验说明 二.git的初始 ...
- git与pycharm合并,珠联璧合
前段时间提交代码都是各种手写push push push,好蠢,今天尝试了一下ide直接提交,爽的一匹,做个总结. 首先github帐号肯定要有. 看图,设置好帐号啥的 再设置git路径,这个应该自动 ...
- 关闭webstorm自动保存,并显示文件未保存标识
1.取消自动保存 2.显示编辑状态设置:
- NHibernate示例
1. 下载相关资源: 下载NHibernate.下载地址: http://nhforge.org/Default.aspx 下载微软Northwind示例数据库,下载地址:http://www.mic ...
- JAVA编程思想读书笔记(五)--多线程
接上篇JAVA编程思想读书笔记(四)--对象的克隆 No1: daemon Thread(守护线程) 参考http://blog.csdn.net/pony_maggie/article/detail ...
- 湖南大学ACM程序设计新生杯大赛(同步赛)J - Piglet treasure hunt Series 2
题目描述 Once there was a pig, which was very fond of treasure hunting. One day, when it woke up, it fou ...
- 洛谷P3402 【模板】可持久化并查集 [主席树,并查集]
题目传送门 可持久化并查集 n个集合 m个操作 操作: 1 a b 合并a,b所在集合 2 k 回到第k次操作之后的状态(查询算作操作) 3 a b 询问a,b是否属于同一集合,是则输出1否则输出0 ...