repo_zf1/documentation/manual/de/module_specs/Zend_Markup-Renderers.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20760 -->
<!-- Reviewed: no -->
<sect1 id="zend.markup.renderers">
    <title>Zend_Markup Renderer</title>

    <para>
        <classname>Zend_Markup</classname> wird aktuell mit einem Renderer ausgeliefert, dem
        <acronym>HTML</acronym> Renderer.
    </para>

    <sect2 id="zend.markup.renderers.add">
        <title>Eigene Tags hinzufügen</title>

        <para>
            Indem man eigene Tags hinzufügt, kann man den <classname>Zend_Markup</classname>
            Renderern eigene Funktionalitäten hinzufügen. Mit der Tag Struktur kann man jede
            Funktionalität welche man haben will hinzufügen. Von einfachen Tags bis zu komplizierten
            Tag Strukturen. Ein einfaches Beispiel für ein 'foo' Tag:
        </para>

        <programlisting language="php"><![CDATA[
// Erstellt eine Instanz von Zend_Markup_Renderer_Html,
// mit Zend_Markup_Parser_BbCode als seinen Parser
$bbcode = Zend_Markup::factory('Bbcode');

// Dies erstellt ein einfaches 'foo' Tag
// Der erste Parameter definiert den Namen des Tags
// Der zweite Parameter nimmt ein Integer welche den Typ des Tags definiert
// Der dritte Parameter ist ein Array die andere Dinge des Tags definiert
// wie die Gruppe des Tags, und (in diesem Fall) ein Start und Ende Tag
$bbcode->addTag(
    'foo',
    Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
    array(
        'start' => '-bar-',
        'end'   => '-baz-',
        'group' => 'inline'
    )
);

// Jetzt gibt dies folgendes aus: 'my -bar-tag-baz-'
echo $bbcode->render('my [foo]tag[/foo]');
]]></programlisting>

        <para>
            Es gilt zu beachten das die Erstellung eigener Tag nur dann Sinn macht wenn der eigene
            Parser diese auch in einer Tag Struktur unterstützt. Aktuell unterstützt dies nur
            BBCode. Textile hat keine Unterstützung für eigene Tags.
        </para>

        <para>
            Einige Renderer (wie der HTML Renderer) enthalten auch Unterstützung für einen 'tag'
            Parameter. Dieser ersetzt die 'start' und 'end' Parameter, und er stellt die Tags
            inklusive einiger Standardattribute und dem schließenden Tag dar.
        </para>

        <sect3 id="zend.markup.renderers.add.callback">
            <title>Ein Callback Tag hinzufügen</title>

            <para>
                Durch das Hinzufügen eines Callback Tags kann man viel mehr tun als nur das einfache
                Ersetzen von Tags. Zum Beispiel kann man den Inhalt ändern, die Parameter verwenden
                um die Ausgabe zu beeinflussen, usw.
            </para>

            <para>
                Ein Callback ist eine Klasse welche das
                <classname>Zend_Markup_Renderer_TokenInterface</classname> Interface implementiert.
                Ein Beispiel einer einfachen Callback Klasse:
            </para>

            <programlisting language="php"><![CDATA[
class My_Markup_Renderer_Html_Upper extends Zend_Markup_Renderer_TokenConverterInterface
{

    public function convert(Zend_Markup_Token $token, $text)
    {
        return '!up!' . strtoupper($text) . '!up!';
    }

}
]]></programlisting>

            <para>
                Jetzt kann man das 'upper' Tag, mit einem Callback einer Instanz der Klasse
                <classname>My_Markup_Renderer_Html_Upper</classname> hinzufügen. Ein einfaches
                Beispiel:
            </para>

            <programlisting language="php"><![CDATA[
// Erstellt eine Instanz von Zend_Markup_Renderer_Html,
// mit Zend_Markup_Parser_BbCode als seinen Parser
$bbcode = Zend_Markup::factory('Bbcode');

// Das erstellt ein einfaches 'foo' Tag
// Der erste Parameter definiert den Namen des Tags
// Der zweite Parameter nimmt ein Integer welches den Tagtyp definiert
// Der dritte Parameter ist ein Array welches andere Dinge über ein Tag
// definiert, wie die Gruppe des Tags und (in diesem Fall) ein Start und Ende
// Tag
$bbcode->addTag(
    'upper',
    Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
    array(
        'callback' => new My_Markup_Renderer_Html_Upper(),
        'group'    => 'inline'
    )
);

// Jetzt wird die folgende Ausgabe erstellt: 'my !up!TAG!up!'
echo $bbcode->render('my [upper]tag[/upper]');
]]></programlisting>
        </sect3>
    </sect2>

    <sect2 id="zend.markup.renderers.list">
        <title>Liste der Tags</title>

        <table id="zend.markup.renderers.list.tags">
            <title>Liste der Tags</title>

            <tgroup cols="2" align="left" colsep="1" rowsep="1">
                <thead>
                    <row>
                        <entry>Beispiel Eingabe (BBCode)</entry>

                        <entry>Beispiel Ausgabe</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry>[b]foo[/b]</entry>

                        <entry><![CDATA[<strong>foo</strong>]]></entry>
                    </row>

                    <row>
                        <entry>[i]foo[/i]</entry>

                        <entry><![CDATA[<em>foo</em>]]></entry>
                    </row>

                    <row>
                        <entry>[cite]foo[/cite]</entry>

                        <entry><![CDATA[<cite>foo</cite>]]></entry>
                    </row>

                    <row>
                        <entry>[del]foo[/del]</entry>

                        <entry><![CDATA[<del>foo</del>]]></entry>
                    </row>

                    <row>
                        <entry>[ins]foo[/ins]</entry>

                        <entry><![CDATA[<ins>foo</ins>]]></entry>
                    </row>

                    <row>
                        <entry>[sup]foo[/sup]</entry>

                        <entry><![CDATA[<sup>foo</sup>]]></entry>
                    </row>

                    <row>
                        <entry>[sub]foo[/sub]</entry>

                        <entry><![CDATA[<sub>foo</sub>]]></entry>
                    </row>

                    <row>
                        <entry>[span]foo[/span]</entry>

                        <entry><![CDATA[<span>foo</span>]]></entry>
                    </row>

                    <row>
                        <entry>[acronym title="PHP Hypertext Preprocessor]PHP[/acronym]</entry>

                        <entry><![CDATA[<acronym title="PHP Hypertext Preprocessor">PHP</acronym>]]></entry>
                    </row>

                    <row>
                        <entry>[url=http://framework.zend.com/]Zend Framework[/url]</entry>

                        <entry><![CDATA[<a href="http://framework.zend.com/">Zend Framework</a>]]></entry>
                    </row>

                    <row>
                        <entry>[h1]foobar[/h1]</entry>

                        <entry><![CDATA[<h1>foobar</h1>]]></entry>
                    </row>

                    <row>
                        <entry>[img]http://framework.zend.com/images/logo.gif[/img]</entry>

                        <entry><![CDATA[<img src="http://framework.zend.com/images/logo.gif" />]]></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>
</sect1>