HTTP/1.1 200 OK Date: Mon, 08 Apr 2002 23:30:49 GMT Server: Apache/1.3.20 (Unix) Last-Modified: Thu, 15 Oct 1998 15:54:00 GMT ETag: "2e97d3-5aa8-36261a98" Accept-Ranges: bytes Content-Length: 23208 Connection: close Content-Type: text/plain Network Working Group Frank Dawson, Lotus Internet Draft Paul Hoffman, IMC Expires six months after October 15, 1998 The vCard v3.0 XML DTD Status of this Memo This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months. Internet-Drafts may be updated, replaced, or made obsolete by other documents at any time. It is not appropriate to use Internet- Drafts as reference material or to cite them other than as a "working draft" or "work in progress". To view the entire list of current Internet-Drafts, please check the "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow Directories on ftp.is.co.za (Africa), ftp.nordu.net (Northern Europe), ftp.nis.garr.it (Southern Europe), munnari.oz.au (Pacific Rim), ftp.ietf.org (US East Coast), or ftp.isi.edu (US West Coast). Distribution of this document is unlimited. Copyright (C) The Internet Society 1998. All Rights Reserved. Abstract This memo defines a [XML] Document Type Definition (DTD) that corresponds to the vCard, electronic business card format defined by [VCARD]. This DTD provides equivalent functionality to the standard format defined by [VCARD]. Documents structured in accordance with this DTD may also be know as 'XML vCard' documents. The mailing list for discussion of this memo is 'ietf-vcard- xml@imc.org'. Send an email to 'ietf-vcard-xml-request@imc.org' with the message 'SUBSCRIBE' to add your email address to this mailing list. Send an email to 'ietf-vcard-xml-request@imc.org' with the message 'UNSUBSCRIBE' to remove your email address from this mailing list. The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY' and 'OPTIONAL' in this document are to be interpreted as described in [RFC 2119]. 1. Introduction The Extended Markup Language (XML) as defined in [XML] is gaining widespread attention as a "web friendly" syntax for encoding and exchanging documents and data on the Internet. This interest includes requests for and discussion of possible document type definitions Dawson, Hoffman 1 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 (DTD) for IETF standards such at the vCard, electronic business card format defined by [VCARD]. This XML DTD is in no way intended to create a separate definition for the vCard schema. The sole purpose for this memo is to define an alternative XML encoding for the format defined by [VCARD]. The vCard DTD does not introduce any capability not expressible in the format defined by [VCARD]. However, an attempt has been made to leverage the capabilities of the XML syntax to better articulate the original intent of the vCard authors. The vCard DTD promotes a number of vCard properties into attributes on the "vCard" element. This has been done to express these properties as "global attributes" for the vCard object, as a whole. For example, the VERSION, REV, PRODID, UID, CLASS properties have been "mapped" into attributes on the vCard object. Binary content in the PHOTO, LOGO, SOUND and KEY properties may either be specified through an external entity reference to the non- XML image or sound content or may be included in the content after first encoding the binary information using the BASE64 encoding of [RFC 2146]. The [VCARD] specification defines a strongly typed object format. This level of data typing is difficult to express in the XML content model since it only supports the parsable character data (i.e., PCDATA") content information. The DTD attempts to convey the vCard's strong data typing with a "value" attribute on each property element. It is the responsibility of the XML application supporting this DTD to make sure that the content information is consistent with the value type declared in the "value" attribute. It is expected that the DTD described in this memo will not normally be included with vCards that are distributed. Instead, this DTD will be externally referenced. This means that such Cards will be well- formed but not valid, as defined in [XML]. 2. vCard XML Document Type Definition The following DTD conforms to XML version 1.0, as specified by [XML]. Dawson, Hoffman 2 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 Dawson, Hoffman 3 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 Dawson, Hoffman 4 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 Dawson, Hoffman 6 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 ]> 3. vCard v3.0 Notation The formal public identifier (FPI) for the DTD described in this specification is "-//IETF//DTD vCard v3.0//EN". A XML document can reference an external non-XML entity containing a vCard v3.0 object, as specified by [VCARD]. The vCard v3.0 object, while encoded in the standard, non-XML format can be referenced in an external entity reference that identifies the [VCARD] format in a notation declaration. The [VCARD] format is identified by the formal public identifier "-//IETF//NONSGML vCard version 3.0//EN", as defined in [FPI]. 4. Example Usage 4.1 Simple vCard The following is a simple example of a XML document using this DTD. Frank Dawson Dawson Frank +1-617-693-8728 Dawson, Hoffman 8 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 +1-919-676-9515 6544 Battleford Drive Raleigh NC 27613-3502 US Frank_Dawson@Lotus.com 4.2 vCard with non-standard extension The following is an example of vCard that also includes a non- standard extension. ]> Frank Dawson Dawson Frank +1-617-693-8728 O+ 4.3 vCard with photo element The following is an example of a vCard that also includes an external reference to a photo. Similar structure would be used to represent a vCard with an external reference to a logo, sound or public key/certificate. ]> Frank Dawson Dawson, Hoffman 9 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 Dawson Frank +1-617-693-8728 Frank_Dawson@Lotus.com The following is an example of a vCard that includes a photo element as inline binary content. Frank Dawson DawsonFrank MIICajCCAdOgAwIBAgICBEUwDQ EEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bmlj YXRpb25z...and so on...IENvcnBvc== 4.4 vCard with an agent element The following is an example of a vCard that includes an agent element. The content of the agent element is another vCard. Frank Dawson Dawson Frank +1.617-693.8728 Kathie Collins Collins Kathie +1.617.693-5660 Kathie_Collins@Lotus.com Frank_Dawson@Lotus.com 4.5 XML document reference to a non-XML vCard The following is an example of a XML document with a proper reference to a non-XML entity containing a vCard object in the format defined by [VCARD]. This example shows how existing vCard objects can be Dawson, Hoffman 10 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 integrated into XML documents using the XML structure defined in this document. ]> 01234-56789 $1,000,000 5. Acknowledgments The following have participated in the drafting and discussion of this memo: Paul Hoffman 6. Security Considerations Security issues are not currently discussed in this memo. 7. Bibliography [FPI] F. Dawson and P. Hoffman, "vCard v3.0 Formal Public Identifier", Internet Draft, http://www.internic.net/internet- drafts/draft-dawson-vcard-fpi-00.txt, July 1998. [ISO9070] "Information Technology_SGML Support Facilities_ Registration Procedures for Public Text Owner Identifiers", ISO/IEC 9070, Second Edition, International Organization for Standardization, April, 1991. [RFC 2045] N. Freed, N. Borenstein, "Multipurpose Internet Mail Extensions (MIME) - Part One: Format of Internet Message Bodies", RFC 2045, November 1996. [RFC 2119] S. Bradner, "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, ftp://ftp.isi.edu/in-notes/ rfc2119.txt, March 1997. [VCARD] F. Dawson and T. Howes, "vCard MIME Directory Profile", RFC 2426, ftp://ftp.isi.edu/in-notes/rfc2426.txt, September 1998. [XML] "Extensible Markup Language (XML)", Worldwid Web Consortium, http://www.w3.org/TR/PR-xml-971208, December 1997. Dawson, Hoffman 11 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 8. Author's Address The following address information is provided in a vCard v3.0 electronic business card, format. BEGIN:VCARD VERSION:3.0 FN:Frank Dawson N:Dawson;Frank ORG:Lotus Development Corporation ADR;WORK;POSTAL;PARCEL:;;6544 Battleford Drive;Raleigh; NC;27613-3502;US TEL;PREF;WORK;MSG:+1-617-693-8728 TEL;WORK;MSG:+1-919-676-9515 EMAIL;PREF;INTERNET:Frank_Dawson@Lotus.com EMAIL;INTERNET:fdawson@earthlink.net END:VCARD BEGIN:VCARD VERSION:3.0 FN:Paul Hoffman N:Hoffman;Paul ORG:Internet Mail Consortium ADR;WORK;POSTAL;PARCEL:;;127 Segre Place;Santa Cruz; CA;95060;US TEL;PREF;WORK;MSG:+1-408-426-9827 EMAIL;INTERNET:phoffman@imc.org END:VCARD Dawson, Hoffman 12 Expires April 1999 Internet Draft vCard v3.0 XML DTD October 15, 1998 9. Full Copyright Statement "Copyright (C) The Internet Society (1998).All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implmentation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works.However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process MUST be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Dawson, Hoffman 13 Expires April 1999