# &quanta; benutzen

## Einführung

Während des Versuchs, der beste HTML-Editor zu werden, kam den Entwicklern von &quanta; eine verrückte Idee: Was, wenn &quanta; ein allgemeiner, erweiterbarer, Formatierungssprachen-Editor wäre?

Also, das ist der Anfang der Antwort. Nicht länger gebunden an HTML wird &quanta; nun immer mehr DTD-gesteuert. Wenn Sie eine für XML oder SGML definieren können, &quanta; kann auch als IDE dafür dienen.

Nun, es muss gesagt werden, dass &quanta; ein Nebenprodukt der großartigen Anstrengungen, die die ganze KDE Entwicklergemeinde leistet. &quanta; funktioniert ganz nach der Strategie Warum etwas neu schreiben, was jemand schon getan hat und betreut?

&quanta; bietet Internetentwicklern ein intuitives und mächtiges Multiple Document Interface MDI das Ihre Effektivität als Internetentwickler dramatische steigern kann. Durch die Nutzung eigener Aktionen, Skripte und Werkzeugleistenerstellung können Sie jede Arbeit automatisieren. Mit der Benutzung von Kaptain können Sie &quanta; so erweitern, dass Sie nie wieder Skriptsprachen lernen müssen. (Mehr darüber im Abschnitt Erweiterte Funktionen.)

### Der &quanta;-Arbeitsbereich

&quanta; teil Arbeitsplatz-Dateien in drei Kategorien ein: Global, Lokal und Projekt. Diese Unterscheidung beeinflusst den Bereich oder Sichtbarkeit der verschiedenen Komponenten der &quanta;-Umgebung.

Global

  Globale Elemente sind für jeden verfügbar, der &quanta; benutzt. Von Werkzeugleisten zu Aktionen, alles was als global markiert ist, wird in der normalen &quanta;-Verzeichnisstruktur gespeichert. Das hat den Effekt, dass Administratoren erlaubt wird, bestimmte Werkzeugleisten, Aktionen und Vorlagen im globalen Baum zu speichern und in einem Multibenutzersystem für alle Benutzer von &quanta; bereitzustellen.

Lokal

  Lokale Elemente sind Elemente, die Teil der Sammlung von individuellen Benutzer sind. Sie werden im jeweiligen Heimatverzeichnis des Benutzers gespeichert und sind Teil der Umgebungsinformation von KDE. Das bedeutet, dass die lokalen Elemente für diesen Benutzer überall zur Verfügung stehen. Das erlaubt Ihnen, Ihre am häufigsten benutzten Vorlagen und Werkzeugleisten in Ihrem Heimatverzeichnis zu speichern und Sie in allen Dokumenten zu benutzen.

Projekt

  Projektelemente sind diese, die nur einem bestimmten Projekt angehören. Sie können alles sein, von einer CSS-Vorlage zu einer Werkzeugleiste mit einer eigenen Aktion, die einen speziellen magischen Trick ausführt. Einfach gesagt, ist dies der limitierteste Bereich. Alle Elemente im Projekt-Arbeitsbereich werden in den Verzeichnisbaum des Projektes gespeichert.

## &quanta;s MDI-Oberfläche

&quanta; mit diesem Dokument!!

&quanta; MDI, während der Bearbeitung dieses Dokuments

&quanta;s MDI ist in drei Hauptteile eingeteilt: das Editorfenster, das Baumansichtsfenster und die Werkzeugleisten.

## Das &quanta;-Editorfenster

Vergrößerung auf das Editorfenster

&quanta;s Editorfenster

&quanta;s Editorfenster erlaubt mehrere Dateien zur selben Zeit zu öffnen. Wenn nur eine Datei geöffnet ist, füllt das Dokument das ganze Editorfenster. Wenn ein zweites geöffnet wird, wird ein klein wenig Platz vom unteren Rand genommen um einzelne Reiter mit dem Dateinamen und einem Statussymbol für jede Datei anzuzeigen. (Dieses Statussymbol ist hier nicht zu sehen, aber es ist eine blaue Diskette neben dem Dateinamen, wenn die Datei nach einer Änderung noch nicht gespeichert war.)

