o.O
Guten Tag!
Als allererstes möchte ich mich einmal bei den Typo3 Machern bedanken, da dieses CMS wirklich gut ist.
So, nun kommt aber gleich darauf schon die große Rüge: Wieso wird ein solch großartiges CMS mit einer solch dürftigen Dokumentation ausgestattet?
Da ich mir das "Getting Started" Tutorial bereits durchgearbeitet habe (das ich als verständlich und gut befunden habe), bin ich nun zum "Modern Template building" übergegangen, in der Hoffnung auch etwas zu verstehen. Nix da! In diesem Tutorial werden einem hoffnungslos irgendwelche Codeschnipsel an den Kopf geworfen die für jemanden der keine Ahnung von Typoscript hat einfach nicht verstehbar sind, zumal ich in der Logik von TypoScript bis dato noch nichts erwähnenswertes entdeckt habe (Vielleicht ändert sich das ja mal mit fortschreitendem Wissen).
Die TypoScript Online Referenz ist meiner Meinung nach komplett überflüssig, da sie nicht den geringsten Zusammenhang zwischen Objekten erklärt. Beispiel:
Im Tutorial werden 2 Zeilen Typoscript so angegeben:
page.10 = TEXT
page.10.value.wrap = <b> |</b> <br />
Also gehe ich da ich mich eigentlich täglich mit Objektorientierter Programmierung beschäftige davon aus, dass "value" eine Methode eines Objekts, in dem Fall des Objektes "10" ist. 10 ist laut Doku ein sogenanntes "cObjekt", das als "TEXT" definiert wurde, also schaue ich unter "TEXT" nach, finde eine Beschreibung "text, wrap with stdWrap properties" (Was immer auch ein WRAP sein mag). Also suche ich nach dem "stdWrap" Objekt und sehe eine Liste von Eigenschaften, die ungeordneter nicht sein könnte, da sie ja die interne Abarbeitungsreihenfolge repräsentiert, die ja natürlich wichtig ist. Wenn ich einem Kunden ein Menü einrichte, würde dieser ja auch die Funktionsanordnung die die innere Abarbeitung repräsentiert bevorzugen, nicht etwa eine komplizierte alphabetische Auflistung.
Zum Glück gibt es ja "Strg+F", also kein Problem 🙂
Nun sagt mir die Referenz folgendes:
Property: "wrap"
Data type: "wrap /+.splitChar"
Description: ".splitChar defines an alternative splitting character (default is "|" - the vertical line)"
Datentyp "wrap/+. splitChar" , Ok heisst der Datentyp nun so oder kann man da irgendwie zwischen "wrap", "/+." oder ".splitChar" aussuchen oder was bedeuten diese nirgendwo erklärten Hieroglyphen?
Da mir ja die Beschreibung sagt "splitChar" definiert mir einen alternativen Aufteilungscharakter frage ich mich nun: "Komisch, ich wollte eigentlich nur erfahren was "wrap" mach und plötzlich bekomme ich hier ein splitChar an den Kopf geworfen, dessen Anwendung nicht erklärt ist und für mich eigentlich nicht im geringsten Falle relevant ist".
Also dachte ich mir, wird wohl besser werden, und sah mir das Kapitel an wo Php Funktionen eingebunden werden. Aber nichts wurde besser, im Gegenteil. Irgendwelche Objekte werden dahergeschrieben, die auf irgendwelche Arrayvariablen die in der Php Funktion vorkommen zugreifen. Noch dazu wird eine Übergabefunktion definiert, und direkt aus TS die PHP Funktion alleine ohne Übergabeparameter aufgerufen. Wird wohl Typo3 irgendwie machen. Aber durch ständiges probieren kommt man bestimmt einmal drauf. In 1 Woche vielleicht. Oder auch früher. Schliesslich hat diese Doku ja nur noch 40 Seiten also wird man prima in 5-6 Monaten fertig.
Ich meine ist das denn so schwer jemanden der sich schon die Mühe mach sich mit einem solchen Mörderprojektz auseinandersetzt mit einer anständigen Doku zu unterstützen? Ich weiss, es ist Freeware und daher könnten jetzt Stimmen laut werden, die sagen "Reg dich nicht auf, einem geschenkten Gaul schaut man nicht ins Maul". Aber wenn man dieses CMS schon so hochpreist, dann sollte es diesen Anforderungen auch gerecht werden -und im Bezug auf TypoScript ist dies bezüglich einer ordentlichen Doku überhaupt nicht der Fall. Da Typo3 ja immer unfangreicher wird und demzufolge immer komplexer, werden immer weniger Menschen die Qualen der ewigen "probieren geht über studieren Phase" auf sich nehmen und auf andere Systeme umsteigen die erheblich besser dokumentiert sind.
Ich weiß, dass ich sehr schlecht über Typo3 rede, aber es betrifft nur die Dokumentation, das CMS an sich ist super.
Falls jemand einen Link hat, der TypoScript __logisch__ und für Anfänger verständlich erklärt dann möchte ich bitten diesen zu posten, somit wäre nicht nur mir, sondern auch vielen anderen Anfängern geholfen (bezüglich dieses Themas gibt es ja schn unzählige Posts). Die deutsche Typo3 Dokumentation habe ich mir schon besorgt und einmal quergelesen - diese macht mir wieder Hoffnungen, es ist aber nicht so viel TS beschrieben.
freundliche Grüße,
pete