56 lines
8.4 KiB
HTML
56 lines
8.4 KiB
HTML
|
<html><head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||
|
|
<title>address</title><link rel="stylesheet" href="manual.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.57.0"><link rel="home" href="index.html" title="XML Résumé Library User Guide"><link rel="up" href="elementref.html" title="Element Reference"><link rel="previous" href="element.achievements.html" title="achievements"><link rel="next" href="element.annotation.html" title="annotation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1 class="pageTitle"><a href="../../index.html"><span style="color: red;">XML</span><span style="font-weight: bold;">Résumé</span><span style="color: red;">Library</span></a>:
|
||
|
|
<a href="index.html">User Guide</a></h1><div class="navheader"><table width="100%" summary="Navigation header"><tr><td align="left" width="33%"><a accesskey="p" href="element.achievements.html"><img src="caret-l.gif" width="11" height="7" border="0" alt="Previous">achievements</a> </td><td align="center" width="34%"><a accesskey="u" href="elementref.html"><img src="caret-u.gif" width="11" height="7" border="0" alt="Up">Element Reference</a></td><td align="right" width="33%"> <a accesskey="n" href="element.annotation.html">annotation<img src="caret-r.gif" width="11" height="7" border="0" alt="Next"></a></td></tr></table></div><div class="refentry" lang="en"><a name="element.address"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>address — A postal address</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="refsect2" lang="en"><h3>Content Model</h3><pre class="synopsis">(#PCDATA|<a href="element.street.html" title="street">street</a>|<a href="element.street2.html" title="street2">street2</a>|<a href="element.suburb.html" title="suburb">suburb</a>|<a href="element.ward.html" title="ward">ward</a>|<a href="element.city.html" title="city">city</a>|<a href="element.state.html" title="state">state</a>|<a href="element.province.html" title="province">province</a>|<a href="element.county.html" title="county">county</a>|<a href="element.prefecture.html" title="prefecture">prefecture</a>|<a href="element.zip.html" title="zip">zip</a>|<a href="element.postalCode.html" title="postalCode">postalCode</a>|<a href="element.country.html" title="country">country</a>|<a href="element.break.html" title="break">break</a>)*</pre></div><div class="refsect2" lang="en"><h3>Attributes</h3><div class="informaltable"><table width="100%" border="1"><colgroup><col align="left"><col align="left"><col align="left"></colgroup><thead><tr valign="top"><th align="left" valign="top">Name</th><th align="left" valign="top">Type</th><th align="left" valign="top">Default</th></tr></thead><tbody><tr valign="top"><td align="left" valign="top">format</td><td align="left" valign="top"><p>Enumeration:</p><table class="simplelist" border="0" summary="Simple list"><tr><td><tt class="sgmltag-attvalue">standard</tt></td></tr><tr><td><tt class="sgmltag-attvalue">european</tt></td></tr><tr><td><tt class="sgmltag-attvalue">italian</tt></td></tr></table></td><td align="left" valign="top"><span class="emphasis"><em>None</em></span></td></tr><tr valign="top"><td align="left" valign="top">id</td><td align="left" valign="top">ID</td><td align="left" valign="top"><span class="emphasis"><em>None</em></span></td></tr><tr valign="top"><td align="left" valign="top">targets</td><td align="left" valign="top">CDATA</td><td align="left" valign="top"><span class="emphasis"><em>None</em></span></td></tr></tbody></table></div></div></div><div class="refsect1" lang="en"><h2>Description</h2><p>
|
||
|
|
The <tt class="sgmltag-element">address</tt> element defines a single
|
||
|
|
postal address. It does <span class="bold"><b>not</b></span> contain
|
||
|
|
information about a person who resides at the address.
|
||
|
|
</p><p>
|
||
|
|
Different countries have different address formatting conventions.
|
||
|
|
Address formatting is controlled by the <a href="param.address.format.html" title="address.format"><i><tt>address.format</tt></i></a>
|
||
|
|
parameter.
|
||
|
|
</p><p>
|
||
|
|
If an address cannot be specified using <tt class="sgmltag-element">address</tt>'s child elements (<tt class="sgmltag-element">street</tt>, <tt class="sgmltag-element">city</tt>, etc.), it may be specified in untagged
|
||
|
|
format. In this case, the address will be formatted verbatim, with line
|
||
|
|
breaks preserved.
|
||
|
|
</p><div class="refsect2" lang="en"><h3>Parents</h3><p>
|
||
|
|
<tt class="sgmltag-element">address</tt> may be contained in these
|
||
|
|
elements:
|
||
|
|
<span class="simplelist"><a href="element.header.html" title="header"><tt class="sgmltag-element">header</tt></a>, <a href="element.referee.html" title="referee"><tt class="sgmltag-element">referee</tt></a></span>
|
||
|
|
</p></div><div class="refsect2" lang="en"><h3>Attributes</h3><div class="variablelist"><dl><dt><span class="term"><tt class="sgmltag-attribute">id</tt></span></dt><dd><p>
|
||
|
|
A string used to uniquely identify an address. The address may
|
||
|
|
then be referred to by this identifier.
|
||
|
|
</p></dd><dt><span class="term"><tt class="sgmltag-attribute">format</tt></span></dt><dd><p>
|
||
|
|
The address format. This attribute specifies the format of an
|
||
|
|
address, and overrides the global <a href="param.address.format.html" title="address.format"><i><tt>address.format</tt></i></a>
|
||
|
|
parameter for each address that it appears in.
|
||
|
|
</p></dd></dl></div></div></div><div class="refsect1" lang="en"><h2>See Also</h2><p>
|
||
|
|
<span class="simplelist"><a href="param.address.format.html" title="address.format"><i><tt>address.format</tt></i></a></span>.
|
||
|
|
</p></div><div class="refsect1" lang="en"><h2>Examples</h2><div class="example"><a name="d0e1559"></a><p class="title"><b>Example 1. U.S.-style address</b></p><pre class="programlisting"><address>
|
||
|
|
<street>123 Pickle St.</street>
|
||
|
|
<street>Apt. #12</street>
|
||
|
|
<city>Sourville</city>
|
||
|
|
<state>NX</state>
|
||
|
|
<zip>99999-9999</zip>
|
||
|
|
</address></pre><p>Formatted as:</p><div class="literallayout"><p><tt>123 Pickle St. Apt. #12<br>
|
||
|
|
Sourville, NX 99999-9999</tt></p></div></div><div class="example"><a name="d0e1570"></a><p class="title"><b>Example 2. Italian address</b></p><pre class="programlisting"><address>
|
||
|
|
<street>Via Garibaldi, 23</street>
|
||
|
|
<city>Sorrento</city>
|
||
|
|
<postalCode>123 456</postalCode>
|
||
|
|
<province>NA</province>
|
||
|
|
<country>Italy</country>
|
||
|
|
</address></pre></div><div class="example"><a name="d0e1576"></a><p class="title"><b>Example 3. Untagged address</b></p><pre class="programlisting"><address>Reina #35, apt. 4a, e/ Gervasio y Escobar
|
||
|
|
Ciudad de La Habana, CP 11900
|
||
|
|
CUBA</address></pre><p>Formatted as:</p><div class="literallayout"><p><tt>Reina #35, apt. 4a, e/ Gervasio y Escobar<br>
|
||
|
|
Ciudad de La Habana, CP 11900<br>
|
||
|
|
CUBA</tt></p></div><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
|
||
|
|
You may have noticed that the XML for this address isn't indented as
|
||
|
|
usual. This is because untagged addresses are formatted verbatim,
|
||
|
|
and so any indentation would be preserved in the formatted address.
|
||
|
|
The address text begins on the same line as the start tag for the
|
||
|
|
same reason (we don't want a leading linebreak in the formatted
|
||
|
|
address).
|
||
|
|
</p></div></div><p>
|
||
|
|
For additional address examples, look at the XML files in the <tt>examples/addressing</tt> directory of the
|
||
|
|
XML Résumé Library distribution.
|
||
|
|
</p></div></div><div class="navheader"><table width="100%" summary="Navigation header"><tr><td align="left" width="33%"><a accesskey="p" href="element.achievements.html"><img src="caret-l.gif" width="11" height="7" border="0" alt="Previous">achievements</a> </td><td align="center" width="34%"><a accesskey="u" href="elementref.html"><img src="caret-u.gif" width="11" height="7" border="0" alt="Up">Element Reference</a></td><td align="right" width="33%"> <a accesskey="n" href="element.annotation.html">annotation<img src="caret-r.gif" width="11" height="7" border="0" alt="Next"></a></td></tr></table></div></body></html>
|