Insert Files

Inserts a file, group of files or directory of files into a new or existing TTK.

Syntax

Catalyst /M UserName [Rule:Rulename] [TTKName:TTKName] FileListFile:FileListName [SourceLang:Language TargetLang:Language] [/open] [RelativeTo:DirName]

Catalyst /M UserName [Rule:Rulename] [TTKName:TTKName] FromFolder:FolderName [/S] [/A] [SourceLang:Language TargetLang:Language] [/open]

Catalyst /M UserName [Rule:Rulename] [TTKName:TTKName] FName [, FName1 [,...]] [HHPFile:HPPFilename] [SourceLang: Language TargetLang:Language] [/open]

Parameters

/M	Insert files into a new or existing TTK
UserName	The name that will appear in the history list in the TTK.
Rule	ezParse rule to be used when aligning a file
TTKName:FName	Tag used to specify the name of the TTK to create or to insert files into. NOTE: If a TTKName is not specified, it will be automatically created by substituting the file extension .TTK to the end of the filename being inserted. One TTK will be created for each file inserted.
FileListFile:FileListName	Tag used to specify the path of a file that contains a list of filenames to be inserted into a TTK.
HHPFile:HPPFilename	Tag used to specify a HHP when inserting a compiled CHM file into a TTK
FromFolder:Foldername	Tag used to specify the path to a folder from which all files are to inserted into a TTK(s).
/S	Recurse all sub-folders
FName, FName1,[Fname2,...]	The full path of a file to be inserted into a TTK. Multiple filenames can be specified seperated by a semi-colon(,)
/A	Preserve directory structure in Project TTK file when inserting files.
SourceLang:Language	Tag used to specify the source language of the inserted file. See section on Language Codes.
TargetLang:Language	Tag used to specify the target language of the inserted file. See section on Language Codes.
RelativeTo:	This tag is used in conjunction with the FileListFile: tag and is used to truncate directory names with your Project TTK file relative to a declared root directory For example if you use the RelativeTo tag, a Project TTK file will be created from all the files listed in the FileListFile tag, however the created directories within the Project TTK file will only contain the a directory name that is relative to the directory declared using the RelativeTo tag. Note: The /A switch must also be included in order to maintain the directory structure.
Rule	Use the Rule tag to specify the name of an ezParse rule that is to be applied to an XML document or text file during the insertion operation. These rules are defined using ezParse. If the Rule tag is not used, Alchemy CATALYST will always select the default first rule for each XML and Text file format.
/open	Launches MS Notepad and displays the content of CatalystBatchLog.txt when the ezScript command finishes.

Sample content of a FileListName file

This is a sample of the contents which may appear in the file "Filelist.txt" as in the first example below.

"C:\Samples\Catalyst.rc"

"C:\Samples\Catalyst.exe"

"C:\Samples\IDBasedFiles.txt" Rule:"MyNewParser"

"C:\Samples\Conditional.xml" Rule:"XML ShowAll"

Examples

This example creates a new TTK called Master.ttk and inserts into it all the files that are listed in FileListName.txt. In the history report of this TTK, John will be the name assigned to this activity.

Catalyst /M John TTKName:Master.ttk FileListFile:Filelist.txt

This example appends all the files in the folder and sub-folders of C:\Allfiles into a TTK called TTKfile.ttk.

Catalyst /M John TTKName:C:\English\TTKFile.ttk FromFolder:C:\AllFiles\ /S /A

This example inserts the File.exe into a new TTK which will be names File.ttk (since no TTKName is specified). As no Source Language and Target Languages have been specified the default set Project Languages will be used..

Catalyst /M John File.exe SourceLang:"English (Ireland)" TargetLang:"German (Standard)"

This example inserts the VortexDemo.chm into a new TTK called InsertCHM.ttk. The HHP file VortexDemo.hhp will also be inserted. As no languages have been specified the default set Project Languages will be used.

Catalyst /M John TTKName:C:\InsertCHM.ttk C:\Samples\VortexDemo.chm HHPFile:C:\Samples\VortexDemo.hhp