Function createFileWithTemplate

src/engine/TemplateEngine.ts:576–629

(
		filePath: string,
		resolvedTemplatePath: string
	)

	}

	protected async createFileWithTemplate(
		filePath: string,
		resolvedTemplatePath: string
	) {
		try {
			const templateContent: string = await this.getTemplateContent(
				resolvedTemplatePath
			);

			// Extract filename without extension from the full path.
			const fileBasename = basenameWithoutMdOrCanvas(filePath);
			this.formatter.setTitle(fileBasename);
			// {{FOLDER}} in the body reflects the file's actual on-disk folder.
			this.formatter.setTargetFolderPath(parentFolderPath(filePath));

			const formattedTemplateContent: string =
				await this.formatter.withTemplatePropertyCollection(() =>
					this.formatter.formatFileContent(templateContent),
				);

			// Get template variables before creating the file
			const templateVars = this.formatter.getAndClearTemplatePropertyVars();

			log.logMessage(`TemplateEngine.createFileWithTemplate: Collected ${templateVars.size} template property variables for ${filePath}`);
			if (templateVars.size > 0) {
				log.logMessage(`Variables: ${Array.from(templateVars.keys()).join(', ')}`);
			}

			const suppressTemplaterOnCreate = filePath
				.toLowerCase()
				.endsWith(".md");
			const createdFile: TFile = await this.createFileWithInput(
				filePath,
				formattedTemplateContent,
				{ suppressTemplaterOnCreate },
			);

			// Post-process front matter for template property types BEFORE Templater
			if (shouldPostProcessFrontMatter(createdFile, templateVars)) {
				await postProcessFrontMatter(this.app, createdFile, templateVars);
			}

			// Process Templater commands for template choices
			await overwriteTemplaterOnce(this.app, createdFile);

			return createdFile;
		} catch (err) {
			if (isMacroAbortError(err)) {
				throw err;
			}
			reportError(err, `Could not create file with template at ${filePath}`);
			return null;
		}
	}

	public setLinkToCurrentFileBehavior(behavior: LinkToCurrentFileBehavior) {
		this.formatter.setLinkToCurrentFileBehavior(behavior);