Add Help to Your Application/zh CN: what changed

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

Old	New		Line
1	1		LCL带来一个帮助系统，允许你为你自己的应用程序来创建帮助。
2	2
3	3		## 快速开始
4	4
5	5		`在 examples/helphtml/中打开示例。`
6	6
7	7		演示如何使用HTML帮助控件。只需要拖拽它们到你的项目中。并设置并创建HTML文件。就可以给程序提供HelpKeyword。
8	8
9	9		如果要使用CHM帮助，请参照CHM帮助部分。
10	10
11	11		这里是一个非常好的演示 (chmdemo.zip): <http://forum.lazarus.freepascal.org/index.php/topic,38487.msg261731.html#msg261731>
12	12
13	13		## 帮助基础
14	14
15	15		LCL帮助包含两部分: 帮助数据库和查看器. 帮助数据库包含关键字(ID, node, message, pascal, ...)到帮助页面(或者帮助网页网站，或者...)。帮助查看器援引帮助数据库来向用户显示帮助信息。
16	16
17	17		- [[THelpDatabase]]管理内容。它可以是HTML页面、或fpdoc XML文、或一个CHM文件、或一个数据库、或任何东西的一个集合。
18	18		- [[THelpViewer]]是一个显示帮助内容的组件。例如，一个mime类型的text/html查看器可以启动一个网页浏览器。
19	19
20	20		当请求帮助时，LCL询问每个注册的[[THelpDatabase]]，并且每个数据库都会返回一个条目列表。如果返回数个条目，LCL会要求用户来选择一个条目。接下来LCL或要求数据库来显示条目的帮助。数据库提取帮助内容，并向LCL请求支持mime类型内容的查看器。最后，查看器显示帮助内容。
21	21
22	22		## CHM
23	23
24	24		上下文相关的CHM应用程序帮助自lazarus1.0和更高版本开始能够使用。
25	25
26	26		一个演示程序，包含演示如何使用CHM和[[lhelp\|lhelpCHM]]查看器（默认情况下与IDE帮助使用同一个查看器）来包含上下文相关的帮助。请查看\${lazarusdir}/components/chmhelp/democontrol/.
27	27
28	28		你可以写你自己的CHM文件，例如，使用古老的Microsoft HTML Workshop，或者使用新的Lazarus chmmaker 工具(位于\$(lazarusdir)/tools/chmmaker)。你可以使用一个[[TCHMHelpDatabase]]控件，像下面描述的[[THTMLHelpDatabase]]控件。
29	29
30	30		使用CHM系统的优点是一个较小的、独立的帮助文件，而不是多个文件。另一方面，并不是每个系统都默认安装了CHM查看器，因此您可能希望包含lhelp，一个用Pascal编写的CHM查看器，包含在Lazarus源代码(components/chmhelp/lhelp/lhelp.lpi)中。
31	31
32	32		### 使用LHelp
33	33
34	34		- 在你的窗体上放置一个TLHelpConnector。
35	35		- 使用LHelp可执行文件的名称和位置来设置LHelpPath。(路径可以是绝对的，也可以是相对于应用程序的目录)
36	36		- 设置AutoRegister为true
37	37
38	38		``` pascal
39	39		// Example with both chm file and LHelp.exe in Application folder.
40	40		Procedure TForm1.FormCreate(Sender: TObject);
41	41		Begin
42	42		If FileExists(ChangeFileExt(Application.ExeName, '.chm')) Then
43	43		Begin
44	44		CHMHelpDatabase1.Filename := ChangeFileExt(Application.ExeName, '.chm');
45	45		CHMHelpDatabase1.Keyword := 'test';
46	46		CHMHelpDatabase1.AutoRegister:=True;
47	47
48	48		LHelpConnector1.LHelpPath := IncludeTrailingBackSlash(ExtractFileDir(Application.ExeName)) + 'lhelp.exe';
49	49		LHelpConnector1.AutoRegister:=True;
50	50		end
51	51		Else
52	52		mnuHelpMain.Enabled := False;
53	53		End;
54	54
55	55		Procedure TForm1.Button1Click(Sender: TObject);
56	56		Begin
57	57		If mnuHelpMain.Enabled Then
58	58		ShowHelpOrErrorForKeyword('','test/Main.html');
59	59		//ShowTableOfContents; (Not implemented for TCHMHelpDatabase)
60	60		End;
61	61		```
62	62
63	63		## HTML
64	64
65	65		LCL提供两个组件来使用HTML文件获取帮助:[[THTMLHelpDatabase]]和[[THTMLBrowserHelpViewer]]。为查看HTML帮助，查看lazarus示例：examples/helphtml/htmlhelp1.lpi。
66	66
67	67		### 为你的应用程序设置HTML帮助
68	68
69	69		<img src="LazHtmlHelp.jpg" title="Lazarus help items" width="500" alt="Lazarus help items" /> 添加HTML帮助到你的应用程序是很容易的：
70	70
71	71		- 在一个窗体上放置一个THTMLHelpDatabase。
72	72		- 设置AutoRegister为 true 。
73	73		- 设置KeywordPrefix为html/ 。它意味着所有关键字都必须以字符串html/为开头。
74	74		- 设置BaseURL为<file://yourhelp/>。这将在子文件夹yourhelp中搜索HTML文件。你可以具体指定完整的路径(像:<file:///usr/lib/yourhelp/>）或者一个URL(像:<http://www.yoursite.com/>)。
75	75
76	76		- 在窗体上放置一个THTMLBrowserHelpViewer。这个组件可以启动用户的默认浏览器。
77	77		- 设置AutoRegister为 true 。
78	78
79	79		### 创建一个帮助条目
80	80
81	81		- 现在创建子文件夹yourhelp，并创建一个html页面 yourhelp/edit1.html。如果是网站，帮助页应该是可使用的：<http://www.yoursite.com/edit1.html>。
82	82		- 在一个窗体上放置一个TEdit。
83	83		- 设置HelpType为htKeyword
84	84		- 设置HelpKeyword为html/edit1.html
85	85
86		-	当运行程序时，你可以聚焦于编辑并按<span class="kbd">F1</span>键援引助。在macOS下帮助按键顺序是<span class="kbd">Cmd-?</span> (或 <span class="kbd">Cmd+Shift+?</span>，取决于你的键盘布局)。注意: 一些窗口管理器、小部件集组合不会将F1传递给LCL。
	86	+	当运行程序时，你可以聚焦于编辑并按`F1`键援引助。在macOS下帮助按键顺序是`Cmd-?` (或 `Cmd+Shift+?`，取决于你的键盘布局)。注意: 一些窗口管理器、小部件集组合不会将F1传递给LCL。
