How To Make Lazarus Docs/de: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1		-	\
2	1		Zurück zu den [[Additional information/de\|Zusätzlichen Informationen]].\
3		-	\
	2	+
4	3		== Erstellen von Dokumentationsdateien für Lazarus ==
5	4
6	5		Dokumentationsdateien, die möglicherweise in das Online Hilfesystem eingebunden werden, können aus den Unit Dateien in der Lazarus Component Library (LCL) generiert werden. Das FpDoc Dienstprogramm kann HTML Dateien generieren, wobei die Pascal Quelldateien (.pp oder .pas) als Eingabe verwendet werden. Erbeblich hilfreichere Informationen können aufgenommen werden, wenn in Verbindung mit der Quelldatei eine XML Beschreibungsdatei verwendet wird.
7	6
8		-	Auch wenn es möglich ist, XML Tags von Hand unter Verwendung der Anweisungen im FpDoc Handbuch zu erstellen, ist es viel einfacher, das Dienstprogramm <u>makeskel</u> zu verwenden, welches als Teil der FpDoc Suite geliefert wird. Dieses Dienstprogramm generiert eine XML Datei mit einer Reihe leerer Tags für jeden Bezeichner, jeden Typ, jede Prozedur und jede Funktion in der Quelldatei. Der Benutzer kann dann diese XML Datei bearbeiten, entweder mit einem einfachen Texteditor oder unter Verwendung eines XML Editors wie KXMLEditor. Es gibt eine riesige Anzahl von Einträgen in diesen Dateien: Mein Vorschlag ist, nur die Tags zu bearbeiten die Objekte beschreiben, zumindest am Anfang (benutze die Suchfunktion, um 'object' zu finden. Dann gib kurze Titel und kurze Beschreibungen für die Komponenten ein).
	7	+	Auch wenn es möglich ist, XML Tags von Hand unter Verwendung der Anweisungen im FpDoc Handbuch zu erstellen, ist es viel einfacher, das Dienstprogramm makeskel zu verwenden, welches als Teil der FpDoc Suite geliefert wird. Dieses Dienstprogramm generiert eine XML Datei mit einer Reihe leerer Tags für jeden Bezeichner, jeden Typ, jede Prozedur und jede Funktion in der Quelldatei. Der Benutzer kann dann diese XML Datei bearbeiten, entweder mit einem einfachen Texteditor oder unter Verwendung eines XML Editors wie KXMLEditor. Es gibt eine riesige Anzahl von Einträgen in diesen Dateien: Mein Vorschlag ist, nur die Tags zu bearbeiten die Objekte beschreiben, zumindest am Anfang (benutze die Suchfunktion, um 'object' zu finden. Dann gib kurze Titel und kurze Beschreibungen für die Komponenten ein).
9	8
10	9		Wenn sie die Bearbeitung der XML Datei beendet haben, speichern sie diese und starten
11	10
12	11		`fpdoc --package=lcl --input=thisunit.pp --descr=thisunit.xml`
13	12
14	13		Die resultierenden HTML Dateien werden in einem Unterverzeichnis namens 'thisunit' abgelegt.
15	14
16	15		Es wird eine große Anzahl von HTML Dateien geben (typischerweise über 160) - diese werden eventuell alle für die Hilfedateien verwendet, aber es gibt zu viele Informationen, zum Beispiel, um sie auf dieser WiKi Seite zu zeigen. Es ist hilfreich, die Dateien zu filtern, so dass nur die jenigen einbezogen werden, die Komponenten beschreiben. Dies kann erreicht werden mit
17	16
18	17		`grep -l Inheritance * > outputfile`
19	18
20	19		da nur Komponenten eine Beschreibung ihrer Vererbung haben. Die Outputdatei kann dann benutzt werden, den HTML-Text in einfachen Text zu konvertieren. Eine solche Anwendung ist html2text. Der Prozess wurde teilweise im folgenden Pascal Programm automatisiert (welches mehr als einfach ist, nicht besonders robust, aber es funktioniert!):
21	20
22	21		``` pascal
23	22		program convhtml;
24	23		{ CT Kirkpatrick, MD 20040720 }
25	24		{$mode objfpc}{$H+}
26	25		{ liest eine Liste von Dateinamen von listfile ein, und konvertiert sie sinngemäß von HTML zu Klartext und
27	26		schreibt den Output aller Dateien in outfile }
28	27		uses
29	28		Classes, unix;<br>
30	29		var
31	30		listfile, outfile: text;
32	31		pathname, listfname, outfname, fname: string;
33	32		execstring, comstring: string;
34	33		begin
35	34		Writeln ('Enter path for files to convert');
36	35		Readln (pathname);
37	36		Writeln ('Enter name of file to contain list of files for conversion');
38	37		Readln (listfname);
39	38		shell ('grep -l Inheritance ' + pathname + '* > ' + pathname + 'filelist.txt');
40	39		Writeln ('Enter name of output file');
41	40		Readln (outfname);
42	41		Assign (listfile, pathname +'filelist.txt');
43	42		Assign (outfile, pathname + outfname);
44	43		Reset (listfile);
45	44		Rewrite (outfile);
46	45		while not eof (listfile) do
47	46		begin
48	47		readln (listfile, fname); //writeln (fname);
49	48		//if fname = '' then begin readln (listfile, fname); writeln (fname) end;
50	49		execstring := '/usr/bin/html2text ';
51	50		comstring := '-nobs ' + fname
52	51		+ ' >> ' + pathname + outfname;
53	52		writeln ('Executing ', execstring, comstring);
54	53		shell (execstring + comstring);
55	54		end;
56	55		end.
57	56		```
58	57
59	58		## Mitwirkende und Änderungen
60	59
61	60		Diese Seite wurde von der epikwiki [Version](http://lazarus-ccr.sourceforge.net/index.php?wiki=HowToMakeLazarusDocs) konvertiert. Original von User:Kirkpatc.
62	61
63	62		---
64	63		From the Free Pascal wiki, page "How To Make Lazarus Docs/de", as it stood on 2020-02-17 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history