Project Templates/ru: what changed

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

Old	New		Line
1	1		# Обзор
2	2
3	3		Вы можете приспособиться при создании новых проектов. Среда IDE позволяет регистрировать собственные типы проектов с помощью пакетов designtime. Пакет projtemplates ( он предварительно установлен в обычных бинарных пакетах Lazarus) позволяет просто использовать существующие проекты в качестве шаблонов.
4	4
5	5		# Пакет projtemplates
6	6
7	7		Этот пакет реализует шаблоны проектов и поставляется с исходными кодами lazarus (components/projecttemplates/projtemplates.lpk).
8	8
9	9		Пакет поставляется с предустановленными бинарными пакетами Lazarus (например, установщик Windows). Этот пакет добавляет категорию в диалог File-New: Template projects
10	10
11	11		Он также добавляет пункт меню New project from Template в меню File, а также меню project template options в разделе Tools \[общего\] меню. Этот пункт меню отображается только в том случае, если каталог шаблонов (см. следующий абзац) существует и содержит хотя бы один подкаталог шаблонов.
12	12
13	13		В \[разделе\] Project template options можно выбрать каталог. Этот каталог должен содержать подкаталог для каждого шаблона. Каждый каталог шаблонов содержит шаблон для проекта: набор файлов, которые будут скопированы и использованы в качестве нового проекта.
14	14
15	15		Во время копирования пакет будет сканировать имена файлов/каталогов и содержимое файлов для подстановки переменных: __VARNAME__ будет заменено значением переменной VARNAME
16	16
17	17		По умолчанию движок знает о 2 переменных:
18	18
19	19		- ProjDir: Каталог, в котором будет создан новый проект.
20	20		- ProjName: Название нового проекта в ProjDir.
21	21
22	22		Дополнительные переменные должны быть определены в файле с именем project.ini в каталоге проекта. Это - файл в формате Windows INI.
23	23
24	24		Раздел \[Variables\] будет сканироваться на предмет имен переменных:
25	25
26	26		``` ini
27	27		[Variables]
28	28		VarName1=Description 1[\|DefaultValue 1]
29	29		VarName2=Description 2[\|DefaultValue 2]
30	30		```
31	31
32	32		Найденные переменные будут представлены с их описанием в диалоговом окне, и пользователь должен представить значение для переменных.
33	33
34	34		Файл project.ini может содержать второй раздел, называемый Project, который может содержать некоторую информацию о проекте. Здесь можно найти следующие ключевые слова:
35	35
36	36		## ProjectFile
37	37
38	38		Имя файла (без расширения) lpi-файла проекта шаблона. Любой файл с именем, равным этому (без расширения), обрабатывается специально, он переименовывается в имя проекта. То есть, вот это ProjectFile=example заменит example.lpi, example.lpr и example.cfg на имя, данное пользователем. По умолчанию предполагается, что значением ProjectFile является project (обратите внимание, что файл .ini не копируется)
39	39
40	40		ProjectFile не является обязательным. Первый файл *.lpi в папке проекта шаблона будет принят как ProjectFile, если ProjectFile не указан или не существует.
41	41
42	42		## Name
43	43
44	44		Название шаблона. Имя и описание будут представлены в диалоге 'File-New'.
45	45
46	46		## Author
47	47
48	48		Автор шаблона
49	49
50	50		## Description
51	51
52	52		Краткое (однострочное) описание проекта. Имя и описание будут представлены в диалоге 'File-New'.
53	53
54	54		## Recurse
55	55
56	56		Логическое значение (1/0), которое указывает движку \[осуществлять\] рекурсивный \[поиск\] в подкаталогах или нет.
57	57
58	58		## Exclude
59	59
60	60		Разделенный запятыми список расширений имени файла, которые не следует искать для подстановки ключевых слов.
61	61
62	62		## Как начать
63	63
64	64		Шаг 1;
65	65
66	66		Создайте свой собственный каталог шаблонов (например, ~ /.lazarus/mytemplates) и установите этот путь в Lazarus (меню: Tools -\> Project Template Options).
67	67
68	68		Шаг 2:
69	69
70	70		Чтобы любые шаблонные функции появились в меню File Lazarus'а, вам понадобится как минимум один шаблон, который вы можете использовать в своем существующем (обычном) проекте;
71	71
72	72		\- Создайте каталог в вашем каталоге шаблонов (например, ~/.lazarus/mytemplates/myfirsttemplate)
73	73
74	74		\- Скопируйте файлы вашего проекта в этот новый каталог (.lfm, .pas, .ico, .lpi, .lpr, .res)
75	75
76	76		Шаг 3:
77	77
78	78		Создайте файл project.ini в новом каталоге шаблонов.
79	79
80	80		Минимум, \[файл\] должен выглядеть примерно так:
81	81
82	82		project.ini:
83	83
84	84		``` ini
85	85		[Variables]
86	86
87	87		[Project]
88	88		Name=My Form Template
89	89		```
90	90
91	91		Необязательно: Приятной особенностью Project Templates является то, что они поддерживают переменные. Так как проект, вероятно, не будет называться так же, как ваш пример шаблона, вам придется внести некоторые изменения в код и переименовать файл.
92	92
93	93		Файлы: Переименуйте файл проекта (ico, lpi, lpr, res) в __PROJNAME __. Ext (где расширение, конечно, является исходным расширением). Например: project.lpi становится __PROJNAME __. Lpi. Примечание: содержимое файла lpi может нуждаться в некоторой очистке, например, удаление истории, ссылки на файлы, даже если вы не уверены, нужен ли файл lpi.
94	94
95	95		Содержимое файла: Для всех файлов, которые ссылаются на project.lpi и т.д., измените содержимое ваших файлов, чтобы все ссылки на "project" превратились в "__PROJNAME__" (с кавычками)
96	96
97	97		Вы можете опционально определить свои собственные переменные, например, чтобы дать "unit.pas" другое имя файла. Например, вы можете определить __MAINUNIT__ и __MAINFORM__ в project.ini как MAINUNIT и MAINFORM - во время создания Lazarus запросит у вас эти имена. Теперь каждое вхождение __MAINUNIT__, например, будет заменено предоставленным вами текстом (избегайте специальных символов и пробелов).
98	98
99	99		Обратите внимание, что это работает для всех переменных; Каждое вхождение переменной в именах файлов и содержимом файла будет заменено тем, что вы ввели при создании нового проекта на основе вашего шаблона. Предопределенными переменными являются PROJNAME и PROJDIR, но я пока не нашел назначения для PROJDIR.
100	100
101	101		Некоторые примеры:
102	102
103	103		project.ini
104	104
105	105		``` ini
106	106		[Variables]
107	107		MAINUNIT=Filename for the default unit.pas file
108	108		MAINFORM=Form name
109	109
110	110		[Project]
111	111		Name=My Custom Form
112	112		Author=Hansaplast
113	113		Description=Lazarus LCL form specifically for my needs
114	114		```
115	115
116	116		__PROJNAME__.lpr:
117	117
118	118		``` pascal
119	119		program __PROJNAME__;
120	120
121	121		{$mode objfpc}{$H+}
122	122
123	123		uses
124	124		{$IFDEF UNIX}{$IFDEF UseCThreads}
125	125		cthreads,
126	126		{$ENDIF}{$ENDIF}
127	127		Interfaces, // this includes the LCL widgetset
128	128		Forms, __MAINUNIT__;
129	129
130	130		{$R *.res}
131	131
132	132		begin
133	133		Application.Initialize;
134	134		Application.CreateForm(T__MAINFORM__, __MAINFORM__);
135	135		Application.Run;
136	136		end.
137	137		```
138	138
139	139		__MAINUNIT__.pas:
140	140
141	141		``` pascal
142	142		unit __MAINUNIT__;
143	143
144	144		{$mode objfpc}{$H+}
145	145
146	146		interface
147	147
148	148		uses
149	149		Classes, SysUtils, FileUtil, Forms, Controls, Graphics, Dialogs, ExtCtrls,
150	150		Buttons, StdCtrls, LCLIntf, LCLType, ComCtrls;
151	151
152	152		type
153	153
154	154		{ __MAINFORM__ }
155	155
156	156		T__MAINFORM__ = class(TForm)
157	157
158	158		...
159	159
160	160		procedure T__MAINFORM__.FormPaint(Sender: TObject);
161	161		...
162	162
163	163		//etc
164	164		```
165	165
166	166		__MAINUNIT__.lfm:
167	167
168		-	~~``` pascal~~
	168	+	``` lfm
169	169		object __MAINFORM__: T__MAINFORM__
170	170		...
171	171		```
172	172
173	173		Имейте в виду, что этот краткий учебник только для начинающих, предлагаемый механизм замены переменных может использоваться для самых разных целей. Например, чтобы определить заголовок формы, заявление об авторском праве, веб-ссылку на ваши формы, конкретные объекты и т.д. --Hansaplast 16:30, 4 August 2012 (UTC)
174	174
175	175		---
176	176		From the Free Pascal wiki, page "Project Templates/ru", as it stood on 2022-01-30 after a change by RolfW, 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