From cef4ae267657cde9a6610485943b526b18e5f34f Mon Sep 17 00:00:00 2001 From: messju Date: Sat, 18 Jun 2005 20:07:24 +0000 Subject: [PATCH] sync with en --- .../designers/chapter-debugging-console.xml | 86 ++++++----- docs/de/designers/config-files.xml | 111 ++++++++------ docs/de/designers/language-modifiers.xml | 145 +++++++++++------- .../language-modifier-capitalize.xml | 82 ++++++++-- 4 files changed, 270 insertions(+), 154 deletions(-) diff --git a/docs/de/designers/chapter-debugging-console.xml b/docs/de/designers/chapter-debugging-console.xml index 609fbcae..ac9ba7d6 100644 --- a/docs/de/designers/chapter-debugging-console.xml +++ b/docs/de/designers/chapter-debugging-console.xml @@ -1,41 +1,55 @@ - - - Debugging Konsole - - Smarty wird mit einer eingebauten Debugging Konsole ausgeliefert. Diese - Konsole informiert über die im aufgerufenen Template eingebundenen - Templates, die zugewiesenen Variablen und die Konfigurations-Variablen. - Die Formatierung der Konsole wird über das Template 'debug.tpl' - gesteuert. Um debugging zu aktivieren, setzten Sie '$debugging' auf 'true' - und (falls nötig) übergeben in '$debug_tpl' den Pfad zum 'debug.tpl' - Template (normalerweise SMARTY_DIR). Wenn Sie danach eine Seite laden, - sollte ein Javascript-Fenster geöffnet werden in welchem Sie alle - Informationen zur aufgerufenen Seite finden. Falls Sie die Variablen - eines bestimmten Templates ausgeben wollen, können Sie dazu die - Funktion {debug} verwenden. - Um debugging auszuschalten, können Sie '$debugging' auf 'false' setzen. - Sie können debugging auch temporär aktivieren, in dem Sie der - aufgerufenen URL SMARTY_DEBUG mit übergeben, dies muss jedoch zuerst mit - $debugging_ctrl aktiviert werden. - - - Technische Bemerkung - - Die Debugging Konsole funktioniert nicht für Daten die via 'fetch()' geladen - wurden, sondern nur für Daten die via 'display()' ausgegeben werden. Die Konsole - besteht aus ein paar Zeilen Javascript welche am Ende jeder Seite eingefügt werden. - Wenn Sie Javascript nicht mögen, können Sie die Ausgabe in 'debug.tpl' selbst - definieren. Debug-Ausgaben werden nicht gecached und Informationen zu 'debug.tpl' - selbst werden nicht ausgegeben. - - - - - Die Ladezeiten werden in Sekunden, oder Bruchteilen davon, angegeben. - - + + + Debugging Konsole + + Smarty wird mit einer eingebauten Debugging Konsole + ausgeliefert. Diese Konsole informiert über die im aufgerufenen + Template eingebundenen Templates, + die zugewiesenen Variablen und die + Konfigurations-Variablen. + Die Formatierung der Konsole wird über das Template debug.tpl gesteuert. Um + debugging zu aktivieren, setzten Sie $debugging auf 'true' und (falls + nötig) übergeben in $debug_tpl den Pfad zum + Debugtemplate (normalerweise SMARTY_DIRdebug.tpl). Wenn Sie + danach eine Seite laden, sollte ein Javascript-Fenster geöffnet + werden in welchem Sie alle Informationen zur aufgerufenen Seite + finden. Falls Sie die Variablen eines bestimmten Templates ausgeben + wollen, können Sie dazu die Funktion {debug} verwenden. Um + debugging auszuschalten, können Sie $debugging auf 'false' setzen. + Sie können debugging auch temporär aktivieren, in dem Sie der + aufgerufenen URL SMARTY_DEBUG mit übergeben, dies muss jedoch + zuerst mit $debugging_ctrl aktiviert + werden. + + + Technische Bemerkung + + Die Debugging Konsole funktioniert nicht für Daten die via fetch() geladen wurden, sondern nur + für Daten die via display() + ausgegeben werden. Die Konsole besteht aus ein paar Zeilen + Javascript welche am Ende jeder Seite eingefügt werden. Wenn + Sie Javascript nicht mögen, können Sie die Ausgabe in + 'debug.tpl' selbst definieren. Debug-Ausgaben werden nicht gecached + und Informationen zu 'debug.tpl' selbst werden nicht ausgegeben. + + + + + Die Ladezeiten werden in Sekunden, oder Bruchteilen davon, angegeben. + + - - - Konfigurationsdateien - - Konfigurationsdateien sind ein praktischer Weg um Template-Variablen - aus einer gemeinsamen Datei zu lesen. Ein Beispiel sind die Template-Farben. - Wenn Sie die Farben einer Applikation anpassen wollen, müssen Sie normalerweise - alle Templates durcharbeiten, und die entsprechenden Werte ändern. - Mit einer Konfigurationsdatei können Sie alle Definitionen in einer - einzigen Datei vornehmen, und somit auch einfach ändern. - - - Beispiel der Konfigurationsdatei-Syntax - + + + Konfigurationsdateien + + Konfigurationsdateien sind ein praktischer Weg um Template-Variablen + aus einer gemeinsamen Datei zu lesen. Ein Beispiel sind die + Template-Farben. Wenn Sie die Farben einer Applikation anpassen + wollen, müssen Sie normalerweise alle Templates durcharbeiten, + und die entsprechenden Werte ändern. Mit einer + Konfigurationsdatei können Sie alle Definitionen in einer + einzigen Datei vornehmen, und somit auch einfach ändern. + + + Beispiel der Konfigurationsdatei-Syntax + - - - Die Werte in einer Konfigurationsdatei können in einfachen/doppelten Anführungszeichen - notiert werden. Falls Sie einen Wert haben der sich über mehrere Zeilen ausbreitet muss dieser - Wert in dreifachen Anführungszeichen (""") eingebettet werden. Die Kommentar-Syntax kann frei - gewählt werden, solange sie nicht der normalen Syntax entsprechen. Wir empfehlen die - Verwendung von # (Raute) am Anfang jeder Kommentar-Zeile. - - - Dieses Beispiel hat 2 'sections'. 'section'-Namen werden von []-Zeichen umschlossen - und können alle Zeichen ausser [ und ] enthalten. - Die vier Variablen welche am Anfang der Datei definiert werden sind globale Variablen. Diese - Variablen werden immer geladen. Wenn eine definierte 'section' geladen wird, werden also - die globalen Variablen ebenfalls eingelesen. Wenn eine Variable sowohl global als auch - in einer 'section' vorkommt, wird die 'section'-Variable verwendet. Wenn zwei Variablen - in der gleichen 'section' den selben Namen aufweisen wird die Letztere verwendet. - - - Konfigurationsdateien werden mit config_load geladen. - - - Sie können Variablen oder auch ganze 'sections' verstecken indem - Sie dem Namen ein '.' voranstellen. Dies ist besonders wertvoll wenn - Ihre Applikation sensitive Informationen aus der Konfigurationsdatei liest - welche von der Template-Engine nicht verwendet werden. Falls eine Drittpartei - eine Änderung an der Konfigurationsdatei vornimmt können Sie so - sicherstellen, dass die sensitiven Daten nicht in deren Template geladen - werden können. - + + + Die Werte in einer + Konfigurationsdatei können in einfachen/doppelten + Anführungszeichen notiert werden. Falls Sie einen Wert haben der + sich über mehrere Zeilen ausbreitet muss dieser Wert in + dreifachen Anführungszeichen (""") eingebettet werden. Die + Kommentar-Syntax kann frei gewählt werden, solange sie nicht der + normalen Syntax entsprechen. Wir empfehlen die Verwendung von + # (Raute) am Anfang jeder Kommentar-Zeile. + + + Dieses Beispiel hat 2 'sections'. 'section'-Namen werden von + []-Zeichen umschlossen und können alle Zeichen ausser + [ und ] enthalten. Die vier + Variablen welche am Anfang der Datei definiert werden sind globale + Variablen. Diese Variablen werden immer geladen. Wenn eine + definierte 'section' geladen wird, werden also die globalen + Variablen ebenfalls eingelesen. Wenn eine Variable sowohl global als + auch in einer 'section' vorkommt, wird die 'section'-Variable + verwendet. Wenn zwei Variablen in der gleichen 'section' den selben + Namen aufweisen wird die Letztere verwendet, es sei denn $config_overwrite ist + deaktiviert ('false'). + + + Konfigurationsdateien werden mit config_load + geladen. + + + Sie können Variablen oder auch ganze 'sections' verstecken indem + Sie dem Namen ein '.' voranstellen. Dies ist besonders wertvoll wenn + Ihre Applikation sensitive Informationen aus der Konfigurationsdatei + liest welche von der Template-Engine nicht verwendet werden. Falls + eine Drittpartei eine Änderung an der Konfigurationsdatei + vornimmt können Sie so sicherstellen, dass die sensitiven Daten + nicht in deren Template geladen werden können. + + + Siehe auch: {config_load}, $config_overwrite, get_config_vars(), clear_config() und config_load() + - - - Variablen-Modifikatoren - - Variablen-Modifikatoren können auf alle Variablen angewendet werden, um deren Inhalt zu verändern. Dazu - hängen sie einfach ein | (Pipe-Zeichen) und den Modifikatornamen an die entsprechende - Variable an. Ein Modifikator über Parameter in seiner Arbeitsweise beinflusst werden. Diese Parameter - werden dem Modifikatorname angehängt und mit : getrennt. - - - Modifikator Beispiel - - + + Variablen-Modifikatoren + + Variablen-Modifikatoren können auf alle Variablen angewendet + werden, um deren Inhalt zu verändern. Dazu hängen sie einfach + ein | (Pipe-Zeichen) und den Modifikatornamen an + die entsprechende Variable an. Ein Modifikator über Parameter in + seiner Arbeitsweise beinflusst werden. Diese Parameter werden dem + Modifikatorname angehängt und mit : getrennt. + + + Modifikator Beispiel + + - - - Wenn Sie einen Modifikator auf ein Array anwenden, wird dieser auf jeden Wert angewandt. - Um zu erreichen, dass der Modifkator auf den Array selbst angewendet wird, muss dem - Modifikator ein @ Zeichen vorangestellt werden. Beispiel: - {$artikelTitel|@count} (gibt die Anzahl Elemente des Arrays $artikelTitel aus.) - - - Modifikatoren können aus Ihrem $plugins_dir - automatisch geladen (sehen Sie dazu auch Naming Conventions) - oder explizit registriert werden (register_modifier). - Zudem können alle PHP-Funktionen implizit als Modifikatoren verwendet werden. (Das Beispiel mit dem - @count Modifier verwendet die Funktion 'count' von PHP und keinen Smarty Modifikator) - PHP Funktionen zu verwenden eröffnet zwei Probleme: erstens: manchmal ist die Parameter Reiehnfolge nicht - erwünscht. ({"%2.f"|sprintf:$float} funktioniert zwar, sieht aber als {$float|string_format:"%2.f"} - das durch Smarty geliefert wird, besser aus. Zweitens: wenn $security auf TRUE gesetzt ist, - müssen alle verwendeten PHP Funktionen im $security_settings['MODIFIER_FUNCS']-Array - enthalten sein. - -&designers.language-modifiers.language-modifier-capitalize; -&designers.language-modifiers.language-modifier-count-characters; -&designers.language-modifiers.language-modifier-cat; -&designers.language-modifiers.language-modifier-count-paragraphs; -&designers.language-modifiers.language-modifier-count-sentences; -&designers.language-modifiers.language-modifier-count-words; -&designers.language-modifiers.language-modifier-date-format; -&designers.language-modifiers.language-modifier-default; -&designers.language-modifiers.language-modifier-escape; -&designers.language-modifiers.language-modifier-indent; -&designers.language-modifiers.language-modifier-lower; -&designers.language-modifiers.language-modifier-nl2br; -&designers.language-modifiers.language-modifier-regex-replace; -&designers.language-modifiers.language-modifier-replace; -&designers.language-modifiers.language-modifier-spacify; -&designers.language-modifiers.language-modifier-string-format; -&designers.language-modifiers.language-modifier-strip; -&designers.language-modifiers.language-modifier-strip-tags; -&designers.language-modifiers.language-modifier-truncate; -&designers.language-modifiers.language-modifier-upper; -&designers.language-modifiers.language-modifier-wordwrap; +]]> + + + + Wenn Sie einen Modifikator auf ein Array anwenden, wird dieser auf + jeden Wert angewandt. Um zu erreichen, dass der Modifkator auf den + Array selbst angewendet wird, muss dem Modifikator ein + @ Zeichen vorangestellt werden. Beispiel: + {$artikelTitel|@count} (gibt die Anzahl Elemente + des Arrays $artikelTitel aus.) + + + Modifikatoren können aus Ihrem $plugins_dir automatisch + geladen (sehen Sie dazu auch Naming Conventions) oder + explizit registriert werden (register_modifier). Zudem + können alle PHP-Funktionen implizit als Modifikatoren verwendet + werden. (Das Beispiel mit dem @count Modifier + verwendet die Funktion 'count' von PHP und keinen Smarty + Modifikator) PHP Funktionen zu verwenden eröffnet zwei Probleme: + erstens: manchmal ist die Parameter Reiehnfolge nicht + erwünscht. ({"%2.f"|sprintf:$float} + funktioniert zwar, sieht aber als + {$float|string_format:"%2.f"} das durch Smarty + geliefert wird, besser aus. Zweitens: wenn $security auf TRUE gesetzt ist, + müssen alle verwendeten PHP Funktionen im + $security_settings['MODIFIER_FUNCS']-Array enthalten sein. + + + Siehe auch register_modifier(), register_function(), Smarty durch Plugins erweitern und Variablen-Modifikatoren. + + + &designers.language-modifiers.language-modifier-capitalize; + &designers.language-modifiers.language-modifier-cat; + &designers.language-modifiers.language-modifier-count-characters; + &designers.language-modifiers.language-modifier-count-paragraphs; + &designers.language-modifiers.language-modifier-count-sentences; + &designers.language-modifiers.language-modifier-count-words; + &designers.language-modifiers.language-modifier-date-format; + &designers.language-modifiers.language-modifier-default; + &designers.language-modifiers.language-modifier-escape; + &designers.language-modifiers.language-modifier-indent; + &designers.language-modifiers.language-modifier-lower; + &designers.language-modifiers.language-modifier-nl2br; + &designers.language-modifiers.language-modifier-regex-replace; + &designers.language-modifiers.language-modifier-replace; + &designers.language-modifiers.language-modifier-spacify; + &designers.language-modifiers.language-modifier-string-format; + &designers.language-modifiers.language-modifier-strip; + &designers.language-modifiers.language-modifier-strip-tags; + &designers.language-modifiers.language-modifier-truncate; + &designers.language-modifiers.language-modifier-upper; + &designers.language-modifiers.language-modifier-wordwrap; - - - capitalize (in Grossbuchstaben schreiben) - - Wird verwendet um den Anfangsbuchstaben aller Wörter in der Variable gross (upper case) zu schreiben. - - - capitalize (in Grossbuchstaben schreiben) - + + + capitalize (in Grossbuchstaben schreiben) + + + + + + + + + + Parameter Position + Typ + Benötigt + Vorgabe + Beschreibung + + + + + 1 + boolean + Nein + false + Bestimmt ob Wörter die Ziffern enthalten auch in + Großschreibung gewandelt werden + + + + + + Wird verwendet um den Anfangsbuchstaben aller Wörter in der + Variable gross (upper case) zu schreiben. + + + capitalize (in Grossbuchstaben schreiben) + +assign('articleTitle', 'diebe haben in norwegen 20 tonnen streusalz entwendet.'); + +?> +]]> + + + Wobei das Template wie folgt aussieht: + + + + + + AUSGABE: + + + - - +]]> + + + + Siehe auch lower (in + Kleinbuchstaben schreiben) upper (in Grossbuchstaben + umwandeln) + +