Plugin writers need to take care that text may come from included topics. For example:
- The documentation of
beforeCommonTagsHandler should be improved to clarify that it is not triggered on included topics.
- The documentation of plugin writing should be improved to point out that plugin authors need to take care that they might be called on an included section. If there are links generated by the plugin, these need to be generated before the
afterCommonTagsHandler is run, as then the rendering has lost the information that we are in an included text, or the state needs to be memorized from earlier.
- The documentation of plugin writing should be improved to let plugin authors know that there is an additional parameter passed to
commonTagsHandler which indicates that this call is in the context of an include. (Not sure whether this is ever used.)