mirror of
https://gitlab.com/freepascal.org/lazarus/lazarus.git
synced 2025-06-04 22:18:33 +02:00
51 lines
1.8 KiB
Plaintext
51 lines
1.8 KiB
Plaintext
This package implements project templates.
|
|
|
|
Installing this package in the IDE adds a category to the 'File-New' dialog:
|
|
'Template projects'
|
|
|
|
It also adds a 'New project from Template' menu item to the 'File' menu, as
|
|
well as a 'project template options' menu under the 'Tools' menu.
|
|
|
|
In the 'Project template options', a directory can be selected. This project
|
|
should contain a subdirectory per template. Each template directory contains
|
|
a template for a project: A collection of files which will be copied and
|
|
used as a new project.
|
|
|
|
During the copy, the package will scan the file/directory names and the
|
|
contents of the files for variable substitution: $(VARNAME) will be
|
|
replaced by the value of a variable $(VARNAME).
|
|
|
|
By default, the engine knows 2 variables:
|
|
ProjDir : The directory where the new project will be created.
|
|
ProjName : The name of the project.
|
|
|
|
Additional variables must be defined in a file called 'project.ini' in the
|
|
directory of the project. This is a file in Windows INI format.
|
|
|
|
The section [Variables] will be scanned for variable names:
|
|
[Variables]
|
|
VarName1=Description 1
|
|
VarName2=Description 2
|
|
|
|
The variables found will be presented with their description in a dialog,
|
|
and the user must present a value for the variables.
|
|
|
|
The 'project.ini' file can contain a second section, called 'Project', which
|
|
can contain some info about the project. The following keywords can be found
|
|
there:
|
|
|
|
Name
|
|
Name of the template
|
|
Author
|
|
Author of the template
|
|
Description
|
|
Short (one-line) description of the project
|
|
Recurse
|
|
A boolean value (1/0) which tells the engine to recurse in subdirectories
|
|
or not.
|
|
Exclude
|
|
Comma separated list of filename extensions which should not be searched
|
|
for keyword subsitution.
|
|
|
|
The Name,Author and description will be presented in the 'File-New' dialog.
|