Difference between revisions of "Project Templates/ru"
(11 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{Project Templates}} |
=Обзор= | =Обзор= | ||
Line 5: | Line 5: | ||
Вы можете приспособиться при создании новых проектов. Среда IDE позволяет регистрировать собственные типы проектов с помощью пакетов designtime. Пакет '''projtemplates''' ( он предварительно установлен в обычных бинарных пакетах Lazarus) позволяет просто использовать существующие проекты в качестве шаблонов. | Вы можете приспособиться при создании новых проектов. Среда IDE позволяет регистрировать собственные типы проектов с помощью пакетов designtime. Пакет '''projtemplates''' ( он предварительно установлен в обычных бинарных пакетах Lazarus) позволяет просто использовать существующие проекты в качестве шаблонов. | ||
− | = | + | =Пакет projtemplates= |
− | + | Этот пакет реализует шаблоны проектов и поставляется с исходными кодами lazarus (components/projecttemplates/projtemplates.lpk). | |
− | + | Пакет поставляется с предустановленными бинарными пакетами Lazarus (например, установщик Windows). Этот пакет добавляет категорию в диалог '''File-New''': '''Template projects''' | |
− | + | Он также добавляет пункт меню '''New project from Template''' в меню '''File''', а также меню '''project template options''' в разделе '''Tools''' [общего] меню. Этот пункт меню отображается только в том случае, если каталог шаблонов (см. следующий абзац) существует и содержит хотя бы один подкаталог шаблонов. | |
− | |||
− | |||
− | |||
− | + | В [разделе] ''Project template options'' можно выбрать каталог. Этот каталог должен содержать подкаталог для каждого шаблона. Каждый каталог шаблонов содержит шаблон для проекта: набор файлов, которые будут скопированы и использованы в качестве нового проекта. | |
− | |||
− | |||
− | |||
− | + | Во время копирования пакет будет сканировать имена файлов/каталогов и содержимое файлов для подстановки переменных: '''__VARNAME__''' будет заменено значением переменной VARNAME | |
− | |||
− | |||
− | + | По умолчанию движок знает о 2 переменных: | |
− | *ProjDir: | + | *ProjDir: Каталог, в котором будет создан новый проект. |
− | *ProjName: | + | *ProjName: Название нового проекта в ProjDir. |
− | + | Дополнительные переменные должны быть определены в файле с именем '''project.ini''' в каталоге проекта. Это - файл в формате Windows INI. | |
− | |||
− | + | Раздел ''[Variables]'' будет сканироваться на предмет имен переменных: | |
+ | |||
+ | <syntaxhighlight lang="ini"> | ||
[Variables] | [Variables] | ||
− | VarName1=Description 1 | + | VarName1=Description 1[|DefaultValue 1] |
− | VarName2=Description 2 | + | VarName2=Description 2[|DefaultValue 2] |
+ | </syntaxhighlight> | ||
− | + | Найденные переменные будут представлены с их описанием в диалоговом окне, и пользователь должен представить значение для переменных. | |
− | |||
− | + | Файл ''project.ini'' может содержать второй раздел, называемый ''Project'', который может содержать некоторую информацию о проекте. Здесь можно найти следующие ключевые слова: | |
− | |||
− | |||
==ProjectFile== | ==ProjectFile== | ||
− | + | Имя файла (без расширения) lpi-файла проекта шаблона. Любой файл с именем, равным этому (без расширения), обрабатывается специально, он переименовывается в имя проекта. То есть, вот это ''ProjectFile=example'' заменит ''example.lpi'', ''example.lpr'' и ''example.cfg'' на имя, данное пользователем. По умолчанию предполагается, что значением '''ProjectFile''' является ''project'' (обратите внимание, что файл .ini не копируется) | |
− | + | ||
− | ( | + | ProjectFile не является обязательным. Первый файл *.lpi в папке проекта шаблона будет принят как ProjectFile, если ProjectFile не указан или не существует. |
==Name== | ==Name== | ||
− | + | Название шаблона. Имя и описание будут представлены в диалоге 'File-New'. | |
==Author== | ==Author== | ||
− | + | Автор шаблона | |
==Description== | ==Description== | ||
− | + | Краткое (однострочное) описание проекта. Имя и описание будут представлены в диалоге 'File-New'. | |
==Recurse== | ==Recurse== | ||
− | + | Логическое значение (1/0), которое указывает движку [осуществлять] рекурсивный [поиск] в подкаталогах или нет. | |
==Exclude== | ==Exclude== | ||
− | + | Разделенный запятыми список расширений имени файла, которые не следует искать для подстановки ключевых слов. | |
− | |||
− | == | + | ==Как начать== |
− | ''' | + | '''Шаг 1;''' |
− | + | Создайте свой собственный каталог шаблонов (например, ~ /.lazarus/mytemplates) и установите этот путь в Lazarus (меню: Tools -> Project Template Options). | |
− | ''' | + | '''Шаг 2:''' |
− | + | Чтобы любые шаблонные функции появились в меню File Lazarus'а, вам понадобится как минимум один шаблон, который вы можете использовать в своем существующем (обычном) проекте; | |
− | - | + | - Создайте каталог в вашем каталоге шаблонов (например, ~/.lazarus/mytemplates/myfirsttemplate) |
− | - | + | - Скопируйте файлы вашего проекта в этот новый каталог (*.lfm, *.pas, *.ico, *.lpi, *.lpr, *.res) |
− | ''' | + | '''Шаг 3:''' |
− | + | Создайте файл ''project.ini'' в новом каталоге шаблонов. | |
− | + | Минимум, [файл] должен выглядеть примерно так: | |
project.ini: | project.ini: | ||
+ | |||
+ | <syntaxhighlight lang="ini"> | ||
[Variables] | [Variables] | ||
[Project] | [Project] | ||
Name=My Form Template | Name=My Form Template | ||
+ | </syntaxhighlight> | ||
− | '' | + | '''Необязательно:''' |
+ | Приятной особенностью Project Templates является то, что они поддерживают переменные. Так как проект, вероятно, не будет называться так же, как ваш пример шаблона, вам придется внести некоторые изменения в код и переименовать файл. | ||
− | + | '''Файлы''': | |
− | + | Переименуйте файл проекта (ico, lpi, lpr, res) в __PROJNAME __. Ext (где расширение, конечно, является исходным расширением). | |
+ | Например: project.lpi становится __PROJNAME __. Lpi. | ||
+ | Примечание: содержимое файла lpi может нуждаться в некоторой очистке, например, удаление истории, ссылки на файлы, даже если вы не уверены, нужен ли файл lpi. | ||
− | ''' | + | '''Содержимое файла''': |
− | + | Для всех файлов, которые ссылаются на project.lpi и т.д., измените содержимое ваших файлов, чтобы все ссылки на "project" превратились в "__PROJNAME__" (с кавычками) | |
− | |||
− | |||
− | + | Вы можете опционально определить свои собственные переменные, например, чтобы дать "unit.pas" другое имя файла. | |
− | + | Например, вы можете определить __MAINUNIT__ и __MAINFORM__ в project.ini как MAINUNIT и MAINFORM - во время создания Lazarus запросит у вас эти имена. | |
+ | Теперь каждое вхождение __MAINUNIT__, например, будет заменено предоставленным вами текстом (избегайте специальных символов и пробелов). | ||
− | + | Обратите внимание, что это работает для всех переменных; | |
− | + | Каждое вхождение переменной в именах файлов и содержимом файла будет заменено тем, что вы ввели при создании нового проекта на основе вашего шаблона. Предопределенными переменными являются PROJNAME и PROJDIR, но я пока не нашел назначения для PROJDIR. | |
− | |||
− | + | Некоторые примеры: | |
− | |||
− | + | '''project.ini''' | |
− | |||
− | project.ini | ||
+ | <syntaxhighlight lang="ini"> | ||
[Variables] | [Variables] | ||
MAINUNIT=Filename for the default unit.pas file | MAINUNIT=Filename for the default unit.pas file | ||
Line 123: | Line 115: | ||
Author=Hansaplast | Author=Hansaplast | ||
Description=Lazarus LCL form specifically for my needs | Description=Lazarus LCL form specifically for my needs | ||
+ | </syntaxhighlight> | ||
− | __PROJNAME__.lpr: | + | '''__PROJNAME__.lpr''': |
+ | <syntaxhighlight lang="pascal"> | ||
program __PROJNAME__; | program __PROJNAME__; | ||
Line 144: | Line 138: | ||
Application.Run; | Application.Run; | ||
end. | end. | ||
+ | </syntaxhighlight> | ||
− | __MAINUNIT__.pas: | + | '''__MAINUNIT__.pas''': |
+ | <syntaxhighlight lang="pascal"> | ||
unit __MAINUNIT__; | unit __MAINUNIT__; | ||
Line 169: | Line 165: | ||
//etc | //etc | ||
+ | </syntaxhighlight> | ||
+ | '''__MAINUNIT__.lfm''': | ||
− | + | <syntaxhighlight lang="pascal"> | |
− | |||
object __MAINFORM__: T__MAINFORM__ | object __MAINFORM__: T__MAINFORM__ | ||
... | ... | ||
+ | </syntaxhighlight> | ||
− | + | Имейте в виду, что этот краткий учебник только для начинающих, предлагаемый механизм замены переменных может использоваться для самых разных целей. | |
− | + | Например, чтобы определить заголовок формы, заявление об авторском праве, веб-ссылку на ваши формы, конкретные объекты и т.д. | |
− | |||
--[[User:Hansaplast|Hansaplast]] 16:30, 4 August 2012 (UTC) | --[[User:Hansaplast|Hansaplast]] 16:30, 4 August 2012 (UTC) | ||
− | |||
− | |||
− |
Latest revision as of 13:44, 30 January 2022
│
Deutsch (de) │
English (en) │
русский (ru) │
Обзор
Вы можете приспособиться при создании новых проектов. Среда IDE позволяет регистрировать собственные типы проектов с помощью пакетов designtime. Пакет projtemplates ( он предварительно установлен в обычных бинарных пакетах Lazarus) позволяет просто использовать существующие проекты в качестве шаблонов.
Пакет projtemplates
Этот пакет реализует шаблоны проектов и поставляется с исходными кодами lazarus (components/projecttemplates/projtemplates.lpk).
Пакет поставляется с предустановленными бинарными пакетами Lazarus (например, установщик Windows). Этот пакет добавляет категорию в диалог File-New: Template projects
Он также добавляет пункт меню New project from Template в меню File, а также меню project template options в разделе Tools [общего] меню. Этот пункт меню отображается только в том случае, если каталог шаблонов (см. следующий абзац) существует и содержит хотя бы один подкаталог шаблонов.
В [разделе] Project template options можно выбрать каталог. Этот каталог должен содержать подкаталог для каждого шаблона. Каждый каталог шаблонов содержит шаблон для проекта: набор файлов, которые будут скопированы и использованы в качестве нового проекта.
Во время копирования пакет будет сканировать имена файлов/каталогов и содержимое файлов для подстановки переменных: __VARNAME__ будет заменено значением переменной VARNAME
По умолчанию движок знает о 2 переменных:
- ProjDir: Каталог, в котором будет создан новый проект.
- ProjName: Название нового проекта в ProjDir.
Дополнительные переменные должны быть определены в файле с именем project.ini в каталоге проекта. Это - файл в формате Windows INI.
Раздел [Variables] будет сканироваться на предмет имен переменных:
[Variables]
VarName1=Description 1[|DefaultValue 1]
VarName2=Description 2[|DefaultValue 2]
Найденные переменные будут представлены с их описанием в диалоговом окне, и пользователь должен представить значение для переменных.
Файл project.ini может содержать второй раздел, называемый Project, который может содержать некоторую информацию о проекте. Здесь можно найти следующие ключевые слова:
ProjectFile
Имя файла (без расширения) lpi-файла проекта шаблона. Любой файл с именем, равным этому (без расширения), обрабатывается специально, он переименовывается в имя проекта. То есть, вот это ProjectFile=example заменит example.lpi, example.lpr и example.cfg на имя, данное пользователем. По умолчанию предполагается, что значением ProjectFile является project (обратите внимание, что файл .ini не копируется)
ProjectFile не является обязательным. Первый файл *.lpi в папке проекта шаблона будет принят как ProjectFile, если ProjectFile не указан или не существует.
Name
Название шаблона. Имя и описание будут представлены в диалоге 'File-New'.
Author
Автор шаблона
Description
Краткое (однострочное) описание проекта. Имя и описание будут представлены в диалоге 'File-New'.
Recurse
Логическое значение (1/0), которое указывает движку [осуществлять] рекурсивный [поиск] в подкаталогах или нет.
Exclude
Разделенный запятыми список расширений имени файла, которые не следует искать для подстановки ключевых слов.
Как начать
Шаг 1;
Создайте свой собственный каталог шаблонов (например, ~ /.lazarus/mytemplates) и установите этот путь в Lazarus (меню: Tools -> Project Template Options).
Шаг 2:
Чтобы любые шаблонные функции появились в меню File Lazarus'а, вам понадобится как минимум один шаблон, который вы можете использовать в своем существующем (обычном) проекте;
- Создайте каталог в вашем каталоге шаблонов (например, ~/.lazarus/mytemplates/myfirsttemplate)
- Скопируйте файлы вашего проекта в этот новый каталог (*.lfm, *.pas, *.ico, *.lpi, *.lpr, *.res)
Шаг 3:
Создайте файл project.ini в новом каталоге шаблонов.
Минимум, [файл] должен выглядеть примерно так:
project.ini:
[Variables]
[Project]
Name=My Form Template
Необязательно: Приятной особенностью Project Templates является то, что они поддерживают переменные. Так как проект, вероятно, не будет называться так же, как ваш пример шаблона, вам придется внести некоторые изменения в код и переименовать файл.
Файлы: Переименуйте файл проекта (ico, lpi, lpr, res) в __PROJNAME __. Ext (где расширение, конечно, является исходным расширением). Например: project.lpi становится __PROJNAME __. Lpi. Примечание: содержимое файла lpi может нуждаться в некоторой очистке, например, удаление истории, ссылки на файлы, даже если вы не уверены, нужен ли файл lpi.
Содержимое файла: Для всех файлов, которые ссылаются на project.lpi и т.д., измените содержимое ваших файлов, чтобы все ссылки на "project" превратились в "__PROJNAME__" (с кавычками)
Вы можете опционально определить свои собственные переменные, например, чтобы дать "unit.pas" другое имя файла. Например, вы можете определить __MAINUNIT__ и __MAINFORM__ в project.ini как MAINUNIT и MAINFORM - во время создания Lazarus запросит у вас эти имена. Теперь каждое вхождение __MAINUNIT__, например, будет заменено предоставленным вами текстом (избегайте специальных символов и пробелов).
Обратите внимание, что это работает для всех переменных; Каждое вхождение переменной в именах файлов и содержимом файла будет заменено тем, что вы ввели при создании нового проекта на основе вашего шаблона. Предопределенными переменными являются PROJNAME и PROJDIR, но я пока не нашел назначения для PROJDIR.
Некоторые примеры:
project.ini
[Variables]
MAINUNIT=Filename for the default unit.pas file
MAINFORM=Form name
[Project]
Name=My Custom Form
Author=Hansaplast
Description=Lazarus LCL form specifically for my needs
__PROJNAME__.lpr:
program __PROJNAME__;
{$mode objfpc}{$H+}
uses
{$IFDEF UNIX}{$IFDEF UseCThreads}
cthreads,
{$ENDIF}{$ENDIF}
Interfaces, // this includes the LCL widgetset
Forms, __MAINUNIT__;
{$R *.res}
begin
Application.Initialize;
Application.CreateForm(T__MAINFORM__, __MAINFORM__);
Application.Run;
end.
__MAINUNIT__.pas:
unit __MAINUNIT__;
{$mode objfpc}{$H+}
interface
uses
Classes, SysUtils, FileUtil, Forms, Controls, Graphics, Dialogs, ExtCtrls,
Buttons, StdCtrls, LCLIntf, LCLType, ComCtrls;
type
{ __MAINFORM__ }
T__MAINFORM__ = class(TForm)
...
procedure T__MAINFORM__.FormPaint(Sender: TObject);
...
//etc
__MAINUNIT__.lfm:
object __MAINFORM__: T__MAINFORM__
...
Имейте в виду, что этот краткий учебник только для начинающих, предлагаемый механизм замены переменных может использоваться для самых разных целей. Например, чтобы определить заголовок формы, заявление об авторском праве, веб-ссылку на ваши формы, конкретные объекты и т.д. --Hansaplast 16:30, 4 August 2012 (UTC)