Oben im Fenster ist der Werkzeugleistenteil. Aktuell hat &quanta; eine Standardsammlung von Werkzeugleisten, die geladen werden. Das sind Standard, Schrift, Tabellen, Listen, Formulare und Andere. Sie sind die Original-Werkzeugleisten, die schon eine Zeitlang Teil von &quanta; sind. Diese Werkzeugleisten sind streng nach HTML und werden weiterhin ein Teil von &quanta; sein, aber vielleicht nur noch bei Bedarf geladen.

Die Werkzeugleistenbenutzung ist sehr einfach. Wenn Sie nach einem grundlegenden Tag suchen (wie <u>) klicken Sie auf das Tag und es wird in Ihr Dokument eingefügt. Dann geben Sie die Informationen dazwischen ein (wenn es ein schließendes Tag besitzt) und nennen es gut. Wenn Sie ein Tag einfügen, das mehr Informationen braucht (wie ein <a href...>) bekommen Sie eine Dialogbox mit verschiedenen Feldern, die Sie ausfüllen können. Ein Dialog zur Erstellung eines HTML-Ankers

HTML Werkzeugleistenankerdialog

## Das &quanta;-Baumansichtsfenster

&quanta;s Baumansichtsfenster

Die Baumansicht ist der Platz, an dem Sie navigieren und Informationen in &quanta; bekommen. Seine Karteikartenform präsentiert Ihnen einenDatei, Projekt, Vorlagen, Dokumentstruktur und Dokumentationsbaum.

### Reiter in der Baumansicht

  Dateibaum: Dort können Sie das gesamte Dateisystem in Baumform durchforsten. Sie werden mit zwei Perspektiven konfrontiert. Die erste ist auf Ihr Heimatverzeichnis gesetzt und die zweite startet im Wurzelverzeichnis. Benutzen Sie diese um existierende Dateien zu finden, die Sie bearbeiten oder zum aktiven Projekt hinzufügen wollen. Ein Rechtsklick auf eine Datei in dieser Ansicht gibt Ihnen verschiedene Optionen zum Verwalten derselben und erlaubt Ihnen die Datei zum Projekt hinzuzufügen oder die Ansicht zwischen Baum und Liste umzuschalten. Versuchen Sie es!

  Projektbaum: Hoffentlich benutzen Sie Projekte, wenn Sie &quanta; benutzen.Projektmanagement ist das mächtigste Werkzeug, das &quanta; bietet. Diese Ansicht gibt Ihnen direkten Zugriff auf die Struktur und erlaubt Ihnen, die Dateien in Ihrem Projekt durch Rechtsklick zu verwalten. Fügen Sie Dateien hinzu, entfernen Sie sie oder laden Sie individuelle Dateien hoch. All das können Sie mit einem Rechtsklick tun, inklusive dem unwiederrufbaren Löschen von Dateien.

  Vorlagenbaum: Eine der neuen Funktionen in &quanta; 3 sind Vorlagen. Vorlagen können einfach alles sein, von Bildern über Code-Teile bis zu ganzen Webseiten. Vorlagen werden in drei Kategorien eingeteilt, basierend auf dem Bereich oder der Sichtbarkeit im aktuellen Kontext. Das sind Global, Lokal und Projekt. Wie Sie vielleicht raten, sind globale Vorlagen immer sichtbar. Lokale Vorlagen sind sichtbar für Benuzter, die sie erstellt haben und Projektvorlagen sind nur in einem einzigen Projekt sichbar. Mehr zu Vorlagen hier.

  Strukturbaum: Diese nette kleine Ansicht gibt Ihnen ein Überblick, wie das Analysewerkzeug (engl. Parser) Ihr Dokument sieht. Es ist sehr einfach zu verstehen und hilft mit den schließenden Tags, die man einfach so leicht vergisst.

  Dokumentationsbaum: Hier ist die ganze Dokumentation aufgelistet, die Sie in &quanta; erreichen können. Sie können vorgepackte Dokumentationspakete für &quanta; von http://quanta.sourceforge.net/docs.html herunterladen oder Sie können für &quanta; Ihre eigene Dokumentation erstellen.

