Feat: Limiting the number of glossary links for ambiguous terms

[about-code]

User Story

As a technical writer using a structured Markdown page template with similar headings over and over again I would like to limit the number of superscript links generated when meantioning one of the headings somewhere in the book.

For example in technical writing there might be templates for things such as User Stories which intentionally replicate the same headings over and over again. In these situations you do not want to link every mention of User Story with a dozen files nor would you want to have dozens of superscript links in text (it might be acceptable in a book index).

Prior Art

• In Use superscript for links to definitions of ambiguously defined terms #57 we implemented superscript links for ambiguously defined glossary terms so to link a term with each definition in (multiple) glossaries. There is not yet any upper limit.
• In Feat: Cross-linking with any section #122 we implemented basic cross-linking functionality. With being able to treat basically all the documents of a book like glossaries there may be situations as given by the user story where the same headings (terms) exist in many pages.
• In Feat (Cross-Linking): Select heading depths to participate in linkification. #135 we implemented one measure to exclude headings at a certain depth from linkification but this is a rather brute-force way of dealing with the situation.

Proposal

There should be an option to

• a) either limit the number of superscript links in documents (not necessarily in Index files)
• b) or a rule for when headings are no longer subject to linkification at all, e.g. if the same definition of a heading exists more than x times, then it should no longer be considered for linkification.