# &quanta; erweitern

Dieses Kapitel beschreibt, wie Sie &quanta; an Ihre Bedürfnisse anpassen können und wie Sie &quanta; helfen können, besser zu werden.

## Erstellen Sie Ihre eignen Dokumentationen für &quanta;

Vielleicht die beste Hinzufügung zu &quanta; für den normalen Benutzer ist die Möglichkeit, eine spezielle Dokumentation für die Skriptsprache oder die Formatierungssprache hinzuzufügen, die Sie am liebsten mögen. Deswegen beschreibt dieses Kapitel, wie ich einen PHP-Dokumentationsbaum für meine persönliche Nutzung erstelle.

Bevor Sie Ihre eigene Dokumentation starten, könnten Sie mal in das &quanta; Repository schauen, ob jemand das schon für Sie getan hat.

Es gibt zwei Teile in diesem Prozess. Zuerst müssen Sie ein existierende Dokumentation für die Formatierungs-/Skriptsprache suchen. Dann müssen Sie die docrc-Datei erstellen. Den ersten Teil überlassen wir Ihnen, den zweiten behandeln wir hier.

Die normale Form der docrc-Datei sieht so aus:

    #KDE Konfigurationsdatei
    [Tree]
    Doc dir=<pfad, relativ zu dieser Datei, zu den Dokumentations-HTML-Dateien> z.b. php42/
    #Elemente im Hauptindex Top Element=<Ihre Beschreibung für diese Dokumentationen
    > z.B. PHP 4.2 Dokumentatino

    Section 1=Section1.html
    Section 2=#Sec2.1,#Sec2.2,#Sec2.3
    Sec2.1=Sec2.1.html
    Sec2.2=Sec2.2.html
    Sec2.3=Sec2.3.html
    ...

    [Context]
    ContextList=func1,func2,tag1,tag2,tag3
    func1=func1.html
    func2=func2.html
    tag1=tag1.html
    tag2=tag2.html
    tag3=tag3.html

Die docrc ist in zwei Teile geteilt: Tree und Context.

Der Abschnitt "Tree" definiert den sichtbaren Teil der Dokumentation im Dokumentationsbaum. Zum Beispiel sehen Sie jetzt in den PHP Dokumentation so etwas:

Bezüglich dieses Bildes, sieht meine docrc so aus:

    #KDE Config File

    [Tree]

    Doc dir=php42/

    #top level elements
    Top Element=PHP 4.2 documentation

    PHP 4.2 documentation=Table of Contents,#Getting Started,#Language Reference

    Table of Contents=index.html

    Getting Started=Introduction, ...
    Introduction=introduction.html
    ...

    Language Reference=Basic syntax, ...
    Basic syntax=language.basic-syntax.html
    ...

Beachten Sie das # vor Getting Started und Language Reference. Das zeigt an, dass dies Unterbehälter sind und eigenen Inhalt haben. Ich glaube nicht, dass es hier eine Tiefenbegrenzung gibt.

Sie merken, dass das Inhaltsverzeichnis direkt auf eine Datei referenziert ist (und konsequenterweise am oberen Ende der Baumansicht angezeigt wird!).

Leerzeichen beeinflussen nichts, aber schauen Sie nach & und < Zeichen. Diese sollten durch &amp; und &lt; in allen xml-basierten &quanta; Resourcendateien ersetzt werden.

Der Abschnitt "Context" ist der Abschnitt der docrc-Datei wird benutzt, um kontextabhängige Hilfe zu bekommen. Wenn Sie zum Beispiel ein PHP Skript schreiben und Sie die Dokumentation zur Funktion mysql_fetch_array sehen wollen, wählen Sie die Funktion einfach aus und drücken &Ctrl; H für die Kontexthilfe. Sie sehen die Dokumentation zu mysql_fetch_array. Es gibt nur zwei Eintragstypen hier: die "ContextList" und die Dateizugehörigkeitszeilen.

ContextList

  Sehr einfach, es ist einfach eine kommagetrennte Liste von den Kontexteinträgen, die Sie verfügbar haben wollen (für PHP sind diese die Funktionen).

Dateizugehörigkeitszeilen

  Sie haben die Form "Kontexteintrag"=HTML-Doku-Datei, z.B. acos=function.acos.html

. Eine gekürzte Versino meines Abschnitts "Context" ist hier:

    #Schlagwörter für die Kontexthilfe
    [Context]
    ContextList=abs,acos,acosh,addcslashes,addslashes,...

    abs=function.abs.html
    acos=function.acos.html
    acosh=function.acosh.html
    addcslashes=function.addcslashes.html
    addslashes=function.addslashes.html
    ...

Nun können Sie Ihre docrc-Datei einfach speichern und zwar nach `$`HOME`/.kde/share/apps/quanta/doc` oder `$`KDEDIR`/share/apps/quanta/doc` für lokale bzw. globale Benutzung. Dann erstellen Sie ein Verzeichnis (das, das Sie in Ihrer docrc-Datei angegeben haben) im selben Verzeichnis und kopieren Ihre HTML-Dokumentation dorthin.

Sie müssen &quanta; neu starten und sehen dann Ihre Dokumentationen.

Wenn Sie sich sicher sind, dass Sie gut und es wert sind, geteilt zu werden, senden Sie Ihre docrc-Dateien mit einer Beschreibung von wichtigen Informationen, z.B. welche Dokumentation benutzt wurden an das &quanta; Repository für die Benutzung von der &quanta;-Gemeinschaft. Sie werden davon nicht reich werden, aber Sie werden stolz darauf sein, bei der besten Webentwicklungsplattform mitgearbeitet zu haben.