## &quanta; Werkzeugleisten

Eine große Verbesserung in der Anstrengung von &quanta;, streng nach DTDs zu handeln, ist die einfache Benutzung für jede einzelne DTD. Dafür wurden die Werkzeugleisten in &quanta; stark erweitert. Werkzeugleisten sind einfach genug zu verstehen. Sie klicken auf den Knopf und bekommen eine zugewiesene Aktion dieses Knopfs. Der richtig coole Teil hier ist, dass Sie Ihre eigenen Aktionen in &quanta; definieren können.

Die Benutzung von Werkzeugleisten in &quanta; ist unvorstellbar einfach. Wenn Sie &Alt;I Werkzeugleisten auswählen, können Sie dort Werkzeugleisten laden, speichern, hinzufügen und per Mail verschicken.

Das Laden und Speichern ist sehr einfach. Wenn Sie eine Werkzeugleiste laden wollen, können Sie einen der drei Arbeitsbereiche von &quanta; wählen.

Eine der interessantesten neuen Funktionen der &quanta;-Werkzeugleisten ist, dass Sie sie direkt aus &quanta; per E-Mail verschicken können. Wenn Sie das tun, packt &quanta; alle Aktionen und die Werkzeugleisteninformationen in ein gepacktes Archiv zusammen und gibt es an &kmail; weiter. Wenn Sie eine Werkzeugleiste per Mail bekommen, können Sie sie irgendwo speichern und in &quanta; wie jede andere laden.

### Wie man Werkzeugleisten in &quanta; benutzt

Wie vorhin beschreiben werden Werkzeugleisten in &quanta; hauptsächlich durch den Menüeintrag Werkzeugleisten verwaltet. Benutzbarkeit und Schöpfung sind etwas ganz verschiedenes. Zu Schöpfungen gehört mehr, als dieses Dokument zulässt. Benutzbarkeit wird hier diskutiert.

Die Benutzung ist sehr einfach. Sie klicken auf das Symbol des gewünschten Tags und eine der drei Möglichkeiten tritt auf: Das Tag wird eingefügt (optional mit einem schließenden Tag) (z.B. das HTML-Tag Fett), eine Dialogbox erscheint, in der Sie die Tag-Eigenschaften einstellen können oder zuletzt wird eine Aktion ausgeführt, die etwas lustiges mit ihrer aktuellen Datei/ihrem aktuellen Projekt tut. Für die erste Möglichkeit werde ich kein Beispiel geben, da sie einfach zu verstehen ist. Für die zweite und dritte lesen Sie einfach weiter...

Wenn Sie für Skriptaktionen zwei Dateien in Ihrem Heimatverzeichnis mit dem folgenden Inhalt erstellen, werden Sie freudig überrascht sein.

dt.actions

    <!DOCTYPE actionsconfig>
    <actions>
    <action icon=mini-book1.png type=script name=usr_1 \
    	text=Shell
    > <script output=message error=message \
    	input=none
    >xterm</script>
    </action>
    </actions>

dt.toolbar

    <!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
    <kpartgui name="quanta" version="2">
      <ToolBar tabname="My1stToolbar" name="dt" >
       <text
    >My1stToolbar</text>
       <Action name="usr_1" />
      </Toolbar>
    </kpartgui>

Nun klicken Sie aufWerkzeugleisten Werkzeugleiste laden Lokale Werkzeugleiste laden , gehen zur Datei dt.toolbar in Ihrem Heimatverzeichnis (Vergessen Sie nicht, die Dateimaske von * nach *.toolbar.gz zu ändern) und die Aktion, die Sie erstellt haben wird nun zu einer Werkzeugleiste hinzugefügt, die My1stToolbar heißt. Wenn Sie auf die Aktion in dieser Werkzeugleiste klicken, öffnet sich ein xterm-Fenster.

