Erzeugung der ExtBase Dokumentation mit FOP
Für alle, die sich genau so sehnlich wie ich eine Dokumentation zu ExtBase wünschen, habe ich versucht, mit Hife von FOP (FormattingObjectsProcessor) die vorhandene DocBook Dokumentation zu rendern. Leider totaler Fehlschlag. Das XML validiert nicht und die Konvertierung fällt auf die Schnauze.
Netterweise hat mir Lars das Ganze unter Ubuntu gerendert (da scheint es kein Problem zu ein - manchmal könnte man echt auf Mac OS kacken...) - dabei kam das folgende PDF Dokument raus.
Hier also das Missing Manual zu ExtBase. Ich hoffe, dass die ExtBase Entwickler möglichst bald die Doku nachschieben und nicht nur das XML Dokument ausliefern, mit dem leider niemand was anfangen kann :-)
Extbase Dokumentation / Manual zum Download |
- 7 Kommentare
Vielen Dank!
Danach habe ich seit erscheinen der 4.3er Version von TYPO3 gesucht. Sehr unverständlich, warum sowas nicht direkt dem Paket beilag...
Re: Vielen Dank!
Hallo,
ich finde es nicht unverständlich, dass es nicht Beilag. Extbase und Fluid sind viel arbeit die - meines Erachtens - nur auf zwei Schultern lastete. Die Leistung sollte honoriert werden.
Und der kommentar von dir ist eher wieder eine Typische "mitnehmgesellschaft" Kommentar. Also ich kam bisher auch gut ohne Handbuch aus, 1. gibts ne Super Mailinglist, 2. sind die Jungs auch offen für persönliche Fragen
3. ist der Quellcode super-Dokumentiert.
4. gibts ein eins-a example
Mit ein wenig "eigeninitiative" findest du ohne viel aufwand alle information in dem PDF auch so. Aber unverständlich warum man selbst was tun sollte, die macher haben mir das zu liefern, schließlich zahle ich ja auch unmengen an geld für TYPO3 und an die die das machen sollen....
Wann kommt endlich die Doku ...
Zunächst einmal: Danke für Deine Unterstützung.
Da ich mich mit "die Typo3 Entwickler" angesprochen fühle aber noch ein Kommentar dazu: Wir "TYPO3 Entwickler" leisten die ganze Entwicklung in unserer Freizeit. Wir machen das, weil es uns Spaß macht und spannend ist. Der Release von Extbase hat uns (das Team hinter Extbase) an die körperlichen, familiären und mentalen Grenzen geführt. Dass verschiedene "dringende" Features fehlen oder die Doku noch nicht bereit steht, ist darauf zurückzuführen und auf nichts Anderes (auch nicht auf ein Extbase-Buch).
Grüße
Jochen
Entschuldigung...
Hallo liebe Typo3 Entwickler, es tut mir leid, wenn ich da den einen oder anderen von euch wohl persönlich vergrault habe. Klar ist es viel Zeit, die ihr da investiert und klar ist auch, dass man sich da nicht in eine reine Nehmerrolle setzen sollte. Ich habe denke ich schon auch etwas dazu beigetragen, indem ich z.B. alle Bugs direkt poste und damit etwas Beta-Testen betrieben habe. Das ein Projekt wie Typo3 nur funktioniert, wenn ein gutes Team dahintersteckt ist klar. Dennoch ist es für mich unverständlich, warum man bei allem Stress dann so etwas wie eine gerenderte Doku weglässt. Es ist doch für euch eine Sache von Sekunden, die Doku zu rendern und beizulegen. So wie es im Moment ist, muss man sie erst mal finden und dann gerendert bekommen. Um die Akzeptanz von ExtBase und Typo3 zu erhöhen und Vorurteile abzubauen - die es zweifelsohne gegenüber Typo3 gibt - wäre es schön, wenn ihr diesen Missstand möglichst schnell beseitigt. Viele Grüße aus Karlsruhe Mimi
XSL Datei zum Rendering mit FOP
Welche xsl Datei habt ihr für das Rendering verwendet? Ich wäre dankbar, wenn ihr diese hier zur Verfügung stellen würdet.
Docbook Rendering von ExtBase Manual
Hallo Steffen,
wir haben das am Schluss ohne FOP und XSL gemacht, statt dessen mit einem Tool, dass es z.B. unter Ubuntu gibt. Es heißt dblatex und wird folgendermaßen verwendet:
dblatex --pdf index.xml
Viele Grüße
Mimi
neue version
danke für das pdf- find es super!
gibts bereits eine neuere version? soviel ich mitbekommen habe ist das API noch nicht stable oder?