TypoScript , Dokumentation sehr schlecht

petewulf · 2004-11-09T12:39:13+00:00

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 = | 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

mstuebner · 9. November 2004 19:34

petewulf schrieb
mstuebner schrieb
[Wie oft pro Tag liest man: Ich brauche Extension xyz, will nicht mal jemand sowas schreiben? (Jeder, nur ich nicht...)]

Ja kann ich gerne machen, insofern es meine Zeit zulässt und insofern ich TypoScript jemals verstehen werde 🙂

Siehst Du? DU brauchst diese Dokumentation, kannst aber nur tun wozu Du Zeit findest, logisch. Die Entwickler brauchen diese Doku nicht (haben das ja im Kopf) und müssen auch mit ihrer Zeit auskommen und zudem noch weiter entwicklen (was auch Zeit kostet). Merkst Du was? ;-)

Es ist immer der selbe Begrenzer (Zeit & Lust). Aber schaun mer mal.

petewulf · 9. November 2004 20:37

Hi mstuebner!

mstuebner schrieb
Siehst Du? DU brauchst diese Dokumentation, kannst aber nur tun wozu Du Zeit findest, logisch. Die Entwickler brauchen diese Doku nicht (haben das ja im Kopf) und müssen auch mit ihrer Zeit auskommen und zudem noch weiter entwicklen (was auch Zeit kostet). Merkst Du was? ;-)

Es ist immer der selbe Begrenzer (Zeit & Lust). Aber schaun mer mal.

Ja sicher hast du teilweise Recht. Teilweise sage ich deswegen, da man in diesem Fall unterscheiden muß. Die Entwickler leben durch und von diesem System, und dazu gehört nun mal auch eine anständige Dokumentation, denn schliesslich und endlich finden zahlende Kunden ja auch nur diese Dokumentationen zur Auswahl vor. Ist ja bezugnehmend auf andere Produkte/Dienstleistungen auch nicht anders, passt das Produkt ist man zufrieden, ist es nicht in Ordnung, findet sich der Weg zu anderen Anbietern. Klar bin ich auch bereit dafür auch etwas zu bezahlen, doch muss dafür die Ware auch in Ordnung sein. Und das Ziel des Entwickler dieses Systems ist es nun einmal eine große Community aufzubauen, in der sich durchaus viele Leute wiederfinden, die diese Leistung honorieren und dafür bezahlen. Meine Hauptaufgabe beschränkt sich nicht darauf den Entwickler in seinen Projekten zu unterstützen, sondern meine Arbeit besteht darin selbst Kunden zufrieden zu stellen und Dienstleistungen anzubieten - wovon ich natürlich auch einiges aus reiner Anerkennung machen muss um eben diese Kunden zufrieden zu stellen und auf längere Sicht zu halten.

Aus diesem Grunde sage ich, ich schreibe gerne eine Doku wenn ich die Zeit dazu finde. 8-)

mit freundlichen Grüßen,
Pete

mic_jan · 9. November 2004 21:16

Die Entwickler leben durch und von diesem System, und dazu gehört nun mal auch eine anständige Dokumentation, denn schliesslich und endlich finden zahlende Kunden ja auch nur diese Dokumentationen zur Auswahl vor.

Ich glaube, Kasper und Konsorten leben nicht von Typo3, sondern von der Umsetzung mit Typo3. Der Kunde braucht dann keine Doku für TypoScript u.ä.

Schließlich muss der normale Kunde auch nicht im HTML-Code rumwurschteln...

Gruss

Michael

mstuebner · 10. November 2004 00:03

petewulf schrieb
Die Entwickler leben durch und von diesem System, und dazu gehört nun mal auch eine anständige Dokumentation, denn schliesslich und endlich finden zahlende Kunden ja auch nur diese Dokumentationen zur Auswahl vor.

Ich "glaube" Du verwechselst gewisse Dinge. Es ist anzunehmen, dass Kasper davon lebt mit T3 kundenspezifische Projekte umzusetzen. Aber der Kunde zahlt dann nicht für T3 die er downloaden kann, sondern für das angepasste funktionsfähige Gesamtwerk, welches ihm, sicherlich mit einer projektbezogenen Dokumentation, übergeben wird.

NIEMAND der sich an T3 selbst bedient zahlt dafür. Und wenn irgendjemand für einen Kunden ein T3-Projekt umsetzt, dann zahlt der Kunde für die Umsetzung und Anpassung, aber NICHT für T3! Dahingehend solltest Du Deine Ansicht korrigieren. Daher ergeben sich dann auch andere Einstellungen und Ansichten betreffend Dokumentation etc.

Oder drückst Du einenm Kunden, für den Du ein Projekt umsetzt einfach die gesammelte zusammengestoppelte Entwicklerdokumentationin die Hand??

petewulf schrieb
Klar bin ich auch bereit dafür auch etwas zu bezahlen, doch muss dafür die Ware auch in Ordnung sein.

Und DAS ist Dein Trugschluss. Die Nutzer von T3 sollen (bzw. tun dies) nicht für oder an T3 mit Geld BEZAHLEN, sondern durch eigene Leistungen (Entwicklung oder/und Dokumentation) ihren Beitrag zu T3 beitragen. Oder hattest Du vor Kasper irgendwann mal einen großen Scheck zu schicken?

petewulf schrieb
Und das Ziel des Entwickler dieses Systems ist es nun einmal eine große Community aufzubauen, in der sich durchaus viele Leute wiederfinden, die diese Leistung honorieren und dafür bezahlen.

Wieder falsch. Es geht nicht immer um Geld!

petewulf schrieb
Meine Hauptaufgabe beschränkt sich nicht darauf den Entwickler in seinen Projekten zu unterstützen, sondern meine Arbeit besteht darin selbst Kunden zufrieden zu stellen und Dienstleistungen anzubieten

