Customised templates: Difference between revisions

m
#*If ''Include Standard Files'' is selected it processes all the standard files (those listed in table above). The (built in, third party) component which handles the processing of the template file copes with a missing input file by creating an empty output file.
#*If ''Include Standard Files'' is not selected, then only the files explicitly listed as local files for processing are processed.
#*Regardless of that setting, the Cumulus component will process those listed in [[Cumulus.ini#Section:_FTP_Site]] as local files (the first 10 appear on 'Files' tab in internet settings screen reached from configuration menu) that also have ''Process?'' selected (set to 1 in Cumulus.ini#Section:_FTP_Site). [[File:Cumulus FTP Process.png |right]]
#Processing means:
#The result of that process is the creation of local web pages (until build 1092 the created pages were in XHTML 1.0 Transitional using charset=iso-8859-1; from build 1093 the created pages are by default - see below for how to change this - in HTML 5 using charset="UTF-8")
#*Where it finds a [[Webtags|web tag]] it will -
#*By inserting Hyper Text Mark-up Language structure and text as defined by the template.
#*Where it finds a [[Webtags|web tag]] it will
#**either insert the relevant observations from the weather station,
#**or insert derived values calculated by Cumulus,
#** or insert time-stamps (formatted by default or [[Webtags#Time.2FDate_.27format.27_Parameter|how you specify]]),
#** or [[Webtags#Miscellaneous|miscellaneous]] values.
#*Otherwise text and code as defined by the template is copied into the output file. <br/><br/>
#*The file name that Cumulus uses for the created local web page depends on whether the original template is being processed by ''Include Standard Files'' (in which case the created web page is the same name without a T) or being processed as an ''Extra file'' because it is listed on the ''Files'' tab (or in cumulus.ini FTP section) as a local file (in which case the created web page is the same as the original filename with its extension but with 'tmp' suffixed to the extension). The latter copes with customised templates that do not use the 'T' convention.[[File:Cumulus FTP Process.png]]
#The result of that process is the creation of local output pages:
#Cumulus will FTP these up to your web space on the internet. If you have asked it to use ''Rename'' on the remote file, a temporary name is created with the suffix 'tmp' added to the final file name as shown in diagram above. The final file names on your web site will be as in table above, without the letter T for templates being processed by ''Include Standard Files'', or the name you specify for the remote file name on the ''Files' tab (or in [[Cumulus.ini#Section:_FTP_Site]]) for customised templates (what the chart labels as ''Extra files'').
#*Typically the output is a HTML web page, but it is also possible to process scripts with cumulus web tags and then produce an output file in JavaScript or PHP Hypertext pre-processor.
#The result of that process is the creation of local web pages *(until build 1092 theany created web pages were in XHTML 1.0 Transitional using charset=iso-8859-1; from build 1093 thenormal created web pages are by default - see below for how to change this - in HTML 5 using charset="UTF-8")
#*The file name that Cumulus uses for the created local output page depends on the original template:
#**If template is being processed by "Include Standard Files", the created output page is the same name without a T,
#**If template is listed on the ''Files'' tab (or in cumulus.ini FTP section) as a local file then the created web page has 'tmp' suffixed to the extension. This copes with customised templates that do not use the 'T' convention. <br/><br/>
#Cumulus will FTP these up to your web space on the internet. If you have asked it to use ''Rename'' on the remote file, a temporary name is created with the suffix 'tmp' added to the final file name as shown in diagram abovehere. The final file names on your web site will be as in table above, without the letter T for templates being processed by ''Include Standard Files'', or the name you specify for the remote file name on the ''Files' tab (or in [[Cumulus.ini#Section:_FTP_Site]]) for customised templates (what the chart labels as ''Extra files'').
#*for templates being processed by ''Include Standard Files'', final file name is as in table above without the letter T;
#*for customised templates (what the chart labels as ''Extra files''), final file name is the name you specify for the remote file name on the ''Files' tab (or in [[Cumulus.ini#Section:_FTP_Site]]).
 
The standard website set up, with several other files, is fully described in [[Simple_Website_setup]].
5,838

edits