Cumulus template file: Difference between revisions

1,054 bytes added ,  22:48, 7 April 2021
m
Line 42: Line 42:
=== Using web tags in templates for creating HTML pages ===
=== Using web tags in templates for creating HTML pages ===


*You can create a template file that has a structure of HTML elements with Cumulus web tags to represent the information you want included.
You can include special markers in your template file that are called web tags; during processing Cumulus will replace them with the actual values. 
*If you   [[Customised_templates#What_to_select_on_the_.27Files.27_tab_of_the_Internet_Settings_screen_within_the_.27Configuration.27_menu|ask Cumulus to process]] that template file, it will create a HTML page from the template, and during that file creation replace the tag with the current value of the item the tag represents.
 
*You also need to tell Cumulus that the resulting HTML file is to be uploaded to the internet (or copied to a local web server).
Typically you would use this to build your own website by having an HTML template file with your layout, static text and graphics.  In the position on the page you wish Cumulus to insert the relevant data place a web tag in the general format specified here:  <pre><#tag_name [optional input parameters][optional output parameters]></pre>
 
''Note: When you put a tag into your template, be careful that whatever program you are using to develop your web pages doesn't change the angle brackets to slightly different symbols -- this is a common cause of failure!''  There are a number of editing tools that are '''designed for editing programming code''' and you should use one of those (e.g. Notepad++, Brackets, NoteTab Light, HTML kit, amongst many others), ''rather than a tool designed for web page design editing'' (e.g. Dreamweaver, word press, amongst others).
 
To summarise the necessary tasks:
#You can create a template file that has a structure of HTML elements with Cumulus web tags to represent the information you want included.
#Next you ask Cumulus [[Customised_templates#What_to_select_on_the_.27Files.27_tab_of_the_Internet_Settings_screen_within_the_.27Configuration.27_menu|to process]] that template file, it will create a HTML page from the template, and during that file creation replace the tag with the current value of the item the tag represents.
#You also need to tell Cumulus that the resulting HTML file is to be uploaded to the internet (or copied to a local web server).


=== Using web tags in scripts ===
=== Using web tags in scripts ===
5,838

edits