Webtags (preserving history): Difference between revisions

Webtags (preserving history) (view source)

Revision as of 14:57, 28 July 2020

1,090 bytes added , 14:57, 28 July 2020

m

→‎Inconsistency of web tag names

Sfws

5,838

edits

@@ Line 232: / Line 232: @@
 ==Inconsistency of web tag names==
-You will find yourself frequently having to refer to this article, if you decide to make your own Cumulus templates (see section below for more information). This applies whether those templates are for [[Customised templates|web pages]],  to implement [[Xml webtags|Extensible Mark-up Language files]],  or [[Php webtags|PHP Hypertext Pre-processor scripts]]. This because web tags were introduced at different times, and there was no convention as to how they were named, so there is great inconsistency in the naming, making it very easy to spell a tag_name incorrectly.
+Some tags are all lower-case, some are camel-case, and some start with a capital letter. Have a look yourself at just how much inconsistency is present in the names in the tables below. The great inconsistency in the naming, gives rise to a problem as it very easy to spell a tag_name incorrectly as you naturally expect there to be a standard pattern.
-For example the character "Y" might be included in a web tag to denote '''yesterday''', or it might denote ''this year''; where the Y is indicating '''yesterday''', it is sometimes a ''prefix'', sometimes a ''suffix''!
+You will find yourself frequently having to refer to this article, if you decide to make your own Cumulus templates (see section below for more information). This applies whether those templates are for [[Customised templates|web pages]],  to implement [[Xml webtags|Extensible Mark-up Language files]],  or [[Php webtags|PHP Hypertext Pre-processor scripts]].
-Some web tags for '''today''' include a "T" as a suffix, some do not. "T" is also used as a suffix for the time-stamp tags.
+When Steve Loft introduced the first web tags as part of developing software for his own use, he did not create a naming standard to ensure consistency in the future. As he introduced further web tags at different times, the names used might be consistent amongst the ones introduced that day, but there was still no naming convention to ensure consistency with tags introduced previously or to help name future tags.
-Some tags are all lower-case, some are camel-case, and some start with a capital letter. Have a look yourself at just how much inconsistency is present in the names in the tables below.
+===Inconsistency for today, yesterday, this month, this year groups===
+It would be easier if all tags reporting parameters for today were consistent, let alone consistency in naming between tags for today and yesterday.  The tags for this year and this month were introduced in same release, so there is some consistency in how they were named then, but no standard to ensure future tags for this month and this year would be named the same way.
+===Inconsistency in use of "Y"===
+ For example the character "Y" might be included in a web tag to denote '''yesterday''', or it might denote ''this year''; where the Y is indicating '''yesterday''', it is sometimes a ''prefix'', sometimes a ''suffix''!
+===Inconsistency in use of "T"===
+Some web tags for '''today''' include a "T" as a suffix, some do not. "T" is used  for the time-stamp tags as a prefix sometimes and as a suffix sometimes. This is particularly confusing and is why you must look up time-stamp tags in the tables in this article.
+===Choosing script variable names derived from tag names===
 In the web tag to PHP variable scripts, I have posted, see [[Php_webtags#Minimised_Upload_size]], I have tried to introduce better consistency in the PHP variable names, so "T" is added as a suffix to all "today" variables for example. Some other script authors try to match the inconsistent web tag names, so their script variable names are also inconsistent.