Customised templates: Difference between revisions

m
→‎What is meant by 'Cumulus processes templates': viewtopic.php?f=14&t=7500&sd=a&start=40
m (→‎Slightly less simple customisation of trendsT.htm: Text re-sequenced when adding comment only applies to Cumulus 1)
m (→‎What is meant by 'Cumulus processes templates': viewtopic.php?f=14&t=7500&sd=a&start=40)
== What is meant by 'Cumulus processes templates' ==
#When Cumulus is ready to perform a web site update, it will read each template file:
#*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.
#*those listed in table above if ''Include Standard Files'' is selected
#*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).
#andThe runresult aof that process thatis the creation createsof locallylocal 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")
#*By inserting Hyper Text Mark-up Language structure and text as defined by the template.
#*Where it finds a [[Webtags|web tag]] it will
#*Where it finds a web tag it will insert the relevant observations from the weather station, values calculated by Cumulus, time-stamps, or miscellaneous values, for each.
#**either insert the relevant observations from the weather station,
#*The file name that Cumulus uses for the created local webpage 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]]
#**or insert derived values calculated by Cumulus,
#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 (The chart labels these as ''Extra files'').
#** or insert time-stamps (formatted by default or [[Webtags#Time.2FDate_.27format.27_Parameter|how you specify]]),
#** or [[Webtags#Miscellaneous|miscellaneous]] values.
#*The file name that Cumulus uses for the created local webpageweb 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]]
#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 (Thewhat the chart labels these as ''Extra files'').
 
The standard website set up, with several other files, is fully described in [[Simple_Website_setup]].
5,838

edits