Commentaries
How Sefaria Treats Commentaries
In the Sefaria database, commentaries are treated the same as regular texts. This means that commentary texts have their own individual Index
and each edition of text for that commentary is represented by its own Version
record.
Index Attributes for Commentaries
We use specific attributes on the Index
record to indicate that an Index
is a commentary on another book. Those attributes are elaborated below:
Attribute | Type | Description |
---|---|---|
|
| Generally |
|
| The base book(s) this one is dependent on. For example, |
|
| Enables auto-linking between a base text and a commentary. These values match keys in the So far, four options exist:
The corresponding (This helps maintain the auto-linking feature once afforded commentaries by default. It also makes room to expand and have various algorithms for linking between a dependent text and its base text/s) |
|
| This is the value for a group of index records. It is used to contain the former commentator name which was once the primary handle on a commentary. Now used to group many indices belonging to a larger corpus, such as commentaries. Requires a matching Hebrew ex: The |
|
| Only texts with Default is |
Below is an example of how these specific fields would be filled on the Index
record of Ramban on Genesis
:
"title": "Ramban on Genesis"
"base_text_titles": [
"Genesis"
],
"base_text_mapping": "many_to_one",
"collective_title": "Ramban",
"dependence": "Commentary",
"categories": ["Tanakh", "Rishonim on Tanakh", "Ramban", "Torah"]
Commentaries and Category
Categories are mostly used to denote where the book will show up in the Sefaria Table of Contents.
This means that the text "Ramban on Genesis"
with the category path of ["Tanakh", "Rishonim on Tanakh", "Ramban", "Torah"]
will show up under Tanakh >> Rishonim on Tanakh >> Ramban >> Torah.
-
For a commentary, the category indicating the type of commentary (i.e. in this example,
Rishonim on Tanakh
) comes after one top level category . E.g.["Tanakh", "Rishonim on Tanakh", "Ramban", "Torah"]
-
In some cases, it comes after multiple categories, particularly for Talmud. E.g.
["Talmud", "Bavli", "Rishonim on Talmud", "Rashi", "Seder Zeraim" ]
Updated 4 days ago