Foswiki on GitHub is open for business! Next release meeting: Monday September 1, 1300Z

Item9702: Document all template directives and macros

Priority: CurrentState: AppliesTo: Component: WaitingFor:
Enhancement Closed Engine Documentation  
While editing templates, I ran across a few apparent macro invocations (template directives? how does a user distinguish?) that weren't documented in System.Macros or System.Skins#Settings_in_Skins:

  • QUERYPARAMSTRING
  • REVARG

-- DanDascalescu - 17 Sep 2010

George has started a great initiative to get these things (1) identified and (2) documented. I'd like to add a second step:
  1. Identify
  2. Eliminate
  3. Document
These template tokens have always been a problem; they are usually the result of a coder not fully understanding how to use templates just hacking in the simplest thing. The more we can do to eradicate these stains, the better.

For example, the ubiquitous SPLIT token could be replaced by three macro definitions, top, repeat and bottom. Of course the use of thse macros also need to be documented.

-- CrawfordCurrie - 18 Sep 2010
 

ItemTemplate edit

Summary Document all template directives and macros
ReportedBy DanDascalescu
Codebase trunk
SVN Range
AppliesTo Engine
Component Documentation
Priority Enhancement
CurrentState Closed
WaitingFor
Checkins Foswikirev:9194 Foswikirev:9467 Foswikirev:9468 Foswikirev:9485 Foswikirev:11521 Foswikirev:11525 Foswikirev:12719
TargetRelease patch
ReleasedIn 1.1.4
Topic revision: r13 - 17 Dec 2011, GeorgeClark
 
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. see CopyrightStatement. Creative Commons License