sync with en

This commit is contained in:
messju
2005-10-10 15:41:31 +00:00
parent ff428d79c0
commit 70353bb9cc

View File

@@ -1,8 +1,16 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: andreas Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: andreas Status: ready -->
<sect1 id="language.function.html.image">
<title>html_image (Ausgabe von HTML-IMG Tag)</title>
<para>
{html_image} ist eine <link
linkend="language.custom.functions">eigene Funktion</link> die ein
HTML Tag f<>r ein Bild erzeugt. Die H<>he und Breite der Ausgabe wird
automatisch aus der Bilddatei berechnet wenn die Werte nicht
<20>bergeben werden.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -30,90 +38,93 @@
<row>
<entry>height</entry>
<entry>string</entry>
<entry>No</entry>
<entry><emphasis>Normale H&ouml;he des Bildes</emphasis></entry>
<entry>H&ouml;he des Bildes</entry>
<entry>Nein</entry>
<entry><emphasis>Normale H<EFBFBD>he des Bildes</emphasis></entry>
<entry>H<EFBFBD>he des Bildes</entry>
</row>
<row>
<entry>width</entry>
<entry>string</entry>
<entry>No</entry>
<entry>Nein</entry>
<entry><emphasis>Normale Breite des Bildes</emphasis></entry>
<entry>Breite des Bildes</entry>
</row>
<row>
<entry>basedir</entry>
<entry>string</entry>
<entry>no</entry>
<entry><emphasis>DOCUMENTROOT</emphasis></entry>
<entry>Basisverzeichnis f&uuml;r relative Pfadangaben</entry>
<entry>Nein</entry>
<entry><emphasis>DOCUMENT_ROOT</emphasis></entry>
<entry>Basisverzeichnis f<EFBFBD>r relative Pfadangaben</entry>
</row>
<row>
<entry>alt</entry>
<entry>string</entry>
<entry>no</entry>
<entry>Nein</entry>
<entry><emphasis>""</emphasis></entry>
<entry>Alternative Beschreibung des Bildes</entry>
</row>
<row>
<entry>href</entry>
<entry>string</entry>
<entry>no</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Link f&uuml;r das Bild</entry>
<entry>Link f<EFBFBD>r das Bild</entry>
</row>
<row>
<entry>path_prefix</entry>
<entry>string</entry>
<entry>Nein</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Pr<EFBFBD>fix f<>r den Pfad zum Bild</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
html_image ist eine eigene Funktion die ein HTML Tag f&uuml;r ein Bild erzeugt.
Die H&ouml;he und Breite der Ausgabe wird automatisch aus der Bilddatei berechnet
wenn die Werte nicht &uuml;bergeben werden.
basedir ist der Basispfad der f<>r die Verlinkung verwendet werden
soll. Wenn kein Wert <20>bergeben wird, wird die <link
linkend="language.variables.smarty">Umgebungsvariable</link>
DOCUMENT_ROOT verwendet. Wenn <link
linkend="variable.security">Sicherheit</link> eingeschaltet ist,
muss das Bild in einem sicheren Verzeichnis liegen.
</para>
<para>
basedir ist der Basispfad der f&uuml;r die Verlinkung verwendet werden soll. Wenn kein
Wert &uuml;bergeben wird, wird die Umgebungsvariable DOCUMENT_ROOT verwendet. Wenn Sicherheit
eingeschaltet ist, muss das Bild in einem sicheren Verzeichnis liegen.
<parameter>href</parameter> ist das href Attribut f<>r das
Image-Tag. Wenn dieser Wert <20>bergeben wird, wird um das Bild ein
&lt;a href="LINKVALUE"&gt;&lt;a&gt; Tag erzeugt.
</para>
<para>
<parameter>href</parameter> ist das href Attribut f&uuml;r das Image-Tag. Wenn dieser Wert &uuml;bergeben wird,
wird um das Bild ein &lt;a href="LINKVALUE"&gt;&lt;a&gt; Tag erzeugt.
<parameter>path_prefix</parameter> ist ein optionaler Pr<50>fix der dem
Bildpfad vorangestellt wird. Die ist n<>tzlich wenn zum Beispiel f<>r
den Bildpfad ein anderer Servername verwendet werden soll.
</para>
<para>
Alle weiteren Parameter werden als Name/Wert Paare (Attribute) im &lt;img&gt;-Tag ausgegeben.
Alle weiteren Parameter werden als Name/Wert Paare (Attribute) im
&lt;img&gt;-Tag ausgegeben.
</para>
<note>
<title>Technische Bemerkung</title>
<para>
html_image greift auf das Dateisystem zu um H&ouml;he und Breite zu errechnen. Wenn Sie
caching nicht verwenden sollten Sie normalerweise auf diese Funktion aus performance Gr&uuml;nden verzichten.
{html_image} greift auf das Dateisystem zu um H<EFBFBD>he und Breite zu
errechnen. Wenn Sie <link linkend="caching">caching</link> nicht
verwenden sollten Sie normalerweise auf diese Funktion aus
performance Gr<47>nden verzichten.
</para>
</note>
<example>
<title>html_image</title>
<programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->display('index.tpl');
?>
]]>
</programlisting>
<para>
Wobei index.tpl wie folgt aussieht:
</para>
<programlisting>
<![CDATA[
-----------------------------------
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}
]]>
</programlisting>
<para>
M&ouml;gliche Ausgabe:
M<>gliche Ausgabe:
</para>
<screen>
<![CDATA[