Note: This filter outputs text both at the start of a file, and the start of a Restriction. To only output text at the start of a file, use the Add File Header filter.
Adds the contents of the file or the specified text to the start of each file. Useful for adding advertising banners to web pages or other forms of file header. This filter is usually positioned at the top of the filter list ie just after <input>. Sub filters can be used to pre-process the file or text being added.
Note: If you wish to add a header to each page of a file that contains many pages, the best method of doing so is to use an 'Add Header Text' filter in conjunction with a search and replace for page end characters. Search for a form feed character (\f or \012), and when you find it, replace with a \f followed by your page header text.
You can use this filter to add a Unicode Byte Order Mark (BOM) to your file:
The right-click (or context) menu on this field supports Undo, Cut, Copy, Paste, Delete, Clear Entire Field, Select All and Select All And Copy, entering special characters and inserting macros and global variables. Special characters and macros are ONLY supported when they are entered in the text field - they will not be interpreted or parsed when a file's contents are included.