A transformation action can be applied on a batch of selected files from the contextual menu of the Project view without having
to open the files involved in the transformation. You can apply the same scenario to a batch
of files or multiple scenarios to a single file or batch of files.
-
(Optional, but recommended) Organize the files you want to transform in logical
folders.
-
Create a logical folder in the Project view by using the action from the contextual menu of the root file.
-
Add files you want to transform to the logical folder by using the
Add Files or
Add Edited
File actions from the contextual menu of the logical folder.
Note: You can skip this step if the files are already in a dedicated folder that does
not include any additional files or folders. You can also manually select the
individual files in the Project view each time you want to
transform them, but this can be tedious.
-
Right-click the newly created logical folder and select to select one or more transformation scenarios to be applied on all the
files in the logical folder.
Note: These types of transformation scenarios must be configured with the current file
(${cf}) or current file URL (${currentFileURL})
editor variables for the input file. This ensures that each file becomes the current
file when its turn arrives in the batch transformation process. Edit the transformation
scenario to make sure the appropriate editor variable is assigned for the input file.
For example, for a DocBook PDF transformation make sure the XML
URL input box is set to the ${currentFileURL} editor
variable. For a DITA PDF transformation make sure the args.input
parameter is set to the ${cf} editor variable.
-
Now that logical folder has been associated with one or more transformation scenarios,
whenever you want to apply the same batch transformation you can select from the contextual menu and the same previously associated scenario(s)
will be applied.
-
If you want a different type of transformation to be applied to each file inside the
logical folder, associate individual scenarios for each file and select from the contextual menu of the logical folder.