MAM-parsed-plus imposes an order on the nesting of templates.
Although the order is somewhat arbitrary, it is important that there be such an order, to make the data easier to use. As with many standards, the existence of the standard is more important than the details of the standard.
The order is a partial order on templates. In other words, templates are ordered by equivalence classes.
These equivalence classes can also be thought of as ranks. Templates within an equivalence class are exclusive of each other, i.e. can never be nested within each other, so there is no need to define an ordering amongst them.
Here are the ranks for column E, with symbolic categories that align with sections in the main mpplus document.
| Template(s) | Category |
|---|---|
| מ:כפול | choice of cantillation |
| נוסח | documentation note |
| מ:הערה-2 | scroll difference note |
| כו״ק, כתיב ולא קרי, ..., ..., ..., ... | ketiv/qere |
| מ:קמץ | choice of qamats “size” |
| מ:דחי, מ:צינור | choice of stress helper |
| מ:אות-מיוחדת-במילה | word with special letter |
| מ:אות-ק, מ:אות-ג, ..., ... מ:לגרמיה-2, מ:פסק, מ:מקף אפור ש, מודגש, ..., ... סס, ססס, פפ, פפפ ר0, ר1, ר2, ר3, ר4 |
misc. terminal |
The rest of this document shows call graphs. These graphs show which templates nest inside other templates. Whereas the normal order shown above constrains the possible template nestings, the call graphs show the actual nestings that occur in practice.
The presence of a directed edge A → B indicates that, somewhere in MAM-parsed-plus, a call to template B nests within a call to template A. The edge is labeled with the number of times this nesting occurs.
The call graph below, for column E, omits the נוסח and מ:כפול templates. This is to keep it more readable.
To better understand the graph above, let’s look at one particular edge in the graph. Let’s look at the edge from “כו״ק, …” to מ:קמץ.
The notation “כו״ק, …” is a shorthand for a group of three ketiv/qere templates. You can see the list of all three by hovering over the node in the SVG graph:
The “12” edge from “כו״ק, …” to מ:קמץ indicates that 12 times in MAM-parsed-plus, a call to מ:קמץ nests within a call to one of those three templates.
Not shown on the graph is how many times מ:קמץ nests within a call to each of those three templates. It happens to break down like this:
Here are two concrete Wikitext examples:
Note that the Gen 13:3 example contains both of the 2 cases where מ:קמץ nests within מ:קו״כ-אם-2: two calls to מ:קמץ nest within a single call to מ:קו״כ-אם-2.
The edge counts in the graph above are quite low. This shows that, ignoring נוסח and מ:כפול, nesting in column E is rare. Though it is still low, the highest count, 97, is somewhat misleading. It is somewhat misleading since the special letter templates, by definition, must be nested under מ:אות-מיוחדת-במילה. (The special letter templates are מ:אות-ק (small), מ:אות-ג (large), and מ:אות תלויה (hung).)
The call graph below, for column D, is, as expected, much simpler than the one for column E. Recall that ש is the paragraph divider template, used exclusively in the second argument to נוסח.
The call graph below, for column C, is, like the one for column D, quite simple. Indeed it may look a little simpler than it really is because many templates are “hiding” beneath the “סס, …” node. (You can see the list of all of them by hovering over that node in the SVG graph.)