87	87
88	88		## INF (使用fpGUI的DocView帮助查看器)
89	89
90	90		查看Lazarus论坛中包含的消息和示例项目。[1](http://forum.lazarus.freepascal.org/index.php/topic,27864.msg173887.html#msg173887)
91	91
92	92		It shows a fully working example of an LCL application using [[fpGUI]]'s [DocView help viewer](http://fpgui.sourceforge.net/screenshots_apps.shtml). It shows context sensitive help and general help.
93	93
94	94		例如:
95	95
96		-	~~- Set focus to a specific control and press <span class="kbd">F1</span>. It will show the help topic for that specific control.~~
	96	+	- Set focus to a specific control and press `F1`. It will show the help topic for that specific control.
97	97		- Click the Help button and it will show the help topic for the dialog/form.
98	98		- Select the "Help -\> Show Help" menu item and it will show the general application help and display the first topic in the help file.
99	99
100	100		## 请参阅
101	101
102	102		- [[Add an Apple Help Book to your macOS app\|添加一个苹果系统帮助书到你的macOS应用程序]]
103	103
104	104		## 贡献者和更改
105	105
106	106		- 简体中文版本由 robsean 于 2020-03-09 创建。
107	107
108	108		---
109	109		From the Free Pascal wiki, page "Add Help to Your Application/zh CN", as it stood on 2021-02-04 after a change by Robsean, 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).
110	110		Category: CHM
111	111		Category: Help and Docs
112	112		Category: Tutorials

Back to history