Zend Framework 1.9.9 Manual
|
|
Jede Datei des Manuals muß die folgenden XML Deklarationen am Beginn der Datei enthalten:
XML Dateien von übersetzten Sprachen müssen auch ein Revisions Tag enthalten das mit der Revision der englischen Sprachdatei korrespondiert auf der die Übersetzung basiert.
Die maximale Zeilenlänge, inklusive Tags, Attribute und Einrückungen, darf 100 Zeichen nicht überschreiten. Es gibt nur eine einzige Ausnahme zu dieser Regel: Attributen und Werte Paaren ist es erlaubt die 100 Zeichen zu überschreiten wenn diese nicht getrennt werden dürfen.
Eine Einrückung sollte aus 4 Leerzeichen bestehen. Tabulatoren sind nicht erlaubt.
Tags welche auf dem gleichen Level sind müssen auch die gleiche Einrückung haben.
Tags welche ein Level unter dem vorhergehenden Tag sind müssen mit 4 zusätzlichen Leerzeichen eingerückt werden.
Mehrere Block Tags in der gleichen Zeile sind nicht erlaubt; mehrere Inline Tags sind trotzdem erlaubt.
Zend_Magicexistiert nicht.Zend_Aclexistiert.
Die Zeilen Begrenzung folgt der Unix Textdatei Konvention. Zeilen müssen mit einem einzelnen Linefeed (LF) Zeichen enden. Linefeed Zeichen werden als ordinale 10, oder Hexadezimale 0x0A repräsentiert.
Beachte: Es sind keine Carriage Returns (CR) zu verwenden welche die Konvention in Apple OS's (0x0D) sind, oder die Carriage Return - Linefeed Kombination (CRLF) welche der Standard für Windows OS (0x0D, 0x0A) sind.
Leere Tags sind nicht erlaubt; alle Tags müssen Text oder Untertags enthalten.
Irgendein Text.
Öffnende Block Tags sollten direkt nach Ihnen keine Leerzeichen haben sondern nur einen Zeilenumbruch (und Einrückungen in der folgenden Zeile).
LEERZEICHEN
Öffnende Inline Tags sollten keine Leerzeichen haben die Ihnen direkt folgen.
Das ist die KlasseZend_Class . Das ist die KlasseZend_Class .
Schließenden Block Tags können Leerzeichen vorangestellt sein die dem aktuellen Einrückungslevel entsprechen, aber nicht mehr als diese Anzahl.
Schließenden Inline Tags dürfen keine Leerzeichen vorangestellt sein.
Das ist die KlasseZend_Class Das ist die KlasseZend_Class
Mehrere Zeilenumbrüche innerhalb oder auch zwischen Tags sind nicht erlaubt.
Etwas Text... ... und mehr Text. Anderer Paragraph. Etwas Text... ... und mehr Text Anderer Paragraph.
Tags auf dem gleichen Level müssen durch eine leere Zeile getrennt sein um die Lesbarkeit zu erhöhen.
Etwas Text... Mehr Text... Etwas Text... Mehr Text...
Das erste Untertag sollte direkt unterhalb seiner Eltern geöffnet werden, ohne das eine leere Zeile zwischen Ihnen ist; das letzte Untertag solte direkt vor dem Schließenden Tag seiner Eltern geschlossen werden.
Das öffnende <programlisting> Tag muss das richtige "language" Attribut anzeigen und auf dem gleichen Level eingerückt sein wie die vorhergehenden Blöcke.
Vorhergehender Paragraph. CDATA sollte um alle Programm Auflistungen vorhanden sein.
<programlisting> Sektionen dürfen keine Zeilenumbrüche oder Leerzeichen am Anfang oder Ende der Sektion besitzen, da diese auch in der endgültigen Ausgabe dargestellt werden.
Endende CDATA und <programlisting> Tags sollten in der gleichen Zeile, aber ohne Einrückung stehen.
Das <programlisting> Tag sollte das "language" Atribut mit einem Wert enthalten der dem Inhalt der Programm Auflistung entspricht. Typischerweise enthält es die Werte "css", "html", "ini", "javascript", "php", "text", und "xml".
Für Programm Auflistungen die nur PHP Code enthalten werden keine PHP Tags (wie z.B. "<?php", "?>") benötigt, und sollten auch nicht verwendet werden. Sie zeigen nur das Naheliegendste und werden durch die Verwendung des <programlisting> Tags impliziert.
]]> ]]> Die Zeilenlängen in Programm Auflistungen sollten den Coding Standard Empfehlungen folgen.
require_once(), require(), include_once() und include() sollten innerhalb von PHP Auflistungen nicht verwendet werden. Sie zeigen nur das naheliegendste, und sind meistens nicht notwendig wenn ein Autoloader verwendet wird. Sie sollten nur verwendet werden wenn Sie essentiell für das Beispiel sind.
Note: Niemals Short Tags verwenden
Short Tags (z.B., "<?", "<?=") sollten niemals innerhalb von programlisting oder einer Dokuments verwendet werden.
Das Tag <classname> muß jedesmal verwendet werden wenn ein Klassenname durch sich selbst repräsentiert wird; er sollte nicht in Kombination mit einem Methodennamen, Variablennamen, oder einer Konstante verwendet werden, und auch anderer Inhalt ist nicht innerhalb des Tags erlaubt.
Die Klasse Zend_Class .
Variablen müssen im <varname> Tag eingehüllt sein. Variablen müssen mit Verwendung des "$" Siegels geschrieben werden. Kein anderer Inhalt ist innerhalb des Tags erlaubt, ausser es wird ein Klassenname verwendet, der eine Klassenvariable anzeigt.
Die Variable $var und die KlassenvariableZend_Class::$var .
Methoden müssen innerhalb des <methodname> Tags stehen. Methoden müssen entweder die komplette Methoden Signatur enthalten, oder zumindest ein Paar schließender Klammern (z.B., "()"). Kein anderer Inhalt ist innerhalb dieses Tags erlaubt, ausser es wird ein Klassenname verwendet der eine Klassenmethode anzeigt.
Die Methode foo() und die KlassenmethodeZend_Class::foo() . Eine Methode mit der kompletten Signaturfoo($bar, $baz)
Das <constant> Tag ist zu verwenden wenn Konstanten angezeigt werden sollen. Konstanten müssen GROßGESCHRIEBEN werden. Kein anderer Inhalt ist innerhalb dieses Tags erlaubt, ausser es wird ein Klassenname verwendet, der eine Klassenkonstante anzeigt.
Die Konstante FOO und die KlassenkonstanteZend_Class::FOO .
Dateinamen und Pfade müssen im <filename> Tag enthalten sein. Kein anderer Inhalt ist innerhalb dieses Tags erlaubt.
Die Datei application/Bootstrap.php .
Commands, Shell Skripte, und Programmaufrufe müssen im <command> Tag enthalten sein. Wenn das Kommando Argumente enthält sollten diese auch im Tag enthalten sein.
Ausführen von zf.sh create project .
Die Verwendung des <code> Tags ist nicht erlaubt. Stattdessen sollten die anderen vorher besprochenen Inline Tags verwendet werden.
Das <title> Tag darf keine anderen Tags enthalten.
Verwendung von <classname>Zend_Class</classname> Verwendung von Zend_Class
|
|
|