Network Working Group Frank Dawson, Lotus Internet Draft Paul Hoffman, IMC Dawson, Hoffman 3 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Dawson, Hoffman 5 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Dawson, Hoffman 6 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Dawson, Hoffman 7 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Dawson, Hoffman 8 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Dawson, Hoffman 9 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Dawson, Hoffman 10 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 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 +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. Dawson, Hoffman 11 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 ]> 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 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== Dawson, Hoffman 12 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 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 Document with multiple vCards The following is an example of a vCard document that includes more than one vCard. John Smith Smith John jsmith@host.com Fred Stone Stone Fred fstone@host1.com 4.6 Document utilizing vCard namespace The following is an example of a XML document that declares the vCard namespace as it's default namespace. Dawson, Hoffman 13 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Frank Dawson Dawson Frank fdawson@host1.com The following is an example of a XML document that includes elements from the vCard namespace. John Smith +1-919-555-1234 1234567 999.99 4.7 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 integrated into XML documents using the XML structure defined in this document. ]> 01234-56789 $1,000,000 5. Namespace [NSPACE] defines "XML namespaces" to be a collection of names, identified by a URI, which are used in XML documents as element types and attribute names. XML namespaces allow multiple markup vocabulary in a single document. Considering the utility of the vCard properties Dawson, Hoffman 14 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 in other applications, it is important for the vCard XML DTD to define a namespace for the vCard element types. This memo includes the definition of both a qualified name for the vCard namespace and also a default namespace. The namespace declaration is specified by attributes on the "vCard" element. The default namespace is specified with the "xmlns" attribute and the qualified name for the vCard namespace is specified with the "xmlns:vcf" attribute. The default namespace attribute is useful in XML documents that are based on the vCard document types. The qualified name for the vCard namespace is useful in XML documents that partially consist of vCard elements types but also consist of element types from other schemas. The following is an example of the a vCard namespace declaration using the qualified namespace: The following is an example of a vCard namespace declaration using the default namespace: 6. Acknowledgments The following have participated in the drafting and discussion of this memo: Scott Boag, Dean Burton, Charles Goldfarb, Alex Hoppman, Sean McGrath, Noah Mendelsohn, Thomas Rowe 7. Security Considerations Security issues are not currently discussed in this memo. Dawson, Hoffman 15 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 8. 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. [NSPACE] T. Bray, D. Hollander, A. Layman, "Namespaces in XML", WD- xml-names-19980916, http://www.w3.org/TR/1998/WD-xml-names-19980916, Septebmer 1998. [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. 9. Author's Address The following address information is provided in a vCard XML DTD electronic business card, format. Frank Dawson Dawson Frank Lotus Development Corporation 6544 Battleford Drive Raleigh NC 27613-3502 +1-617-693-8728 +1-919-676-9515 Frank_Dawson@Lotus.com fdawson@earthlink.net Dawson, Hoffman 16 Expires May 1999 Internet Draft vCard v3.0 XML DTD November 15, 1998 Paul Hoffman Hoffman Paul Internet Mail Consortium 127 Segre Place Santa Cruz CA 95060 US +1-408-426-9827 phoffman@imc.org 10. 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 17 Expires May 1999