Zum Inhalt springen

Doku Extensions im Backend anzeigen ?

Erstellt am 5. Oktober 2003 · 11 Antworten · letzte Antwort am 5. Februar 2007

Tags: Frage

aviereck ·

Hey,

ich bin leider immer noch nicht dahinter gekommen, ob es möglich ist die im Online Repository herunterladbaren Dokumentationen in irgend einer Art und Weise im Backend unter dem Punkt "Doc" anzuzeigen???

Habe leider vergeblich nach den richtigen Beiträgen hierzu im Forum gesucht.

Evtl. kann mir da jemand auf die Sprünge helfen, wie die Doku´s verwendet werden können bzw. wie sie eingebunden werden.

Danke
Alwin

tpits ·

Auch auf die Gefahr hin das ich jetzt voll daneben liege und es da eine neue Extension gibt, die ich nicht kenne.

Ich kenne das Doc Modul im Backend nur als Ort in dem offene Datensätze angezeigt werden.

Eventuel hast Du da was anders verstanden als es gedacht war?

CU
TP

aviereck ·

Ok,

wenn nicht im Backend der Doc Bereich - wo kann man dann die Dokumentationen, die man im Extension Manager runterladen kann anzeigen ???
Es muß doch möglich sein, diese irgendwie als Content, Plugin etc. oder im Backend als Modul anzuzeigen ?

Gruß
Alwin

aviereck ·

Danke,

aber die Dokumentation habe ich schon lange.
Meine Frage ist damit immer noch nicht beantwortet:

Wie funktionieren die "Doku-Extensions" ? und wie kann man sie integrieren ?

o.O
Alwin

tpits ·

Hi,

jetzt versteh ich was Du vor hast.

Das ist eine gute Frage, würde mich auch sehr interessieren. Leider weiß ich das nun auch nicht. o.O

Sollte ich was rausfinden, melde ich mich hier wieder.

CU TP

aviereck ·

Die Antwort ist eigentlich gar nicht so schwierig! und wird einem spätestens dann klar, wenn man seine erste Extension erstellt:

Kasper hat das so organisiert, dass man nicht nur Extension Keys für die "eigentlichen Extensions" registriert, sondern auch um eine eigenständige Dokumentation zu schreiben.

Ich habe letztlich eine Dokumentation zum Thema "Typo3 auf Linux Mandrake 9.1" geschrieben und diese als Extension in das Extension Repository hochgeladen.
In der Extension besteht dann eigentlich nur ein File, nämlich im Unterverzeichnis "doc" ein "manual.sxw" File.

Dieses SXW File ist ein OpenOffice Dokument (Open Office ist quasi das Microsoft Word von Linux :-)) im XML Format.
Alle Dokumentationen für Typo3 werden nur noch in diesem Format produziert, da die www.typo3.org Seite diese SXW Dateien automatisch aus dem Extension Repository einlesen kann und die Doku dann unter: http://typo3.org/1421.0.html ( der Dokumentationsseite von Typo3.org) einstellt, ohne dass noch jemand irgend etwas macht.

Stellst Du eine neue Version Deiner Extension auf www.typo3.org bereit, wird automatisch auch Deine Dokumentation - falls Du eine erstellt hast - wieder erneut eingelesen.

Du kannst - wenn Du eine Extension hochlädst - bestimmen, ob Deine Extension im EM angezeigt werden soll oder nicht. Hierfür gibt es dann ein entsprechendes Menü etc.

Für die SXW Dokumentationsdateien gibt es eine Vorlage: http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=290&cHash=8ca184e2e0

Damit man weiss, wie das alles so funktioniert und was wie warum konfiguriert und eingestellt werden muss, liest man am besten folgende Dokumentation:
http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=291&cHash=26debf4caa

Genial Idee, man muss nur erst einmal herausfinden, was Kasper so alles zaubert!!!
Ich lerne jeden Tag was Neues.

Hoffe, das hat Dir ein bisserl weitergeholfen.
Wenn Du noch Fragen hast, ich weiß jetzt, wie das geht :-)

Alwin

extension22 ·

Seit typo3.org umgestellt ist, finde ich das leere Template für manual.sxw nicht mehr.
Habe schon viele Extensions nach einem brauchbaren Gerüst durchforstet, aber entweder haben die keine Doku oder ein Monstrum wie tt_news.

Hat jemand einen Link oder kann es mir mailen (Adresse per PM)?

Danke!
Schöne Grüße, Ext. 22

aviereck schrieb

Die Antwort ist eigentlich gar nicht so schwierig! und wird einem spätestens dann klar, wenn man seine erste Extension erstellt:

Kasper hat das so organisiert, dass man nicht nur Extension Keys für die "eigentlichen Extensions" registriert, sondern auch um eine eigenständige Dokumentation zu schreiben.

Ich habe letztlich eine Dokumentation zum Thema "Typo3 auf Linux Mandrake 9.1" geschrieben und diese als Extension in das Extension Repository hochgeladen.
In der Extension besteht dann eigentlich nur ein File, nämlich im Unterverzeichnis "doc" ein "manual.sxw" File.

Dieses SXW File ist ein OpenOffice Dokument (Open Office ist quasi das Microsoft Word von Linux :-)) im XML Format.
Alle Dokumentationen für Typo3 werden nur noch in diesem Format produziert, da die www.typo3.org Seite diese SXW Dateien automatisch aus dem Extension Repository einlesen kann und die Doku dann unter: http://typo3.org/1421.0.html ( der Dokumentationsseite von Typo3.org) einstellt, ohne dass noch jemand irgend etwas macht.

Stellst Du eine neue Version Deiner Extension auf www.typo3.org bereit, wird automatisch auch Deine Dokumentation - falls Du eine erstellt hast - wieder erneut eingelesen.

Du kannst - wenn Du eine Extension hochlädst - bestimmen, ob Deine Extension im EM angezeigt werden soll oder nicht. Hierfür gibt es dann ein entsprechendes Menü etc.

Für die SXW Dokumentationsdateien gibt es eine Vorlage: http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=290&cHash=8ca184e2e0

Damit man weiss, wie das alles so funktioniert und was wie warum konfiguriert und eingestellt werden muss, liest man am besten folgende Dokumentation:
http://typo3.org/doc.0.html?&tx_extrepmgm_pi1[extUid]=291&cHash=26debf4caa

Genial Idee, man muss nur erst einmal herausfinden, was Kasper so alles zaubert!!!
Ich lerne jeden Tag was Neues.

Hoffe, das hat Dir ein bisserl weitergeholfen.
Wenn Du noch Fragen hast, ich weiß jetzt, wie das geht :-)

Alwin

mmecker ·

Dieser Post hat mich endlich auf die richtige Spur gebracht:
Die Vorlage zum Erstellen von Dokumentationen ist als eigene Extension "Documentation template" (Key: doc_template) im Extension Repository zu finden.

Und ich Dummchen hab's immer unter "Documentation" gesucht... :o

mmecker ·

Zur ursprünglichen Fragestellung dieses Threads:

Die gewünschte Funktion kann mittlerweile über folgende Extension erreicht werden:
EXT: Extension Manual Viewer
Extension Key: rlmp_extensiondocs