--------- FILE TAGS --------- ---------- TAG FORMAT ---------- Where "Perl" represents your Perl code: ----------- DESCRIPTION ----------- The FILE tag is used to import files into your PTM documents in standard format. PTM tags will not be evaluated when the file is loaded, but if the end user is viewing your calling PTM document with a web browser, any HTML in the loaded file will be evaluated. This is most useful when you wish to display PTM code to your audience, while keeping HTML formatting ability. It is also useful in debugging while a site is in development, as you can view the HTML formatted page while, at the same time, being able to see your PTM/Perl code snippets. The contents of the FILE tag are evaluated to a file name before the file is loaded. This ability allows you to load files dynamically by using variables instead of having to use static file names. Because of this, however, the use of single (') and double (") quotes is necessary when passing a file name, as it will be evaluated as a Perl statement. Once evaluated to a file name, the FILE tag contents are passed to the "get_file_text" function behind the scenes. Therefore, no unquoted semicolons (;) should be placed inside a FILE tag, as it would prematurely end the function call. -------------- USAGE EXAMPLES -------------- --------------------------------------------------------- Example 1: Loading a File by calling its Static File Name --------------------------------------------------------- ---------------------------------------------------------- Example 2: Loading a File from a Name Stored in a Variable ---------------------------------------------------------- -------------------------------------------------------------------- Example 3: Loading ".html" Files 1-10 with the DO Tag and a For Loop --------------------------------------------------------------------