&quanta-menus; &quanta-projects;

## &quanta; Vorlagen

Vorlagen sind grundsätzlich Skelettdokumente, Code-Teile und Dateien zum Verknüpfen. &quanta; benutzt Vorlagen fundamental als ein Standarddateisystem mit verbesserter Organisation und Oberfläche. Sie können jede Ressource in den Vorlagenbaum kopieren, verschieben oder verknüpfen. Denken Sie über Quanta-Vorlagen ungefähr so, wie Sie über die Limitierung Ihres Dateisystems denken.

Vorlagen existieren in verschachtelten Verzeichnissen. Es gibt keine Grenze wie tief man sie schachteln darf, allerdings erwartet Quanta in jedem Verzeichnis eine konsistente Aktion, für den Basisvorlagentyp, der weiter unten beschrieben wird. Zusätzliche Vorlagen erlauben Prä- und Posttext um die Vorlagen herumzubauen. Das erleichtert die Tagerstellung. Die nächste Aktualisierung nach der Einführung soll werden, dass man Variable an den Text übergeben kann, wie Bildgrößeninformation, um die Tagerstellung zu vereinfachen.

Unser Ziel mit Vorlagen ist es, sie zu einem Mehrfachdateienkonzept von Vorlagen auszubauen, um z.B. eine Reihenfolge zu erstellen oder einen "Über..."-Abschnitt. Idealerweise wird das ein Werkzeug, um Ihre Arbeit am produktivsten und dynamischsten zu machen. Ein eventuelles Ziel ist es, ein strukturiertes Vorlagendesign zu haben und damit die Struktur der Webseite nachzumodellieren und interaktive Ihre Seiten zu aktualisieren und erstellen. Wenn Sie dazu beitragen wollen schauen Sie auf die Seite Helfer gesucht.

Einige Vorlagen, die mit &quanta; mitgeliefert werden haben Bedingungen für ihren Einsatz. Bitte lesen Sie sorgfältig die Benutzungsbedingungen am Beginn jeder Vorlage, bevor Sie sie benutzen.

### Vorlagentypen

Aktuell sind Vorlagen auf folgende Objekttypen beschränkt:

- Dokument
- Text, der in ein Dokument eingefügt werden kann
- Eine zu verknüpfende Datei, um ein Dokument zu vervollständigen

Ein Dokument kann jeder Dokumenttyp sein. Normalerweise wollen Sie spezifischere oder verschiedene Dokumente in Unterverzeichnisse aufbewahren. Hier können Sie einen grundlegenden Rahmen für das festlegen, was Sie tun wollen und Ihre Arbeit organisiert und effizient durchführen. Einzufügender Text kann alles sein von einem Code-Schnipsel zu einem Skript oder was auch immer Sie benutzen wollen. Das überlappt die Möglichkeit, Textblöcke als Aktionen einzufügen, die über die Werkzeugleiste ausgeführt werden. Verknüpfte Dateien können binär sein, PHP Klassenbibliotheken oder was auch immer.

### Vorlagenbereiche

Vorlagen sind abhängig von Ihrem Arbeitsbereich in &quanta; zu erreichen.

### Vorlagen erstellen

Erstellen Sie eine Dokumentstruktur, die Sie mögen (XML, HTML, DocBook, usw.) und klicken Sie auf DAtei Als Vorlage speichern Als lokale Vorlage/Projektvorlage speichern

Wenn das getan worden ist, werden Sie bemerken das die Vorlage NICHT im Projektansichtsfenster auftauch (auch wenn Sie als Projektvorlage gespeichert wurde). Schauen Sie in die Vorlagenansicht um Ihre Vorlage zu finden.

