TypoScript , Dokumentation sehr schlecht

Hallo Pete,

ich finde eigentlich, dass Typo3 - zumindest für ein OpenSource-Projekt - erstaunlich viel Dokumentation bereithält.

Was TypoScript betrifft, hast Du aber recht: die Dokumentation ist knapp. Vor allem aber - und diese Erfahrung habe auch ich gemacht - fällt es gerade objektorientiert denkenden Menschen sehr schwer, in diese Konfigurationssprache einzusteigen, eben weil die Punkt-Notation zunächst an eine Objekt/Methoden/Member-Notation erinnert - das war auch für mich anfangs sehr verwirrend.

Man muss sich einfach immer im Klaren darüber sein, dass alles in einem gigantischen, geschachtelten Array landet, dessen Einträge eben jeweils die durch Punkte getrennten Werte sind.

Dazu muss man dann eben noch wissen, welche Einträge ausgelesen werden und welche Einträge durch stdWrap laufen (das ist i.d.R. angegeben - für die Funktion von stdWrap gibt es ein separates Kapitel).

Fazit: derzeit bleibt einem nicht viel anderes übrig, als sich durch MTB, TypoScript by Example durchzuarbeiten und sich die Bsp. in TSRef anzusehen.

Gruß,
Der Karl

Vielleicht hilft aber auch die deutsche Dokumentation von Robert Meyer weiter? Diese findet man links auf dieser Seite im Menü.

karlklammer schrieb

Man muss sich einfach immer im Klaren darüber sein, dass alles in einem gigantischen, geschachtelten Array landet, dessen Einträge eben jeweils die durch Punkte getrennten Werte sind.

Eben! Wer versucht, sich Typoscript als Objektorientierte Sprache vorzustellen, der wird schier verzweifeln. TS ist halt keine Sprache, sondern eher so wie die Registry unter Windows zu verstehen...

CU
maxhb

Also ich habe auch die Doku gelesen und ich beschäftige mich auch mit der Programmierung und ich kann nur sagen: LIES GENAUER!!! Das is doch nicht so schwer.
Also ich bin mal erlich.
Ich hab erst die Doku gelesen und mir dann ein buch gekauft und was ergibt sich dadraus: das buch ist überflüssig geworden.
Also entweder bin ich Klug(das bezweifel ich ernsthaft) oda du hast nicht genau gelsen. Und wenn das lesen alleine nicht hilft dann eben neben her noch üben!

mfg

Hallo!

Ja ich werde mich einmal näher mit dem deutschen Tutorial beschäftigen, und versuchen mir die TypoScript-Brille aufzusetzen, anscheinend muss ich meine guten alten Objektorientierten Ansichten temporär abschalten um dies zu verstehen.

Jedenfalls werde ich die Suche nach dem "heiligen Gral" (-> ordentliche TypoScript Doku) nicht aufgeben, bis ich zumindest ansatzweise fündig werde 🙂

mit freundlichen Grüßen,
Pete

Ich schließ mich trotzdem mal an... template building 2+3 haben mich damals auch nicht weitergebracht sondern eher verwirrt, sehr viel besser sind da die Bücher wie zb:

Typo3, Enterprise Content Management
von Werner Altmann, Rene Fritz und Daniel Hinderink

oder auch zum nachblättern (weil kurz aber einfach)

Content Management mit Typo3, Galileo Computing
von Andreas Stöckl

MFG Proximo

PS: Es gibt auch einige gute bis sehrgute Tuts.. also einfach mal suchen 😉

petewulf schrieb

Jedenfalls werde ich die Suche nach dem "heiligen Gral" (-> ordentliche TypoScript Doku) nicht aufgeben, bis ich zumindest ansatzweise fündig werde 🙂

Und nicht vergessen solltest Du, dass auch DEINE Hilfe jederzeit hochgradig willkommen ist! Du kannst Dir jederzeit die aktuelle TSRef nehmen und so umstrukturieren dass sie besser und leichter zu verstehen ist. (Falls Du Openoffice nicht installieren kannst formatiere ich Dir die Datei gerne in ein beliebiges Format.)

Es ist immer ein "wenig" ärgerlich, wenn man sieht, dass Viele (gerechtfertigte) Kritik üben, aber nie zu einer Änderung beitragen. Bei einem kommerziellen System kann ich das verstehen, da hab ich für bezahlt. Aber T3 steht jedem frei zur Verfügung, nur die Ansprüche vieler sind die selben wie an ein teueres kommerzielles System. Und das past nicht.

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

mstuebner schrieb

Und nicht vergessen solltest Du, dass auch DEINE Hilfe jederzeit hochgradig willkommen ist! Du kannst Dir jederzeit die aktuelle TSRef nehmen und so umstrukturieren dass sie besser und leichter zu verstehen ist. (Falls Du Openoffice nicht installieren kannst formatiere ich Dir die Datei gerne in ein beliebiges Format.)

Es ist immer ein "wenig" ärgerlich, wenn man sieht, dass Viele (gerechtfertigte) Kritik üben, aber nie zu einer Änderung beitragen. Bei einem kommerziellen System kann ich das verstehen, da hab ich für bezahlt. Aber T3 steht jedem frei zur Verfügung, nur die Ansprüche vieler sind die selben wie an ein teueres kommerzielles System. Und das past nicht.

[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 🙂

freundliche Grüße,
Pete

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.

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

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

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.

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 😉

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... 😉

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

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.

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

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.