• View
• Edit
• History
• Attach
• Print
• Backlinks

SignalWhenMarkup

Questions answered by this recipe

How can I tell whether my markup function is called within (:markup:) source code?

Description

The script sets a global variable, $SignalMarkupMarkup, that tells you whether and how deep the 'markup chain' (MarkupToHTML / MarkupTable execution) is inside a (:markup:) code sequence.

Some cookbooks like SlimTableOfContents, TitleMarkup, SectionEdit need to know or should at least care about that.
They should / should not / should differently execute their code inside (:markup:) page source text.

Activation

Download signalwhenmarkup.phpΔ into your cookbook folder an activate it as usual by adding the following line to your local/config.php:

  include_once("$FarmD/cookbook/signalwhenmarkup.php");

Usage

Whenever you need to know whether your own markup is evaluated within (:markup:) code, check the value of global $SignalMarkupMarkup:

  $SignalMarkupMarkup == 0  - we are NOT in a (:markup:) sequence
  $SignalMarkupMarkup == 1...n we are in the n'th level

Notes

Works by redirecting the markups 'markup' and 'markupend'.

Release Notes

If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".

• (2009-02-01) Initial version

See Also

Contributors

Comments