Wenn Sie zusätzlich in die Möglichkeiten schauen, die Ihnen ein Rechtsklick bietet, sehen Sie komplette Dateiverwaltungswerkzeuge, um Verzeichnisse zu erstellen oder zu kopieren oder um Vorlagen von einem zum anderen Ort zu verschieben.

### Vorlagen mit Projekten benutzen

Projektvorlagen erlauben Ihnen, sich genauer zu konzentrieren. Sie können Kopfzeilen, Fußzeilen erstellen oder dynamisch mit PHP Include-Dateien werden und Sie verknüpfen. Zusätzlich gibt es einige sehr schöne Möglichkeiten, die wir für Projektvorlagen bedacht haben.

Wenn Sie ein Projekt erstellen können Sie optional alle globalen und lokalen Vorlagen dorthin kopieren. Ein erbendes Projekt bekommt aber immer die Standard-Vorlagen, also geht nicht verloren. Sie können auswählen, wo Ihre Vorlagendateien gespeichert werden sollen, also können Sie in Ihrem Server-Hauptverzeichnis liegen und einfach hochzuladen sein oder Sie können sie sicher machen und Sie in das Hauptverzeichnis des Servers verknüpfen. Wenn Sie eine Datei verknüpfen, die nicht in Ihrem Projekt ist, werden Sie gefragt, ob Sie die Datei kopieren wollen. Das verhindert verschwundene Dateien beim Hochladen. Sie haben immer die Kontrolle, wo Ihre Vorlagen liegen, so können Sie sie auch verschieben. Jedoch verfolgt Quanta das nicht, also müssen Sie Verknüpfungen von Hand abändern. Das ist eine gute Arbeit für kfilereplace, das wir demnächst als kpart in Quanta einfügen wollen.

### Vorlagenverhalten verwalten

Die Vorlagenstruktur im Vorlagenfenster basiert auf den Dateien in `$`KDEDIR`/share/apps/quanta/templates` und `$`HOME`/.kde/share/apps/quanta/templates`. Jedes dieser Verzeichnisse wird als einer der drei Behältertypen definiert:

files/all

  Binärdateien und solche Dinge werden mit Ihrer URL eingefügt (z.B. Bilder als <img src=/src/url >)

text/all

  Text, den Sie in Ihr aktuelles Dokument einfügen können. Zeug wie wiederholende Blöcke, usw.

template/all

  Dokumentvorlagen, die Sie benutzen können, um neue Dateien zu erstellen. Sie öffnen ein neues Fenster in Quanta.

Um das Verhalten von jedem Verzeichnis zu setzen, klicken Sie in der Vorlagenansicht darauf und wählen Sie Eigenschaft. Der folgende Dialog öffnet sich:

Typ

  Eine Box mit den eben diskutierten Typen: files, text, template. Diese Box wird grau, wenn Sie die Box Von Eltern erben aktiviert haben.

Von Eltern erben (<blah >)

  Das ist standardmäßig angeschaltet und ist gut für alle Verzeichnisse außer dem Hauptverzeichnis ihres Vorlagenbaums. Wenn das Hauptverzeichnis diese Einstellung angekreuzt hat, wird das alle Vorlagen für dieses Verzeichnis und für alle weiteren deaktivieren. Wenn das nicht das Hauptverzeichnis ist, dann ist <blah > irgendwas wie text/all. Wenn dort nichts steht, dann befinden Sie sich im Hauptverzeichnis.

Prä-/Posttext benutzen

  Aktiviert Prä- und Posttext für Vorlagen in diesem Verzeichnis. Das kann eine gemeinsame Kopf- und Fußzeile für alle Ihre Vorlagen eines Projektes sein. Sie kopieren dann die Inhaltsvorlagen in das Verzeichnis und haben eine komplette Seite mit den eigenen Kopf- und Fußzeilen als Startpunkt.

Prätext

  Der Text, der vor dem Vorlageninhalt eingefügt werden soll.

Posttext

  Der Text, der hinter dem Vorlageninhalt eingefügt werden soll.