Robert
Nickel

## Aktionen in &quanta; erstellen

Aktionen in &quanta; sind die Basis für alle Erweiterungen, die &quanta; hat und in der Zukunft haben wird. Derselbe Mechanismus der eine Aktion in &quanta; definiert, aktiviert die automatische Vervollständigung und Tag-Dialoge. Mit Aktionen sind Ihnen praktisch keine Grenzen gesetzt. Zum Beispiel benutzen wir html tidy auf unseren Webseiten.

Lassen Sie uns beginnen: Einstellungen Aktionen festlegen

Wenn Sie den Aktionsdialog starten, sehen Sie dieses Fenster. Links befindet sich eine Liste der aktuell bekannten Aktionen. Sie können eine davon auswählen und dieselben Aktionen für eine existierende Aktion ausführen.

Wir erstellen eine neue Aktion, also lassen Sie uns auf den Knopf "Neu" (unten links) klicken und beginnen.

Nun werden Sie mit einem leeren Satz von Einstellungen konfrontiert:

Text

  Das ist der Name der Aktion

Tool tip

  Ich bin mir nicht sicher, wo das angezeigt wird. Es ist freiwillig!

Statustext

  Ich weiß auch nicht wofür das ist. Es ist freiwillig!

Diese Aktion platzieren auf (Place this action onto)

  Das aktiviert die Box, aus der Sie auswählen können, auf welche Werkzeugleiste die Aktion platziert weren soll. Wenn Sie nichts wählen, können Sie die Aktion später unter Einstellungen Werkzeugleisten einrichten hinzufügen.

Nachdem Sie diese grundlegenden Dinge ausgefüllt haben, können Sie ein Symbol für die Aktion auswählen, indem Sie auf den Symbolknopf links vom Feld "Text" klicken.

Nun das wichtige der Aktion. Die Aktionsdefinition.

Wenn wir ein Formatierungstag definieren, benutzen wir den Reiter "Tag", um die Parameter des Tags einzugeben.

Dazu:

<Formatierung >

  Dort geben Sie den namen des Tags ein, wie es in Ihrem Dokument erscheinen soll. z.B. <div align=center>

</tag >

  Hier geben Sie ein schließendes Tag ein, wenn es eines gibt. z.B. <//div>. Falls es keines gibt, lassen Sie die Box unangekreuzt.

Dialog Tag bearbeiten öffnen, falls verfügbar (Run Edit Tag dialog if available)

  Das öffnet den Dialogeditor, falls eine Formatierungsdatei für diesen Eintrag existiert. Schauen Sie in den Abschnitt Formatierungsdateien für weitere Informationen darüber.

Un nun... Zurück zu unserem Programmablauf. Machen wir weiter mit unserer html tidy Aktion.

Klicken Sie auf den Reiter "Skript" um das folgende erscheinen zu lassen:

Eingabebox oben

  Dort geben Sie die gewünschte Anwendung an. In unserem Fall ist das /usr/local/bin/tidy, da ich dort tidy aufbewahre.

Nun zu den Seiten Eingabe/Ausgabe/Fehler.

Reiter "Eingabe"

Keine

  Keine Eingabe für dieses Skript. Das kann nützlich sein, wenn wir ein Tcl/Tk-Skript starten, das ein Fenster für die Benutzerabfrage öffnet und dann die Ergebnisse zurückgibt. Wir werden für tidy etwas anderes wählen.

Markierter Text

  Genau was drauf steht. Es gibt eine Kopie des aktuell ausgewählten Textes in die Standardeingabe des Skripts. Wir könnten das für tidy benutzen, aber es ist nicht lustig, alles in einem großen Dokument zu markieren.

Aktuelles Dokument

  Schiebt den Inhalt der Editorversion der Datei durch die Standardeingabe des Skriptes. Das benutzen wir für tidy.

Nun klicken Sie bitte auf den Reiter Ausgabe. Dort entscheiden wir, wo das Skript die Ausgabe hinschreibt.

Keine

  Oh. Das wäre schön, wenn wir eine externe Anwendung starten, die nur eine Eingabe entgegennimmt und nichts ausgibt. Das ist keine Lösung für uns mit tidy.

Einfügen an Cursor-Position

  Genau was es sagt. Stellen Sie sicher, dass der Cursor genau da steht, wo der Text eingefügt werden soll.

Aktuelles Dokument ersetzen

  Ersetzt die komplette Datei. Es wird nicht die Datei auf der Festplatte überschreiben aber es wird ihre aktuelle Sitzung vernichten. Benutzen Sie es mit Vorsicht. Wir werden es nicht für tidy benutzen.

Neues Dokument erstellen

  Gibt die Ausgabe in ein neues Dokument aus. Das ist die beste Lösung für tidy.

Nachrichtenfenster

  Gibt die Ausgabe in das Nachrichtenfenster &Ctrl; M . Das ist nützlich für die Fehlerbereinigung und den Reiter "Fehler", aber nicht für unsere Ausgabe.

Für Reiter "Fehler" sind die Einstellungen dieselben wie auf dem Reiter "Ausgabe". Normalerweise werden Sie das Nachrichtenfenster benutzen um Ihnen eine Hilfe zu geben oder die Einstellung "Keine".