Aqua 2024.3 Help

File and Code Templates

Aqua creates files using file templates as described in File templates. Use this page to view, edit, and create such templates .

Scheme

Select the scope to which the file templates apply:

  • Default: file templates created at the IDE level. These templates are available in all projects that you open with the current IDE instance. Use them as your personal templates that you prefer regardless of the specific project. Aqua stores global templates in the IDE configuration directory under fileTemplates.

  • Project: file templates specific for the current project. These templates are available to everyone who works on this project. Aqua stores them in the project folder under .idea/fileTemplates.

Tabs

Aqua includes the following types of templates:

Files

Aqua uses file templates to create new files.

Includes

These are templates for reusable fragments that can be included in file templates. For more information, refer to Reusable content in templates.

Code

Aqua uses these built-in templates as snippets to generate various constructs.

You can edit the templates available on this tab to modify how Aqua generates these constructs, but you cannot create new ones. To create custom code snippets, use live templates.

Toolbar

the Create Template button Create Template

Create a new file or include template.

the Create Child Template File button Create Child Template File

Add a child template to the selected template to create a set of multiple files with one template.

the Remove Template button Remove Template

Delete the selected file or include template. You can delete only custom templates, not the default ones.

the Copy Template button Copy Template

Create a copy of the selected file or include template.

the Revert to Original Template button Revert to Original Template

Revert the selected template to its original state. You can revert only modified default templates.

Template settings

Name

Specify the name of the template to display in the UI.

Not available for default built-in templates.

Extension

Specify the file extension to associate the template with a specific file type.

Not available for default built-in templates.

File name

If necessary, specify a name for the file created from this template. By default, Aqua prompts the user to enter a name when adding the file. You can hard-code a specific name to avoid the prompt entirely, or compose a template from available variables. For example, here is how you can use the specified name but put it one directory above the one that was selected during file creation: ../${NAME}

Not available for default built-in templates.

Template editor

Edit the code used for the selected template. For more information about the syntax used in file templates, see Syntax.

Reformat according to style

Reformat the contents generated based on this template according to the code style defined for this file type.

This option is available only for file templates.

Enable Live Templates

Insert live templates inside the file template. Use the Velocity escape syntax to include live template variables in a file template, for example: #[[ $MY_VARIABLE$ $END$ ]]#

Last modified: 11 October 2024