% text/plain

 
  % -------------------------------------------
  %  latex generated by: booktolatex.cgi   
  %   from source file : ../htdocs/books/other/other-book.txt       
  %                  on: 19 April 2024,  2:48pm         
  %         querystring: books/other/other-book.txt  
  %       document-root: /var/www/html
  %         script-name: /cgi-bin/booktopdf.cgi
  %         Server-name: bumble.sourceforge.net
  %          Sed-script: booktolatex.sed
  % ------------------------------------------- 

  \documentclass[a4paper,12pt]{article} 
  \usepackage[margin=0.4cm,noheadfoot]{geometry} 
  \usepackage{color}                   %% to use colours, use "xcolor" for more
  \usepackage{multicol}                %% for multiple columns 
  \usepackage{keystroke}               %% for keyboard key images 
  \usepackage[toc]{multitoc}           %% for multi column table of contents
  \usepackage{tocloft}                 %% to customize the table of contents
  \setcounter{tocdepth}{2}             %% only display 2 levels in the contents
  \setlength{\cftbeforesecskip}{0cm}   %% make the toc more compact
  \usepackage{listings}                %% for nice code listings
  %\lstset{language={},
  \lstset{language=,                 
    %% define special comment delimiters '##(' and ')' 
    moredelim=[s][\color{grey}\itshape\footnotesize\ttfamily]{~(}{)},
    basicstyle=\ttfamily,           %% fixed pitch font
    xleftmargin=1cm,                %% margin on the left outside the frames
    breaklines=true,                %% break long code lines
    breakatwhitespace=false,        %% break long code lines anywhere
    breakindent=10pt,               %% reduce the indent from 20pt to 10
    postbreak=\mbox{{\color{blue}\small$\Rightarrow$\space}},  %% mark with arrow
    showstringspaces=false,            %% dont show spaces within strings 
    framerule=5pt,                     %% thickness of the frames
    rulecolor=\color{lightgrey}, frame=l}   %% source code settings
  \usepackage{graphicx}                %% to include images
  \usepackage{fancybox}                %% boxes with rounded corners 
  \usepackage{wrapfig}                 %% flow text around tables, images 
  \usepackage{tabularx}                %% change width of tables 
  \usepackage[table]{xcolor}           %% alternate row colour tables
  \usepackage{booktabs}                %% for heavier rules in tables 
  \usepackage[small,compact]{titlesec} %% sections more compact, less space
  \usepackage{enumitem}                %% more compact and better lists 
  \setlist{noitemsep}                  %% reduce list item spacing 
  \usepackage{hyperref}     %% make urls into hyperlinks
  \hypersetup{              %% add "pdftex," if only pdf output is required
     colorlinks=true,       %% set up the colours for the hyperlinks 
     linkcolor=black,       %% internal document links black 
     urlcolor=black,        %% url links black 
     filecolor=red,       
     citecolor=red, 
     bookmarks=true, pdfpagemode=UseOutlines} 

  % define some colours to use
  \definecolor{lightgrey}{gray}{0.70}
  \definecolor{grey}{gray}{0.30}

  \titleformat{\section}[frame]    %% titlesec: create framed section headings
     {\normalfont} 
     {\filleft \footnotesize \enspace Section \thesection\enspace\enspace} 
     {3pt} {\bfseries\itshape\filright} 
     
  \title{} 
  \author{}
  \date{27 October 2011,  6:33pm} 
  \setlength{\parindent}{0pt}
  % \setlength{\parskip}{1ex}

  % label lists with stars
  \renewcommand{\labelitemi}{$\star$}

  \begin{document} 

  \centerline{\Large \bf } \medskip
  \begin{center}
    {\huge ``}\textit{}{\huge ''}
    \textsc{}
  \end{center}
  % -----------------------------------
  % the toc should be 2 columns because of the \multitoc package 
  \tableofcontents


  The other book



\section{Vcard}

 Vcard is used for storing contact information for people and 
 organisations. It is a format recognised by many email and chat
 software programs.

 It may seem odd that this section is so detailed, but I have been
 searching for a good 'contacts' data format, and this seems the
 best I can find. At least its not xml.

 Vcard is specified in the 'request for comments' RFC 2425 and RFC 2426

\begin{description}[labelindent=1cm, leftmargin=2cm, style=nextline]
 \item[\url{http://www.rfc-ref.org/RFC-TEXTS/2426/}]
    the vcard rfc
 \item[\url{http://www.rfc-ref.org/RFC-TEXTS/2426/chapter3.html\#sub1sub1}]
    definitions and examples for the the vcard types.
\end{description}

\subsection{Vcard Implementation Quirks}

 The fastmail.fm import allows lower case names, but no
 spaces before any of the element names.

 Skype vcard import function apparently doesnt import phone numbers (!)
 which is something of a pity.


  \arrayrulecolor{gray}
  \begin{center}
  \begin{tabular}{ |rl| }
    \multicolumn{2}{c}{\textbf{ Debian-style packages for vcard }} \\
  \hline

 \texttt{ 2vcard } & Convert address book to vcard format \\ 

 \texttt{ glabels } & \\ 

 \texttt{ vcard4j } & A java library (but not a user application) \\ 

    \hline
    \end{tabular}
    \end{center}
\subsection{Attribute Lists}


  \arrayrulecolor{gray}
  \begin{center}
  \begin{tabular}{ |rl| }
    \multicolumn{2}{c}{\textbf{ vcard attribute names and purpose }} \\
  \hline

 \texttt{ N } & The name of the person or company (structured) eg: 'N:Small;Frank' \\ 

 \texttt{ FN } & The formatted (display) name of the person or entity eg 'FN:Frank Small' \\ 

 \texttt{ PHOTO } & An image or photograph of the person or entity \\ 

 \texttt{ BDAY } & Date of birth \\ 

 \texttt{ ADR } & A postal address in a structured format  \\ 

 \texttt{ LABEL } & A displayable postal address  \\ 

 \texttt{ TEL } & A telephone number eg 'TEL;TYPE=WORK,VOICE:(111) 555-1212' \\ 

 \texttt{ EMAIL } & An email address eg 'EMAIL;TYPE=PREF,INTERNET:forrestgump@example.com' \\ 

 \texttt{ MAILER } & The type of email program used \\ 

 \texttt{ TZ } & The standard time zone of the entity \\ 

 \texttt{ GEO } & A geographical latitude and longitude \\ 

 \texttt{ TITLE } & Job title,  \\ 

 \texttt{ ROLE } & Job role (eg 'executive)  \\ 

 \texttt{ LOGO } & A company or personal logo image, can be a url or mime data \\ 

 \texttt{ AGENT } & A person who will act on behalf vcard person or entity. (eg secretary) \\ 

 \texttt{ ORG } & Organization Name or Organizational unit, X.520 Organization Name/Unit \\ 

 \texttt{ NOTE } & Supplementary information or a comment  \\ 

 \texttt{ REV } & Time and date of last revision of the vcard eg 'REV:20080424T195243Z' \\ 

 \texttt{ SOUND } & Sound of the pronunciation of the formatted name  \\ 

 \texttt{ URL } & A url to obtain realtime information about the person/entity  \\ 

 \texttt{ UID } & A globally unique identifier for the person/entity (?) \\ 

 \texttt{ VERSION } & The version of the vCard Specification \\ 

 \texttt{ KEY } & The public encryption key associated with the vCard object \\ 

    \hline
    \end{tabular}
    \end{center}

  \arrayrulecolor{gray}
  \begin{center}
  \begin{tabular}{ |rl| }
    \multicolumn{2}{c}{\textbf{ vcard attribute extensions }} \\
  \hline

 \texttt{ X-ABUID } & String, Apple Address Book UUID for that entry \\ 

 \texttt{ X-ANNIVERSARY } & YYYY-MM-DD, additional anniversaries (see BDAY) \\ 

 \texttt{ X-ASSISTANT } & A string, assistant name (instead of Agent) \\ 

 \texttt{ X-MANAGER } & A managers name (text) \\ 

 \texttt{ X-SPOUSE } & Spouse name (text) \\ 

 \texttt{ X-GENDER } & Either ``Male'' or ``Female'' only \\ 

 \texttt{ X-AIM } & Instant Messaging (IM) contact information; TYPE parameter as for TEL  \\ 

 \texttt{ X-ICQ } & IM contact information;  \\ 

 \texttt{ X-JABBER } & IM contact information; \\ 

 \texttt{ X-MSN } & IM contact information;  \\ 

 \texttt{ X-YAHOO } & IM contact information; \\ 

 \texttt{ X-SKYPE } & IM contact information; \\ 

 \texttt{ X-GADUGADU } & IM contact information; \\ 

 \texttt{ X-GROUPWISE } & IM contact information; \\ 

 \texttt{ X-MS-IMADDRESS } & Property, string, " (IM address in VCF attachment from Outlook (right click Contact, Send Full Contact, Internet Format.) \\ 

 \texttt{ X-MS-CARDPICTURE } & Works like PHOTO or LOGO. an outlook image of the Card  \\ 

 \texttt{ X-PHONETIC-FIRST-NAME } & \\ 

 \texttt{ X-PHONETIC-LAST-NAME } & Roman spelling of name, eg Japanese names  \\ 

 \texttt{ X-MOZILLA-HTML } & Property, TRUE/FALSE, mail recipient wants HTML email \\ 

    \hline
    \end{tabular}
    \end{center}
\emph{ Difference between vcard 2.1 and 3.0` }
\begin{lstlisting}
  EMAIL;TYPE=INTERNET;TYPE=PREF   ~(3.0)
\end{lstlisting}
\begin{lstlisting}
  EMAIL;TYPE=internet,pref        ~(3.0)
\end{lstlisting}
\begin{lstlisting}
  EMAIL;INTERNET;PREF             ~(2.1)
\end{lstlisting}

\emph{ The most minimul vcard example (all these elements are obligatory) }
 \begin{lstlisting}
 BEGIN:VCARD
 VERSION:3.0
 N:Bond;James
 FN:James Bond
 END:VCARD
 \end{lstlisting}

\emph{ Vcard version 3.0 example (note the 'TYPE=work,voice' etc syntax }
 \begin{lstlisting}
   BEGIN:VCARD
   VERSION:3.0
   N:Clark;James
   FN:James Clark
   ORG:Bubba Gump Shrimp Co.
   TITLE:Mr
   TEL;TYPE=work,voice:(111) 555-1212
   TEL;TYPE=home,voice:(404) 555-1212
   ADR;TYPE=work:;;100 Waters Edge;Baytown;LA;30314;United States of America
   LABEL;TYPE=WORK:100 Waters Edge\nBaytown, LA 30314\nUnited States of America
   ADR;TYPE=HOME:;;42 Plantation St.;Baytown;LA;30314;United States of America
   LABEL;TYPE=HOME:42 Plantation St.\nBaytown, LA 30314\nUnited States of America
   EMAIL;TYPE=PREF,INTERNET:forrestgump@example.com
   REV:20080424T195243Z
   END:VCARD
 \end{lstlisting}

\emph{ Vcard data exported from 'fastmail.fm' email }
 \begin{lstlisting}
   BEGIN:VCARD
   VERSION:2.1
   FN:amy and ben
   N:ben;amy and;;
   NICKNAME:amyandben
   EMAIL;INTERNET;PREF:alpountain@yahoo.co.uk
   ADR;HOME;ENCODING=QUOTED-PRINTABLE:;the stalls, moreton lane=0D;draycott in the clay;ashbourne;derbyshire;;uk
   END:VCARD
 \end{lstlisting}

\subsection{Vcard Name Types}

\emph{ Vcard comments  }
\begin{lstlisting}
  ;
\end{lstlisting}

\emph{ The formatted or 'display' name for a person or entity }
\begin{lstlisting}
  FN:Mr. John Q. Public\, Esq.
\end{lstlisting}

\emph{ The 'N' name element is made up of }
\begin{lstlisting}
  Family Name, Given Name, Additional Names, Honorific Prefix, Honorific Suffix.
\end{lstlisting}

\emph{ Structured name examples }
\begin{lstlisting}
  N:Public;John;Quinlan;Mr.;Esq.
\end{lstlisting}
\begin{lstlisting}
  N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.
\end{lstlisting}

\emph{ Photos }
\begin{lstlisting}
  PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif
\end{lstlisting}
\begin{lstlisting}
  PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN...etc
\end{lstlisting}
  
\emph{ Birthdays }
\begin{lstlisting}
  BDAY:1996-04-15
\end{lstlisting}
\begin{lstlisting}
  BDAY:1953-10-15T23:10:00Z
\end{lstlisting}
\begin{lstlisting}
  BDAY:1987-09-27T08:30:00-06:00
\end{lstlisting}


  \arrayrulecolor{gray}
  \begin{center}
  \begin{tabular}{ |rl| }
    \multicolumn{2}{c}{\textbf{ telephone 'TYPE' values }} \\
  \hline

  \texttt{ work } & \\ 

  \texttt{ home } & A residence not work \\ 

  \texttt{ pref } & The preferred phone (if there is more than one) \\ 

  \texttt{ voice } & A normal phone (not a fax) \\ 

  \texttt{ fax } & A fax phone \\ 

  \texttt{ cell } & A cell phone (a mobile phone) \\ 

  \texttt{ video } & A phone with video capability \\ 

  \texttt{ modem } & \\ 

  \texttt{ bbs } & A bulletin board  \\ 

  \texttt{ car } & A carphone \\ 

    \hline
    \end{tabular}
    \end{center}
\emph{ Mark up the prefered work telephone (as opposed to a fax) with voice mail  }
\begin{lstlisting}
  TEL;TYPE=work,voice,pref,msg:+1-213-555-1234
\end{lstlisting}
  
\emph{ A home fax line  }
\begin{lstlisting}
  TEL;TYPE=home,fax,pref:+1-213-555-1234
\end{lstlisting}

\emph{ An x400 style email address, whatever that is }
\begin{lstlisting}
  EMAIL;TYPE=x400:jdoe@isp.net
\end{lstlisting}

\emph{ A preferred email address () }
\begin{lstlisting}
  EMAIL;TYPE=internet,pref:jane_doe@abc.com
\end{lstlisting}

\emph{ Postal addresses }
  \begin{lstlisting}

  == address types
  .. intl - an address outside the current country
  .. dom - an address within the current country
  .. postal - a postal address (?)
  .. parcel - a parcel postal address
  .. work - a work postal address
  .. pref - the preferred postal address (where there is more than one)
  ..

  po box, flat number, house number and street name, the locality (e.g., city);
  the region (e.g., state or province); the postal code; the country name. 
  ADR;TYPE=postal,pref:;;123 Main Street;SomeTown;NSW;2028;Australia  ##(the same)
  \end{lstlisting}

\emph{ A postal address example }
\begin{lstlisting}
  ADR;TYPE=postal;TYPE=pref:;;123 Main Street;Katoomba;NSW;2028;Australia
\end{lstlisting}

\emph{ A gpo box in hobart australia }
\begin{lstlisting}
  ADR;TYPE=postal:gpo 1990;;;Hobart;TAS;7001;Australia
\end{lstlisting}

\emph{ The 'label' which is the displayed postal address }
  \begin{lstlisting}
     LABEL;TYPE=dom,home,postal,parcel:Mr.John Q. Public\, Esq.\n
        Mail Drop: TNE QB\n123 Main Street\nAny Town\, CA  91921-1234 \nU.S.A.
 \end{lstlisting}

\emph{ Indicate a company or personal logo image (a url location of the image file) }
\begin{lstlisting}
  LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg
\end{lstlisting}

\emph{ Inline mime encoding of an logo image }
\begin{lstlisting}
  LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJK ... etc
\end{lstlisting}

\emph{ The entity organisation name (company, branch, division) }
\begin{lstlisting}
  ORG:ABC\, Inc.;North American Division;Marketing
\end{lstlisting}

\emph{ Additional notes }
\begin{lstlisting}
  NOTE: this number is available 24/7
\end{lstlisting}

\emph{ Indicate when the information in the vcard was revised }
\begin{lstlisting}
  REV:1995-10-31T22:27:10Z
\end{lstlisting}
\begin{lstlisting}
  REV:1997-11-15
\end{lstlisting}

\subsection{Vcard Geographical Information}

\emph{ The timezone element indicates in what time zone the entity resides }
\begin{lstlisting}
  TZ:-05:00
\end{lstlisting}
\begin{lstlisting}
  TZ;VALUE=text:-05:00; EST; Raleigh/North America
\end{lstlisting}

\emph{ The geographical position of the entity in decimial longitude vs latitude }
\begin{lstlisting}
  GEO:37.386013;-122.082932
\end{lstlisting}

\subsection{Job Title Elements}

\emph{ The vcard job title element (based on X.520 'title' element) }
\begin{lstlisting}
  TITLE:Director\, Research and Development
\end{lstlisting}

\emph{ The role of the person within an organisation }
\begin{lstlisting}
  ROLE:Programmer
\end{lstlisting}



   \end{document}
