Difference between revisions of "FPDoc Editor/de"

From Lazarus wiki
Jump to navigationJump to search
m
m (full check and update; translated)
Line 1: Line 1:
 
{{FPDoc Editor}}
 
{{FPDoc Editor}}
  
−
== 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 zum Erzeugen von Hilfedateien. Lazarus liefert zwei Editoren mit zum Erzeugen/Aktualisieren der FPDoc Quelltext Dokumentation. Einen einfachen, eingebauten names '''FPDoc Editor''', der auf dieser Seite beschrieben wird, und einen vollständigen Editor namens '''LazDE'''.
 +
 
 +
Für mehr Informationen siehe: [http://lazarus-ccr.sourceforge.net/fpcdoc/fpdoc/fpdoc.html Free Pascal Dokumentationstool Handbuch].
  
−
=== LazDE - Lazarus Documentation Editor ===
 
 
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.
 
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_Documentation_Editor|LazDE - Lazarus Documentation Editor]]
  
 +
=Wo ist FPDoc zu finden? =
 
FPDoc ist in die Lazarus IDE integriert. Es ist im Menü "Ansicht" zu finden.
 
FPDoc ist in die Lazarus IDE integriert. Es ist im Menü "Ansicht" zu finden.
  
−
== Gebrauch ==
+
= Gebrauch =
 
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 wird dann automatisch speichern.
 +
 
 +
 
 +
=Bearbeiten von FPDoc-Einträgen von FPC-Quellen, RTL und FCL=
 +
 
 +
Die FPDoc-Einträge von FPC-Quellen können von SVN heruntergeladen werden:
  
−
2. Setzen sie den Suchpfad für FPDoc im Dialog Projekt | Projekteinstellungen ..., unter der Registerseite FPDoc.
+
cd /home/username/yourchoice/
 +
svn co http://svn.freepascal.org/svn/fpcdocs/trunk fpcdocs
  
−
3. Öffnen oder wählen sie eine Datei, für die eine Dokumentation existiert.  
+
Fügen Sie den Pfad ''/home/username/yourchoice/fpcdocs'' unter  Menü/Einstellungen/Umgebung/FPDoc-Editor hinzu.
  
−
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.
+
Machen Sie einen Terst mit ''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
+
* Ünterstü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

Revision as of 19:28, 14 June 2011

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

Einleitung

FPDoc ist das Free-Pascal-Dokumentationswerkzeug zum Erzeugen von Hilfedateien. Lazarus liefert zwei Editoren mit zum Erzeugen/Aktualisieren der FPDoc Quelltext Dokumentation. Einen einfachen, eingebauten names FPDoc Editor, der auf dieser Seite beschrieben wird, und einen vollständigen Editor namens LazDE.

Für mehr Informationen siehe: Free Pascal Dokumentationstool Handbuch.

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.

LazDE - Lazarus Documentation Editor

Wo ist FPDoc zu finden?

FPDoc ist in die Lazarus IDE integriert. Es ist im Menü "Ansicht" zu finden.

Gebrauch

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 wird dann automatisch speichern.


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 Menü/Einstellungen/Umgebung/FPDoc-Editor hinzu.

Machen Sie einen Terst mit 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.
  • Ünterstü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=50702"