added italian docs. thanks to Gianluca Gillini

docs/it/programmers/api-functions/api-display.xml

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision$ -->
+<refentry id="api.display">
+ <refnamediv>
+  <refname>display</refname>
+  <refpurpose></refpurpose>
+ </refnamediv>
+ <refsect1>
+  <title />
+  <methodsynopsis>
+   <type>void</type><methodname>display</methodname>
+   <methodparam><type>string</type><parameter>template</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Visualizza il template. Dovete fornire un tipo e percorso
+   corretti per la <link linkend="template.resources">risorsa del template</link>.
+   Come secondo parametro opzionale potete passare una cache id.
+   Consultate la <link linkend="caching">sezione sul caching</link> per
+   maggiori informazioni.
+  </para>
+  &parameter.compileid;
+  <example>
+   <title>display</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+include("Smarty.class.php");
+$smarty = new Smarty;
+$smarty->caching = true;
+
+// faccio le chiamate al db solo se
+// non esiste la cache
+if(!$smarty->is_cached("index.tpl")) {
+
+  // dummy up some data
+  $address = "245 N 50th";
+  $db_data = array(
+               "City" => "Lincoln",
+               "State" => "Nebraska",
+               "Zip" => "68502"
+             );
+
+  $smarty->assign("Name","Fred");
+  $smarty->assign("Address",$address);
+  $smarty->assign($db_data);
+
+}
+
+// visualizzo l'output
+$smarty->display("index.tpl");
+?>
+]]>
+   </programlisting>
+  </example>
+  <para>
+   Usate la sintassi delle <link
+   linkend="template.resources">risorse dei template</link>
+   per visualizzare file che si trovano al di fuori della
+   directory $template_dir.
+  </para>
+  <example>
+   <title>esempi di visualizzazione di risorse di template</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// percorso assoluto
+$smarty->display("/usr/local/include/templates/header.tpl");
+
+// percorso assoluto (equivale al precedente)
+$smarty->display("file:/usr/local/include/templates/header.tpl");
+
+// percorso assoluto windows (OBBLIGATORIO il prefisso "file:")
+$smarty->display("file:C:/www/pub/templates/header.tpl");
+
+// inclusione dalla risorsa di template di nome "db"
+$smarty->display("db:header.tpl");
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->