Difference between revisions of "FPDoc Editor/de"

From Lazarus wiki
Jump to navigationJump to search
m
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{FPDoc Editor}}
 
{{FPDoc Editor}}
−
 
+
<br>
 +
Zurück zu den [[Additional information/de|Zusätzlichen Informationen]].<br>
 +
<br>
 
== Einleitung ==
 
== Einleitung ==
−
LazDoc ist ein integrierter Editor/Betrachter für Lazarus. Hierzu beschriebene Elemente und der Gebrauch von LazDoc selbst erfordern von Ihnen, mit FPDoc vertraut zu sein. Für mehr Informationen siehe: [http://lazarus-ccr.sourceforge.net/fpcdoc/fpdoc/fpdoc.html Free Pascal Dokumentationstool Handbuch]
+
FPDoc ist das Free-Pascal-Dokumentationswerkzeug speziell zum Erzeugen von Hilfedateien für individuelle Einheiten vom Pascal Quellkode. Für mehr Informationen siehe: [http://lazarus-ccr.sourceforge.net/fpcdoc/fpdoc/fpdoc.html Free Pascal Dokumentationstool Handbuch (englisch)].
  
−
=== LazDE - Lazarus Documentation Editor ===
+
[[image:FPDocEditorDescription.png]]
−
Der große Bruder des ''FPDoc Editor'' ist [[Lazarus_Documentation_Editor|lazde]] der Lazarus-Dokumentationseditor. Er ist ein eigenständiges Programm und befindet sich in ($LazDir)/doceditor/lazde.lpi. Er muss mit der IDE übersetzt werden und läuft dann außerhalb der IDE.
 
  
−
== Wo ist FPDoc zu finden? ==
+
Lazarus liefert einen eingebauten FPDoc Hilfe Betrachter und zwei Editoren mit zum Erzeugen beziehungsweise Aktualisieren der FPDoc Quelltext Dokumentation. Einen einfachen, eingebauten names '''FPDoc Editor''', der auf dieser Seite beschrieben wird, und einen vollständigen und aufwendigeren Editor namens [[Lazarus_Documentation_Editor/de|LazDE]].
  
−
FPDoc ist in die Lazarus IDE integriert. Es ist im Menü "Ansicht" zu finden.
+
Der große Bruder des ''FPDoc Editor'' ist [[Lazarus_Documentation_Editor/de|LazDE]] der Lazarus-Dokumentationseditor. Er ist ein eigenständiges Programm und befindet sich in ($LazDir)/doceditor/lazde.lpi. Er muss mit der IDE übersetzt werden und läuft dann außerhalb der IDE. Sie können ihn als externes Werkzeug zum Werkzeugemenü hinzufügen.
  
−
== Gebrauch ==
+
== Benutzung des FPDoc Editors ==
 
Die Verwendung von FPDoc ist sehr einfach.
 
Die Verwendung von FPDoc ist sehr einfach.
  
−
1. Öffnen sie den FPDoc Editor. Sie können ihn im Menü "Ansicht" finden.
+
1. Öffnen Sie den FPDoc Editor. Sie können ihn im Menü "Ansicht" finden.
 +
 
 +
2. Setzen und bewegen Sie den Cursor. Nachdem der Cursor im Quelltext-Editor platziert wurde, werden Sie bemerken, dass sich die Beschriftung des Formulars FPDoc ändert. Die Beschriftung zeigt das ausgewählte Quellelement und den Dateinamen der Dokumentationsdatei. Durch Auswahl der geeigneten Seite in FPDoc können Sie ein spezifisches Dokumentations-Tag bearbeiten. Natürlich ist es auch möglich, FPDoc nur als Betrachter zu nutzen.
 +
 
 +
3. Klicken Sie auf die Schaltfläche 'Hilfe erzeugen'. Falls Sie die FPDoc-Suchpfade noch nicht eingerichtet haben, wird die IDE Sie fragen, wo die FPDoc-Dateien gespeichrt werden sollen. Für Projekte werden Sie normalerweise ein Unterverzeichnis 'docs' nehmen.
 +
 
 +
4. Schreiben Sie eine kurze Beschreibung.
 +
 
 +
5. Klicken Sie auf den Speichern-Knopf links oder gehen Sie zum nächsten Element (Der Editor speichert automatisch, wenn sie das Element verlassen).
 +
 
 +
== Bearbeiten von FPDoc-Einträgen von LCL- und Lazarus-Quellen ==
  
−
2. Setzen sie den Suchpfad für FPDoc im Dialog Projekt | Projekteinstellungen ..., unter der Registerseite FPDoc.
+
Die sind in den Verzeichnissen  ($LazDir)\docs\xml, sie können diese Verzeichnisse zu den FPDoc Pfaden unter Werkzeuge / Einstellungen / FPDoc-Editor hinzufügen.
  
−
3. Öffnen oder wählen sie eine Datei, für die eine Dokumentation existiert.
+
== Bearbeiten von FPDoc-Einträgen von FPC-Quellen, RTL und FCL ==
  
−
4. Setzen und bewegen sie den Cursor. Nachdem der Cursor im Quelltext-Editor platziert wurde, werden sie beobachten, dass sich die Beschriftung des Formulars FPDoc ändert. Die Beschriftung zeigt das ausgewählte Quellelement und den Dateinamen der Dokumentationsdatei. Durch Auswahl der geeigneten Seite in FPDoc können sie ein spezifisches Dokumentations-Tag bearbeiten. Natürlich ist es auch möglich, FPDoc nur als Betrachter zu nutzen.
+
Die FPDoc-Einträge von FPC-Quellen können von SVN heruntergeladen werden:
 +
 
 +
cd /home/username/yourchoice/
 +
svn co http://svn.freepascal.org/svn/fpcdocs/trunk fpcdocs
 +
 
 +
Fügen Sie den Pfad ''/home/username/yourchoice/fpcdocs'' unter  Werkzeuge / Einstellungen / FPDoc-Editor hinzu.
 +
 
 +
Ein gutes Elment für einen Test ist ''TComponent.Name''.
  
 
== Zukünftige Pläne ==
 
== Zukünftige Pläne ==
−
Die todo-Liste enthält gegenwärtig folgende Punkte, in keiner besonderen Reihenfolge:
+
Die Todo-Liste enthält gegenwärtig folgende Punkte, in keiner besonderen Reihenfolge:
  
−
* Einen HTML-Viewer hinzufügen; LazDoc wird die Dokumentation automatisch erzeugen
+
* Einen Hilfeeditor für Themen schreiben.
−
* Das Bearbeiten von Projektdateien ermöglichen
+
* Nettere html-Ausgaben für die Tooltips (Hinweisfenster) erzeugen.
−
* Das Erstellen neuer Elemente mit LazDoc in der Dokumentation ermöglichen
+
* Unterstützung von Operatoren
−
* Die Dokumentations-Tags zu erweitern mit: "todo", "notes" und "topic"
 
−
* Alle Dokumentations-Tags zu LazDoc hinzufügen
 
−
* Mehr Quellenelemente für die Interpretation durch LazDoc hinzufügen unter Verwendung existierender Code-Werkzeuge (jetzt werden procedure/function/constructor/destructor unterstützt)  
 
−
* Den Overhead noch weiter zu reduzieren
 
−
* IPC für die Kommunikation benutzen
 
−
* Erzeugung neuer Dokumentationsdateien mit LazDoc
 
−
* LazDoc zu den IDE-Einstellungen hinzufügen (Anzeige und Position in der IDE)
 
−
* LazDoc soll auf "keydown" im Sourceeditor reagieren (derzeit defekt)
 
−
* LazDoc zu einem WYSIWYG-Editor zu machen, vergleichbar mit einem Richtext-Editor.
 
  
−
== Erledigt ==
+
=== Erledigt ===
−
* Arbeiten für FPC-Quellen zu schaffen (rtl Dateien existieren bereits)
+
* Den Linkeditor erweitert um Packages und Bezeichner anzuzeigen
−
* Einstellungen zum Menü "Umgebungseinstellungen" hinzufügen
+
* Dokumentationsmarkierungen "example" im FPDoc-Editor angefügt
−
* Hinzufügen einer kleinen Werkzeugleiste mit den verfügbaren Makeup-Tags.
+
* Dokumentationsmarkierungen  "topic" im FPDoc-Editor angefügt
−
* Dokumentations-Tags "see also" zu LazDoc hinzufügen
+
* FPDoc-Editor erzeugt neue Elemente in der Dokumentation
−
* Bearbeitung von Projektdateien ermöglichen
+
* FPDoc-Editor erzeugt neue Dokumentationsdateien
−
* Die Dokumentations-Tags zu erweitern mit: "todo" and "notes" (Kein Grund. Es gibt Alternativen)
+
* Eine kleine Werkzeugleiste mit den verfügbaren Makeup-Tags hinzugefügt
−
* Overhead noch weiter reduzieren
+
* FPDoc-Editor arbeitet auf Tastendruck im Quelltexteditor
 +
* FPDoc-Editor in den IDE-Einstellungen berücksichtigt (Anzeige und Position in der IDE)
 +
* Ihn mit FPC-Quellen zum Laufen bringen (rtl Dateien existieren bereits)
 +
* Einstellungen zum Menü "Umgebungseinstellungen" hinzugefügt
 +
* Bearbeitung von Projektdateien ermöglicht
 +
* Die Dokumentations-Tags erweitert mit: "todo" and "notes" (Kein Grund. Es gibt Alternativen)
 +
* Overhead noch weiter reduziert
 +
* Alle Quellelemente werde von FPDoc-Editor mittels der CodeTools interpretiert.
 
* Finde geerbte Einträge. Zum Beispiel TControl.Align von TButton.Align.
 
* Finde geerbte Einträge. Zum Beispiel TControl.Align von TButton.Align.
 
* Optimierung: geerbte Einträge werden bei Leerlauf (des Prozessors) analysiert.
 
* Optimierung: geerbte Einträge werden bei Leerlauf (des Prozessors) analysiert.
 
* Optimierung: XML-Dateien werden gecached und nur einmal geparsed bzw. nur wenn sie sich auf der Festplatte änderten.
 
* Optimierung: XML-Dateien werden gecached und nur einmal geparsed bzw. nur wenn sie sich auf der Festplatte änderten.
 +
* Einen HTML-Viewer hinzufügen; Dieser ist verfügbar durch Installation des Packages 'turbopoweriprodsgn'.
 +
* Checks nach ungültigen xml-Tags und automatische Reparaturen
 +
<br>
 +
 +
[[Category:Tutorials/de]]

Latest revision as of 13:05, 3 July 2015

│ Deutsch (de) │ English (en) │ français (fr) │ 日本語 (ja) │ polski (pl) │ português (pt) │ русский (ru) │

Zurück zu den Zusätzlichen Informationen.

Einleitung

FPDoc ist das Free-Pascal-Dokumentationswerkzeug speziell zum Erzeugen von Hilfedateien für individuelle Einheiten vom Pascal Quellkode. Für mehr Informationen siehe: Free Pascal Dokumentationstool Handbuch (englisch).

FPDocEditorDescription.png

Lazarus liefert einen eingebauten FPDoc Hilfe Betrachter und zwei Editoren mit zum Erzeugen beziehungsweise Aktualisieren der FPDoc Quelltext Dokumentation. Einen einfachen, eingebauten names FPDoc Editor, der auf dieser Seite beschrieben wird, und einen vollständigen und aufwendigeren Editor namens LazDE.

Der große Bruder des FPDoc Editor ist LazDE der Lazarus-Dokumentationseditor. Er ist ein eigenständiges Programm und befindet sich in ($LazDir)/doceditor/lazde.lpi. Er muss mit der IDE übersetzt werden und läuft dann außerhalb der IDE. Sie können ihn als externes Werkzeug zum Werkzeugemenü hinzufügen.

Benutzung des FPDoc Editors

Die Verwendung von FPDoc ist sehr einfach.

1. Öffnen Sie den FPDoc Editor. Sie können ihn im Menü "Ansicht" finden.

2. Setzen und bewegen Sie den Cursor. Nachdem der Cursor im Quelltext-Editor platziert wurde, werden Sie bemerken, dass sich die Beschriftung des Formulars FPDoc ändert. Die Beschriftung zeigt das ausgewählte Quellelement und den Dateinamen der Dokumentationsdatei. Durch Auswahl der geeigneten Seite in FPDoc können Sie ein spezifisches Dokumentations-Tag bearbeiten. Natürlich ist es auch möglich, FPDoc nur als Betrachter zu nutzen.

3. Klicken Sie auf die Schaltfläche 'Hilfe erzeugen'. Falls Sie die FPDoc-Suchpfade noch nicht eingerichtet haben, wird die IDE Sie fragen, wo die FPDoc-Dateien gespeichrt werden sollen. Für Projekte werden Sie normalerweise ein Unterverzeichnis 'docs' nehmen.

4. Schreiben Sie eine kurze Beschreibung.

5. Klicken Sie auf den Speichern-Knopf links oder gehen Sie zum nächsten Element (Der Editor speichert automatisch, wenn sie das Element verlassen).

Bearbeiten von FPDoc-Einträgen von LCL- und Lazarus-Quellen

Die sind in den Verzeichnissen ($LazDir)\docs\xml, sie können diese Verzeichnisse zu den FPDoc Pfaden unter Werkzeuge / Einstellungen / FPDoc-Editor hinzufügen.

Bearbeiten von FPDoc-Einträgen von FPC-Quellen, RTL und FCL

Die FPDoc-Einträge von FPC-Quellen können von SVN heruntergeladen werden: 

cd /home/username/yourchoice/
svn co http://svn.freepascal.org/svn/fpcdocs/trunk fpcdocs

Fügen Sie den Pfad /home/username/yourchoice/fpcdocs unter Werkzeuge / Einstellungen / FPDoc-Editor hinzu.

Ein gutes Elment für einen Test ist TComponent.Name.

Zukünftige Pläne

Die Todo-Liste enthält gegenwärtig folgende Punkte, in keiner besonderen Reihenfolge:

  • Einen Hilfeeditor für Themen schreiben.
  • Nettere html-Ausgaben für die Tooltips (Hinweisfenster) erzeugen.
  • Unterstützung von Operatoren

Erledigt

  • Den Linkeditor erweitert um Packages und Bezeichner anzuzeigen
  • Dokumentationsmarkierungen "example" im FPDoc-Editor angefügt
  • Dokumentationsmarkierungen "topic" im FPDoc-Editor angefügt
  • FPDoc-Editor erzeugt neue Elemente in der Dokumentation
  • FPDoc-Editor erzeugt neue Dokumentationsdateien
  • Eine kleine Werkzeugleiste mit den verfügbaren Makeup-Tags hinzugefügt
  • FPDoc-Editor arbeitet auf Tastendruck im Quelltexteditor
  • FPDoc-Editor in den IDE-Einstellungen berücksichtigt (Anzeige und Position in der IDE)
  • Ihn mit FPC-Quellen zum Laufen bringen (rtl Dateien existieren bereits)
  • Einstellungen zum Menü "Umgebungseinstellungen" hinzugefügt
  • Bearbeitung von Projektdateien ermöglicht
  • Die Dokumentations-Tags erweitert mit: "todo" and "notes" (Kein Grund. Es gibt Alternativen)
  • Overhead noch weiter reduziert
  • Alle Quellelemente werde von FPDoc-Editor mittels der CodeTools interpretiert.
  • Finde geerbte Einträge. Zum Beispiel TControl.Align von TButton.Align.
  • Optimierung: geerbte Einträge werden bei Leerlauf (des Prozessors) analysiert.
  • Optimierung: XML-Dateien werden gecached und nur einmal geparsed bzw. nur wenn sie sich auf der Festplatte änderten.
  • Einen HTML-Viewer hinzufügen; Dieser ist verfügbar durch Installation des Packages 'turbopoweriprodsgn'.
  • Checks nach ungültigen xml-Tags und automatische Reparaturen


Retrieved from "http://wiki.freepascal.org/index.php?title=FPDoc_Editor/de&oldid=91831"