Mit dieser Einstellung kann man den Thread beenden, weil sinnlos, da Thema verfehlt. Sorry to say. Liest sich ein "bischen" Egozentrisch.

petewulf schrieb
Aus diesem Grunde sage ich, ich schreibe gerne eine Doku wenn ich die Zeit dazu finde. 8-)

Das sei Dir belassen, nur solltest Du von anderen nicht mehr erwarten als von Dir selbst. Es ist eben nicht Aufgabe der anderen Dir das Geldverdienen besonders einfach zu machen.

robert.meyer · 10. November 2004 00:13

Hallo,

Aus diesem Grunde sage ich, ich schreibe gerne eine Doku wenn ich die Zeit dazu finde

Das will ich sehen...

P.S.: Termine zu TYPO3-Workshops stehen auf der linken Seite 😉

Jörg Roth · 10. November 2004 00:40

Jeder, der "erfahren" mit Typo3 ist, wird sagen, es gibt nix einfacheres als TypoScript. Vorteile hat der, der sich schon mal in einer anderen Scriptsprache mit der Punktsyntax auseinandergesetzt hat. Egal ob Javascript, Lingo oder ActionScript - alles das gleiche Strickmuster. Und da man nunmal Stricken lernen muss... 😃

Und was "Wraps" betrifft: Schon mal beim Mexikaner gewesen? Da gibt's auch leckere Wraps... ich steh mehr auf die mit Gemüsefüllung, andere bevorzugen die original Mexikanischen (Hot!!! Drei Ausrufezeichen).
Und was hält die Füllung nun zusammen? Jenau. Ein Weizenmehlfladen. Und in TS ist das nix anderes... nur das es dort unterschiedliche Fladen zur Auswahl hat... 😉

Oliver Thiele · 10. November 2004 00:51

Danke Jörg,
den Vergleich mit den Wraps werde ich mir für meine nächsten Typo3-Schulungen merken =). Vielleicht sollte man dabei erwähnen, daß die verschiedenen Wraps im TS wie unterschiedliche Falttechniken zu sehen sind. :p

mstuebner · 10. November 2004 13:08

robert.meyer schrieb
Hallo,

Aus diesem Grunde sage ich, ich schreibe gerne eine Doku wenn ich die Zeit dazu finde

Das will ich sehen...

Und ich hatte mir einen solchen Kommentar extra verkniffen. 😃 Böser Robert.

petewulf · 10. November 2004 15:11

Hi mstuebner!

Da ich nun einmal von Kaspers Worten ausgehe, die auf www.typo3.org veröffentlich worden sind, gehe ich nun einmal davon aus, dass diese richtig sind:

-------------------------------------------------------------
Zitat:
The main programmer, Kasper Skårhøj, is an independent freelancer. 80% of his time is dedicated to TYPO3 development and the remaining 20% to paid freelance jobs (with Typo3). You are strongly encouraged to consider making a donation to Kasper, in particular if you are making or saving money by using TYPO3!
-------------------------------------------------------------

Ok und deshalb sage ich, ich würde natürlich den Entwickler insofern unterstützen indem ich ihm einen kleinen Geldanteil der durchgeführten Projekte überweise. Und da ich in diesem Fall eher diese Art der Unterstützung bevorzuge, stellt das natürlich kein Problem dar.

Mal abgesehen davon, dass es ökonomisch sicherlich der falsche Weg wäre, sich als Typo3 Neuling so derart tief in das System einzuarbeiten nur um eine super Doku zu schreiben, die der Entwickler von Typo in einem Bruchteil schreiben könnte. Wie gesagt, 80% der Zeit verbringt Kasper damit, Typo3 weiterzuentwickeln, 20% als Freelancer um sich GELD zu beschaffen um zu überleben. Und wenn eben mehr Geld zur Verfügung stehen würde(natürlich nur dann wenn mehrere Leute unterstützend mitwirken), wäre es Kasper möglich von mir aus 90% Zeit in Typo3 zu investieren und 10% als Freelancer um sich am Leben zu erhalten. Und da er selbst sagt, dass ihn freiwillige Abgaben erfreuen dann ist das auch so. Daher sehe ich nicht den geringsten Grund zur Aufregung wenn ich diesen Weg wähle, der aus meiner Sicht der bessere ist.

Und bezüglich der Community, klar ist es richtig, dass alle Leute die die Zeit und Lust dazu finden unterstützend mitwirken, sei es durch Forumsbeiträge, Dokus, Hilfestellungen, etc. Nur glaube ich, dass es jedem selbst frei gestellt ist in welcher Art und in welchem Ausmaß dies erfolgen soll.

mit freundlichen Grüßen,
Pete

mstuebner · 10. November 2004 21:14

Lediglich zwei abschliessende Anmerkungen von mir:

petewulf schrieb
You are strongly encouraged to consider

Das Wort für "kaufen" wäre BUY. Gegen finanzielle Unterstützung ist nie etwas einzuwenden, jedoch gibt Dir das in keiner Weise einen ANSPRUCH auf irgendwas.

petewulf schrieb
Nur glaube ich, dass es jedem selbst frei gestellt ist in welcher Art und in welchem Ausmaß dies erfolgen soll.

Das hat Dir meines Wissens auch niemand abgesprochen. MIR ging es nur Dir einen Denkanstoss bezüglich Deiner "ICH KAUFE / ICH HABE FORDERUNGEN/ANSPRÜCHE" Auffassung zu geben.

Ob mir das gelungen ist weis ich nicht, aber ich habs versucht. Und für mich sehe ich dieses Thema als erschöpft an.

Viel Spass noch mit T3.