From 213cd2080862f248feee8a44dd4562b659dcc8ea Mon Sep 17 00:00:00 2001 From: saengel Date: Thu, 4 Jan 2024 13:48:07 +0200 Subject: [PATCH] feat(API Docs): JSON Update --- static/files/openAPI.json | 8230 ++++++++++++++++++++++++++----------- 1 file changed, 5910 insertions(+), 2320 deletions(-) diff --git a/static/files/openAPI.json b/static/files/openAPI.json index e645d2cca8..a64a267639 100644 --- a/static/files/openAPI.json +++ b/static/files/openAPI.json @@ -941,8 +941,8 @@ } }, "/api/topics/{topic_slug}": { - "summary": "The Topics API", - "description": "The topics API has two possible use cases:\n1. With a `topic_slug` passed in as a path parameter, in which case the API will return all of the metadata for the given topic. \n2. Without a `topic_slug` passed in as a path parameter, in which case the API will return a list of *all of the topics in the Sefaria database* along with their metadata. ", + "summary": "The Specific Topic API", + "description": "This API will return all of the metadata for the given topic passed in as a path parameter with its `topic_slug`. ", "get": { "responses": { "200": { @@ -955,7 +955,62 @@ "Sukkot Topic": { "value": { "slug": "sukkot", - "titles": [], + "titles": [ + { + "text": "Tabernacles", + "lang": "en" + }, + { + "text": "Succot", + "lang": "en" + }, + { + "text": "Sukkos", + "lang": "en" + }, + { + "text": "Succos", + "lang": "en" + }, + { + "text": "Booths", + "lang": "en" + }, + { + "text": "sukkot", + "lang": "en" + }, + { + "text": "succot", + "lang": "en" + }, + { + "text": "Succoth", + "lang": "en" + }, + { + "text": "Sukkoth", + "lang": "en" + }, + { + "text": "חג הסוכות", + "lang": "he" + }, + { + "text": "סכות", + "lang": "he" + }, + { + "text": "Sukkot", + "lang": "en", + "primary": true + }, + { + "text": "סוכות", + "lang": "he", + "primary": true + } + ], "alt_ids": { "_temp_id": "סוכות" }, @@ -998,11 +1053,11 @@ } } }, - "description": "1. When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n2. When one calls this endpoint _without_ passing a specific `topic_slug` as a path parameter, the API will return a list of JSON objects - where each object represents a topic in the Sefaria database, and contains all of the relevant metadata. " + "description": "When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n" } }, - "summary": "Topics API", - "description": "1. When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n2. When one calls this endpoint _without_ passing a specific `topic_slug` as a path parameter, the API will return a list of JSON objects - where each object represents a topic in the Sefaria database, and contains all of the relevant metadata. " + "summary": "Specific Topic API", + "description": "When one calls this endpoint _with_ a specific `topic_slug`, it returns a JSON object containing the metadata for the topic. \n" }, "parameters": [ { @@ -1027,1547 +1082,4368 @@ }, "in": "path", "required": true - } - ] - } - }, - "components": { - "schemas": { - "ref": { - "description": "A string representing a citation to a Jewish text. \n\nA valid ref consists of a title string followed optionally by a section string or a segment string. \n\nA title string is any one of the known text titles or title variants in the Sefaria Database.", - "type": "string", - "example": "\"Mishnah Peah 4:2\"" - }, - "versionData": { - "title": "Root Type for versionData", - "description": "Information about a single text version of a title", - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "versionTitle": { - "type": "string" - }, - "versionSource": { - "type": "string" - }, - "language": { - "type": "string" - }, - "status": { - "type": "string" - }, - "license": { - "type": "string" - }, - "versionNotes": { - "type": "string" - }, - "digitizedBySefaria": { - "type": "string" - }, - "priority": { - "format": "int32", + }, + { + "name": "with_links", + "description": "`1` or `0`. If `1`, includes intra-topic links in the `result` field, under `links`.", + "schema": { "type": "integer" }, - "versionTitleInHebrew": { - "type": "string" - }, - "versionNotesInHebrew": { - "type": "string" - }, - "extendedNotes": { - "type": "string" - }, - "extendedNotesHebrew": { - "type": "string" - }, - "purchaseInformationImage": { - "type": "string" - }, - "purchaseInformationURL": { - "type": "string" - }, - "shortVersionTitle": { - "type": "string" + "in": "query", + "required": false + }, + { + "name": "annotate_links", + "description": "`1` or `0`. If `1`, adds the following fields to each intra-topic link: `title`, `titleIsTransliteration`, `shouldDisplay`, and `order`.", + "schema": { + "type": "integer" }, - "shortVersionTitleInHebrew": { - "type": "string" + "in": "query" + }, + { + "name": "group_related", + "description": "`1` or `0`. If `1`, groups link types with the `groupRelated` key set to true. This will simulate how the sidebar looks on the Sefaria site.", + "schema": { + "type": "integer" }, - "isBaseText": { - "type": "boolean" + "in": "query" + }, + { + "name": "with_refs", + "description": "`1` or `0`. If `1`, adds a list of `Ref`s tagged with this topic under the `refs` key.", + "schema": { + "type": "integer" }, - "firstSectionRef": { - "type": "string" - } + "in": "query" }, - "example": { - "title": "Genesis", - "versionTitle": "The Contemporary Torah, Jewish Publication Society, 2006", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002529489/NLI", - "language": "en", - "status": "locked", - "license": "CC-BY-NC", - "versionNotes": "Dedicated by an anonymous donor in honor of all women and girls who study, teach, and transform Torah.\n

\nRead the preface to The Contemporary Torah\n

\n See the Dictionary of Gender in the Torah", - "digitizedBySefaria": "", - "priority": 7, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "תרומה אלמונית לכבוד כל הנשים והבנות שלומדות, מלמדות ונותנות צורה חדשה לתורה", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "https://jps.org/wp-content/uploads/2014/10/ContemporaryTorah-300x458.png", - "purchaseInformationURL": "https://jps.org/books/contemporary-torah/", - "shortVersionTitle": "The Contemporary Torah, JPS, 2006", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Genesis 1" + { + "name": "annotate_time_period", + "description": "`1` or `0`. If `1`, the response includes time period data under the `timePeriod` key.", + "schema": {}, + "in": "query" } - }, - "nameAPIResponse": { - "title": "Root Type for nameAPIResponse", - "description": "Full response of the Name API", - "type": "object", - "properties": { - "lang": { - "description": "The language of the completion results.", - "enum": [ - "en", - "he" - ], - "type": "string" - }, - "is_ref": { - "description": "Returns `true` if the submitted text is a valid Sefaria textual reference", - "type": "boolean" - }, - "completions": { - "description": "A list of autocompletion responses for the submitted text.", - "type": "array", - "items": { - "type": "string" - } - }, - "completion_objects": { - "description": "A list of autocompletion response objects for the submitted text along with some information about them.", - "type": "array", - "items": { - "type": "object", - "properties": { - "title": { - "type": "string" - }, - "key": { - "type": "string" - }, - "type": { - "type": "string" - }, - "is_primary": { - "type": "boolean" + ] + }, + "/api/topics": { + "summary": "The Topics API", + "description": "The topics API returns a list of JSON objects containing metadata for every topic in the Sefaria database. ", + "get": { + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/TopicJSON" + } }, - "order": { - "format": "int32", - "type": "integer" + "examples": { + "The first three topics returned: ": { + "value": [ + { + "slug": "prayer", + "titles": [ + { + "primary": true, + "text": "תפילה", + "lang": "he" + }, + { + "primary": true, + "text": "Prayer", + "lang": "en" + }, + { + "text": "Tefillah", + "lang": "en", + "transliteration": true + }, + { + "text": "תפלה", + "lang": "he", + "fromTerm": true + }, + { + "text": "T'filah", + "lang": "en" + }, + { + "text": "Tefilla", + "lang": "en" + }, + { + "text": "Tefilah", + "lang": "en" + }, + { + "text": "התפלל", + "lang": "he" + }, + { + "text": "Liturgy", + "lang": "en" + }, + { + "text": "Siddur", + "lang": "en" + }, + { + "text": "תְּפִלָּה", + "lang": "he" + }, + { + "text": "סידור", + "lang": "he" + }, + { + "text": "סדר התפילה", + "lang": "he" + }, + { + "lang": "en", + "text": "prayer" + }, + { + "lang": "en", + "text": "#Tefillah" + }, + { + "lang": "en", + "text": "Tefila" + }, + { + "lang": "en", + "text": "TEFILA" + }, + { + "lang": "en", + "text": "Tefiilah" + }, + { + "lang": "en", + "text": "Tfillah" + }, + { + "lang": "en", + "text": "T'fillah" + }, + { + "lang": "en", + "text": "T'filla" + }, + { + "lang": "en", + "text": "Tfilla" + }, + { + "lang": "en", + "text": "T'fila" + } + ], + "alt_ids": { + "_temp_id": "תפלה", + "_temp_toc_id": "Prayer", + "_old_slug": "tfilla1" + }, + "description": {}, + "categoryDescription": { + "en": "Liturgy and modes of Jewish prayer.", + "he": "נוסחי תפילה ודרכי תפילה יהודית." + }, + "isTopLevelDisplay": true, + "displayOrder": 30, + "numSources": 2937, + "good_to_promote": true, + "primaryTitle": { + "en": "Prayer", + "he": "תפילה" + } + }, + { + "slug": "torah", + "titles": [ + { + "text": "Torah", + "lang": "en", + "primary": true + }, + { + "text": "תורה", + "lang": "he", + "primary": true + }, + { + "text": "Chumash", + "lang": "en" + }, + { + "lang": "en", + "text": "torah" + } + ], + "alt_ids": { + "_temp_id": "תורה" + }, + "numSources": 2333, + "good_to_promote": true, + "primaryTitle": { + "en": "Torah", + "he": "תורה" + } + }, + { + "slug": "passover", + "titles": [ + { + "text": "Passover", + "lang": "en", + "primary": true + }, + { + "text": "פסח", + "lang": "he", + "primary": true + }, + { + "text": "Pesach", + "lang": "en", + "transliteration": true + }, + { + "text": "Pesah", + "lang": "en" + }, + { + "text": "Chag HaPesach", + "lang": "en", + "fromTerm": true + }, + { + "text": "Pessach", + "lang": "en", + "fromTerm": true + }, + { + "text": "חג הפסח", + "lang": "he", + "fromTerm": true + }, + { + "text": "חג המצות", + "lang": "he", + "fromTerm": true + }, + { + "lang": "he", + "text": "חג פסח" + } + ], + "alt_ids": { + "_temp_id": "פסח", + "_old_slug": "-13" + }, + "properties": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/passover", + "dataSource": "sefaria" + }, + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/passover", + "dataSource": "sefaria" + } + }, + "description": { + "en": "Passover, or Pesach, is a week long springtime festival commemorating the Exodus from Egypt. It also celebrates national redemption, and freedom from slavery. It is observed through avoidance of certain foods (especially grains) and ritual dinners called Seders where attendees retell the story of the Exodus.", + "he": "חג הפסח הוא חג שנמשך שבוע וחל באביב, לזכר יציאת מצרים. הוא גם חוגג את גאולת העם והשחרור מעבדות. הוא נחגג באמצעות הימנעות ממאכלים מסוימים (במיוחד דגנים) וסעודה טקסית הנקראת ליל הסדר אשר בה מספרים המשתתפים את סיפור יציאת מצרים." + }, + "categoryDescription": {}, + "displayOrder": 10, + "numSources": 2040, + "description_published": true, + "primaryTitle": { + "en": "Passover", + "he": "פסח" + } + }, + { + "slug": "teshuvah", + "titles": [ + { + "text": "Teshuvah", + "lang": "en", + "primary": true + }, + { + "text": "Teshuva", + "lang": "en" + }, + { + "text": "Repentance", + "lang": "en" + }, + { + "text": "Tshuva", + "lang": "en" + }, + { + "text": "Repentence", + "lang": "en" + }, + { + "text": "T'shuva", + "lang": "en" + }, + { + "text": "teshuva", + "lang": "en" + }, + { + "text": "teshuvah", + "lang": "en" + }, + { + "text": "Repent", + "lang": "en" + }, + { + "text": "Tshuvah", + "lang": "en" + }, + { + "text": "תשובה", + "lang": "he", + "primary": true + }, + { + "text": "תְּשׁוּבָה", + "lang": "he" + } + ], + "alt_ids": { + "_temp_id": "תשובה" + }, + "description": { + "en": "The word \"teshuvah\" literally means “return” and is best translated as \"repentance.\" Teshuvah is presented in Jewish sources as a gift from God because it allows one to return to the path of righteousness. Although it can be done at any time, Yom Kippur is the Jewish holiday most associated with repentance.", + "he": "המונח תשובה כוונתו שיבה אל דרכי האל. במקורות היהודיים נתפסת התשובה כמתנה מאלוהים, מכיוון שהיא מאפשרת לאדם לשוב ולדבוק בדרכי הטוב והיושר. אף שתשובה היא דבר שאפשר לעשות בכל עת, יום הכיפורים הוא המועד המוכר ביותר למטרה זו." + }, + "categoryDescription": {}, + "numSources": 1967, + "good_to_promote": true, + "description_published": true, + "data_source": "sefaria", + "primaryTitle": { + "en": "Teshuvah", + "he": "תשובה" + } + }, + { + "slug": "יחיד-וחברה", + "titles": [ + { + "lang": "he", + "text": "יחיד וחברה", + "primary": true + } + ], + "alt_ids": { + "_old_slug": "-163" + }, + "numSources": 1826, + "primaryTitle": { + "en": "", + "he": "יחיד וחברה" + } + } + ] + } } } }, - "example": "[{\n \"title\": \"Ruth\",\n \"key\": \"Ruth\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth Rabbah\",\n \"key\": \"Ruth Rabbah\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth\",\n \"type\": \"PersonTopic\",\n \"key\": \"ruth\",\n \"is_primary\": true,\n \"order\": 4999550\n }, {\n \"title\": \"Ruach Hakodesh\",\n \"type\": \"Topic\",\n \"key\": \"ruach-hakodesh1\",\n \"is_primary\": true,\n \"order\": 4999902\n }, {\n \"title\": \"Ruach\",\n \"type\": \"Topic\",\n \"key\": \"ruach1\",\n \"is_primary\": true,\n \"order\": 4999949\n }, {\n \"title\": \"Rubissa Sharona Hassan\",\n \"type\": \"User\",\n \"key\": \"sharona-hassan\",\n \"pic\": \"https://storage.googleapis.com/sefaria-profile-pictures/sharona-hassan-1622999139-small.png\",\n \"order\": 6999998,\n \"is_primary\": true\n }]" - }, - "is_book": { - "description": "Returns `true` if the submitted text is a book level reference. e.g. (Genesis)", - "type": "boolean" - }, - "is_node": { - "description": "Returns true if the submitted text is a `node` in a complex text.", - "type": "boolean" - }, - "is_section": { - "description": "Returns `true` if the submitted text is a section ref. (e.g. Genesis 4)", - "type": "boolean" - }, - "is_segment": { - "description": "Returns `true` if the submitted text is a segment level reference (e.g. Genesis 43:3)", - "type": "boolean" - }, - "is_range": { - "description": "Returns `true` if the submitted text is a a ranging ref (one that spans multiple sections or segments.) e.g. (Genesis 4-5)", - "type": "boolean" - }, - "type": { - "enum": [ - "ref", - "Topic", - "AuthorTopic", - "PersonTopic", - "User" - ], - "type": "string" - }, - "ref": { - "description": "If `is_ref` is `true`, this returns the cannonical ref for the submitted text.", - "type": "string" - }, - "url": { - "description": "If `is_ref` is `true`, this returns the URL path to link to the submitted text on Sefaria.org", - "type": "string" - }, - "index": { - "description": "If `is_ref` is `true`, this returns the cannonical name of the `index` of the submitted text.", - "type": "string" - }, - "book": { - "description": "If the submitted response is a ref, this returns the book it belonhs to.", - "type": "string" - }, - "internalSections": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "internalToSections": { - "type": "array", - "items": { - "format": "int32", - "type": "integer" - } - }, - "sections": { - "type": "array", - "items": { - "type": "string" - } - }, - "toSections": { - "type": "array", - "items": { + "description": "A list of JSON objects, each object representing a topic in the Sefaria database. Please note, since this list is over 30,000 topics long, in the example we only presented the first several topics that are returned in the array. " + } + }, + "summary": "Topics API", + "description": "The topics API returns a list of JSON objects, each object containing all of the metadata for each topic in the Sefaria database. " + } + }, + "/api/calendars/next-read/{parasha}": { + "get": { + "parameters": [ + { + "name": "parasha", + "description": "One of the 54 weekly Torah Parasha names in English or one of the 7 double parshiyot.", + "schema": { + "enum": [ + "Bereshit", + "Noach", + "Lech-Lecha", + "Vayera", + "Chayei Sara", + "Toldot", + "Vayetzei", + "Vayishlach", + "Vayeshev", + "Miketz", + "Vayigash", + "Vayechi", + "Shemot", + "Vaera", + "Bo", + "Beshalach", + "Yitro", + "Mishpatim", + "Terumah", + "Tetzaveh", + "Ki Tisa", + "Vayakhel", + "Pekudei", + "Vayikra", + "Tzav", + "Shmini", + "Tazria", + "Metzora", + "Achrei Mot", + "Kedoshim", + "Emor", + "Behar", + "Bechukotai", + "Bamidbar", + "Nasso", + "Beha’alotcha", + "Sh’lach", + "Korach", + "Chukat", + "Balak", + "Pinchas", + "Matot", + "Masei", + "Devarim", + "Vaetchanan", + "Eikev", + "Re’eh", + "Shoftim", + "Ki Teitzei", + "Ki Tavo", + "Nitzavim", + "Vayeilech", + "Ha’azinu", + "Vezot Haberakhah", + "Vayakhel-Pekudei", + "Tazria-Metzora", + "Achrei Mot-Kedoshim", + "Behar-Bechukotai", + "Chukat-Balak", + "Matot-Masei", + "Nitzavim-Vayeilech" + ], "type": "string" + }, + "in": "path", + "required": true + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CalendarNextReadAPI" + } + } + }, + "description": "Successful Response" + } + }, + "summary": "Parasha Next Read API", + "description": "Given a Parasha name in English, this API returns the next Hebrew and English dates that it is read, along with details about the Torah and Haftarah readings for that date." + } + }, + "/api/index/": { + "get": { + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/APIIndexResponse" + } + } + }, + "description": "Successful Response" + } + }, + "summary": "Table of Contents API", + "description": "This API endpoint returns the titles of all the books in the Sefaria Library arranged by their category along with some additional metadata. This is a large and rarely changing request and should be cached locally if you utilize it." + } + }, + "/api/search-wrapper": { + "post": { + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/SearchPOSTData" + } } }, - "examples": { - "type": "array", - "items": {} - }, - "sectionNames": { - "description": "Given a reference, this returns the names of the sections and segments at each depth of that text.", - "type": "array", - "items": { + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/searchResponse" + } + } + }, + "description": "Successful Response" + } + }, + "summary": "Search API", + "description": "An [elastic search](https://www.elastic.co/guide/en/elasticsearch/reference/current/) endpoint for Sefaria's data. Given a properly formated POST request this endpoint will return search results for appropriate Sefaria records." + } + }, + "/api/img-gen/{tref}": { + "get": { + "parameters": [ + { + "name": "lang", + "description": "The language the social image should return. ", + "schema": { + "enum": [ + "he", + "en" + ], "type": "string" - } + }, + "in": "query" }, - "heSectionNames": { - "description": "Given a reference, this returns the names of the sections and segments at each depth of that text in Hebrew.", - "type": "array", - "items": { + { + "name": "platform", + "description": "This value determines the size of the image, set to the platform's ideal as specified in their own developer documentation.", + "schema": { + "enum": [ + "facebook", + "twitter" + ], "type": "string" - } + }, + "in": "query" }, - "addressExamples": { - "description": "Given a partial ref, this will return an array of strings of possible ways that it might be completed.", - "type": "array", - "items": { + { + "name": "ven", + "description": "The version title we want the English text to return from.", + "schema": { "type": "string" - } + }, + "in": "query" }, - "heAddressExamples": { - "description": "Given a partial ref, this will return an array of hebrew strings of possible ways that it might be completed.", - "type": "array", - "items": { + { + "name": "vhe", + "description": "The version title we want the Hebrew text to return from.", + "schema": { "type": "string" - } + }, + "in": "query" } - }, - "example": { - "lang": "en", - "is_ref": true, - "completions": [ - "Job", - "Rashi on Job", - "Rashi on Amos", - "Rashi on Arachin", - "Rashi on Beiah", - "Rashi on Bechorot", - "Rashi on Berachoth", - "Rashi on Chag.", - "Rashi on Hullin", - "Rashi on Dan." - ], - "completion_objects": [ - { - "title": "Job", - "key": "Job", - "type": "ref", - "is_primary": true, - "order": 1000000 + ], + "responses": { + "200": { + "content": { + "image/png": {} }, - { - "title": "Job", - "type": "Topic", - "key": "job-and-his-friends", - "is_primary": false, - "order": 4999978 + "description": "Successful Response" + } + }, + "summary": "Social Img API", + "description": "Given a Sefaria text reference and some other optional params, this endpoint returns a png image ready to share on social. On Sefaria.org we use it primarily to auto-generate social images for any page." + }, + "parameters": [ + { + "name": "tref", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true + } + ] + }, + "/api/texts/translations": { + "get": { + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "type": "string" + } + }, + "examples": { + "translationEx": { + "value": [ + "ar", + "cs", + "de", + "en", + "eo", + "es", + "fa", + "fi", + "fr", + "he", + "hu", + "it", + "ko", + "pl", + "pt", + "ru", + "yi" + ] + } + } + } }, - { - "title": "Rashi on Job", - "key": "Rashi on Job", - "type": "ref", - "is_primary": true, - "order": 1000000 + "description": "Successful Response" + } + }, + "summary": "Translations Available API", + "description": "Returns a list of distinct languages for which translations exist in the database." + } + }, + "/api/texts/translations/{lang}": { + "get": { + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "title": { + "description": "Title of the book on Sefaria", + "type": "string" + }, + "url": { + "description": "Base URL of the book on Sefaria", + "type": "string" + }, + "versionTitle": { + "description": "Title of this specific translation of the title", + "type": "string" + }, + "rtlLanguage": { + "description": "Is this version a RTL text (i.e. `he`) or LTR text (i.e. `en`)", + "enum": [ + "he", + "en" + ], + "type": "string" + } + } + } + } }, - { - "title": "Rashi on Amos", - "key": "Rashi on Amos", - "type": "ref", - "is_primary": true, - "order": 1000000 + "description": "Successful Response" + } + }, + "summary": "Translations for Language API", + "description": "Returns a dictionary of texts translated into `lang`, organized by the Sefaria category & secondary category of each title." + }, + "parameters": [ + { + "examples": { + "en": { + "value": "en" }, - { - "title": "Rashi on Arachin", - "key": "Rashi on Arakhin", - "type": "ref", - "is_primary": false, - "order": 1000000 + "he": { + "value": "he" }, - { - "title": "Rashi on Beiah", - "key": "Rashi on Beitzah", - "type": "ref", - "is_primary": false, - "order": 1000000 - }, - { - "title": "Rashi on Bechorot", - "key": "Rashi on Bekhorot", - "type": "ref", - "is_primary": false, - "order": 1000000 + "yi": { + "value": "yi" + } + }, + "name": "lang", + "description": "An ISO 639-1 language code.", + "schema": { + "type": "string" + }, + "in": "path", + "required": true + } + ] + }, + "/api/links/{ref}": { + "get": { + "parameters": [ + { + "name": "ref", + "schema": { + "$ref": "#/components/schemas/ref" }, - { - "title": "Rashi on Berachoth", - "key": "Rashi on Berakhot", - "type": "ref", - "is_primary": false, - "order": 1000000 + "in": "path", + "required": true + }, + { + "name": "with_text", + "description": "`with_text` is an optional parameter that determines whether or not the API response will include the text of any connected links. It's default is `1`", + "schema": { + "type": "boolean" }, - { - "title": "Rashi on Chag.", - "key": "Rashi on Chagigah", - "type": "ref", - "is_primary": false, - "order": 1000000 + "in": "query" + }, + { + "name": "with_sheet_links", + "description": "`with_sheet_links` is an optional parameter that determines whether or not the API response will include links to user generated source sheets from Sefaria. It's default is `0`", + "schema": { + "type": "boolean" }, - { - "title": "Rashi on Hullin", - "key": "Rashi on Chullin", - "type": "ref", - "is_primary": false, - "order": 1000000 + "in": "query" + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/LinkObj" + } + } + } }, - { - "title": "Rashi on Dan.", - "key": "Rashi on Daniel", - "type": "ref", - "is_primary": false, - "order": 1000000 - } - ], - "is_book": false, - "is_node": false, - "is_section": false, - "is_segment": true, - "is_range": false, - "type": "ref", - "ref": "Rashi on Job 1:3:3", - "url": "Rashi_on_Job.1.3.3", - "index": "Rashi on Job", - "book": "Rashi on Job", - "internalSections": [ - 1, - 3, - 3 - ], - "internalToSections": [ - 1, - 3, - 3 - ], - "sections": [ - "1", - "3", - "3" - ], - "toSections": [ - "1", - "3", - "3" - ], - "examples": [], - "sectionNames": [ - "Chapter", - "Verse", - "Comment" - ], - "heSectionNames": [ - "פרק", - "פסוק", - "פירוש" - ], - "addressExamples": [ - "3", - "6", - "9" - ], - "heAddressExamples": [ - "ג׳", - "ו׳", - "ט׳" - ] + "description": "Successful response" + } + }, + "summary": "Links API", + "description": "Returns a list of known connections for the submitted text `ref` along with some additional metadata." + }, + "parameters": [ + { + "name": "ref", + "schema": { + "$ref": "#/components/schemas/ref" + }, + "in": "path", + "required": true } + ] + }, + "/api/v3/texts/{tref}": { + "summary": "v3 Texts", + "description": "The most up-to-date way to retrieve Sefaria texts, with language data that can handle displaying a right-to-left text with a right-to-left translation. ", + "get": { + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/v3TextsJson" + }, + "examples": { + "Esther 1.1": { + "value": { + "versions": [ + { + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah", + "text": "וַיְהִ֖י בִּימֵ֣י אֲחַשְׁוֵר֑וֹשׁ ה֣וּא אֲחַשְׁוֵר֗וֹשׁ הַמֹּלֵךְ֙ מֵהֹ֣דּוּ וְעַד־כּ֔וּשׁ שֶׁ֛בַע וְעֶשְׂרִ֥ים וּמֵאָ֖ה מְדִינָֽה׃" + } + ], + "available_versions": [ + { + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah" + }, + { + "status": "locked", + "priority": 2, + "license": "CC-BY-NC", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "JPS, 1985", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS_1985.png", + "purchaseInformationURL": "https://www.nebraskapress.unl.edu/jps/9780827602526/", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://jps.org/books/tanakh-the-holy-scriptures-blue/", + "versionTitle": "Tanakh: The Holy Scriptures, published by JPS" + }, + { + "status": "locked", + "priority": 1, + "license": "Public Domain", + "versionNotes": "This 1917 translation by the Jewish Publication Society is in the public domain. JPS graciously shared digital images of this text with the Open Siddur Project, from which the text was imported by Sefaria.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "כתבי הקודש: תרגום חדש (1917 JPS)", + "versionNotesInHebrew": "תרגום JPS 1917 קיים בנחלת הכלל. הסריקות באדיבות JPS. שעתוק הטקסט תודות לפרויקט Open Siddur, משם יובא הטקסט למאגר ספריא", + "shortVersionTitle": "JPS 1917", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://opensiddur.org/2010/08/%D7%AA%D7%A0%D7%B4%D7%9A-the-holy-scriptures-a-new-translation-jps-1917/", + "versionTitle": "The Holy Scriptures: A New Translation (JPS 1917)" + }, + { + "status": "locked", + "priority": 1, + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תנ״ך מלווה בטעמי מקרא", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.tanach.us/Tanach.xml", + "versionTitle": "Tanach with Ta'amei Hamikra" + }, + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תנ״ך - טקסט בלבד", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.tanach.us/Tanach.xml", + "versionTitle": "Tanach with Text Only" + }, + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תנ״ך עם ניקוד", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.tanach.us/Tanach.xml", + "versionTitle": "Tanach with Nikkud" + }, + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "תרגום קהילת ספריא", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Sefaria Community Translation" + }, + { + "status": "locked", + "priority": "", + "license": "CC-BY", + "versionNotes": "To enhance the quality of this text, obvious translation errors were corrected in accordance with the Hebrew source", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "כתובים' על פי רש״י, רבי שרגא זילברשטיין", + "versionNotesInHebrew": "כדי לשפר את איכות הטקסט הזה, שונו שגיאות תרגום ברורות בהתאם למקור העברי", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://www.sefaria.org/shraga-silverstein", + "versionTitle": "The Rashi Ketuvim by Rabbi Shraga Silverstein" + }, + { + "status": "locked", + "priority": "", + "license": "CC-BY-NC", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/9f4b3fedfe5a8889a3a7b3b7f3022091.png", + "purchaseInformationURL": "https://korenpub.com/collections/tanakh", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.korenpub.com/koren_en_usd/koren/tanakh-bible/the-koren-jerusalem-bible.html", + "versionTitle": "The Koren Jerusalem Bible" + }, + { + "status": "locked", + "priority": "", + "license": "CC-BY", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/958565938f3a7ed617834d467ac93c9f.png", + "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.judaicaplace.com/search/brand/Metsudah-Publications/", + "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001" + }, + { + "status": "locked", + "priority": "", + "license": "CC-BY", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "חמש מגילות, הוצאת 'מצודה', לייקווד תשס\"א", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/232433ac3323606604f21e0c70f0c061.png", + "purchaseInformationURL": "https://www.israelbookshoppublications.com/store/pc/Metsudah-Five-Megilloth-w-Rashi-26p309.htm", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://www.judaicaplace.com/search/brand/Metsudah-Publications/", + "versionTitle": "The Metsudah Five Megillot, Lakewood, N.J., 2001" + }, + { + "status": "locked", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מגילת אסתר - מהדורה פורימית!!", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Megillat Esther - Purim Edition!!" + }, + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fr", + "languageFamilyName": "french", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://fr.wikisource.org/wiki/Bible_du_Rabbinat_1899", + "versionTitle": "Bible du Rabbinat 1899 [fr]" + }, + { + "status": "", + "priority": "", + "license": "CC0", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מגילת אמוג'י", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Emoji Megillah" + }, + { + "status": "", + "priority": "", + "license": "CC0", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.sefaria.org", + "versionTitle": "Emoji Megillah" + }, + { + "status": "", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Izaak Cylkow, 1841 - 1908 ", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "pl", + "languageFamilyName": "polish", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://bibliepolskie.pl/", + "versionTitle": "Bible in Polish, trans. Izaak Cylkow, 1841 - 1908 [pl]" + }, + { + "status": "", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "it", + "languageFamilyName": "italian", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://www.archivio-torah.it", + "versionTitle": "Ester. Traduzione italiana di Samuel David Luzzatto, 1872 [it]" + }, + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fa", + "languageFamilyName": "persian", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://www.iranjewish.com/megilla/megilla_main.htm", + "versionTitle": "Book of Esther in Farsi, trans. by Pole-Choubi, synagogue Talmood Torah [fa]" + }, + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fa", + "languageFamilyName": "persian", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "http://www.iranjewish.com/megilla/megilla_main.htm", + "versionTitle": "Book of Esther in Farsi, trans. by Pole-Choubi, synagogue Talmood Torah, LTR [fa]" + }, + { + "status": "", + "priority": "", + "license": "Public Domain", + "versionNotes": "This 1941 translation published by Yehoʼash Farlag Gezelshaft is in the public domain. A transcribed digitized version was produced by Itsik \"Robert\" Goldenberg, et al, by the Yehoyesh Project (1998-2006) under the direction of Leonard Prager. That version was graciously shared with the Open Siddur Project, from which the text was imported by Sefaria.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "yi", + "languageFamilyName": "yiddish", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "http://opensiddur.org/praxes/study/yehoyeshs-yiddish-translation-of-the-tanakh/", + "versionTitle": "Yehoyesh's Yiddish Tanakh Translation [yi]" + }, + { + "status": "locked", + "priority": "", + "license": "", + "versionNotes": "Translator: Marion Kaufmann, based on german translations of Tur-Sinai, Martín Buber and Franz Rosenzwig
Review and correction: Manes Kogan
Final Review: Batia Dorfman", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "es", + "languageFamilyName": "spanish", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.seminariorabinico.org/wp-content/uploads/El-libro-de-Ester-Meguila-Ester.pdf", + "versionTitle": "El libro de Ester - Meguila Ester - Seminario Rabínico [es]" + }, + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Samuel Cahen, 1831 ", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "fr", + "languageFamilyName": "french", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.levangile.com/Bible-CAH-1-1-1-complet-Contexte-oui.htm", + "versionTitle": "La Bible, Traduction Nouvelle, Samuel Cahen, 1831 [fr]" + }, + { + "status": "locked", + "priority": "", + "license": "Public Domain", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "eo", + "languageFamilyName": "esperanto", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://eo.wikisource.org/wiki/Malnova_Testamento_(Zamenhof)/Ester/1", + "versionTitle": "La Malnova Testamento, L.L.Zamenhof [eo]" + }, + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "Digitized by Chajm Guski and Marina Struse", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "de", + "languageFamilyName": "german", + "isBaseText": false, + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://www.talmud.de/tlmd/tanach/", + "versionTitle": "Die Heilige Schrift, trans. Dr. Simon Bernfeld, Berlin, 1902 - German [de]" + }, + { + "status": "locked", + "priority": "", + "license": "PD", + "versionNotes": "", + "formatAsPoetry": "", + "digitizedBySefaria": true, + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": "", + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "title": "Esther", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A7%D7%A8%D7%90_%D7%9E%D7%91%D7%95%D7%90%D7%A8", + "versionTitle": "Miqra Mevoar, trans. and edited by David Kokhav, Jerusalem 2020" + }, + { + "status": "", + "priority": "", + "license": "", + "versionNotes": "Read the Preface to the Revised JPS Edition\n

\nRead the Notes on Gender in Translation for the Revised JPS Edition\n

\nRead a Commentary on the Hebrew word 'ish in the Revised JPS Edition", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Revised JPS, 2023", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS-Tanakh-Gender-Sensitive-Edition-Cover-300x450.jpg", + "purchaseInformationURL": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": "", + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Esther", + "versionSource": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "versionTitle": "THE JPS TANAKH: Gender-Sensitive Edition" + } + ], + "ref": "Esther 1:1", + "heRef": "אסתר א׳:א׳", + "sections": [ + "1", + "1" + ], + "toSections": [ + "1", + "1" + ], + "sectionRef": "Esther 1", + "heSectionRef": "אסתר א׳", + "firstAvailableSectionRef": "Esther 1:1", + "isSpanning": false, + "spanningRefs": [ + "Esther 1:1" + ], + "next": "Esther 2", + "title": "Esther 1", + "book": "Esther", + "heTitle": "אסתר", + "primary_category": "Tanakh", + "type": "Tanakh", + "indexTitle": "Esther", + "categories": [ + "Tanakh", + "Writings" + ], + "heIndexTitle": "אסתר", + "isComplex": false, + "isDependant": false, + "order": [ + 34, + 8 + ], + "collectiveTitle": "", + "heCollectiveTitle": "", + "alts": [], + "lengths": [ + 10, + 167 + ], + "length": 10, + "textDepth": 2, + "sectionNames": [ + "Chapter", + "Verse" + ], + "addressTypes": [ + "Perek", + "Pasuk" + ], + "titleVariants": [ + "Est.", + "Est", + "Ester", + "Esth.", + "Esth", + "Esther" + ], + "heTitleVariants": [ + "מגילת אסתר", + "אסתר" + ], + "index_offsets_by_depth": {}, + "warnings": [] + } + } + } + } + }, + "description": "Successful retrieval of the desired texts." + } + }, + "summary": "v3 Texts API", + "description": "The most up-to-date way to retrieve texts from Sefaria via the API, with enhanced control over language, language direction, and other parameters. " }, - "dictionaryEntry": { - "title": "Root Type for dictionaryEntry", - "description": "A single dictionary entry on Sefaria.", - "type": "object", - "properties": { - "headword": { - "description": "The main word in the lexicon entry. The one you would look up in the book version.", - "type": "string" + "parameters": [ + { + "examples": { + "language": { + "value": "hebrew" + }, + "language|version": { + "value": "hebrew|Miqra according to the Masorah" + } }, - "parent_lexicon": { - "description": "Name of the lexicon from which the entry comes from.", + "name": "version", + "description": "There are two possible forms for the string passed as the `version`:\n1. `language`\n2. `language|versionTitle`\n\nWhen in the form of `language`, all versions in that language are returned in the `versions` field of the response object. When in the form of `language>|
\nRead the preface to The Contemporary Torah\n

\n See the Dictionary of Gender in the Torah", + "digitizedBySefaria": "", + "priority": 7, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "תרומה אלמונית לכבוד כל הנשים והבנות שלומדות, מלמדות ונותנות צורה חדשה לתורה", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://jps.org/wp-content/uploads/2014/10/ContemporaryTorah-300x458.png", + "purchaseInformationURL": "https://jps.org/books/contemporary-torah/", + "shortVersionTitle": "The Contemporary Torah, JPS, 2006", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Genesis 1" } }, - "JastrowDictionaryEntry": { - "title": "JastrowDictionaryEntry", - "description": "An entry from Jastrow’s Dictionary,", + "nameAPIResponse": { + "title": "Root Type for nameAPIResponse", + "description": "Full response of the Name API", "type": "object", - "allOf": [ - { - "$ref": "#/components/schemas/dictionaryEntry" - } - ], "properties": { - "rid": { - "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" + "lang": { + "description": "The language of the completion results.", + "enum": [ + "en", + "he" + ], + "type": "string" }, - "quotes": { - "description": "" + "is_ref": { + "description": "Returns `true` if the submitted text is a valid Sefaria textual reference", + "type": "boolean" }, - "refs": { - "description": "Cross references to selections in the Sefaria library.", + "completions": { + "description": "A list of autocompletion responses for the submitted text.", "type": "array", "items": { - "$ref": "#/components/schemas/ref" + "type": "string" } }, - "prev_hw": { - "description": "The previous headword entry from the book." - }, - "next_hw": { - "description": "The next headword entry from the book." - }, - "plural_form": { - "description": "The plural form of the headword." - }, - "language_reference": { - "description": "" - }, - "language_code": { - "description": "A string containing the following characters `h.` (Hebrew), `b. h.` (Biblical Hebrew) `ch.` or `Ch.` (Chaldean) indicating the source language of the entry." - }, - "alt_headwords": { - "description": "An array of alternate headwords for the entry. Symbolized in print as those headwords separated by commas after the initial entry.", + "completion_objects": { + "description": "A list of autocompletion response objects for the submitted text along with some information about them.", "type": "array", "items": { - "type": "string" - } - }, - "content": { - "description": "", - "type": "object", - "properties": { - "senses": { - "type": "array", - "items": { - "$ref": "#/components/schemas/SenseJastrowDictionaryEntry" + "type": "object", + "properties": { + "title": { + "type": "string" + }, + "key": { + "type": "string" + }, + "type": { + "type": "string" + }, + "is_primary": { + "type": "boolean" + }, + "order": { + "format": "int32", + "type": "integer" } - }, - "morphology": { - "description": "A description of the morphological form of the word, one of `m., m. pl., f., f. pl., pr. n., pr. n. pl., pr. n. f., pr. n. m., pron., pers. pron.`", - "type": "string" } - } - } - } - }, - "textAPIReponse": { - "title": "Root Type for textAPIReponse", - "description": "Expected reponse data from Sefaria's Text API", - "type": "object", - "properties": { - "ref": { - "$ref": "#/components/schemas/ref" + }, + "example": "[{\n \"title\": \"Ruth\",\n \"key\": \"Ruth\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth Rabbah\",\n \"key\": \"Ruth Rabbah\",\n \"type\": \"ref\",\n \"is_primary\": true,\n \"order\": 1000000\n }, {\n \"title\": \"Ruth\",\n \"type\": \"PersonTopic\",\n \"key\": \"ruth\",\n \"is_primary\": true,\n \"order\": 4999550\n }, {\n \"title\": \"Ruach Hakodesh\",\n \"type\": \"Topic\",\n \"key\": \"ruach-hakodesh1\",\n \"is_primary\": true,\n \"order\": 4999902\n }, {\n \"title\": \"Ruach\",\n \"type\": \"Topic\",\n \"key\": \"ruach1\",\n \"is_primary\": true,\n \"order\": 4999949\n }, {\n \"title\": \"Rubissa Sharona Hassan\",\n \"type\": \"User\",\n \"key\": \"sharona-hassan\",\n \"pic\": \"https://storage.googleapis.com/sefaria-profile-pictures/sharona-hassan-1622999139-small.png\",\n \"order\": 6999998,\n \"is_primary\": true\n }]" }, - "heRef": { - "$ref": "#/components/schemas/ref" + "is_book": { + "description": "Returns `true` if the submitted text is a book level reference. e.g. (Genesis)", + "type": "boolean" }, - "isComplex": { - "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its Index, and the way the data is stored. For more on complex texts, see the documentation here.", + "is_node": { + "description": "Returns true if the submitted text is a `node` in a complex text.", "type": "boolean" }, - "text": { - "oneOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "array", - "items": { - "type": "string" - } - } - }, - { - "type": "array", - "items": { - "type": "string" - } - } - ], - "description": "The default, or specified text written in LTR characters for the query (Usually English). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text." + "is_section": { + "description": "Returns `true` if the submitted text is a section ref. (e.g. Genesis 4)", + "type": "boolean" }, - "he": { - "oneOf": [ - { - "type": "array", - "items": { - "type": "string" - } - }, - { - "type": "string" - } + "is_segment": { + "description": "Returns `true` if the submitted text is a segment level reference (e.g. Genesis 43:3)", + "type": "boolean" + }, + "is_range": { + "description": "Returns `true` if the submitted text is a a ranging ref (one that spans multiple sections or segments.) e.g. (Genesis 4-5)", + "type": "boolean" + }, + "type": { + "enum": [ + "ref", + "Topic", + "AuthorTopic", + "PersonTopic", + "User" ], - "description": "The default, or specified text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text." + "type": "string" }, - "versions": { - "type": "array", - "items": { - "$ref": "#/components/schemas/versionData" - } + "ref": { + "description": "If `is_ref` is `true`, this returns the cannonical ref for the submitted text.", + "type": "string" }, - "textDepth": { - "format": "int32", - "type": "integer" + "url": { + "description": "If `is_ref` is `true`, this returns the URL path to link to the submitted text on Sefaria.org", + "type": "string" }, - "sectionNames": { - "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", - "type": "array", - "items": { - "type": "string" - } + "index": { + "description": "If `is_ref` is `true`, this returns the cannonical name of the `index` of the submitted text.", + "type": "string" }, - "addressTypes": { - "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", + "book": { + "description": "If the submitted response is a ref, this returns the book it belonhs to.", + "type": "string" + }, + "internalSections": { "type": "array", "items": { - "type": "string" + "format": "int32", + "type": "integer" } }, - "lengths": { + "internalToSections": { "type": "array", "items": { "format": "int32", "type": "integer" } }, - "length": { - "format": "int32", - "type": "integer" - }, - "heTitle": { - "type": "string" - }, - "titleVariants": { + "sections": { "type": "array", "items": { "type": "string" } }, - "heTitleVariants": { + "toSections": { "type": "array", "items": { "type": "string" } }, - "type": { - "type": "string" - }, - "primary_category": { - "type": "string" - }, - "book": { - "description": "The title of the book that the response comes from.", - "type": "string" + "examples": { + "type": "array", + "items": {} }, - "categories": { - "description": "A list of categories that a text belongs to. ", + "sectionNames": { + "description": "Given a reference, this returns the names of the sections and segments at each depth of that text.", "type": "array", "items": { "type": "string" } }, - "order": { + "heSectionNames": { + "description": "Given a reference, this returns the names of the sections and segments at each depth of that text in Hebrew.", "type": "array", "items": { - "format": "int32", - "type": "integer" + "type": "string" } }, - "sections": { - "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", + "addressExamples": { + "description": "Given a partial ref, this will return an array of strings of possible ways that it might be completed.", "type": "array", "items": { - "format": "int32", - "type": "integer" + "type": "string" } }, - "toSections": { + "heAddressExamples": { + "description": "Given a partial ref, this will return an array of hebrew strings of possible ways that it might be completed.", "type": "array", "items": { - "format": "int32", - "type": "integer" + "type": "string" } - }, - "isDependant": { - "type": "boolean" - }, - "indexTitle": { - "type": "string" - }, - "heIndexTitle": { - "type": "string" - }, - "sectionRef": { - "$ref": "#/components/schemas/ref" - }, - "firstAvailableSectionRef": { - "type": "string" - }, - "heSectionRef": { - "$ref": "#/components/schemas/ref" - }, - "isSpanning": { - "type": "boolean" - }, - "versionTitle": { - "type": "string" - }, - "versionTitleInHebrew": { - "type": "string" - }, - "shortVersionTitle": { - "type": "string" - }, - "shortVersionTitleInHebrew": { - "type": "string" - }, - "versionSource": { - "type": "string" - }, - "versionStatus": { - "type": "string" - }, - "versionNotes": { - "type": "string" - }, - "extendedNotes": { - "type": "string" - }, - "extendedNotesHebrew": { - "type": "string" - }, - "versionNotesInHebrew": { - "type": "string" - }, - "digitizedBySefaria": { - "description": "Was the `text` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", - "type": "boolean" - }, - "license": { - "type": "string" - }, - "formatEnAsPoetry": { - "type": "boolean" - }, - "heVersionTitle": { - "type": "string" - }, - "heVersionTitleInHebrew": { - "type": "string" - }, - "heShortVersionTitle": { - "type": "string" - }, - "heShortVersionTitleInHebrew": { - "type": "string" - }, - "heVersionSource": { - "type": "string" - }, - "heVersionStatus": { - "type": "string" - }, - "heVersionNotes": { - "type": "string" - }, - "heExtendedNotes": { - "type": "string" - }, - "heExtendedNotesHebrew": { - "type": "string" - }, - "heVersionNotesInHebrew": { - "type": "string" - }, - "heDigitizedBySefaria": { - "description": "Was the `he` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", - "type": "boolean" - }, - "heLicense": { - "type": "string" - }, - "formatHeAsPoetry": { - "type": "boolean" - }, - "alts": { - "type": "array", - "items": {} - }, - "index_offsets_by_depth": { - "type": "object" - }, - "next": { - "nullable": true, - "description": "Next segment reference in sequence, if last ref, field will be `null`.", - "type": "string" - }, - "prev": { - "nullable": true, - "description": "Previous segment reference in sequence, if first ref, field will be `null`.", - "type": "string" - }, - "commentary": { - "type": "array", - "items": {} - }, - "sheets": { - "type": "array", - "items": {} - }, - "layer": { - "type": "array", - "items": {} } }, "example": { - "ref": "Mishnah Peah 4:2", - "heRef": "משנה פאה ד׳:ב׳", - "isComplex": false, - "text": [ - "Peah is given from [the crop] while it is still connected with the soil. But in the case of hanging vine-branches and the date-palm, the owner brings down [the fruit] and distributes it among the poor. Rabbi Shimon says: the same applies to smooth nut trees. Even if ninety-nine [of the poor] say [to the owner] to distribute it and one says to leave it in the field, this latter is listened to, since he spoke in accordance with the halakhah.", - "With hanging vine-branches and date-palm trees it is not so; even if ninety-nine [of the poor] say [to the owner] to leave it in the field and one says to distribute it, this latter is listened to, since he spoke in accordance with the halakhah.", - "If [a poor man] took some of the peah [already collected] and threw it onto the remainder [not yet collected], he gets none of it. If he fell down upon it, or spread his cloak over it, they take the peah away from him. The same applies to gleanings and the forgotten sheaf.", - "[The poor] may not harvest peah with scythes or tear it out [of the ground] with spades, so that they might not strike one another [with these implements].", - "There are three times a day [the poor] make a search [in the field for peah]: morning, noon, and sunset. Rabban Gamaliel says: these [times] were only set lest they reduce them. Rabbi Akiva says: these were set lest they add to them. [The men] of Bet Namer used to have the poor harvest [the peah] with the aid of a rope, and they left peah at the end of each furrow.", - "A non-Jew who harvested his field and then converted, he is exempt from [leaving] gleanings, the forgotten sheaf and peah. Rabbi Judah makes him liable to leave the forgotten sheaf, since he becomes liable for the forgotten sheaf at the time of their binding.", - "One who dedicated standing grain [to the Temple] and then redeemed it while it was still standing grain, he is liable [to give the agricultural gifts to the poor]. [If he dedicated] sheaves and redeemed them while they were still sheaves, he is liable. [If he dedicated] standing grain and redeemed it [when it was already in] sheaves, he is exempt, since at the time when it became liable it was exempt.", - "Similarly one who dedicates his produce prior to the stage when they are subject to tithes and then redeemed them, they are liable [to be tithed]. If [he dedicated them] when they had already become subject to tithes and then redeemed them, they are liable [to be tithed]. If he dedicated them before they had ripened, and they became ripe while in the possession of the [Temple] treasurer, and he then redeemed them, they are exempt, since at the time when they would have been liable, they were exempt.", - "One who collected peah and said, “This is for so-and-so a poor man:” Rabbi Eliezer says: he has thus acquired it for him. The sages say: he must give it to the first poor man he finds. Gleanings, the forgotten sheaf and the peah of non-Jews are subject to tithes, unless he [the non-Jew] had declared them ownerless.", - "What are gleanings? That which falls down at the time of harvesting. If while he was harvesting, he harvested a handful, or plucked a fistful, and then a thorn pricked him, and what he had in his hand fell to the ground, it still belongs to the owner. [That which drops from] inside the hand or the sickle [belongs] to the poor, but [that which falls from] the back of the hand or the sickle [belongs] to the owner. [That which falls from] the top of the hand or sickle: Rabbi Ishmael says: to the poor; But Rabbi Akiva says: to the owner.", - "[Grain found in] ant holes where the stalks are still standing, behold it still belongs to the owner. After the harvesters [had passed over them], those found in the top parts [of the ant holes belong] to the poor, but [those found] on the bottom parts [belong] to the owner. Rabbi Meir says: it all belongs to the poor, for gleanings about which there is any doubt are regarded as gleanings." - ], - "he": [ - "הַפֵּאָה נִתֶּנֶת בִּמְחֻבָּר לַקַּרְקָע. בְּדָלִית וּבְדֶקֶל, בַּעַל הַבַּיִת מוֹרִיד וּמְחַלֵּק לָעֲנִיִּים. רַבִּי שִׁמְעוֹן אוֹמֵר, אַף בַּחֲלִיקֵי אֱגוֹזִים. אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לְחַלֵּק וְאֶחָד אוֹמֵר לָבוֹז, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", - "בְּדָלִית וּבְדֶקֶל אֵינוֹ כֵן, אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לָבוֹז וְאֶחָד אוֹמֵר לְחַלֵּק, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", - "נָטַל מִקְצָת פֵּאָה וּזְרָקָהּ עַל הַשְּׁאָר, אֵין לוֹ בָהּ כְּלוּם. נָפַל לוֹ עָלֶיהָ, וּפֵרֵשׂ טַלִּיתוֹ עָלֶיהָ, מַעֲבִירִין אוֹתָהּ הֵימֶנּוּ. וְכֵן בְּלֶקֶט, וְכֵן בְּעֹמֶר הַשִּׁכְחָה: \n", - "פֵּאָה אֵין קוֹצְרִין אוֹתָהּ בְּמַגָּלוֹת, וְאֵין עוֹקְרִין אוֹתָהּ בְּקַרְדֻּמּוֹת, כְּדֵי שֶׁלֹּא יַכּוּ אִישׁ אֶת רֵעֵהוּ: \n", - "שָׁלשׁ אַבְעָיוֹת בַּיּוֹם, בַּשַּׁחַר וּבַחֲצוֹת וּבַמִּנְחָה. רַבָּן גַּמְלִיאֵל אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יִפְחֲתוּ. רַבִּי עֲקִיבָא אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יוֹסִיפוּ. שֶׁל בֵּית נָמֵר הָיוּ מְלַקְּטִין עַל הַחֶבֶל, וְנוֹתְנִים פֵּאָה מִכָּל אֻמָּן וְאֻמָּן: \n", - "עוֹבֵד כּוֹכָבִים שֶׁקָּצַר אֶת שָׂדֵהוּ וְאַחַר כָּךְ נִתְגַּיֵּר, פָּטוּר מִן הַלֶּקֶט וּמִן הַשִּׁכְחָה וּמִן הַפֵּאָה. רַבִּי יְהוּדָה מְחַיֵּב בְּשִׁכְחָה, שֶׁאֵין הַשִּׁכְחָה אֶלָּא בִשְׁעַת הָעִמּוּר: \n", - "הִקְדִּישׁ קָמָה וּפָדָה קָמָה, חַיָּב. עֳמָרִין וּפָדָה עֳמָרִין, חַיָּב. קָמָה וּפָדָה עֳמָרִין, פְּטוּרָה, שֶׁבִּשְׁעַת חוֹבָתָהּ הָיְתָה פְטוּרָה: \n", - "כַּיּוֹצֵא בוֹ, הַמַּקְדִּישׁ פֵּרוֹתָיו עַד שֶׁלֹּא בָאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. מִשֶּׁבָּאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. הִקְדִּישָׁן עַד שֶׁלֹּא נִגְמְרוּ וּגְמָרָן הַגִּזְבָּר, וְאַחַר כָּךְ פְּדָאָן, פְּטוּרִים, שֶׁבִּשְׁעַת חוֹבָתָן הָיוּ פְטוּרִים: \n", - "מִי שֶׁלָּקַט אֶת הַפֵּאָה וְאָמַר הֲרֵי זוֹ לְאִישׁ פְּלוֹנִי עָנִי, רַבִּי אֱלִיעֶזֶר אוֹמֵר, זָכָה לוֹ. וַחֲכָמִים אוֹמְרִים, יִתְּנֶנָּה לֶעָנִי שֶׁנִּמְצָא רִאשׁוֹן. הַלֶּקֶט וְהַשִּׁכְחָה וְהַפֵּאָה שֶׁל עוֹבֵד כּוֹכָבִים חַיָּב בְּמַעַשְׂרוֹת, אֶלָּא אִם כֵּן הִפְקִיר: \n", - "אֵיזֶהוּ לֶקֶט, הַנּוֹשֵׁר בִּשְׁעַת הַקְּצִירָה. הָיָה קוֹצֵר, קָצַר מְלֹא יָדוֹ, תָּלַשׁ מְלֹא קֻמְצוֹ, הִכָּהוּ קוֹץ וְנָפַל מִיָּדוֹ לָאָרֶץ, הֲרֵי הוּא שֶׁל בַּעַל הַבָּיִת. תּוֹךְ הַיָּד וְתוֹךְ הַמַּגָּל, לָעֲנִיִּים. אַחַר הַיָּד וְאַחַר הַמַּגָּל, לְבַעַל הַבָּיִת. רֹאשׁ הַיָּד וְרֹאשׁ הַמַּגָּל, רַבִּי יִשְׁמָעֵאל אוֹמֵר, לָעֲנִיִּים. רַבִּי עֲקִיבָא אוֹמֵר, לְבַעַל הַבָּיִת: \n", - "חוֹרֵי הַנְּמָלִים שֶׁבְּתוֹךְ הַקָּמָה, הֲרֵי הֵן שֶׁל בַּעַל הַבָּיִת. שֶׁלְּאַחַר הַקּוֹצְרִים, הָעֶלְיוֹנִים לָעֲנִיִּים, וְהַתַּחְתּוֹנִים שֶׁל בַּעַל הַבָּיִת. רַבִּי מֵאִיר אוֹמֵר, הַכֹּל לָעֲנִיִּים, שֶׁסְּפֵק לֶקֶט, לֶקֶט: \n" + "lang": "en", + "is_ref": true, + "completions": [ + "Job", + "Rashi on Job", + "Rashi on Amos", + "Rashi on Arachin", + "Rashi on Beiah", + "Rashi on Bechorot", + "Rashi on Berachoth", + "Rashi on Chag.", + "Rashi on Hullin", + "Rashi on Dan." ], - "versions": [ + "completion_objects": [ { - "title": "Mishnah Peah", - "versionTitle": "Torat Emet 357", - "versionSource": "http://www.toratemetfreeware.com/index.html?downloads", - "language": "he", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 3, - "versionTitleInHebrew": "תורת אמת 357", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": true + "title": "Job", + "key": "Job", + "type": "ref", + "is_primary": true, + "order": 1000000 }, { - "title": "Mishnah Peah", - "versionTitle": "Mishnah, ed. Romm, Vilna 1913", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001741739", - "language": "he", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": true, - "priority": 2, - "versionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": true + "title": "Job", + "type": "Topic", + "key": "job-and-his-friends", + "is_primary": false, + "order": 4999978 }, { - "title": "Mishnah Peah", - "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", - "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", - "language": "en", - "status": "locked", - "license": "CC-BY", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": 1, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "Dr. Joshua Kulp", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "title": "Rashi on Job", + "key": "Rashi on Job", + "type": "ref", + "is_primary": true, + "order": 1000000 }, { - "title": "Mishnah Peah", - "versionTitle": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002378149/NLI", - "language": "en", - "status": "locked", - "license": "Public Domain", - "versionNotes": "Ordnung Seraïm, übers. und erklärt von Ascher Samter. 1887.
Ordnung Moed, von Eduard Baneth. 1887-1927.
Ordnung Naschim, von Marcus Petuchowski u. Simon Schlesinger. 1896-1933.
Ordnung Nesikin, von David Hoffmann. 1893-1898.
Ordnung Kodaschim, von John Cohn. 1910-1925.
Ordnung Toharot, von David Hoffmann, John Cohn und Moses Auerbach. 1910-1933.", - "digitizedBySefaria": true, - "priority": 0.5, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "title": "Rashi on Amos", + "key": "Rashi on Amos", + "type": "ref", + "is_primary": true, + "order": 1000000 }, { - "title": "Mishnah Peah", - "versionTitle": "Talmud Bavli. German. Lazarus Goldschmidt. 1929 [de]", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001042448/NLI", - "language": "en", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": true, - "priority": 0.25, - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "Lazarus Goldschmidt, 1929 ", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "title": "Rashi on Arachin", + "key": "Rashi on Arakhin", + "type": "ref", + "is_primary": false, + "order": 1000000 }, { - "title": "Mishnah Peah", - "versionTitle": "Open Mishnah", - "versionSource": "http://en.wikisource.org/wiki/Mishnah", - "language": "en", - "status": "locked", - "license": "CC-BY-SA", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "משנה פתוחה", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "title": "Rashi on Beiah", + "key": "Rashi on Beitzah", + "type": "ref", + "is_primary": false, + "order": 1000000 }, { - "title": "Mishnah Peah", - "versionTitle": "Le Talmud de Jérusalem, traduit par Moise Schwab, 1878-1890 [fr]", - "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002182155/NLI", - "language": "en", - "status": "locked", - "license": "Public Domain", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false + "title": "Rashi on Bechorot", + "key": "Rashi on Bekhorot", + "type": "ref", + "is_primary": false, + "order": 1000000 }, { - "title": "Mishnah Peah", - "versionTitle": "Mishnah based on the Kaufmann manuscript, edited by Dan Be'eri", - "versionSource": "https://archive.org/details/MishnaCorrectedKaufman00WHOLE", - "language": "he", - "status": "locked", - "license": "PD", - "versionNotes": "", - "digitizedBySefaria": true, - "priority": "", - "versionTitleInHebrew": "", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": "" + "title": "Rashi on Berachoth", + "key": "Rashi on Berakhot", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Chag.", + "key": "Rashi on Chagigah", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Hullin", + "key": "Rashi on Chullin", + "type": "ref", + "is_primary": false, + "order": 1000000 + }, + { + "title": "Rashi on Dan.", + "key": "Rashi on Daniel", + "type": "ref", + "is_primary": false, + "order": 1000000 } ], - "textDepth": 2, - "sectionNames": [ - "Chapter", - "Mishnah" - ], - "addressTypes": [ - "Perek", - "Mishnah" - ], - "lengths": [ - 8, - 69 + "is_book": false, + "is_node": false, + "is_section": false, + "is_segment": true, + "is_range": false, + "type": "ref", + "ref": "Rashi on Job 1:3:3", + "url": "Rashi_on_Job.1.3.3", + "index": "Rashi on Job", + "book": "Rashi on Job", + "internalSections": [ + 1, + 3, + 3 ], - "length": 8, - "heTitle": "משנה פאה", - "titleVariants": [ - "M Peah", - "Mishna Peah", - "M. Peah", - "Mishnah Péah", - "Pe’ah", - "Pe'ah", - "Peah", - "Mishnah Peah" + "internalToSections": [ + 1, + 3, + 3 ], - "heTitleVariants": [ - "פאה", - "משנה פיאה", - "משנה פאה" + "sections": [ + "1", + "3", + "3" ], - "type": "Mishnah", - "primary_category": "Mishnah", - "book": "Mishnah Peah", - "categories": [ - "Mishnah", - "Seder Zeraim" + "toSections": [ + "1", + "3", + "3" ], - "order": [ - 2, - 2 + "examples": [], + "sectionNames": [ + "Chapter", + "Verse", + "Comment" ], - "sections": [ - 4, - 2 + "heSectionNames": [ + "פרק", + "פסוק", + "פירוש" ], - "toSections": [ - 4, - 2 + "addressExamples": [ + "3", + "6", + "9" ], - "isDependant": false, - "indexTitle": "Mishnah Peah", - "heIndexTitle": "משנה פאה", - "sectionRef": "Mishnah Peah 4", - "firstAvailableSectionRef": "Mishnah Peah 4:2", - "heSectionRef": "משנה פאה ד׳", - "isSpanning": false, - "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", - "versionTitleInHebrew": "", - "shortVersionTitle": "Dr. Joshua Kulp", - "shortVersionTitleInHebrew": "", - "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", - "versionStatus": "locked", - "versionNotes": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "versionNotesInHebrew": "", - "digitizedBySefaria": false, - "license": "CC-BY", - "formatEnAsPoetry": false, - "heVersionTitle": "Torat Emet 357", - "heVersionTitleInHebrew": "תורת אמת 357", - "heShortVersionTitle": "", - "heShortVersionTitleInHebrew": "", - "heVersionSource": "http://www.toratemetfreeware.com/index.html?downloads", - "heVersionStatus": "locked", - "heVersionNotes": "", - "heExtendedNotes": "", - "heExtendedNotesHebrew": "", - "heVersionNotesInHebrew": "", - "heDigitizedBySefaria": false, - "heLicense": "Public Domain", - "formatHeAsPoetry": false, - "alts": [], - "index_offsets_by_depth": {}, - "next": "Mishnah Peah 5", - "prev": "Mishnah Peah 3", - "commentary": [], - "sheets": [], - "layer": [] + "heAddressExamples": [ + "ג׳", + "ו׳", + "ט׳" + ] } }, - "KleinDictionaryEntry": { - "title": "KleinDictionaryEntry", + "dictionaryEntry": { + "title": "Root Type for dictionaryEntry", + "description": "A single dictionary entry on Sefaria.", "type": "object", + "properties": { + "headword": { + "description": "The main word in the lexicon entry. The one you would look up in the book version.", + "type": "string" + }, + "parent_lexicon": { + "description": "Name of the lexicon from which the entry comes from.", + "type": "string" + }, + "parent_lexicon_details": { + "description": "", + "type": "object" + } + } + }, + "StrongsDictionaryEntry": { + "title": "StrongsDictionaryEntry", + "description": "", "allOf": [ { "$ref": "#/components/schemas/dictionaryEntry" } ], "properties": { - "rid": { - "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" + "strong_number": { + "type": "string" }, - "quotes": { + "transliteration": { "description": "" }, - "refs": { - "description": "Internal references to the Klein dictionary for other entries.", - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - }, - "prev_hw": { - "description": "The previous headword entry from the book." - }, - "next_hw": { - "description": "The next headword entry from the book." - }, - "plural_form": { - "description": "The plural form of the headword" - }, - "language_reference": { + "pronunciation": { "description": "" }, "language_code": { - "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word." - }, - "morphology": { - "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]" - }, - "alt_headwords": { - "description": "Alternative spellings of headword" - }, - "notes": { - "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes" - }, - "derivatives": { - "description": "HTML - list of derivate words - tag wrapped with links to Sefaria entries" + "description": "" }, "content": { "description": "", "type": "object", "properties": { + "morphology": { + "type": "string" + }, "senses": { "type": "array", "items": { - "$ref": "#/components/schemas/SenseKleinDictionaryEntry" + "$ref": "#/components/schemas/SenseStrongsDictionaryEntry" } - }, - "morphology": { - "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", - "type": "string" - } - } - } - } - }, - "SenseStrongsDictionaryEntry": { - "description": "", - "type": "object", - "properties": { - "definition": { - "description": "A definition of the word" - }, - "grammar": { - "description": "", - "type": "object", - "properties": { - "verbal_stem": { - "type": "string" } } } - } - }, - "SenseKleinDictionaryEntry": { - "description": "", - "type": "object", - "properties": { - "definition": { - "description": "A definition of the word", - "type": "string" - }, - "grammar": { - "description": "", - "type": "object", - "properties": { - "verbal_stem": { - "type": "string" + }, + "example": { + "headword": "רָאָה", + "parent_lexicon": "BDB Augmented Strong", + "content": { + "morphology": "v", + "senses": [ + { + "definition": "to see, look at, inspect, perceive, consider", + "senses": [ + { + "senses": [ + { + "definition": "to see" + }, + { + "definition": "to see, perceive" + }, + { + "definition": "to see, have vision" + }, + { + "definition": "to look at, see, regard, look after, see after, learn about, observe, watch, look upon, look out, find out" + }, + { + "definition": "to see, observe, consider, look at, give attention to, discern, distinguish" + }, + { + "definition": "to look at, gaze at" + } + ], + "grammar": { + "verbal_stem": "Qal" + } + }, + { + "senses": [ + { + "definition": "to appear, present oneself" + }, + { + "definition": "to be seen" + }, + { + "definition": "to be visible" + } + ], + "grammar": { + "verbal_stem": "Niphal" + } + }, + { + "definition": " to be seen", + "grammar": { + "verbal_stem": "Pual" + } + }, + { + "senses": [ + { + "definition": "to cause to see, show" + }, + { + "definition": "to cause to look intently at, behold, cause to gaze at" + } + ], + "grammar": { + "verbal_stem": "Hiphil" + } + }, + { + "senses": [ + { + "definition": "to be caused to see, be shown" + }, + { + "definition": "to be exhibited to" + } + ], + "grammar": { + "verbal_stem": "Hophal" + } + }, + { + "definition": " to look at each other, face", + "grammar": { + "verbal_stem": "Hithpael" + } + } + ] + } + ] + }, + "strong_number": "7200", + "transliteration": "râʼâh", + "pronunciation": "raw-aw'", + "language_code": "heb", + "parent_lexicon_details": { + "name": "BDB Augmented Strong", + "language": "heb.biblical", + "to_language": "eng", + "text_categories": [ + "Tanakh, Torah", + "Tanakh, Prophets", + "Tanakh, Writings" + ], + "source": "Open Scriptures on GitHub", + "source_url": "https://github.com/openscriptures/strongs", + "attribution": "Based on the work of Larry Pierce at the Online Bible", + "attribution_url": "http://www.blueletterbible.org/contact/contact_gen.cfm" + } + } + }, + "BDBDictionaryEntry": { + "title": "BDBDictionaryEntry", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries", + "type": "string" + }, + "TWOT": { + "description": "The corresponding Theological Wordbook of the Old Testament number for this word", + "type": "string" + }, + "strong_numbers": { + "description": "An array of corresponsing Strong Numbers for this word", + "type": "array", + "items": { + "type": "string" + } + }, + "root": { + "description": "Indicates if the headword is the Biblical root. (Indicated in print, by a larger printed headword)", + "type": "boolean" + }, + "peculiar": { + "description": "A bool indicating the presence of the `‡` symbol in print, demonstrating that the word is peculiar to Biblical Aramaic.", + "type": "boolean" + }, + "ordinal": { + "description": "when the same headword has more than one entry with a differen meaning they are offset by the roman numerals here", + "type": "string" + }, + "occurrences": { + "description": "A count of the number of times the headword appears in the Bible", + "type": "number" + }, + "headword_suffix": { + "description": "In some cases the headword has some additional content in print beyond it. That data is included here.", + "type": "string" + }, + "GK": { + "description": "The corresponding Goodrick/Kohlenberger Lexicon number for this headword.", + "type": "string" + }, + "all_cited": { + "description": "A bool indicating the presense of the `†` symbol in print, indicating that all of the occurences of the word are listed as part of this entry", + "type": "boolean" + }, + "brackets": { + "description": "headword has brackets in print", + "type": "boolean" + }, + "alt_headwords": { + "description": "An array of alternative headwords for the entry", + "type": "array", + "items": { + "type": "string" + }, + "properties": { + "word": { + "description": "The alternative headword", + "type": "string" + }, + "occurences": { + "description": "The number of times the alternative headword exists in the Bible" + } + } + }, + "prev_hw": { + "description": "The previous entry in print", + "type": "string" + }, + "next_hw": { + "description": "the next entry in print", + "type": "string" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "type": "object", + "properties": { + "definition": { + "description": "a definition of this sense of the word", + "type": "string" + }, + "all_cited": { + "description": "A bool indicating the presense of the `†` symbol in print, indicating that all of the occurences of this sense of the word are listed as part of this entry", + "type": "string" + }, + "form": { + "description": "the grammatical verb form (binyan) of the word", + "type": "string" + }, + "note": { + "description": "an additional note for the entry", + "type": "string" + }, + "num": { + "description": "the string of the numbering of this sense in print (it can be a number, English letter, Roman digits, with period, in parentheses, etc.)", + "type": "string" + }, + "occurences": { + "description": "number of occurrences of this sense in bible", + "type": "string" + }, + "pre_num": { + "description": "In some cases the sense has some additional characters before the entry (e.g. the word Especially). That data is included here", + "type": "string" + } + } + } + } + } + } + } + }, + "HebrewDictionaryEntry": { + "title": "HebrewDictionaryEntry", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries", + "type": "string" + }, + "refs": { + "description": "Cross references to selections in the Sefaria library.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "prev_hw": { + "description": "The previous headword entry from the book.", + "type": "string" + }, + "next_hw": { + "description": "The next headword entry from the book.", + "type": "string" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "type": "object", + "properties": { + "definition": { + "description": "A definition of this sense of the word", + "type": "string" + } + } + } + } + } + } + } + }, + "JastrowDictionaryEntry": { + "title": "JastrowDictionaryEntry", + "description": "An entry from Jastrow’s Dictionary,", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" + }, + "quotes": { + "description": "" + }, + "refs": { + "description": "Cross references to selections in the Sefaria library.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "prev_hw": { + "description": "The previous headword entry from the book." + }, + "next_hw": { + "description": "The next headword entry from the book." + }, + "plural_form": { + "description": "The plural form of the headword." + }, + "language_reference": { + "description": "" + }, + "language_code": { + "description": "A string containing the following characters `h.` (Hebrew), `b. h.` (Biblical Hebrew) `ch.` or `Ch.` (Chaldean) indicating the source language of the entry." + }, + "alt_headwords": { + "description": "An array of alternate headwords for the entry. Symbolized in print as those headwords separated by commas after the initial entry.", + "type": "array", + "items": { + "type": "string" + } + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "$ref": "#/components/schemas/SenseJastrowDictionaryEntry" + } + }, + "morphology": { + "description": "A description of the morphological form of the word, one of `m., m. pl., f., f. pl., pr. n., pr. n. pl., pr. n. f., pr. n. m., pron., pers. pron.`", + "type": "string" + } + } + } + } + }, + "textAPIReponse": { + "title": "Root Type for textAPIReponse", + "description": "Expected reponse data from Sefaria's Text API", + "type": "object", + "properties": { + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "$ref": "#/components/schemas/ref" + }, + "isComplex": { + "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its Index, and the way the data is stored. For more on complex texts, see the documentation here.", + "type": "boolean" + }, + "text": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "array", + "items": { + "type": "string" + } + } + }, + { + "type": "array", + "items": { + "type": "string" + } + } + ], + "description": "The default, or specified text written in LTR characters for the query (Usually English). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text." + }, + "he": { + "oneOf": [ + { + "type": "array", + "items": { + "type": "string" + } + }, + { + "type": "string" + } + ], + "description": "The default, or specified text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text." + }, + "versions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/versionData" + } + }, + "textDepth": { + "format": "int32", + "type": "integer" + }, + "sectionNames": { + "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", + "type": "array", + "items": { + "type": "string" + } + }, + "addressTypes": { + "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", + "type": "array", + "items": { + "type": "string" + } + }, + "lengths": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "length": { + "format": "int32", + "type": "integer" + }, + "heTitle": { + "type": "string" + }, + "titleVariants": { + "type": "array", + "items": { + "type": "string" + } + }, + "heTitleVariants": { + "type": "array", + "items": { + "type": "string" + } + }, + "type": { + "type": "string" + }, + "primary_category": { + "type": "string" + }, + "book": { + "description": "The title of the book that the response comes from.", + "type": "string" + }, + "categories": { + "description": "A list of categories that a text belongs to. ", + "type": "array", + "items": { + "type": "string" + } + }, + "order": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "sections": { + "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "toSections": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "isDependant": { + "type": "boolean" + }, + "indexTitle": { + "type": "string" + }, + "heIndexTitle": { + "type": "string" + }, + "sectionRef": { + "$ref": "#/components/schemas/ref" + }, + "firstAvailableSectionRef": { + "type": "string" + }, + "heSectionRef": { + "$ref": "#/components/schemas/ref" + }, + "isSpanning": { + "type": "boolean" + }, + "versionTitle": { + "type": "string" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "versionSource": { + "type": "string" + }, + "versionStatus": { + "type": "string" + }, + "versionNotes": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "digitizedBySefaria": { + "description": "Was the `text` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", + "type": "boolean" + }, + "license": { + "type": "string" + }, + "formatEnAsPoetry": { + "type": "boolean" + }, + "heVersionTitle": { + "type": "string" + }, + "heVersionTitleInHebrew": { + "type": "string" + }, + "heShortVersionTitle": { + "type": "string" + }, + "heShortVersionTitleInHebrew": { + "type": "string" + }, + "heVersionSource": { + "type": "string" + }, + "heVersionStatus": { + "type": "string" + }, + "heVersionNotes": { + "type": "string" + }, + "heExtendedNotes": { + "type": "string" + }, + "heExtendedNotesHebrew": { + "type": "string" + }, + "heVersionNotesInHebrew": { + "type": "string" + }, + "heDigitizedBySefaria": { + "description": "Was the `he` response initially digitized by Sefaria `1` or was it initially generated by another digital publisher `0`", + "type": "boolean" + }, + "heLicense": { + "type": "string" + }, + "formatHeAsPoetry": { + "type": "boolean" + }, + "alts": { + "type": "array", + "items": {} + }, + "index_offsets_by_depth": { + "type": "object" + }, + "next": { + "nullable": true, + "description": "Next segment reference in sequence, if last ref, field will be `null`.", + "type": "string" + }, + "prev": { + "nullable": true, + "description": "Previous segment reference in sequence, if first ref, field will be `null`.", + "type": "string" + }, + "commentary": { + "type": "array", + "items": {} + }, + "sheets": { + "type": "array", + "items": {} + }, + "layer": { + "type": "array", + "items": {} + } + }, + "example": { + "ref": "Mishnah Peah 4:2", + "heRef": "משנה פאה ד׳:ב׳", + "isComplex": false, + "text": [ + "Peah is given from [the crop] while it is still connected with the soil. But in the case of hanging vine-branches and the date-palm, the owner brings down [the fruit] and distributes it among the poor. Rabbi Shimon says: the same applies to smooth nut trees. Even if ninety-nine [of the poor] say [to the owner] to distribute it and one says to leave it in the field, this latter is listened to, since he spoke in accordance with the halakhah.", + "With hanging vine-branches and date-palm trees it is not so; even if ninety-nine [of the poor] say [to the owner] to leave it in the field and one says to distribute it, this latter is listened to, since he spoke in accordance with the halakhah.", + "If [a poor man] took some of the peah [already collected] and threw it onto the remainder [not yet collected], he gets none of it. If he fell down upon it, or spread his cloak over it, they take the peah away from him. The same applies to gleanings and the forgotten sheaf.", + "[The poor] may not harvest peah with scythes or tear it out [of the ground] with spades, so that they might not strike one another [with these implements].", + "There are three times a day [the poor] make a search [in the field for peah]: morning, noon, and sunset. Rabban Gamaliel says: these [times] were only set lest they reduce them. Rabbi Akiva says: these were set lest they add to them. [The men] of Bet Namer used to have the poor harvest [the peah] with the aid of a rope, and they left peah at the end of each furrow.", + "A non-Jew who harvested his field and then converted, he is exempt from [leaving] gleanings, the forgotten sheaf and peah. Rabbi Judah makes him liable to leave the forgotten sheaf, since he becomes liable for the forgotten sheaf at the time of their binding.", + "One who dedicated standing grain [to the Temple] and then redeemed it while it was still standing grain, he is liable [to give the agricultural gifts to the poor]. [If he dedicated] sheaves and redeemed them while they were still sheaves, he is liable. [If he dedicated] standing grain and redeemed it [when it was already in] sheaves, he is exempt, since at the time when it became liable it was exempt.", + "Similarly one who dedicates his produce prior to the stage when they are subject to tithes and then redeemed them, they are liable [to be tithed]. If [he dedicated them] when they had already become subject to tithes and then redeemed them, they are liable [to be tithed]. If he dedicated them before they had ripened, and they became ripe while in the possession of the [Temple] treasurer, and he then redeemed them, they are exempt, since at the time when they would have been liable, they were exempt.", + "One who collected peah and said, “This is for so-and-so a poor man:” Rabbi Eliezer says: he has thus acquired it for him. The sages say: he must give it to the first poor man he finds. Gleanings, the forgotten sheaf and the peah of non-Jews are subject to tithes, unless he [the non-Jew] had declared them ownerless.", + "What are gleanings? That which falls down at the time of harvesting. If while he was harvesting, he harvested a handful, or plucked a fistful, and then a thorn pricked him, and what he had in his hand fell to the ground, it still belongs to the owner. [That which drops from] inside the hand or the sickle [belongs] to the poor, but [that which falls from] the back of the hand or the sickle [belongs] to the owner. [That which falls from] the top of the hand or sickle: Rabbi Ishmael says: to the poor; But Rabbi Akiva says: to the owner.", + "[Grain found in] ant holes where the stalks are still standing, behold it still belongs to the owner. After the harvesters [had passed over them], those found in the top parts [of the ant holes belong] to the poor, but [those found] on the bottom parts [belong] to the owner. Rabbi Meir says: it all belongs to the poor, for gleanings about which there is any doubt are regarded as gleanings." + ], + "he": [ + "הַפֵּאָה נִתֶּנֶת בִּמְחֻבָּר לַקַּרְקָע. בְּדָלִית וּבְדֶקֶל, בַּעַל הַבַּיִת מוֹרִיד וּמְחַלֵּק לָעֲנִיִּים. רַבִּי שִׁמְעוֹן אוֹמֵר, אַף בַּחֲלִיקֵי אֱגוֹזִים. אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לְחַלֵּק וְאֶחָד אוֹמֵר לָבוֹז, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", + "בְּדָלִית וּבְדֶקֶל אֵינוֹ כֵן, אֲפִלּוּ תִשְׁעִים וְתִשְׁעָה אוֹמְרִים לָבוֹז וְאֶחָד אוֹמֵר לְחַלֵּק, לָזֶה שׁוֹמְעִין, שֶׁאָמַר כַּהֲלָכָה: \n", + "נָטַל מִקְצָת פֵּאָה וּזְרָקָהּ עַל הַשְּׁאָר, אֵין לוֹ בָהּ כְּלוּם. נָפַל לוֹ עָלֶיהָ, וּפֵרֵשׂ טַלִּיתוֹ עָלֶיהָ, מַעֲבִירִין אוֹתָהּ הֵימֶנּוּ. וְכֵן בְּלֶקֶט, וְכֵן בְּעֹמֶר הַשִּׁכְחָה: \n", + "פֵּאָה אֵין קוֹצְרִין אוֹתָהּ בְּמַגָּלוֹת, וְאֵין עוֹקְרִין אוֹתָהּ בְּקַרְדֻּמּוֹת, כְּדֵי שֶׁלֹּא יַכּוּ אִישׁ אֶת רֵעֵהוּ: \n", + "שָׁלשׁ אַבְעָיוֹת בַּיּוֹם, בַּשַּׁחַר וּבַחֲצוֹת וּבַמִּנְחָה. רַבָּן גַּמְלִיאֵל אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יִפְחֲתוּ. רַבִּי עֲקִיבָא אוֹמֵר, לֹא אָמְרוּ אֶלָּא כְּדֵי שֶׁלֹּא יוֹסִיפוּ. שֶׁל בֵּית נָמֵר הָיוּ מְלַקְּטִין עַל הַחֶבֶל, וְנוֹתְנִים פֵּאָה מִכָּל אֻמָּן וְאֻמָּן: \n", + "עוֹבֵד כּוֹכָבִים שֶׁקָּצַר אֶת שָׂדֵהוּ וְאַחַר כָּךְ נִתְגַּיֵּר, פָּטוּר מִן הַלֶּקֶט וּמִן הַשִּׁכְחָה וּמִן הַפֵּאָה. רַבִּי יְהוּדָה מְחַיֵּב בְּשִׁכְחָה, שֶׁאֵין הַשִּׁכְחָה אֶלָּא בִשְׁעַת הָעִמּוּר: \n", + "הִקְדִּישׁ קָמָה וּפָדָה קָמָה, חַיָּב. עֳמָרִין וּפָדָה עֳמָרִין, חַיָּב. קָמָה וּפָדָה עֳמָרִין, פְּטוּרָה, שֶׁבִּשְׁעַת חוֹבָתָהּ הָיְתָה פְטוּרָה: \n", + "כַּיּוֹצֵא בוֹ, הַמַּקְדִּישׁ פֵּרוֹתָיו עַד שֶׁלֹּא בָאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. מִשֶּׁבָּאוּ לְעוֹנַת הַמַּעַשְׂרוֹת, וּפְדָאָן, חַיָּבִין. הִקְדִּישָׁן עַד שֶׁלֹּא נִגְמְרוּ וּגְמָרָן הַגִּזְבָּר, וְאַחַר כָּךְ פְּדָאָן, פְּטוּרִים, שֶׁבִּשְׁעַת חוֹבָתָן הָיוּ פְטוּרִים: \n", + "מִי שֶׁלָּקַט אֶת הַפֵּאָה וְאָמַר הֲרֵי זוֹ לְאִישׁ פְּלוֹנִי עָנִי, רַבִּי אֱלִיעֶזֶר אוֹמֵר, זָכָה לוֹ. וַחֲכָמִים אוֹמְרִים, יִתְּנֶנָּה לֶעָנִי שֶׁנִּמְצָא רִאשׁוֹן. הַלֶּקֶט וְהַשִּׁכְחָה וְהַפֵּאָה שֶׁל עוֹבֵד כּוֹכָבִים חַיָּב בְּמַעַשְׂרוֹת, אֶלָּא אִם כֵּן הִפְקִיר: \n", + "אֵיזֶהוּ לֶקֶט, הַנּוֹשֵׁר בִּשְׁעַת הַקְּצִירָה. הָיָה קוֹצֵר, קָצַר מְלֹא יָדוֹ, תָּלַשׁ מְלֹא קֻמְצוֹ, הִכָּהוּ קוֹץ וְנָפַל מִיָּדוֹ לָאָרֶץ, הֲרֵי הוּא שֶׁל בַּעַל הַבָּיִת. תּוֹךְ הַיָּד וְתוֹךְ הַמַּגָּל, לָעֲנִיִּים. אַחַר הַיָּד וְאַחַר הַמַּגָּל, לְבַעַל הַבָּיִת. רֹאשׁ הַיָּד וְרֹאשׁ הַמַּגָּל, רַבִּי יִשְׁמָעֵאל אוֹמֵר, לָעֲנִיִּים. רַבִּי עֲקִיבָא אוֹמֵר, לְבַעַל הַבָּיִת: \n", + "חוֹרֵי הַנְּמָלִים שֶׁבְּתוֹךְ הַקָּמָה, הֲרֵי הֵן שֶׁל בַּעַל הַבָּיִת. שֶׁלְּאַחַר הַקּוֹצְרִים, הָעֶלְיוֹנִים לָעֲנִיִּים, וְהַתַּחְתּוֹנִים שֶׁל בַּעַל הַבָּיִת. רַבִּי מֵאִיר אוֹמֵר, הַכֹּל לָעֲנִיִּים, שֶׁסְּפֵק לֶקֶט, לֶקֶט: \n" + ], + "versions": [ + { + "title": "Mishnah Peah", + "versionTitle": "Torat Emet 357", + "versionSource": "http://www.toratemetfreeware.com/index.html?downloads", + "language": "he", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 3, + "versionTitleInHebrew": "תורת אמת 357", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": true + }, + { + "title": "Mishnah Peah", + "versionTitle": "Mishnah, ed. Romm, Vilna 1913", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001741739", + "language": "he", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": true, + "priority": 2, + "versionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": true + }, + { + "title": "Mishnah Peah", + "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", + "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", + "language": "en", + "status": "locked", + "license": "CC-BY", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": 1, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "Dr. Joshua Kulp", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002378149/NLI", + "language": "en", + "status": "locked", + "license": "Public Domain", + "versionNotes": "Ordnung Seraïm, übers. und erklärt von Ascher Samter. 1887.
Ordnung Moed, von Eduard Baneth. 1887-1927.
Ordnung Naschim, von Marcus Petuchowski u. Simon Schlesinger. 1896-1933.
Ordnung Nesikin, von David Hoffmann. 1893-1898.
Ordnung Kodaschim, von John Cohn. 1910-1925.
Ordnung Toharot, von David Hoffmann, John Cohn und Moses Auerbach. 1910-1933.", + "digitizedBySefaria": true, + "priority": 0.5, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Talmud Bavli. German. Lazarus Goldschmidt. 1929 [de]", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH001042448/NLI", + "language": "en", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": true, + "priority": 0.25, + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "Lazarus Goldschmidt, 1929 ", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Open Mishnah", + "versionSource": "http://en.wikisource.org/wiki/Mishnah", + "language": "en", + "status": "locked", + "license": "CC-BY-SA", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "משנה פתוחה", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Le Talmud de Jérusalem, traduit par Moise Schwab, 1878-1890 [fr]", + "versionSource": "https://www.nli.org.il/he/books/NNL_ALEPH002182155/NLI", + "language": "en", + "status": "locked", + "license": "Public Domain", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false + }, + { + "title": "Mishnah Peah", + "versionTitle": "Mishnah based on the Kaufmann manuscript, edited by Dan Be'eri", + "versionSource": "https://archive.org/details/MishnaCorrectedKaufman00WHOLE", + "language": "he", + "status": "locked", + "license": "PD", + "versionNotes": "", + "digitizedBySefaria": true, + "priority": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": "" + } + ], + "textDepth": 2, + "sectionNames": [ + "Chapter", + "Mishnah" + ], + "addressTypes": [ + "Perek", + "Mishnah" + ], + "lengths": [ + 8, + 69 + ], + "length": 8, + "heTitle": "משנה פאה", + "titleVariants": [ + "M Peah", + "Mishna Peah", + "M. Peah", + "Mishnah Péah", + "Pe’ah", + "Pe'ah", + "Peah", + "Mishnah Peah" + ], + "heTitleVariants": [ + "פאה", + "משנה פיאה", + "משנה פאה" + ], + "type": "Mishnah", + "primary_category": "Mishnah", + "book": "Mishnah Peah", + "categories": [ + "Mishnah", + "Seder Zeraim" + ], + "order": [ + 2, + 2 + ], + "sections": [ + 4, + 2 + ], + "toSections": [ + 4, + 2 + ], + "isDependant": false, + "indexTitle": "Mishnah Peah", + "heIndexTitle": "משנה פאה", + "sectionRef": "Mishnah Peah 4", + "firstAvailableSectionRef": "Mishnah Peah 4:2", + "heSectionRef": "משנה פאה ד׳", + "isSpanning": false, + "versionTitle": "Mishnah Yomit by Dr. Joshua Kulp", + "versionTitleInHebrew": "", + "shortVersionTitle": "Dr. Joshua Kulp", + "shortVersionTitleInHebrew": "", + "versionSource": "http://learn.conservativeyeshiva.org/mishnah/", + "versionStatus": "locked", + "versionNotes": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "versionNotesInHebrew": "", + "digitizedBySefaria": false, + "license": "CC-BY", + "formatEnAsPoetry": false, + "heVersionTitle": "Torat Emet 357", + "heVersionTitleInHebrew": "תורת אמת 357", + "heShortVersionTitle": "", + "heShortVersionTitleInHebrew": "", + "heVersionSource": "http://www.toratemetfreeware.com/index.html?downloads", + "heVersionStatus": "locked", + "heVersionNotes": "", + "heExtendedNotes": "", + "heExtendedNotesHebrew": "", + "heVersionNotesInHebrew": "", + "heDigitizedBySefaria": false, + "heLicense": "Public Domain", + "formatHeAsPoetry": false, + "alts": [], + "index_offsets_by_depth": {}, + "next": "Mishnah Peah 5", + "prev": "Mishnah Peah 3", + "commentary": [], + "sheets": [], + "layer": [] + } + }, + "KleinDictionaryEntry": { + "title": "KleinDictionaryEntry", + "type": "object", + "allOf": [ + { + "$ref": "#/components/schemas/dictionaryEntry" + } + ], + "properties": { + "rid": { + "description": "Returns a unique id for this reference that establishes an ordering of references across the whole catalog. This id will change as the ordering of the categories changes, and may begin to overlap with other numbers because of those changes. However, at any point in time these ids will be unique across the catalog. Used to sort results from ElasticSearch queries" + }, + "quotes": { + "description": "" + }, + "refs": { + "description": "Internal references to the Klein dictionary for other entries.", + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + }, + "prev_hw": { + "description": "The previous headword entry from the book." + }, + "next_hw": { + "description": "The next headword entry from the book." + }, + "plural_form": { + "description": "The plural form of the headword" + }, + "language_reference": { + "description": "" + }, + "language_code": { + "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word." + }, + "morphology": { + "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]" + }, + "alt_headwords": { + "description": "Alternative spellings of headword" + }, + "notes": { + "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes" + }, + "derivatives": { + "description": "HTML - list of derivate words - tag wrapped with links to Sefaria entries" + }, + "content": { + "description": "", + "type": "object", + "properties": { + "senses": { + "type": "array", + "items": { + "$ref": "#/components/schemas/SenseKleinDictionaryEntry" + } + }, + "morphology": { + "description": "One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", + "type": "string" + } + } + } + } + }, + "SenseStrongsDictionaryEntry": { + "description": "", + "type": "object", + "properties": { + "definition": { + "description": "A definition of the word" + }, + "grammar": { + "description": "", + "type": "object", + "properties": { + "verbal_stem": { + "type": "string" + } + } + } + } + }, + "SenseKleinDictionaryEntry": { + "description": "", + "type": "object", + "properties": { + "definition": { + "description": "A definition of the word", + "type": "string" + }, + "grammar": { + "description": "", + "type": "object", + "properties": { + "verbal_stem": { + "type": "string" + }, + "language_code": { + "type": "string" + }, + "binyan_form": { + "description": "what form the root takes in this binyan", + "type": "array", + "items": { + "type": "string" + } + }, + "morphology": { + "type": "string" + } + } + }, + "number": { + "description": "a number indicating which numbered sense this is", + "type": "string" + }, + "plural_form": { + "description": "the plural form of the sense", + "type": "string" + }, + "notes": { + "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes", + "type": "string" + }, + "morphology": { + "description": " One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", + "type": "string" + }, + "language_code": { + "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word.", + "type": "string" + }, + "alternative": { + "type": "string" + } + } + }, + "SenseJastrowDictionaryEntry": { + "description": "Each meaning of the word is tagged as a `sense` within `senses`\nEach sense may be preceded by a bolded number which will be tagged as a `number`\nEach Binyan will also be broken down into `senses`", + "type": "object", + "properties": { + "definition": { + "description": "A definition of the word", + "type": "string" + }, + "grammar": { + "description": "", + "type": "object", + "properties": { + "verbal_stem": { + "type": "string" + }, + "language_code": { + "type": "string" + }, + "binyan_form": { + "description": "Found in verbs, a binyan is a linguistic alternate use of the word. It will be one of the following: Hiph., Hish., Hith., Hithpalp., Hithpol., Hoph., Hoth., Niph, , Nith., Pa., Pi., Pil., Pilp., Pir., Po., Pol., Polp., Pu., Pul., Pulp., Qal., Shaph., Shiph., Shuph., Tiph., Tuph., Hif., Nif., Hithpa., Af., Ithpa., Ithpe., Nithpa", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "number": { + "type": "string" + } + } + }, + "recommendedTopicResponse": { + "title": "Root Type for recommendedTopicResponse", + "description": "", + "type": "object", + "properties": { + "slug": { + "description": "the url slug for the topic.", + "type": "string" + }, + "titles": { + "description": "Titles for the topic by language (usually Hebrew & English)", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + }, + "count": { + "format": "int32", + "description": "Number of times the topic appears in the references", + "type": "integer" + } + }, + "example": { + "slug": "jacobs-burial", + "titles": { + "en": "Jacob's Burial", + "he": "קבורת יעקב" + }, + "count": 3 + } + }, + "ManuscriptJSON": { + "title": "Root Type for ManuscriptJSON", + "description": "Manuscript data and metadata JSON. ", + "required": [ + "manuscript" + ], + "type": "object", + "properties": { + "manuscript_slug": { + "description": "A unique slug for the given manuscript", + "type": "string", + "example": "leningrad-codex-(1008-ce)" + }, + "page_id": { + "description": "The ID for the specific page within the manuscript being referenced. ", + "type": "string", + "example": "LC_Folio_435r" + }, + "image_url": { + "description": "The URL to the image of the manuscript, hosted by Sefaria. All URLs will be prefaced by `https://manuscripts.sefaria.org/`", + "type": "string", + "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" + }, + "thumbnail_url": { + "description": "The url to the thumbnail image of the manuscript. ", + "type": "string", + "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" + }, + "anchorRef": { + "description": "A manuscript image will in most cases be associated with a range of `refs` (i.e. an image of a page of Tanakh will display multiple verses). The `anchorRef` is that complete range the manuscript is associated with, and will contain within it the specific `tref` passed in as a parameter. ", + "type": "string", + "example": "\"Esther 3:15-4:17\"" + }, + "anchorRefExpanded": { + "description": "An array of strings, where each string is a segment level `ref` of the `ref` passed in as a parameter. If a segment level `ref` is passed in, this array will have a length of 1, and only contain that segment level `ref`. If the `ref` passed in is ranged, this array will contain each of the segment level `ref`s within that range. \n\nFor example, if someone was searching for manuscript data for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", + "minItems": 1, + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" + }, + "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" + }, + "manuscript": { + "$ref": "#/components/schemas/ManuscriptVersionMetaData", + "description": "The version metadata for the manuscript, including the title, Hebrew and English descriptions. ", + "properties": { + "slug": { + "type": "string" + }, + "title": { + "type": "string" + }, + "he_title": { + "type": "string" + }, + "source": { + "type": "string" + }, + "description": { + "type": "string" + }, + "he_description": { + "type": "string" + } + }, + "example": "" + } + }, + "example": { + "manuscript_slug": "leningrad-codex-(1008-ce)", + "page_id": "LC_Folio_434v", + "image_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B.jpg", + "thumbnail_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg", + "anchorRef": "Esther 3:15-4:17", + "anchorRefExpanded": [ + "Esther 4:14" + ], + "manuscript": { + "slug": "leningrad-codex-(1008-ce)", + "title": "Leningrad Codex (1008 CE)", + "he_title": "כתב יד לנינגרד (1008)", + "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", + "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", + "he_description": "" + } + } + }, + "ManuscriptVersionMetaData": { + "title": "Root Type for ManuscriptVersionMetaData", + "description": "The specific metadata for the version of the manuscript. ", + "required": [ + "slug", + "description", + "he_description", + "he_title", + "source", + "title" + ], + "type": "object", + "properties": { + "slug": { + "description": "The unique slug for the manuscript. ", + "type": "string", + "example": "leningrad-codex-(1008-ce)" + }, + "title": { + "description": "The title of the manuscript. ", + "type": "string", + "example": "Leningrad Codex (1008 CE)" + }, + "he_title": { + "description": "The manuscript title in Hebrew. ", + "type": "string", + "example": "כתב יד לנינגרד (1008)" + }, + "source": { + "description": "The url for the source of the manuscript images. ", + "type": "string", + "example": "https://dornsife.usc.edu/wsrp/biblical-manuscripts/" + }, + "description": { + "description": "A description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", + "type": "string", + "example": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin" + }, + "he_description": { + "description": "A Hebrew description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", + "type": "string" + } + }, + "example": { + "slug": "leningrad-codex-(1008-ce)", + "title": "Leningrad Codex (1008 CE)", + "he_title": "כתב יד לנינגרד (1008)", + "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", + "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", + "he_description": "" + } + }, + "wordCompletionAPIResponse": { + "description": "An array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels.", + "type": "array", + "items": { + "type": "string" + }, + "example": [ + [ + "אב", + "אַב" + ] + ] + }, + "VersionJSON": { + "title": "Root Type for VersionJSON", + "description": "The metadata for a given version. ", + "type": "object", + "properties": { + "title": { + "description": "The title of the Index. ", + "type": "string", + "example": "Talmud Berakhot" + }, + "versionTitle": { + "description": "The title of the version", + "type": "string", + "example": "\"William Davidson Edition - Vocalized Aramaic\"" + }, + "versionSource": { + "description": "A URL pointing to the hardcopy of the text as it can be found in libraries, most usually in our case the NLI (National Library of Israel), but not exclusively. ", + "type": "string", + "example": "https://www.nli.org.il/he/books/NNL_ALEPH990025294890205171/NLI" + }, + "language": { + "$ref": "#/components/schemas/LanguageCode", + "description": "The language of the version. The versions on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic)", + "example": "'en'\n'he'" + }, + "status": { + "description": "The status field contains either the string `\"locked\"` or an empty string. If `\"locked\"` is the value of the field, it indicates that the text is locked from future updatees, edits and translations from community members. ", + "type": "string", + "example": "\"locked\"" + }, + "license": { + "description": "The copyright license for using, and reproducing the text. ", + "type": "string", + "example": "CC-BY" + }, + "versionNotes": { + "description": "English notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", + "type": "string", + "example": "\"English from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz\"," + }, + "digitizedBySefaria": { + "description": "Whether or not the text was digitized by Sefaria. We have some texts we've been able to add to our database from digital sources, and other texts that we've transfered from print to a digital medium ourselves. This field indicates if Sefaria did the digitization. ", + "type": "boolean", + "example": "True" + }, + "priority": { + "description": "The priority field is a number which indicates the priority of a version relative to all other existing versions of the same text. A value of `1` indicates the lowest priority, while the highest value among all versions of the text indicate the highest priority. Priority values can also be floating point numbers. The priority field determines how the various available versions of a text will be displayed on the Sefaria website. The texts are displayed to the user in a highest-to-lowest priority order, in many cases offering more complete or higher quality versions of the text before ones of inferior quality. ", + "type": "number", + "example": "7" + }, + "versionTitleInHebrew": { + "description": "The title of the version in Hebrew", + "type": "string", + "example": "מהדורת וויליאם דייוידסון - ארמית המנוקד" + }, + "versionNotesInHebrew": { + "description": "Hebrew notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", + "type": "string" + }, + "extendedNotes": { + "description": "English extended notes on a version that go beyond the time and place of printing. ", + "type": "string" + }, + "extendedNotesHebrew": { + "description": "Hebrew extended notes on a version that go beyond the time and place of printing. ", + "type": "string" + }, + "purchaseInformationImage": { + "description": "A URL pointing to an image of the hard copy of the version associated with the digital copy, for those who would like to purchase a hard copy. ", + "type": "string", + "example": "\"https://storage.googleapis.com/sefaria-physical-editions/4fc4b6d5b144eb3915d250d743eaf2e8.png\"" + }, + "purchaseInformationURL": { + "description": "The URL pointing to a website where on can buy a physical copy of the given text version. ", + "type": "string", + "example": "\"https://korenpub.com/collections/the-noe-edition-koren-talmud-bavli-1/products/copy-of-vol-1-berakhot-1\"" + }, + "shortVersionTitle": { + "description": "An English short title for the version", + "type": "string", + "example": "\"Koren - Steinsaltz\"" + }, + "shortVersionTitleInHebrew": { + "description": "A Hebrew short title for the version", + "type": "string" + }, + "isBaseText": { + "description": "Is this a text that has commentary. `true` indicates that there are commentaries on this text, while `false` indicates that the text does not have any commentary. ", + "type": "boolean", + "example": "True" + }, + "firstSectionRef": { + "description": "The first `ref` for this title on a section level (as opposed to the more granular segment level). For example, `Genesis 1` would be the first section level ref of Genesis (as opposed to the segment, `Genesis 1:1`), and `Rashi on Kohelet 1:1` is the first section level ref of `Rashi on Kohelet` (as opposed to the segment level of `Rashi on Kohelet 1:1:1`)", + "type": "string", + "example": "Rashi on Kohelet 1.1" + } + }, + "example": { + "title": "Shulchan Arukh, Orach Chayim", + "versionTitle": "Wikisource Shulchan Aruch", + "versionSource": "https://en.wikisource.org/wiki/Translation:Shulchan_Aruch/Orach_Chaim/338", + "language": "en", + "status": "", + "license": "CC-BY-SA", + "versionNotes": "", + "digitizedBySefaria": "", + "priority": "", + "versionTitleInHebrew": "שולחן ערוך (ויקיטקסט)", + "versionNotesInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "isBaseText": false, + "firstSectionRef": "Shulchan Arukh, Orach Chayim 1" + } + }, + "LanguageCode": { + "description": "The texts on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic). This field is only ever populated by a string containing the value of either `en` or `he`. ", + "type": "string", + "example": "'en'\n'he'" + }, + "FindRefsPOSTRequest": { + "title": "Root Type for FindRefsPOSTRequest", + "description": "A properly formatted POST request for the Find Refs API", + "type": "object", + "properties": { + "text": { + "description": "Initially designed for websites, this API expects the `text` field to contain both a `body` and a `title`. When parsing arbitrary text feel free to just use `body` and pass an empty string `''` to `title`", + "type": "object", + "properties": { + "body": { + "type": "string" + }, + "title": { + "type": "string" + } + } + }, + "lang": { + "description": "Either `he` or `en`. If not included, it will default to one based on the number of Hebrew or Latin characters in the `body` of the `text`.", + "type": "string" + } + }, + "example": { + "text": { + "body": "Genesis 1:1 is a citation and also Mishnah Peah 3-4. So is שמות ב", + "title": "Some thoughts on Sefer Bereishit 1" + }, + "lang": "en" + } + }, + "FindRefsAPIResponse": { + "title": "Root Type for FindRefsAPIResponse", + "description": "A response to the Find Refs API", + "type": "object", + "properties": { + "title": { + "description": "Information about any references found in the `title` field of the POST request", + "type": "object", + "properties": { + "results": { + "type": "array", + "items": { + "description": "A single matched reference", + "type": "object", + "properties": { + "startChar": { + "format": "int32", + "description": "The index of the starting character of the match", + "type": "integer" + }, + "endChar": { + "format": "int32", + "description": "The index of the ending character of the match", + "type": "integer" + }, + "text": { + "description": "The matched reference", + "type": "string" + }, + "linkFailed": { + "type": "boolean" + }, + "refs": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + } + } + } + }, + "refData": { + "type": "object", + "properties": { + "RefTitle": { + "type": "object", + "properties": { + "heRef": { + "description": "The Hebrew equivalent of the cannonical ref", + "type": "string" + }, + "url": { + "description": "The URL this ref can be found at on Sefaria", + "type": "string" + }, + "primaryCategory": { + "description": "The primary category this ref belongs to on Sefaria", + "type": "string" + } + } + } + } + } + } + }, + "body": { + "description": "Information about any references found in the `body` field of the POST request", + "type": "object", + "properties": { + "results": { + "type": "array", + "items": { + "description": "A single matched reference", + "type": "object", + "properties": { + "startChar": { + "format": "int32", + "description": "The index of the starting character of the match", + "type": "integer" + }, + "endChar": { + "format": "int32", + "description": "The index of the ending character of the match", + "type": "integer" + }, + "text": { + "description": "The matched reference", + "type": "string" + }, + "linkFailed": { + "type": "boolean" + }, + "refs": { + "type": "array", + "items": { + "$ref": "#/components/schemas/ref" + } + } + } + } + }, + "refData": { + "type": "object", + "properties": { + "RefTitle": { + "type": "object", + "properties": { + "heRef": { + "description": "The Hebrew equivalent of the cannonical ref", + "type": "string" + }, + "url": { + "description": "The URL this ref can be found at on Sefaria", + "type": "string" + }, + "primaryCategory": { + "description": "The primary category this ref belongs to on Sefaria", + "type": "string" + } + } + } + } + } + } + } + }, + "example": { + "title": { + "results": [ + { + "startChar": 23, + "endChar": 34, + "text": "Bereishit 1", + "linkFailed": false, + "refs": [ + "Genesis 1" + ] + } + ], + "refData": { + "Genesis 1": { + "heRef": "בראשית א׳", + "url": "Genesis.1", + "primaryCategory": "Tanakh" + } + } + }, + "body": { + "results": [ + { + "startChar": 0, + "endChar": 11, + "text": "Genesis 1:1", + "linkFailed": false, + "refs": [ + "Genesis 1:1" + ] + }, + { + "startChar": 35, + "endChar": 51, + "text": "Mishnah Peah 3-4", + "linkFailed": false, + "refs": [ + "Mishnah Peah 3-4" + ] + } + ], + "refData": { + "Genesis 1:1": { + "heRef": "בראשית א׳:א׳", + "url": "Genesis.1.1", + "primaryCategory": "Tanakh" + }, + "Mishnah Peah 3-4": { + "heRef": "משנה פאה ג׳-ד׳", + "url": "Mishnah_Peah.3-4", + "primaryCategory": "Mishnah" + } + } + } + } + }, + "CalendarAPIResponse": { + "title": "Root Type for CalendarAPIResponse", + "description": "A response from the Calendar API", + "type": "object", + "properties": { + "date": { + "format": "date", + "description": "The datestring for the calendars shown. It should match the values submitted in `year` `month` `day` or should be the current date.", + "type": "string" + }, + "timezone": { + "description": "An IANA timezone name", + "type": "string" + }, + "calendar_items": { + "type": "array", + "items": { + "description": "A single learning schedule for the selected date", + "type": "object", + "properties": { + "title": { + "description": "The learning schedule title in `he` and `en`", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "Daf Yomi" + }, + "displayValue": { + "description": "The name of the reading for the selected date in the learning schedule in `en` and `he`", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "Vayishlach" + }, + "url": { + "description": "The url path on Sefaria where this selection can be found", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "description": "The Hebrew equivalent of the `ref`", + "type": "string" + }, + "order": { + "format": "int32", + "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", + "type": "integer" + }, + "category": { + "description": "The primary category that this `ref` belongs to", + "type": "string" + }, + "extraDetails": { + "description": "Additional details about this learning schedule entry", + "type": "object", + "properties": { + "aliyot": { + "description": "The breakdown of aliyot for a parashah", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "description": { + "description": "A description of this learning schedule entry if it exists in `he` and `en`", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + } + } + } + } + }, + "example": { + "date": "2023-11-28", + "timezone": "America/Halifax", + "calendar_items": [ + { + "title": { + "en": "Parashat Hashavua", + "he": "פרשת השבוע" + }, + "displayValue": { + "en": "Vayishlach", + "he": "וישלח" + }, + "url": "Genesis.32.4-36.43", + "ref": "Genesis 32:4-36:43", + "heRef": "בראשית ל״ב:ד׳-ל״ו:מ״ג", + "order": 1, + "category": "Tanakh", + "extraDetails": { + "aliyot": [ + "Genesis 32:4-32:13", + "Genesis 32:14-32:30", + "Genesis 32:31-33:5", + "Genesis 33:6-33:20", + "Genesis 34:1-35:11", + "Genesis 35:12-36:19", + "Genesis 36:20-36:43", + "Genesis 36:40-36:43" + ] + }, + "description": { + "en": "Vayishlach (“He Sent”) follows Jacob and his family as Jacob wrestles with a man (commonly understood as an angel), is renamed Israel, and reconciles with his brother, Esau. Jacob’s daughter, Dina, is raped by a Hivite prince, and her brothers sack a city in response. Rachel dies as she gives birth to Jacob's youngest child, Benjamin.", + "he": "פרשת וישלח ממשיכה לעקוב אחרי יעקב ומשפחתו. יעקב נאבק עם איש (שלפי הפרשנות המקובלת הוא מלאך אלוהים), ובסיום המאבק האיש מעניק לו את השם ישראל. יעקב מתפייס עם אחיו עשו. דינה, בתו של יעקב, נאנסת ונשבית בידי נסיך חיווי, ואחיה הורגים את כל הזכרים בעיר ומשיבים אליהם את דינה. רחל מתה בשעת לידתו של בנימין, הצעיר בבני יעקב." + } + }, + { + "title": { + "en": "Haftarah", + "he": "הפטרה" + }, + "displayValue": { + "en": "Obadiah 1:1-21", + "he": "עובדיה א׳:א׳-כ״א" + }, + "url": "Obadiah.1.1-21", + "ref": "Obadiah 1:1-21", + "order": 2, + "category": "Tanakh" + }, + { + "title": { + "en": "Daf Yomi", + "he": "דף יומי" + }, + "displayValue": { + "en": "Bava Kamma 26", + "he": "בבא קמא כ״ו" + }, + "url": "Bava_Kamma.26", + "ref": "Bava Kamma 26", + "order": 3, + "category": "Talmud" + }, + { + "title": { + "en": "929", + "he": "929" + }, + "displayValue": { + "en": "Ezekiel 21 (473)", + "he": "יחזקאל כ״א (473)" + }, + "url": "Ezekiel.21", + "ref": "Ezekiel 21", + "order": 4, + "category": "Tanakh" + }, + { + "title": { + "en": "Daily Mishnah", + "he": "משנה יומית" + }, + "displayValue": { + "en": "Mishnah Yevamot 10:4-5", + "he": "משנה יבמות י׳:ד׳-ה׳" + }, + "url": "Mishnah_Yevamot.10.4-5", + "ref": "Mishnah Yevamot 10:4-5", + "order": 5, + "category": "Mishnah" + }, + { + "title": { + "en": "Daily Rambam", + "he": "הרמב\"ם היומי" + }, + "displayValue": { + "en": "Marriage 14", + "he": "הלכות אישות י״ד" + }, + "url": "Mishneh_Torah,_Marriage.14", + "ref": "Mishneh Torah, Marriage 14", + "order": 6, + "category": "Halakhah" + }, + { + "title": { + "en": "Daily Rambam (3 Chapters)", + "he": "הרמב\"ם היומי (3 פרקים)" + }, + "displayValue": { + "en": "Other Sources of Defilement 9-11", + "he": "הלכות שאר אבות הטומאות ט׳-י״א" + }, + "url": "Mishneh_Torah,_Other_Sources_of_Defilement.9-11", + "ref": "Mishneh Torah, Other Sources of Defilement 9-11", + "order": 7, + "category": "Halakhah" + }, + { + "title": { + "en": "Daf a Week", + "he": "דף השבוע" + }, + "displayValue": { + "en": "Ketubot 64", + "he": "כתובות ס״ד" + }, + "url": "Ketubot.64", + "ref": "Ketubot 64", + "order": 8, + "category": "Talmud" + }, + { + "title": { + "en": "Halakhah Yomit", + "he": "הלכה יומית" + }, + "displayValue": { + "en": "Shulchan Arukh, Orach Chayim 535:2-536:1", + "he": "שולחן ערוך, אורח חיים תקל״ה:ב׳-תקל״ו:א׳" + }, + "url": "Shulchan_Arukh,_Orach_Chayim.535.2-536.1", + "ref": "Shulchan Arukh, Orach Chayim 535:2-536:1", + "order": 9, + "category": "Halakhah" + }, + { + "title": { + "en": "Arukh HaShulchan Yomi", + "he": "ערוך השולחן היומי" + }, + "displayValue": { + "en": "Yoreh De'ah 191:7-15", + "he": "יורה דעה קצ״א:ז׳-ט״ו" + }, + "url": "Arukh_HaShulchan,_Yoreh_De'ah.191.7-15", + "ref": "Arukh HaShulchan, Yoreh De'ah 191:7-15", + "order": 10, + "category": "Halakhah" + }, + { + "title": { + "en": "Tanakh Yomi", + "he": "תנ\"ך יומי" + }, + "displayValue": { + "en": "Samuel Seder 17", + "he": "שמואל סדר יז" + }, + "url": "I_Samuel.25.33-26.24", + "ref": "I Samuel 25:33-26:24", + "order": 11, + "category": "Tanakh" + }, + { + "title": { + "en": "Chok LeYisrael", + "he": "חק לישראל" + }, + "displayValue": { + "en": "Vayishlach", + "he": "וישלח" + }, + "url": "collections/חק-לישראל?tag=Vayishlach", + "order": 12, + "category": "Tanakh" + }, + { + "title": { + "en": "Tanya Yomi", + "he": "תניא יומי" }, - "language_code": { - "type": "string" + "displayValue": { + "en": "15 Kislev", + "he": "טו כסלו" }, - "binyan_form": { - "description": "what form the root takes in this binyan", - "type": "array", - "items": { - "type": "string" - } + "url": "Tanya,_Part_V;_Kuntres_Acharon.6.8", + "ref": "Tanya, Part V; Kuntres Acharon 6:8", + "order": 15, + "category": "Chasidut" + }, + { + "title": { + "en": "Yerushalmi Yomi", + "he": "ירושלמי יומי" }, - "morphology": { - "type": "string" - } + "displayValue": { + "en": "Jerusalem Talmud Orlah 18", + "he": "תלמוד ירושלמי ערלה יח" + }, + "url": "Jerusalem_Talmud_Orlah.3.1.16-3.1", + "ref": "Jerusalem Talmud Orlah 3:1:16-3:1", + "order": 16, + "category": "Talmud" } - }, - "number": { - "description": "a number indicating which numbered sense this is", - "type": "string" - }, - "plural_form": { - "description": "the plural form of the sense", - "type": "string" - }, - "notes": { - "description": "The trailing end of the dictionary entry, after the formal definition - may have comparisons to cognates or similar notes", - "type": "string" - }, - "morphology": { - "description": " One of [n., adj., adv., m.n., abs., art. , attrib., auxil., comp., copul., c st., def., f., f. n., imper.., Imperf., Indef art., Inf, Interj., Interr., Intr., Neut., Part., Pass., Perf., Possess., p. part., prep., pres part., pres t., p.t.., sing., Subj., Tr.]", - "type": "string" - }, - "language_code": { - "description": "If not present, it’s Biblical. Otherwise values could be [PBH, MH, NH, FW] - Post Biblical Hebrew, Middle Hebrew, New Hebrew, Foreign Word.", - "type": "string" - }, - "alternative": { - "type": "string" - } + ] } }, - "SenseJastrowDictionaryEntry": { - "description": "Each meaning of the word is tagged as a `sense` within `senses`\nEach sense may be preceded by a bolded number which will be tagged as a `number`\nEach Binyan will also be broken down into `senses`", + "TopicJSON": { + "title": "Root Type for TopicJSON", + "description": "A JSON object containing all of the metadata for a topic object", + "required": [ + "slug", + "titles" + ], "type": "object", "properties": { - "definition": { - "description": "A definition of the word", - "type": "string" + "slug": { + "description": "The unique slug for a given topic.", + "type": "string", + "example": "nachman-of-breslov" }, - "grammar": { - "description": "", + "titles": { + "description": "An array of JSON objects, each representing an alternative title for the object, in various languages. ", + "type": "array", + "items": { + "$ref": "#/components/schemas/TopicTitlesJSON" + }, + "example": "\"titles\": [\n {\n \"text\": \"Tabernacles\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Booths\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"sukkot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"חג הסוכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"סכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"Sukkot\",\n \"lang\": \"en\",\n \"primary\": true\n },\n {\n \"text\": \"סוכות\",\n \"lang\": \"he\",\n \"primary\": true\n }\n]" + }, + "alt_ids": { + "description": "This is a dictionary containing the keys of naming schemes, and ids of this topic represented in that naming scheme. It’s used both for canonical names in other naming schemes and temporary storage of names when renaming slugs. All of the data here is for internal use, with the exception of the values `bfo` and `wikidata`. `bfo` refers to [basic formal ontology](https://github.com/BFO-ontology/BFO#implementations), and `wikidata` to the wikidata ontology of topics. ", "type": "object", "properties": { - "verbal_stem": { - "type": "string" - }, - "language_code": { + "_temp_id": { "type": "string" + } + }, + "example": "\"alt_ids\": {\n \"_temp_id\": \"משה\",\n \"wikidata\": \"Q9077\",\n \"_old_slug\": \"-75\"\n}" + }, + "properties": { + "$ref": "#/components/schemas/TopicPropertyJson", + "description": "The properties stores optional data relating to the topic, including links (if relevant) to where on can learn more about the topic. ", + "properties": { + "heNliLink": { + "type": "object", + "properties": { + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } + } }, - "binyan_form": { - "description": "Found in verbs, a binyan is a linguistic alternate use of the word. It will be one of the following: Hiph., Hish., Hith., Hithpalp., Hithpol., Hoph., Hoth., Niph, , Nith., Pa., Pi., Pil., Pilp., Pir., Po., Pol., Polp., Pu., Pul., Pulp., Qal., Shaph., Shiph., Shuph., Tiph., Tuph., Hif., Nif., Hithpa., Af., Ithpa., Ithpe., Nithpa", - "type": "array", - "items": { - "type": "string" + "enNliLink": { + "type": "object", + "properties": { + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } } } - } - }, - "number": { - "type": "string" - } - } - }, - "recommendedTopicResponse": { - "title": "Root Type for recommendedTopicResponse", - "description": "", - "type": "object", - "properties": { - "slug": { - "description": "the url slug for the topic.", - "type": "string" + }, + "example": "\"properties\": {\n \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n },\n \"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n }\n}" }, - "titles": { - "description": "Titles for the topic by language (usually Hebrew & English)", - "type": "object", + "description": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "A description of the topic in English", "properties": { "en": { "type": "string" @@ -2575,535 +5451,412 @@ "he": { "type": "string" } - } - }, - "count": { - "format": "int32", - "description": "Number of times the topic appears in the references", - "type": "integer" - } - }, - "example": { - "slug": "jacobs-burial", - "titles": { - "en": "Jacob's Burial", - "he": "קבורת יעקב" + }, + "example": "\"description\": {\n \"en\": \"Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.\",\n \"he\": \"חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'\"\n}" }, - "count": 3 - } - }, - "ManuscriptJSON": { - "title": "Root Type for ManuscriptJSON", - "description": "Manuscript data and metadata JSON. ", - "required": [ - "manuscript" - ], - "type": "object", - "properties": { - "manuscript_slug": { - "description": "A unique slug for the given manuscript", - "type": "string", - "example": "leningrad-codex-(1008-ce)" + "categoryDescription": { + "description": "A description of the category of this topic", + "type": "string" }, - "page_id": { - "description": "The ID for the specific page within the manuscript being referenced. ", - "type": "string", - "example": "LC_Folio_435r" + "displayOrder": { + "format": "int32", + "description": "The order in which topics are displayed on the Sefaria website, relative to other topics within their same category. ", + "type": "integer", + "example": "1" }, - "image_url": { - "description": "The URL to the image of the manuscript, hosted by Sefaria. All URLs will be prefaced by `https://manuscripts.sefaria.org/`", - "type": "string", - "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" + "numSources": { + "format": "int32", + "description": "The number of text sources associated with a topic. ", + "type": "integer", + "example": "831" }, - "thumbnail_url": { - "description": "The url to the thumbnail image of the manuscript. ", - "type": "string", - "example": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg" + "description_published": { + "description": "A boolean representing whether or not the description was published. ", + "type": "boolean", + "example": "true" }, - "anchorRef": { - "description": "A manuscript image will in most cases be associated with a range of `refs` (i.e. an image of a page of Tanakh will display multiple verses). The `anchorRef` is that complete range the manuscript is associated with, and will contain within it the specific `tref` passed in as a parameter. ", + "data_source": { + "description": "How the topic was generated, whether by `sefaria`, a user on a source sheet, or some other source. ", "type": "string", - "example": "\"Esther 3:15-4:17\"" - }, - "anchorRefExpanded": { - "description": "An array of strings, where each string is a segment level `ref` of the `ref` passed in as a parameter. If a segment level `ref` is passed in, this array will have a length of 1, and only contain that segment level `ref`. If the `ref` passed in is ranged, this array will contain each of the segment level `ref`s within that range. \n\nFor example, if someone was searching for manuscript data for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", - "minItems": 1, - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" - }, - "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" + "example": "`sefaria`" }, - "manuscript": { - "$ref": "#/components/schemas/ManuscriptVersionMetaData", - "description": "The version metadata for the manuscript, including the title, Hebrew and English descriptions. ", + "image": { + "$ref": "#/components/schemas/TopicImgJSON", + "description": "Metadata for images associated with topics. ", "properties": { - "slug": { - "type": "string" - }, - "title": { - "type": "string" - }, - "he_title": { + "image_uri": { "type": "string" }, - "source": { + "image_caption": { + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + } + } + }, + "example": "\"image\": {\n \"image_uri\": \"https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg\",\n \"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n }\n}" + }, + "primaryTitle": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "The primary title for a topic.", + "properties": { + "en": { "type": "string" }, - "description": { + "he": { "type": "string" + } + }, + "example": "{\n \"en\": \"Sukkot\",\n \"he\": \"סוכות\"\n}" + }, + "primaryTitleIsTransliteration": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "This field has the possibility of being used to indicate whether or not a title is a transliteration, however the data here is not always consistent or up-to-date. Therefore, it is best to disregard the data in this field, and there are many false negatives. ", + "properties": { + "en": { + "type": "boolean" }, - "he_description": { - "type": "string" + "he": { + "type": "boolean" } }, - "example": "" + "example": "\"primaryTitleIsTransliteration\": {\n \"en\": false,\n \"he\": false\n}" } }, "example": { - "manuscript_slug": "leningrad-codex-(1008-ce)", - "page_id": "LC_Folio_434v", - "image_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B.jpg", - "thumbnail_url": "https://manuscripts.sefaria.org/leningrad-color/BIB_LENCDX_F434B_thumbnail.jpg", - "anchorRef": "Esther 3:15-4:17", - "anchorRefExpanded": [ - "Esther 4:14" + "slug": "sukkot", + "titles": [ + { + "text": "Tabernacles", + "lang": "en" + }, + { + "text": "Succot", + "lang": "en" + }, + { + "text": "Sukkos", + "lang": "en" + }, + { + "text": "Succos", + "lang": "en" + }, + { + "text": "Booths", + "lang": "en" + }, + { + "text": "sukkot", + "lang": "en" + }, + { + "text": "succot", + "lang": "en" + }, + { + "text": "Succoth", + "lang": "en" + }, + { + "text": "Sukkoth", + "lang": "en" + }, + { + "text": "חג הסוכות", + "lang": "he" + }, + { + "text": "סכות", + "lang": "he" + }, + { + "text": "Sukkot", + "lang": "en", + "primary": true + }, + { + "text": "סוכות", + "lang": "he", + "primary": true + } ], - "manuscript": { - "slug": "leningrad-codex-(1008-ce)", - "title": "Leningrad Codex (1008 CE)", - "he_title": "כתב יד לנינגרד (1008)", - "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", - "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", - "he_description": "" - } - } - }, - "ManuscriptVersionMetaData": { - "title": "Root Type for ManuscriptVersionMetaData", - "description": "The specific metadata for the version of the manuscript. ", - "required": [ - "slug", - "description", - "he_description", - "he_title", - "source", - "title" - ], - "type": "object", - "properties": { - "slug": { - "description": "The unique slug for the manuscript. ", - "type": "string", - "example": "leningrad-codex-(1008-ce)" + "alt_ids": { + "_temp_id": "סוכות" }, - "title": { - "description": "The title of the manuscript. ", - "type": "string", - "example": "Leningrad Codex (1008 CE)" + "properties": { + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + }, + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + } }, - "he_title": { - "description": "The manuscript title in Hebrew. ", - "type": "string", - "example": "כתב יד לנינגרד (1008)" + "description": { + "en": "Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.", + "he": "חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'" }, - "source": { - "description": "The url for the source of the manuscript images. ", - "type": "string", - "example": "https://dornsife.usc.edu/wsrp/biblical-manuscripts/" + "categoryDescription": {}, + "displayOrder": 4, + "numSources": 831, + "description_published": true, + "data_source": "sefaria", + "image": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", + "image_caption": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } }, - "description": { - "description": "A description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", - "type": "string", - "example": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin" + "primaryTitle": { + "en": "Sukkot", + "he": "סוכות" }, - "he_description": { - "description": "A Hebrew description of the manuscript, oftening containing details about the archivists or where the physical manuscript images can be found, as well as other library details. ", - "type": "string" + "primaryTitleIsTransliteration": { + "en": false, + "he": false } - }, - "example": { - "slug": "leningrad-codex-(1008-ce)", - "title": "Leningrad Codex (1008 CE)", - "he_title": "כתב יד לנינגרד (1008)", - "source": "https://dornsife.usc.edu/wsrp/biblical-manuscripts", - "description": "Bruce Zuckerman, West Semitic Research, in collaboration with the Ancient Biblical Manuscript Center; courtesy Russian National Library, Saltykov-Schedrin", - "he_description": "" } }, - "wordCompletionAPIResponse": { - "description": "An array of arrays, each containing two strings. The first is a completion entry in Hebrew without vowels and the second includes vowels.", - "type": "array", - "items": { - "type": "string" - }, - "example": [ - [ - "אב", - "אַב" - ] - ] - }, - "VersionJSON": { - "title": "Root Type for VersionJSON", - "description": "The metadata for a given version. ", + "TopicImgJSON": { + "title": "Root Type for TopicImgJSON", + "description": "A JSON object containing the image metadata for topics with images. ", "type": "object", "properties": { - "title": { - "description": "The title of the Index. ", - "type": "string", - "example": "Talmud Berakhot" - }, - "versionTitle": { - "description": "The title of the version", - "type": "string", - "example": "\"William Davidson Edition - Vocalized Aramaic\"" - }, - "versionSource": { - "description": "A URL pointing to the hardcopy of the text as it can be found in libraries, most usually in our case the NLI (National Library of Israel), but not exclusively. ", - "type": "string", - "example": "https://www.nli.org.il/he/books/NNL_ALEPH990025294890205171/NLI" - }, - "language": { - "$ref": "#/components/schemas/LanguageCode", - "description": "The language of the version. The versions on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic)", - "example": "'en'\n'he'" - }, - "status": { - "description": "The status field contains either the string `\"locked\"` or an empty string. If `\"locked\"` is the value of the field, it indicates that the text is locked from future updatees, edits and translations from community members. ", - "type": "string", - "example": "\"locked\"" - }, - "license": { - "description": "The copyright license for using, and reproducing the text. ", - "type": "string", - "example": "CC-BY" - }, - "versionNotes": { - "description": "English notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", + "image_uri": { + "description": "The URL pointing to the image as hosted by Sefaria. ", "type": "string", - "example": "\"English from The William Davidson digital edition of the Koren Noé Talmud, with commentary by Rabbi Adin Even-Israel Steinsaltz\"," - }, - "digitizedBySefaria": { - "description": "Whether or not the text was digitized by Sefaria. We have some texts we've been able to add to our database from digital sources, and other texts that we've transfered from print to a digital medium ourselves. This field indicates if Sefaria did the digitization. ", - "type": "boolean", - "example": "True" - }, - "priority": { - "description": "The priority field is a number which indicates the priority of a version relative to all other existing versions of the same text. A value of `1` indicates the lowest priority, while the highest value among all versions of the text indicate the highest priority. Priority values can also be floating point numbers. The priority field determines how the various available versions of a text will be displayed on the Sefaria website. The texts are displayed to the user in a highest-to-lowest priority order, in many cases offering more complete or higher quality versions of the text before ones of inferior quality. ", - "type": "number", - "example": "7" + "example": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg" }, - "versionTitleInHebrew": { - "description": "The title of the version in Hebrew", + "image_caption": { + "$ref": "#/components/schemas/BillingualJSON", + "description": "A JSON object containing the billingual caption data for an image associated with a topic.", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" + } + }, + "example": "\"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n}" + } + }, + "example": { + "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", + "image_caption": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + } + }, + "BillingualJSON": { + "title": "Root Type for TopicImgCaption", + "description": "A JSON object containing billingual text, both `he` and `en` parallel texts. ", + "type": "object", + "properties": { + "en": { + "description": "The English field for a JSON object representing billingual text. ", "type": "string", - "example": "מהדורת וויליאם דייוידסון - ארמית המנוקד" - }, - "versionNotesInHebrew": { - "description": "Hebrew notes relating to the version, often containing details of authorship, place of printing, and sometimes donor dedications. ", - "type": "string" - }, - "extendedNotes": { - "description": "English extended notes on a version that go beyond the time and place of printing. ", - "type": "string" - }, - "extendedNotesHebrew": { - "description": "Hebrew extended notes on a version that go beyond the time and place of printing. ", - "type": "string" + "example": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library" }, - "purchaseInformationImage": { - "description": "A URL pointing to an image of the hard copy of the version associated with the digital copy, for those who would like to purchase a hard copy. ", + "he": { + "description": "The Hebrew field for a JSON object representing billingual text. ", "type": "string", - "example": "\"https://storage.googleapis.com/sefaria-physical-editions/4fc4b6d5b144eb3915d250d743eaf2e8.png\"" - }, - "purchaseInformationURL": { - "description": "The URL pointing to a website where on can buy a physical copy of the given text version. ", + "example": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + }, + "example": { + "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", + "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + } + }, + "TopicTitlesJSON": { + "title": "Root Type for TopicTitlesJSON", + "description": "Alternative title for a topic, along with the language code representing the language of the given title. ", + "type": "object", + "properties": { + "text": { + "description": "The text of the title", "type": "string", - "example": "\"https://korenpub.com/collections/the-noe-edition-koren-talmud-bavli-1/products/copy-of-vol-1-berakhot-1\"" + "example": "Sukkoth" }, - "shortVersionTitle": { - "description": "An English short title for the version", + "lang": { + "description": "The language of the title, either `en` or `he`. ", "type": "string", - "example": "\"Koren - Steinsaltz\"" - }, - "shortVersionTitleInHebrew": { - "description": "A Hebrew short title for the version", - "type": "string" + "example": "he" }, - "isBaseText": { - "description": "Is this a text that has commentary. `true` indicates that there are commentaries on this text, while `false` indicates that the text does not have any commentary. ", + "Primary": { + "description": "A field depicting whether or not the title is the primary title. Note: For any given topics, one should expect two titles with this field present and set to `true`, an English and a Hebrew primary title. The English value with `primary` set to `true` will match the string value of the `primaryTitle` field on topic. ", "type": "boolean", - "example": "True" - }, - "firstSectionRef": { - "description": "The first `ref` for this title on a section level (as opposed to the more granular segment level). For example, `Genesis 1` would be the first section level ref of Genesis (as opposed to the segment, `Genesis 1:1`), and `Rashi on Kohelet 1:1` is the first section level ref of `Rashi on Kohelet` (as opposed to the segment level of `Rashi on Kohelet 1:1:1`)", - "type": "string", - "example": "Rashi on Kohelet 1.1" + "example": "false" } }, "example": { - "title": "Shulchan Arukh, Orach Chayim", - "versionTitle": "Wikisource Shulchan Aruch", - "versionSource": "https://en.wikisource.org/wiki/Translation:Shulchan_Aruch/Orach_Chaim/338", - "language": "en", - "status": "", - "license": "CC-BY-SA", - "versionNotes": "", - "digitizedBySefaria": "", - "priority": "", - "versionTitleInHebrew": "שולחן ערוך (ויקיטקסט)", - "versionNotesInHebrew": "", - "extendedNotes": "", - "extendedNotesHebrew": "", - "purchaseInformationImage": "", - "purchaseInformationURL": "", - "shortVersionTitle": "", - "shortVersionTitleInHebrew": "", - "isBaseText": false, - "firstSectionRef": "Shulchan Arukh, Orach Chayim 1" + "text": "Tabernacles", + "lang": "en", + "primary": false } }, - "LanguageCode": { - "description": "The texts on Sefaria are grouped into two language buckets, `en` for languages which read left-to-right (i.e. English, Spanish, German) and `he` for languages which read right-to-left (i.e. Hebrew, Arabic). This field is only ever populated by a string containing the value of either `en` or `he`. ", - "type": "string", - "example": "'en'\n'he'" - }, - "FindRefsPOSTRequest": { - "title": "Root Type for FindRefsPOSTRequest", - "description": "A properly formatted POST request for the Find Refs API", + "TopicPropertyJson": { + "title": "Root Type for TopicPropertyJson", + "description": "The JSON object containing information about a topic's properties", "type": "object", "properties": { - "text": { - "description": "Initially designed for websites, this API expects the `text` field to contain both a `body` and a `title`. When parsing arbitrary text feel free to just use `body` and pass an empty string `''` to `title`", - "type": "object", + "heNliLink": { + "$ref": "#/components/schemas/NLILinkJSON", + "description": "A link to the Hebrew page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", "properties": { - "body": { + "value": { "type": "string" }, - "title": { + "dataSource": { "type": "string" } - } + }, + "example": " \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" }, - "lang": { - "description": "Either `he` or `en`. If not included, it will default to one based on the number of Hebrew or Latin characters in the `body` of the `text`.", - "type": "string" + "enNliLink": { + "$ref": "#/components/schemas/NLILinkJSON", + "description": "A link to the English page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", + "properties": { + "value": { + "type": "string" + }, + "dataSource": { + "type": "string" + } + }, + "example": "\"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" } }, "example": { - "text": { - "body": "Genesis 1:1 is a citation and also Mishnah Peah 3-4. So is שמות ב", - "title": "Some thoughts on Sefer Bereishit 1" + "heNliLink": { + "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" }, - "lang": "en" + "enNliLink": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + } } }, - "FindRefsAPIResponse": { - "title": "Root Type for FindRefsAPIResponse", - "description": "A response to the Find Refs API", + "NLILinkJSON": { + "title": "Root Type for NLILinkJSON", + "description": "JSON for storing NLI links related to data in the Sefaria database. ", "type": "object", "properties": { - "title": { - "description": "Information about any references found in the `title` field of the POST request", + "value": { + "description": "A link to a corresponding NLI page to learn more. ", + "type": "string", + "example": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot" + }, + "dataSource": { + "description": "The source of the topic data, whether user-created or Sefaria-created. ", + "type": "string", + "example": "`sefaria`" + } + }, + "example": { + "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", + "dataSource": "sefaria" + } + }, + "CalendarNextReadAPI": { + "title": "Root Type for CalendarNextReadAPI", + "description": "", + "type": "object", + "properties": { + "parasha": { "type": "object", "properties": { - "results": { - "type": "array", - "items": { - "description": "A single matched reference", - "type": "object", - "properties": { - "startChar": { - "format": "int32", - "description": "The index of the starting character of the match", - "type": "integer" - }, - "endChar": { - "format": "int32", - "description": "The index of the ending character of the match", - "type": "integer" - }, - "text": { - "description": "The matched reference", - "type": "string" - }, - "linkFailed": { - "type": "boolean" - }, - "refs": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } - } + "title": { + "description": "This should always read `Parashat Hashavua`", + "type": "object", + "properties": { + "en": { + "type": "string" + }, + "he": { + "type": "string" } - } + }, + "example": "Daf Yomi" }, - "refData": { + "displayValue": { + "description": "The name of the Parashah", "type": "object", "properties": { - "RefTitle": { - "type": "object", - "properties": { - "heRef": { - "description": "The Hebrew equivalent of the cannonical ref", - "type": "string" - }, - "url": { - "description": "The URL this ref can be found at on Sefaria", - "type": "string" - }, - "primaryCategory": { - "description": "The primary category this ref belongs to on Sefaria", - "type": "string" - } - } + "en": { + "type": "string" + }, + "he": { + "type": "string" } - } - } - } - }, - "body": { - "description": "Information about any references found in the `body` field of the POST request", - "type": "object", - "properties": { - "results": { - "type": "array", - "items": { - "description": "A single matched reference", - "type": "object", - "properties": { - "startChar": { - "format": "int32", - "description": "The index of the starting character of the match", - "type": "integer" - }, - "endChar": { - "format": "int32", - "description": "The index of the ending character of the match", - "type": "integer" - }, - "text": { - "description": "The matched reference", + }, + "example": "Vayishlach" + }, + "url": { + "description": "The url path on Sefaria where this selection can be found", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "heRef": { + "description": "The Hebrew equivalent of the `ref`", + "type": "string" + }, + "order": { + "format": "int32", + "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", + "type": "integer" + }, + "category": { + "description": "Should always return `Tanakh`", + "type": "string" + }, + "extraDetails": { + "description": "Additional details about this learning schedule entry", + "type": "object", + "properties": { + "aliyot": { + "description": "The breakdown of aliyot for a parashah", + "type": "array", + "items": { "type": "string" - }, - "linkFailed": { - "type": "boolean" - }, - "refs": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ref" - } } } } }, - "refData": { + "description": { + "description": "A description of this learning schedule entry if it exists in `he` and `en`", "type": "object", "properties": { - "RefTitle": { - "type": "object", - "properties": { - "heRef": { - "description": "The Hebrew equivalent of the cannonical ref", - "type": "string" - }, - "url": { - "description": "The URL this ref can be found at on Sefaria", - "type": "string" - }, - "primaryCategory": { - "description": "The primary category this ref belongs to on Sefaria", - "type": "string" - } - } + "en": { + "type": "string" + }, + "he": { + "type": "string" } } } } - } - }, - "example": { - "title": { - "results": [ - { - "startChar": 23, - "endChar": 34, - "text": "Bereishit 1", - "linkFailed": false, - "refs": [ - "Genesis 1" - ] - } - ], - "refData": { - "Genesis 1": { - "heRef": "בראשית א׳", - "url": "Genesis.1", - "primaryCategory": "Tanakh" - } - } - }, - "body": { - "results": [ - { - "startChar": 0, - "endChar": 11, - "text": "Genesis 1:1", - "linkFailed": false, - "refs": [ - "Genesis 1:1" - ] - }, - { - "startChar": 35, - "endChar": 51, - "text": "Mishnah Peah 3-4", - "linkFailed": false, - "refs": [ - "Mishnah Peah 3-4" - ] - } - ], - "refData": { - "Genesis 1:1": { - "heRef": "בראשית א׳:א׳", - "url": "Genesis.1.1", - "primaryCategory": "Tanakh" - }, - "Mishnah Peah 3-4": { - "heRef": "משנה פאה ג׳-ד׳", - "url": "Mishnah_Peah.3-4", - "primaryCategory": "Mishnah" - } - } - } - } - }, - "CalendarAPIResponse": { - "title": "Root Type for CalendarAPIResponse", - "description": "A response from the Calendar API", - "type": "object", - "properties": { - "date": { - "format": "date", - "description": "The datestring for the calendars shown. It should match the values submitted in `year` `month` `day` or should be the current date.", - "type": "string" }, - "timezone": { - "description": "An IANA timezone name", - "type": "string" - }, - "calendar_items": { + "haftarah": { "type": "array", "items": { - "description": "A single learning schedule for the selected date", "type": "object", "properties": { "title": { - "description": "The learning schedule title in `he` and `en`", + "description": "This should always read `Haftarah`", "type": "object", "properties": { "en": { @@ -3116,7 +5869,7 @@ "example": "Daf Yomi" }, "displayValue": { - "description": "The name of the reading for the selected date in the learning schedule in `en` and `he`", + "description": "The name of the Haftarah", "type": "object", "properties": { "en": { @@ -3135,651 +5888,1488 @@ "ref": { "$ref": "#/components/schemas/ref" }, - "heRef": { - "description": "The Hebrew equivalent of the `ref`", - "type": "string" - }, "order": { "format": "int32", "description": "This is used internally on Sefaria to arrange the learning schedules in the manner we choose.", "type": "integer" }, "category": { - "description": "The primary category that this `ref` belongs to", + "description": "Should return `Tanakh`", "type": "string" - }, - "extraDetails": { - "description": "Additional details about this learning schedule entry", - "type": "object", - "properties": { - "aliyot": { - "description": "The breakdown of aliyot for a parashah", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "description": { - "description": "A description of this learning schedule entry if it exists in `he` and `en`", - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } } } } - } - }, - "example": { - "date": "2023-11-28", - "timezone": "America/Halifax", - "calendar_items": [ - { - "title": { - "en": "Parashat Hashavua", - "he": "פרשת השבוע" - }, - "displayValue": { - "en": "Vayishlach", - "he": "וישלח" - }, - "url": "Genesis.32.4-36.43", - "ref": "Genesis 32:4-36:43", - "heRef": "בראשית ל״ב:ד׳-ל״ו:מ״ג", - "order": 1, - "category": "Tanakh", - "extraDetails": { - "aliyot": [ - "Genesis 32:4-32:13", - "Genesis 32:14-32:30", - "Genesis 32:31-33:5", - "Genesis 33:6-33:20", - "Genesis 34:1-35:11", - "Genesis 35:12-36:19", - "Genesis 36:20-36:43", - "Genesis 36:40-36:43" - ] - }, - "description": { - "en": "Vayishlach (“He Sent”) follows Jacob and his family as Jacob wrestles with a man (commonly understood as an angel), is renamed Israel, and reconciles with his brother, Esau. Jacob’s daughter, Dina, is raped by a Hivite prince, and her brothers sack a city in response. Rachel dies as she gives birth to Jacob's youngest child, Benjamin.", - "he": "פרשת וישלח ממשיכה לעקוב אחרי יעקב ומשפחתו. יעקב נאבק עם איש (שלפי הפרשנות המקובלת הוא מלאך אלוהים), ובסיום המאבק האיש מעניק לו את השם ישראל. יעקב מתפייס עם אחיו עשו. דינה, בתו של יעקב, נאנסת ונשבית בידי נסיך חיווי, ואחיה הורגים את כל הזכרים בעיר ומשיבים אליהם את דינה. רחל מתה בשעת לידתו של בנימין, הצעיר בבני יעקב." - } - }, - { - "title": { - "en": "Haftarah", - "he": "הפטרה" - }, - "displayValue": { - "en": "Obadiah 1:1-21", - "he": "עובדיה א׳:א׳-כ״א" - }, - "url": "Obadiah.1.1-21", - "ref": "Obadiah 1:1-21", - "order": 2, - "category": "Tanakh" - }, - { - "title": { - "en": "Daf Yomi", - "he": "דף יומי" - }, - "displayValue": { - "en": "Bava Kamma 26", - "he": "בבא קמא כ״ו" - }, - "url": "Bava_Kamma.26", - "ref": "Bava Kamma 26", - "order": 3, - "category": "Talmud" - }, - { - "title": { - "en": "929", - "he": "929" - }, - "displayValue": { - "en": "Ezekiel 21 (473)", - "he": "יחזקאל כ״א (473)" - }, - "url": "Ezekiel.21", - "ref": "Ezekiel 21", - "order": 4, - "category": "Tanakh" - }, - { - "title": { - "en": "Daily Mishnah", - "he": "משנה יומית" - }, - "displayValue": { - "en": "Mishnah Yevamot 10:4-5", - "he": "משנה יבמות י׳:ד׳-ה׳" - }, - "url": "Mishnah_Yevamot.10.4-5", - "ref": "Mishnah Yevamot 10:4-5", - "order": 5, - "category": "Mishnah" - }, - { - "title": { - "en": "Daily Rambam", - "he": "הרמב\"ם היומי" - }, - "displayValue": { - "en": "Marriage 14", - "he": "הלכות אישות י״ד" + }, + "date": { + "format": "date-time", + "type": "string" + }, + "he_date": { + "type": "object", + "properties": { + "en": { + "type": "string" }, - "url": "Mishneh_Torah,_Marriage.14", - "ref": "Mishneh Torah, Marriage 14", - "order": 6, - "category": "Halakhah" + "he": { + "type": "string" + } + } + } + }, + "example": { + "parasha": { + "title": { + "en": "Parashat Hashavua", + "he": "פרשת השבוע" }, - { - "title": { - "en": "Daily Rambam (3 Chapters)", - "he": "הרמב\"ם היומי (3 פרקים)" - }, - "displayValue": { - "en": "Other Sources of Defilement 9-11", - "he": "הלכות שאר אבות הטומאות ט׳-י״א" - }, - "url": "Mishneh_Torah,_Other_Sources_of_Defilement.9-11", - "ref": "Mishneh Torah, Other Sources of Defilement 9-11", - "order": 7, - "category": "Halakhah" + "displayValue": { + "en": "Vayakhel-Pekudei", + "he": "ויקהל-פקודי" }, - { - "title": { - "en": "Daf a Week", - "he": "דף השבוע" - }, - "displayValue": { - "en": "Ketubot 64", - "he": "כתובות ס״ד" - }, - "url": "Ketubot.64", - "ref": "Ketubot 64", - "order": 8, - "category": "Talmud" + "url": "Exodus.35.1-40.38", + "ref": "Exodus 35:1-40:38", + "heRef": "שמות ל״ה:א׳-מ׳:ל״ח", + "order": 1, + "category": "Tanakh", + "extraDetails": { + "aliyot": [ + "Exodus 35:1-35:29", + "Exodus 35:30-37:16", + "Exodus 37:17-37:29", + "Exodus 38:1-39:1", + "Exodus 39:2-39:21", + "Exodus 39:22-39:43", + "Exodus 40:1-40:38", + "Exodus 12:1-12:20" + ] }, + "description": { + "en": "Vayakhel (“He Assembled”) opens as God commands the Israelites to observe the Sabbath. Moses asks for material donations for the building of the Mishkan (Tabernacle), and the people donate. A group of artisans designated by God begin building the Mishkan and its vessels.\n\nPekudei (“Accountings Of”) is the final Torah reading in the Book of Exodus. It describes the making of priestly garments worn in the Mishkan (Tabernacle) and the completion of its construction. At God’s command, Moses erects the Mishkan and puts its vessels in place, and God's presence fills the Mishkan.", + "he": "בפרשת ויקהל בני ישראל מצווים לשמור את השבת. בני ישראל מתבקשים לתרום חומרים לבניית המשכן; הם נענים לבקשה בנדיבות ומתבקשים להפסיק לתרום. בצלאל ואהליאב מתחילים לנהל את בניית מבנה המשכן, כלי המשכן והחצר. כל פרט מבוצע כפי שציווה אלוהים את משה.\n\nפרשת פקודי, האחרונה בספר שמות, מסכמת את תרומות החומרים השונים למשכן, ואת עשיית בגדי הכהונה. בפרשה מתואר אירוע הקמת המשכן והכנסת הכלים לתוכו. משהושלמה בניית המשכן הענן מכסה את אוהל מועד, והשכינה שורה במשכן. ענן שוכן על המשכן ביום, ובלילה נראית בו אש, לעיני בני ישראל." + } + }, + "haftarah": [ { "title": { - "en": "Halakhah Yomit", - "he": "הלכה יומית" + "en": "Haftarah", + "he": "הפטרה" }, "displayValue": { - "en": "Shulchan Arukh, Orach Chayim 535:2-536:1", - "he": "שולחן ערוך, אורח חיים תקל״ה:ב׳-תקל״ו:א׳" + "en": "Ezekiel 45:16-46:18", + "he": "יחזקאל מ״ה:ט״ז-מ״ו:י״ח" }, - "url": "Shulchan_Arukh,_Orach_Chayim.535.2-536.1", - "ref": "Shulchan Arukh, Orach Chayim 535:2-536:1", - "order": 9, - "category": "Halakhah" + "url": "Ezekiel.45.16-46.18", + "ref": "Ezekiel 45:16-46:18", + "order": 2, + "category": "Tanakh" + } + ], + "date": "2026-03-14T00:00:00", + "he_date": { + "en": "Adar 25, 5786", + "he": "אדר 25, 5786" + } + } + }, + "APIIndexResponse": { + "title": "Root Type for APIIndexResponse", + "description": "", + "type": "array", + "items": { + "type": "object", + "properties": { + "contents": { + "description": "This level of the object is a category listing.", + "type": "array", + "items": { + "type": "object", + "properties": { + "contents": { + "description": "This level of the object is usually a book level.", + "type": "array", + "items": { + "type": "object", + "properties": { + "categories": { + "description": "A list of categories that this book belongs to.", + "type": "array", + "items": { + "type": "string" + } + }, + "order": { + "format": "int32", + "description": "This is used to order the texts on the Sefaria website.", + "type": "integer" + }, + "primary_category": { + "description": "The main category that this work falls under.", + "type": "string" + }, + "enShortDesc": { + "description": "A short description of this book in English.", + "type": "string" + }, + "heShortDesc": { + "description": "A short description of this book in Hebrew.", + "type": "string" + }, + "corpus": { + "description": "The corpus that this work belongs to e.g. `Tanakh` or `Mishnah` etc.", + "type": "string" + }, + "heTitle": { + "description": "The Hebrew title of this work.", + "type": "string" + }, + "title": { + "description": "The English title of this work.", + "type": "string" + } + } + } + }, + "order": { + "format": "int32", + "description": "This is used to order the texts on the Sefaria website.", + "type": "integer" + }, + "enComplete": { + "description": "Is the entirety of this category available in English", + "type": "boolean" + }, + "heComplete": { + "description": "Is the entirety of this category available in Hebrew", + "type": "boolean" + }, + "enDesc": { + "description": "An English description of the category", + "type": "string" + }, + "heDesc": { + "description": "An Hebrew description of the category", + "type": "string" + }, + "enShortDesc": { + "description": "A short description of this category in English.", + "type": "string" + }, + "heShortDesc": { + "description": "A short description of this category in Hebrew.", + "type": "string" + }, + "heCategory": { + "type": "string" + }, + "category": { + "description": "The current category that these works are nested in.", + "type": "string" + } + } + } }, - { - "title": { - "en": "Arukh HaShulchan Yomi", - "he": "ערוך השולחן היומי" + "order": { + "format": "int32", + "description": "This is used to order the categories on the Sefaria website.", + "type": "integer" + }, + "enComplete": { + "description": "Is the entirety of this category available in English", + "type": "boolean" + }, + "heComplete": { + "description": "Is the entirety of this category available in Hebrew", + "type": "boolean" + }, + "enDesc": { + "description": "An English description of the category", + "type": "string" + }, + "heDesc": { + "description": "An Hebrew description of the category", + "type": "string" + }, + "enShortDesc": { + "description": "A short description of this category in English.", + "type": "string" + }, + "heShortDesc": { + "description": "A short description of this category in Hebrew.", + "type": "string" + }, + "heCategory": { + "type": "string" + }, + "category": { + "description": "The current category that these works are nested in.", + "type": "string" + } + } + } + }, + "searchResponse": { + "title": "Root Type for searchResponse", + "description": "", + "type": "object", + "properties": { + "took": { + "format": "int32", + "type": "integer" + }, + "timed_out": { + "type": "boolean" + }, + "_shards": { + "type": "object", + "properties": { + "total": { + "format": "int32", + "type": "integer" }, - "displayValue": { - "en": "Yoreh De'ah 191:7-15", - "he": "יורה דעה קצ״א:ז׳-ט״ו" + "successful": { + "format": "int32", + "type": "integer" }, - "url": "Arukh_HaShulchan,_Yoreh_De'ah.191.7-15", - "ref": "Arukh HaShulchan, Yoreh De'ah 191:7-15", - "order": 10, - "category": "Halakhah" - }, - { - "title": { - "en": "Tanakh Yomi", - "he": "תנ\"ך יומי" + "skipped": { + "format": "int32", + "type": "integer" }, - "displayValue": { - "en": "Samuel Seder 17", - "he": "שמואל סדר יז" + "failed": { + "format": "int32", + "type": "integer" + } + } + }, + "hits": { + "type": "object", + "properties": { + "total": { + "format": "int32", + "type": "integer" }, - "url": "I_Samuel.25.33-26.24", - "ref": "I Samuel 25:33-26:24", - "order": 11, - "category": "Tanakh" - }, - { - "title": { - "en": "Chok LeYisrael", - "he": "חק לישראל" + "max_score": { + "format": "double", + "type": "number" }, - "displayValue": { - "en": "Vayishlach", - "he": "וישלח" + "hits": { + "type": "array", + "items": { + "type": "object", + "properties": { + "_index": { + "type": "string" + }, + "_type": { + "type": "string" + }, + "_id": { + "type": "string" + }, + "_score": { + "format": "double", + "type": "number" + }, + "_source": { + "type": "object", + "properties": { + "ref": { + "type": "string" + }, + "heRef": { + "type": "string" + }, + "version": { + "type": "string" + }, + "lang": { + "type": "string" + }, + "version_priority": { + "format": "int32", + "type": "integer" + }, + "titleVariants": { + "type": "array", + "items": { + "type": "string" + } + }, + "categories": { + "type": "array", + "items": { + "type": "string" + } + }, + "order": { + "type": "string" + }, + "path": { + "type": "string" + }, + "pagesheetrank": { + "format": "double", + "type": "number" + }, + "comp_date": { + "format": "int32", + "type": "integer" + }, + "exact": { + "type": "string" + }, + "naive_lemmatizer": { + "type": "string" + }, + "hebrew_version_title": { + "type": "string" + } + } + }, + "highlight": { + "type": "object", + "properties": { + "naive_lemmatizer": { + "type": "array", + "items": { + "type": "string" + } + } + } + } + } + } + } + } + }, + "aggregations": { + "type": "object", + "properties": { + "path": { + "type": "object", + "properties": { + "doc_count_error_upper_bound": { + "format": "int32", + "type": "integer" + }, + "sum_other_doc_count": { + "format": "int32", + "type": "integer" + }, + "buckets": { + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "type": "string" + }, + "doc_count": { + "format": "int32", + "type": "integer" + } + } + } + } + } + } + } + } + }, + "example": { + "took": 11, + "timed_out": false, + "_shards": { + "total": 5, + "successful": 5, + "skipped": 0, + "failed": 0 + }, + "hits": { + "total": 7, + "max_score": 16692.562, + "hits": [ + { + "_index": "text-b", + "_type": "text", + "_id": "Shabbat 73b:7 (Sefaria Community Translation [en])", + "_score": 16692.562, + "_source": { + "ref": "Shabbat 73b:7", + "heRef": "שבת ע״ג ב:ז׳", + "version": "Sefaria Community Translation", + "lang": "en", + "version_priority": 1, + "titleVariants": [ + "Masekhet Shabbat", + "Shabbos", + "Shabbath", + "Talmud Shabbat", + "Tractate Shabbat", + "Shab.", + "Sabb.", + "Sabbath", + "BT Shabbat", + "Shabbat" + ], + "categories": [ + "Talmud", + "Bavli", + "Seder Moed" + ], + "order": "A00200000100001460007", + "path": "Talmud/Bavli/Seder Moed/Shabbat", + "pagesheetrank": 769.444762983379, + "comp_date": 450, + "exact": "קוצר: harvest Rashi : Is דש = when the kernel falls from natural covering. This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection ", + "naive_lemmatizer": "קוצר: harvest Rashi : Is דש = when the kernel falls from natural covering. This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection ", + "hebrew_version_title": "תרגום קהילת ספריא" + }, + "highlight": { + "naive_lemmatizer": [ + "This means that we can't peel banana... But we can if it's לאלתר - for immediate consumption. Tosphot : Is דש = when your removing something from natural connection" + ] + } }, - "url": "collections/חק-לישראל?tag=Vayishlach", - "order": 12, - "category": "Tanakh" - }, - { - "title": { - "en": "Tanya Yomi", - "he": "תניא יומי" + { + "_index": "text-b", + "_type": "text", + "_id": "II Samuel 18:12 (Sefaria Community Translation [en])", + "_score": 6415.7573, + "_source": { + "ref": "II Samuel 18:12", + "heRef": "שמואל ב י״ח:י״ב", + "version": "Sefaria Community Translation", + "lang": "en", + "version_priority": 8, + "titleVariants": [ + "2Sam", + "Second Samuel", + "Shmuel Bet", + "Shmuel II", + "Samuel II", + "2 Sam", + "II Shmuel", + "II Sam.", + "II Sam", + "2Sam.", + "2 Samuel", + "II Shemuel", + "2 Sam.", + "II. Samuel", + "II. Sam.", + "Sam. II", + "II Samuel" + ], + "categories": [ + "Tanakh", + "Prophets" + ], + "order": "A00000100300180012", + "path": "Tanakh/Prophets/II Samuel", + "pagesheetrank": 287.86486919568637, + "comp_date": -1000, + "exact": "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders.", + "naive_lemmatizer": "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders." + }, + "highlight": { + "naive_lemmatizer": [ + "And the dude said to Yoav: Bro, I just found the evil guy on a banana papaya tree. Let's go murder him ruthlessly, against the king's orders." + ] + } }, - "displayValue": { - "en": "15 Kislev", - "he": "טו כסלו" + { + "_index": "text-b", + "_type": "text", + "_id": "English Explanation of Mishnah Maasrot 1:1:4 (Mishnah Yomit by Dr. Joshua Kulp [en])", + "_score": 36.80613, + "_source": { + "ref": "English Explanation of Mishnah Maasrot 1:1:4", + "heRef": "ביאור אנגלי על משנה מעשרות א׳:א׳:ד׳", + "version": "Mishnah Yomit by Dr. Joshua Kulp", + "lang": "en", + "version_priority": 0, + "titleVariants": [], + "categories": [ + "Mishnah Commentary", + "Modern Commentary on Mishnah", + "English Explanation of Mishnah", + "Seder Zeraim" + ], + "order": "A001008001000006002000100010004", + "path": "Mishnah Commentary/Modern Commentary on Mishnah/English Explanation of Mishnah/Seder Zeraim/English Explanation of Mishnah Maasrot", + "pagesheetrank": 1.44, + "comp_date": 1997, + "exact": " But whatever is not considered food in the earlier stages [of its growth] but only in its later stages, is not liable [to tithe] until it can be considered food. However, if the produce is not considered edible at its earlier stage of growth, if it is nevertheless harvested at this earlier stage, it can be eaten without being tithed. An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it. It would only need to be tithed if harvested when ripe.", + "naive_lemmatizer": " But whatever is not considered food in the earlier stages [of its growth] but only in its later stages, is not liable [to tithe] until it can be considered food. However, if the produce is not considered edible at its earlier stage of growth, if it is nevertheless harvested at this earlier stage, it can be eaten without being tithed. An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it. It would only need to be tithed if harvested when ripe." + }, + "highlight": { + "naive_lemmatizer": [ + "An example might be a banana. A banana harvested at an earlier stage is not considered food and therefore one who does eat such a banana need not tithe it." + ] + } }, - "url": "Tanya,_Part_V;_Kuntres_Acharon.6.8", - "ref": "Tanya, Part V; Kuntres Acharon 6:8", - "order": 15, - "category": "Chasidut" - }, - { - "title": { - "en": "Yerushalmi Yomi", - "he": "ירושלמי יומי" + { + "_index": "text-b", + "_type": "text", + "_id": "Kedushat Levi, Leviticus, Emor 11 (Kedushat Levi translated by Rb. Eliyahu Munk [en])", + "_score": 27.977217, + "_source": { + "ref": "Kedushat Levi, Leviticus, Emor 11", + "heRef": "קדושת לוי, ויקרא, אמור י״א", + "version": "Kedushat Levi translated by Rb. Eliyahu Munk", + "lang": "en", + "version_priority": 1, + "titleVariants": [ + "Emor", + "Parashat Emor", + "Parshat Emor" + ], + "categories": [ + "Chasidut", + "Early Works" + ], + "order": "A0090000010410011", + "path": "Chasidut/Early Works/Kedushat Levi", + "pagesheetrank": 4.840000000000001, + "comp_date": 1772, + "exact": "The sages in Rosh Hashanah 12 alluded to this when ‎they stated that “the Jewish people are in the habit of counting ‎Biblical calendar dates as based on the view of Rabbi Eliezer when ‎speaking of the deluge, , whereas they do so according ‎to the view of Rabbi Joshua when counting the seasons the ‎seasons of the year.” . The Talmud adds that the ‎astronomers of the gentile nations also count the deluge ‎according to the opinion held by Rabbi Joshua. [The whole ‎statement is extremely puzzling, our author contributing a novel ‎interpretation by understanding it as relating to the mystical ‎dimension of life on earth. Ed.] Our author raises the ‎question that seeing that the astronomers of the gentile nations ‎adopt an opinion that is contrary to halachah , how can they ‎be described as “sages of gentile nations?” We have a rule that ‎anyone contradicting what is written in the Torah or recorded as ‎wisdom by King Solomon is an absolute fool.‎ We need to explain above statement allegorically. We have ‎already explained in connection with a statement in the Talmud ‎‎ Pessachim 118 that when Rabbi Yishmael, son of Rabbi ‎Yossi, fell ill Rabbi Yehudah sent to ‎him asking him to tell them one or two Torah insights of his ‎father that he had not previously revealed. He responded by ‎offering an interpretation of a difficult passage in psalms 117,1 ‎where the psalmist appears to invite the nations of the world to ‎praise G’d, saying: ‎הללו את ה' כל גויים שבחוהו כל האומים‎, “praise the ‎Lord all you nations; extol Him all you peoples!” Seeing that the ‎next verse describes the miracles G’d has performed on behalf of ‎the Jewish people, what reason would the gentiles have to praise ‎G’d for this? He answered that if the gentiles are required to ‎praise the Lord for having been witnesses to miracles performed ‎for the Israelites, how much more so must the Israelites be duty ‎bound to praise Him on account of this! How much loving ‎kindness have we experienced at the hands of G’d without having ‎thanked Him adequately! Thereupon Rabbi asked for another ‎pearl of wisdom that Rabbi Yossi had not yet revealed. He told ‎them that at the time when the messiah would come, the gentiles ‎would welcome him with gifts. It seems clear that the words ‎שבחוהו‎, “praise Him,” in the psalm are not meant as ‎acknowledgement of what G’d had done for the gentiles, but for ‎what He had done for His people, the Israelites. It is the ‎overriding duty of all of G’d’s creatures, including the beasts in ‎the field to praise the Creator in accordance with the manner in ‎which they are capable of doing this. This includes even the flora ‎that appear tied to the place in which they grow, and which do ‎not even enjoy the ability to move freely on G’d’s earth. How ‎much more so must the more advanced forms of life on earth ‎praise their Creator, seeing that they are able to enjoy so much ‎more of the world they have been born into?‎ We may take a cue from the words of Rashi on ‎‎ Shabbat 50, “whatever G’d created, He created for the ‎greater glory of His name.” When Jews are killed for the ‎sanctification of the Lord’s name they do so joyfully.‎ It is therefore not difficult to comprehend that the psalmist ‎reminds the gentiles of their duty to praise the Lord as He has ‎given them an opportunity to carry out His will. Miracles which ‎G’d performed for the Israelites frequently were at the expense of ‎the gentiles who had oppressed them. The psalmist warns these ‎gentiles that they are obligated to praise the Lord for having been ‎privileged to experience His greatness even while they perish in ‎the process. The fact that they had been chosen to be G’d’s means ‎of showing His might to the Israelites is something they have to ‎acknowledge, not grudgingly, but joyfully. The fact that they ‎deliberately try to blind themselves to such recognition, stamps ‎them as utter fools. The perennial problem with fools is that they ‎do not wish to be enlightened, believing that they are wise.‎ However, there will come a time, when G’d will open the eyes ‎of the blind and all of them [those who have survived the ‎cataclysmic events occurring first, Ed.] will turn into ‎servants of the Lord. At the time of the Exodus, when G’d performed miracles that ‎enabled the Israelites to be redeemed, He revealed His power to ‎the Egyptians at the same time, of course. However, the latter, ‎almost until their last breath did not acknowledge that it was G’d ‎Who was fighting them when the waves of the sea of reeds came ‎crashing over them. ‎ The Jews have not always been better, so that Isaiah 2,5 tells ‎us that the time will come when –after the gentiles have already ‎acknowledged all this in Isaiah 2,3 – they too will experienced the ‎‎“light” of the Lord. In psalms 118 David foresees all this already ‎hundreds of years before the prophet Isaiah.‎ Let us revert to the passage in the Talmud Rosh ‎Hashanah 12, and the strange statement referring to the ‎astronomers of the gentiles as “sages.” Traditionally, the month ‎of Tishrey symbolizes that G’d’s attribute of Justice, sits in ‎judgment of His creatures on the first day of that month. The ‎month of Nissan, however symbolizes the attribute of Mercy, ‎loving kindness, as it is the month during which the Jewish ‎people, who had a minimum of merits to their credit, were ‎redeemed after hundreds of years of persecution. When looked at ‎from the perspective of the gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana republic,” ‎practically overnight. The effect of this was so overwhelming that ‎Rahab from Jericho, who harbored Joshua’s spies, was still in awe ‎of that event. .‎ Rabbi Eliezer correctly realized that for the gentiles what we ‎perceive as unmitigated disaster, actually is the catalyst that ‎brings them to recognize G’d in the end, by seeing in the month ‎of Tishrey also a harbinger of the attribute of Mercy, seeing it is ‎the gentiles’ last opportunity to change their ways and survive as ‎servants of G’d. The Talmud introduces a reference to the period during ‎which the deluge occurred, i.e. in Marcheshvan, although neither ‎Rabbi Joshua nor Rabbi Eliezer had made reference to that event ‎at all. When the “sages” of the gentile nations are described as ‎taking their cue from the deluge as being in accord with Rabbi ‎Joshua, even when referring to the deluge, what the Talmud ‎means is that these “gentile sages” recognized that the disasters ‎that had struck them was also an outpouring of G’d’s love, as this ‎enabled the survivors to recognize G’d as a G’d of love after all. ‎‎ [According to the Talmud there the gentile sages ‎recognized what Yitro recognized later also, i.e. ‎that when G’d brings on retribution He makes the punishment fit ‎the crime. Ed.] ‎", + "naive_lemmatizer": "The sages in Rosh Hashanah 12 alluded to this when ‎they stated that “the Jewish people are in the habit of counting ‎Biblical calendar dates as based on the view of Rabbi Eliezer when ‎speaking of the deluge, , whereas they do so according ‎to the view of Rabbi Joshua when counting the seasons the ‎seasons of the year.” . The Talmud adds that the ‎astronomers of the gentile nations also count the deluge ‎according to the opinion held by Rabbi Joshua. [The whole ‎statement is extremely puzzling, our author contributing a novel ‎interpretation by understanding it as relating to the mystical ‎dimension of life on earth. Ed.] Our author raises the ‎question that seeing that the astronomers of the gentile nations ‎adopt an opinion that is contrary to halachah , how can they ‎be described as “sages of gentile nations?” We have a rule that ‎anyone contradicting what is written in the Torah or recorded as ‎wisdom by King Solomon is an absolute fool.‎ We need to explain above statement allegorically. We have ‎already explained in connection with a statement in the Talmud ‎‎ Pessachim 118 that when Rabbi Yishmael, son of Rabbi ‎Yossi, fell ill Rabbi Yehudah sent to ‎him asking him to tell them one or two Torah insights of his ‎father that he had not previously revealed. He responded by ‎offering an interpretation of a difficult passage in psalms 117,1 ‎where the psalmist appears to invite the nations of the world to ‎praise G’d, saying: ‎הללו את ה' כל גויים שבחוהו כל האומים‎, “praise the ‎Lord all you nations; extol Him all you peoples!” Seeing that the ‎next verse describes the miracles G’d has performed on behalf of ‎the Jewish people, what reason would the gentiles have to praise ‎G’d for this? He answered that if the gentiles are required to ‎praise the Lord for having been witnesses to miracles performed ‎for the Israelites, how much more so must the Israelites be duty ‎bound to praise Him on account of this! How much loving ‎kindness have we experienced at the hands of G’d without having ‎thanked Him adequately! Thereupon Rabbi asked for another ‎pearl of wisdom that Rabbi Yossi had not yet revealed. He told ‎them that at the time when the messiah would come, the gentiles ‎would welcome him with gifts. It seems clear that the words ‎שבחוהו‎, “praise Him,” in the psalm are not meant as ‎acknowledgement of what G’d had done for the gentiles, but for ‎what He had done for His people, the Israelites. It is the ‎overriding duty of all of G’d’s creatures, including the beasts in ‎the field to praise the Creator in accordance with the manner in ‎which they are capable of doing this. This includes even the flora ‎that appear tied to the place in which they grow, and which do ‎not even enjoy the ability to move freely on G’d’s earth. How ‎much more so must the more advanced forms of life on earth ‎praise their Creator, seeing that they are able to enjoy so much ‎more of the world they have been born into?‎ We may take a cue from the words of Rashi on ‎‎ Shabbat 50, “whatever G’d created, He created for the ‎greater glory of His name.” When Jews are killed for the ‎sanctification of the Lord’s name they do so joyfully.‎ It is therefore not difficult to comprehend that the psalmist ‎reminds the gentiles of their duty to praise the Lord as He has ‎given them an opportunity to carry out His will. Miracles which ‎G’d performed for the Israelites frequently were at the expense of ‎the gentiles who had oppressed them. The psalmist warns these ‎gentiles that they are obligated to praise the Lord for having been ‎privileged to experience His greatness even while they perish in ‎the process. The fact that they had been chosen to be G’d’s means ‎of showing His might to the Israelites is something they have to ‎acknowledge, not grudgingly, but joyfully. The fact that they ‎deliberately try to blind themselves to such recognition, stamps ‎them as utter fools. The perennial problem with fools is that they ‎do not wish to be enlightened, believing that they are wise.‎ However, there will come a time, when G’d will open the eyes ‎of the blind and all of them [those who have survived the ‎cataclysmic events occurring first, Ed.] will turn into ‎servants of the Lord. At the time of the Exodus, when G’d performed miracles that ‎enabled the Israelites to be redeemed, He revealed His power to ‎the Egyptians at the same time, of course. However, the latter, ‎almost until their last breath did not acknowledge that it was G’d ‎Who was fighting them when the waves of the sea of reeds came ‎crashing over them. ‎ The Jews have not always been better, so that Isaiah 2,5 tells ‎us that the time will come when –after the gentiles have already ‎acknowledged all this in Isaiah 2,3 – they too will experienced the ‎‎“light” of the Lord. In psalms 118 David foresees all this already ‎hundreds of years before the prophet Isaiah.‎ Let us revert to the passage in the Talmud Rosh ‎Hashanah 12, and the strange statement referring to the ‎astronomers of the gentiles as “sages.” Traditionally, the month ‎of Tishrey symbolizes that G’d’s attribute of Justice, sits in ‎judgment of His creatures on the first day of that month. The ‎month of Nissan, however symbolizes the attribute of Mercy, ‎loving kindness, as it is the month during which the Jewish ‎people, who had a minimum of merits to their credit, were ‎redeemed after hundreds of years of persecution. When looked at ‎from the perspective of the gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana republic,” ‎practically overnight. The effect of this was so overwhelming that ‎Rahab from Jericho, who harbored Joshua’s spies, was still in awe ‎of that event. .‎ Rabbi Eliezer correctly realized that for the gentiles what we ‎perceive as unmitigated disaster, actually is the catalyst that ‎brings them to recognize G’d in the end, by seeing in the month ‎of Tishrey also a harbinger of the attribute of Mercy, seeing it is ‎the gentiles’ last opportunity to change their ways and survive as ‎servants of G’d. The Talmud introduces a reference to the period during ‎which the deluge occurred, i.e. in Marcheshvan, although neither ‎Rabbi Joshua nor Rabbi Eliezer had made reference to that event ‎at all. When the “sages” of the gentile nations are described as ‎taking their cue from the deluge as being in accord with Rabbi ‎Joshua, even when referring to the deluge, what the Talmud ‎means is that these “gentile sages” recognized that the disasters ‎that had struck them was also an outpouring of G’d’s love, as this ‎enabled the survivors to recognize G’d as a G’d of love after all. ‎‎ [According to the Talmud there the gentile sages ‎recognized what Yitro recognized later also, i.e. ‎that when G’d brings on retribution He makes the punishment fit ‎the crime. Ed.] ‎", + "hebrew_version_title": "קדושת לוי, מתורגם בידי רבי אליהו מונק" + }, + "highlight": { + "naive_lemmatizer": [ + "gentiles, the month of Nissan ‎symbolizes the attribute of Justice, as during that month G’d ‎brought retribution on the leading nation of the gentiles, ‎reducing a world power, Egypt, to becoming a “banana" + ] + } + }, + { + "_index": "text-b", + "_type": "text", + "_id": "Peninei Halakhah, Shabbat 12:2:3 (Peninei Halakhah, English ed. Yeshivat Har Bracha [en])", + "_score": 19.184504, + "_source": { + "ref": "Peninei Halakhah, Shabbat 12:2:3", + "heRef": "פניני הלכה, שבת י״ב:ב׳:ג׳", + "version": "Peninei Halakhah, English ed. Yeshivat Har Bracha", + "lang": "en", + "version_priority": 0, + "titleVariants": [], + "categories": [ + "Halakhah", + "Modern", + "Peninei Halakhah" + ], + "order": "A004014004010002001200020003", + "path": "Halakhah/Modern/Peninei Halakhah/Peninei Halakhah, Shabbat", + "pagesheetrank": 1.44, + "comp_date": 2007, + "exact": "May one mash foods like bananas and avocados? Some are stringent and forbid doing so with a fork, including for immediate consumption. Even the stringent opinion permits mashing these foods with a spoon, because that is considered a shinui. However, the lenient position allows mashing bananas and avocados even with a fork for immediate consumption, and the halakha follows this position. Thus one may mash a banana or avocado with a fork for immediate consumption. As we have already seen, the prohibition of Toḥen is not relevant to food being prepared for immediate consumption, as long as the mashing is not done with a special utensil designed for this purpose. 3 . There are several reasons for this permission:a) According to most poskim, the prohibition of Toḥen does not apply to fruits or vegetables that are edible .b) Even though SA 321:12 rules in accordance with those who are stringent, nevertheless, when the food is being prepared for immediate consumption, there is no prohibition .c) Even if the prohibition of Toḥen were applicable, according to Igrot Moshe 4:74, Toḥen2, since these foods remain a solid mass even after being mashed, Toḥen does not apply here at all.d) Mashing with a fork already constitutes a shinui, as this is not the normal way to grind . Yeḥaveh Da’at 5:27 and Menuḥat Ahava 2:8:12 permit this in practice. However, Ḥazon Ish OḤ §57 is stringent, and does not allow it even when the food being prepared will be consumed immediately. He also maintains that mashing is considered a type of Toḥen since it breaks down the structure of the fruit. He adds that if the mashing is done to feed the food to a baby, then it is prohibited based on MA 321:14, because it renders the food edible. SSK 6:1 and Hilkhot Shabbat Be-Shabbat 1:12:15 also state that one should be stringent. But they allow mashing with a spoon, as this definitely constitutes a shinui. Similarly, if the foods are very soft, then even those who are normally stringent allow mashing them with a fork. But in practice the primary position is the lenient one, as this is the position of practically all Rishonim.", + "naive_lemmatizer": "May one mash foods like bananas and avocados? Some are stringent and forbid doing so with a fork, including for immediate consumption. Even the stringent opinion permits mashing these foods with a spoon, because that is considered a shinui. However, the lenient position allows mashing bananas and avocados even with a fork for immediate consumption, and the halakha follows this position. Thus one may mash a banana or avocado with a fork for immediate consumption. As we have already seen, the prohibition of Toḥen is not relevant to food being prepared for immediate consumption, as long as the mashing is not done with a special utensil designed for this purpose. 3 . There are several reasons for this permission:a) According to most poskim, the prohibition of Toḥen does not apply to fruits or vegetables that are edible .b) Even though SA 321:12 rules in accordance with those who are stringent, nevertheless, when the food is being prepared for immediate consumption, there is no prohibition .c) Even if the prohibition of Toḥen were applicable, according to Igrot Moshe 4:74, Toḥen2, since these foods remain a solid mass even after being mashed, Toḥen does not apply here at all.d) Mashing with a fork already constitutes a shinui, as this is not the normal way to grind . Yeḥaveh Da’at 5:27 and Menuḥat Ahava 2:8:12 permit this in practice. However, Ḥazon Ish OḤ §57 is stringent, and does not allow it even when the food being prepared will be consumed immediately. He also maintains that mashing is considered a type of Toḥen since it breaks down the structure of the fruit. He adds that if the mashing is done to feed the food to a baby, then it is prohibited based on MA 321:14, because it renders the food edible. SSK 6:1 and Hilkhot Shabbat Be-Shabbat 1:12:15 also state that one should be stringent. But they allow mashing with a spoon, as this definitely constitutes a shinui. Similarly, if the foods are very soft, then even those who are normally stringent allow mashing them with a fork. But in practice the primary position is the lenient one, as this is the position of practically all Rishonim." + }, + "highlight": { + "naive_lemmatizer": [ + "Thus one may mash a banana or avocado with a fork for immediate consumption." + ] + } }, - "displayValue": { - "en": "Jerusalem Talmud Orlah 18", - "he": "תלמוד ירושלמי ערלה יח" + { + "_index": "text-b", + "_type": "text", + "_id": "Klein Dictionary, בָּנָנָה (Carta Jerusalem; 1st edition, 1987 [en])", + "_score": 1.032272, + "_source": { + "ref": "Klein Dictionary, בָּנָנָה", + "heRef": "מילון קליין, בָּנָנָה", + "version": "Carta Jerusalem; 1st edition, 1987", + "lang": "en", + "version_priority": 0, + "titleVariants": [ + "בָּנָנָה" + ], + "categories": [ + "Reference", + "Dictionary" + ], + "order": "A013000001B00729", + "path": "Reference/Dictionary/Klein Dictionary", + "pagesheetrank": 0.04000000000000001, + "comp_date": 1973, + "exact": " בָּנָנָה f.n. FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]", + "naive_lemmatizer": " בָּנָנָה f.n. FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]", + "hebrew_version_title": "כרטא תשמ״ז" + }, + "highlight": { + "naive_lemmatizer": [ + "FW banana. [Sp. and Portuguese banana , from earlier Congolese banam .]" + ] + } }, - "url": "Jerusalem_Talmud_Orlah.3.1.16-3.1", - "ref": "Jerusalem Talmud Orlah 3:1:16-3:1", - "order": 16, - "category": "Talmud" + { + "_index": "text-b", + "_type": "text", + "_id": "Klein Dictionary, מוֹז (Carta Jerusalem; 1st edition, 1987 [en])", + "_score": 0.9270322, + "_source": { + "ref": "Klein Dictionary, מוֹז", + "heRef": "מילון קליין, מוֹז", + "version": "Carta Jerusalem; 1st edition, 1987", + "lang": "en", + "version_priority": 0, + "titleVariants": [ + "מוֹז" + ], + "categories": [ + "Reference", + "Dictionary" + ], + "order": "A013000001M00857", + "path": "Reference/Dictionary/Klein Dictionary", + "pagesheetrank": 0.04000000000000001, + "comp_date": 1973, + "exact": " מוֹז m.n. NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]", + "naive_lemmatizer": " מוֹז m.n. NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]", + "hebrew_version_title": "כרטא תשמ״ז" + }, + "highlight": { + "naive_lemmatizer": [ + "NH banana . [Introduced by Eliezer ben Yehudah as a loan word from Arab. mauz , which is related to Aram. מוֹזָא .]" + ] + } + } + ] + }, + "aggregations": { + "path": { + "doc_count_error_upper_bound": 0, + "sum_other_doc_count": 0, + "buckets": [ + { + "key": "Reference/Dictionary/Klein Dictionary", + "doc_count": 2 + }, + { + "key": "Chasidut/Early Works/Kedushat Levi", + "doc_count": 1 + }, + { + "key": "Halakhah/Modern/Peninei Halakhah/Peninei Halakhah, Shabbat", + "doc_count": 1 + }, + { + "key": "Mishnah Commentary/Modern Commentary on Mishnah/English Explanation of Mishnah/Seder Zeraim/English Explanation of Mishnah Maasrot", + "doc_count": 1 + }, + { + "key": "Talmud/Bavli/Seder Moed/Shabbat", + "doc_count": 1 + }, + { + "key": "Tanakh/Prophets/II Samuel", + "doc_count": 1 + } + ] } - ] + } } }, - "TopicJSON": { - "title": "Root Type for TopicJSON", - "description": "A JSON object containing all of the metadata for a topic object", - "required": [ - "slug", - "titles" - ], + "SearchPOSTData": { + "title": "Root Type for SearchPOSTData", + "description": "", "type": "object", "properties": { - "slug": { - "description": "The unique slug for a given topic.", - "type": "string", - "example": "nachman-of-breslov" + "aggs": { + "description": "List of fields to aggregate on. Common fields are `path` for the `text` type and `group` or `topics` for the `sheet` type", + "type": "array", + "items": { + "type": "string" + } }, - "titles": { - "description": "An array of JSON objects, each representing an alternative title for the object, in various languages. ", + "field": { + "description": "The field you want to query. Common fields to query are `exact` or `naive_lemmatizer` for the `text` and `merged` indexes. For querying the `sheet` index, commonly you'll query the `content` field", + "type": "string" + }, + "filter_fields": { + "description": "Must be the same length as `filters`. Each entry specifies the field to apply the corresponding filter in `filters`. For queries of type `text` this has no effect since there's only one field to filter text queries on (`path`. this field is explained in `filters`). For `sheet` queries, the following fields can appear in `filter_fields`: `collections` (corresponds to the collections that the sheet is in), `topics_en` (corresponds to the topics for this sheet, translated into English), `topics_he` (corresponds to the topics for this sheet, translated into Hebrew).", + "type": "array", + "items": {} + }, + "filters": { + "description": "A list of filters to filter results. These filters cannot include RegEx. Any RegEx characters will be escaped. Each filter is applied to the corresponding field in the `filter_fields` list. E.g. if filters is `[\"Passover\", \"Torah Talks\"]` and `filter_fields` is `[\"topics_en\", \"collections\"]` then the `\"Passover\"` filter will be applied to the `\"topics_en\"` field and the `\"Torah Talks\"` filter will be applied to the `\"collections\"` field. For `text` queries, filters always applies to the `path` field of documents. This essentially corresponds to the category path of the book in Sefaria's table of contents (there are some differences with regards to commentary paths). For `sheet` queries, filters can be applied to `collections`, `topics_en` or `topics_he`. These fields are explained in `filter_fields` param.", + "type": "array", + "items": {} + }, + "query": { + "description": "Your search query.", + "type": "string" + }, + "size": { + "format": "int32", + "description": "For paginating results. The total number of results to return, starting from `start`", + "type": "integer" + }, + "slop": { + "format": "int32", + "description": "The maximum distance between each query word in the resulting document. `0` means an exact match must be found", + "type": "integer" + }, + "sort_fields": { + "description": "List of fields to sort on. If `sort_method = 'score'` this list should have exactly one item. Common fields to sort on are `comp_date` (which list results from titles published chronologically), `order` (which list results based on Sefaria's table of contents structure), `pagesheetrank` (most relevant results based on the Sheet Rank algorithm), `dateCreated` (for sheet results returned chronologically), `views` (for sheet results based on popularity).", "type": "array", "items": { - "$ref": "#/components/schemas/TopicTitlesJSON" + "type": "string" + } + }, + "sort_method": { + "description": "How to sort results. If sort, the values are sorted according to `sort_fields`. If `score`, the value in `sort_fields` is multiplied with the default ElasticSearch score.", + "enum": [ + "sort", + "score" + ], + "type": "string" + }, + "sort_reverse": { + "description": "Whether or not to reverse the sort applied on `sort_fields`", + "type": "boolean" + }, + "sort_score_missing": { + "format": "double", + "description": "The number used in case there is a value missing in your `sort_field`", + "type": "number" + }, + "source_proj": { + "description": "By default, the ElasticSearch document is not returned. Specifying `true` will return the entire document. Specifying a `str` or `list(str)` will perform a projection on the document for the specified fields", + "type": "boolean" + }, + "type": { + "description": "The ElasticSearch index you want to query, and the results you expect to get back. `sheet` returns results from Sefaria's user generated source sheets, while `text` returns results from the library.", + "enum": [ + "text", + "sheet" + ], + "type": "string" + } + }, + "example": { + "aggs": [ + "path" + ], + "field": "naive_lemmatizer", + "filter_fields": [], + "filters": [], + "query": "banana", + "size": 50, + "slop": 10, + "sort_fields": [ + "pagesheetrank" + ], + "sort_method": "score", + "sort_reverse": false, + "sort_score_missing": 0.04, + "source_proj": true, + "type": "text" + } + }, + "return_format": { + "description": "This parameter formats the text that will be returned from the `v3` `texts/` API. It can have one of three values:\n1. `text_only` - This strips footnotes, inline references and all html tags from the returned text\n2. `wrap_all_entities` - This wraps the HTML for links and topic links\n3. `default` - This returns the basic text as it’s saved in Sefaria’s DB\n", + "type": "string" + }, + "v3TextsJson": { + "title": "Root Type for v3TextsJson", + "description": "The JSON returned from the `v3` `texts/` endpoint. ", + "type": "object", + "properties": { + "versions": { + "description": "The list of requested `version` objects. It includes all the data that is unique to the requested `versions`. \n", + "type": "array", + "items": { + "$ref": "#/components/schemas/v3TextVersionsJSON" }, - "example": "\"titles\": [\n {\n \"text\": \"Tabernacles\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succos\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Booths\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"sukkot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"succot\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Succoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"Sukkoth\",\n \"lang\": \"en\"\n },\n {\n \"text\": \"חג הסוכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"סכות\",\n \"lang\": \"he\"\n },\n {\n \"text\": \"Sukkot\",\n \"lang\": \"en\",\n \"primary\": true\n },\n {\n \"text\": \"סוכות\",\n \"lang\": \"he\",\n \"primary\": true\n }\n]" + "example": "{\n\"status\": \"locked\",\n\"priority\": 2,\n\"license\": \"CC-BY-SA\",\n\"versionNotes\": \"Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.\",\n\"formatAsPoetry\": \"\",\n\"digitizedBySefaria\": \"\",\n\"method\": \"\",\n\"heversionSource\": \"\",\n\"versionUrl\": \"\",\n\"versionTitleInHebrew\": \"מקרא על פי המסורה\",\n\"versionNotesInHebrew\": \"\",\n\"shortVersionTitle\": \"\",\n\"shortVersionTitleInHebrew\": \"\",\n\"extendedNotes\": \"\",\n\"extendedNotesHebrew\": \"\",\n\"purchaseInformationImage\": \"\",\n\"purchaseInformationURL\": \"\",\n\"hasManuallyWrappedRefs\": \"\",\n\"actualLanguage\": \"he\",\n\"languageFamilyName\": \"hebrew\",\n\"isBaseText\": true,\n\"isSource\": true,\n\"isPrimary\": true,\n\"direction\": \"rtl\",\n\"language\": \"he\",\n\"versionSource\": \"https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94\",\n\"versionTitle\": \"Miqra according to the Masorah\",\n\"text\": [\n[\n\"חֲז֖וֹן עֹֽבַדְיָ֑ה כֹּֽה־אָמַר֩ אֲדֹנָ֨י יֱהֹוִ֜ה לֶאֱד֗וֹם שְׁמוּעָ֨ה שָׁמַ֜עְנוּ מֵאֵ֤ת יְהֹוָה֙ וְצִיר֙ בַּגּוֹיִ֣ם שֻׁלָּ֔ח ק֛וּמוּ וְנָק֥וּמָה עָלֶ֖יהָ לַמִּלְחָמָֽה׃\",\n\"הִנֵּ֥ה קָטֹ֛ן נְתַתִּ֖יךָ בַּגּוֹיִ֑ם בָּז֥וּי אַתָּ֖ה מְאֹֽד׃\",\n\"זְד֤וֹן לִבְּךָ֙ הִשִּׁיאֶ֔ךָ שֹׁכְנִ֥י בְחַגְוֵי־סֶ֖לַע מְר֣וֹם שִׁבְתּ֑וֹ אֹמֵ֣ר בְּלִבּ֔וֹ מִ֥י יוֹרִדֵ֖נִי אָֽרֶץ׃\",\n\"אִם־תַּגְבִּ֣יהַּ כַּנֶּ֔שֶׁר וְאִם־בֵּ֥ין כּֽוֹכָבִ֖ים שִׂ֣ים קִנֶּ֑ךָ מִשָּׁ֥ם אוֹרִֽידְךָ֖ נְאֻם־יְהֹוָֽה׃\",\n\"אִם־גַּנָּבִ֤ים בָּאֽוּ־לְךָ֙ אִם־שׁ֣וֹדְדֵי לַ֔יְלָה אֵ֣יךְ נִדְמֵ֔יתָה הֲל֥וֹא יִגְנְב֖וּ דַּיָּ֑ם אִם־בֹּֽצְרִים֙ בָּ֣אוּ לָ֔ךְ הֲל֖וֹא יַשְׁאִ֥ירוּ עֹלֵלֽוֹת׃\",\n\"אֵ֚יךְ נֶחְפְּשׂ֣וּ עֵשָׂ֔ו נִבְע֖וּ מַצְפֻּנָֽיו׃\",\n\"עַֽד־הַגְּב֣וּל שִׁלְּח֗וּךָ כֹּ֚ל אַנְשֵׁ֣י בְרִיתֶ֔ךָ הִשִּׁיא֛וּךָ יָכְל֥וּ לְךָ֖ אַנְשֵׁ֣י שְׁלֹמֶ֑ךָ לַחְמְךָ֗ יָשִׂ֤ימוּ מָזוֹר֙ תַּחְתֶּ֔יךָ אֵ֥ין תְּבוּנָ֖ה בּֽוֹ׃\",\n\"הֲל֛וֹא בַּיּ֥וֹם הַה֖וּא נְאֻם־יְהֹוָ֑ה וְהַאֲבַדְתִּ֤י חֲכָמִים֙ מֵֽאֱד֔וֹם וּתְבוּנָ֖ה מֵהַ֥ר עֵשָֽׂו׃\",\n\"וְחַתּ֥וּ גִבּוֹרֶ֖יךָ תֵּימָ֑ן לְמַ֧עַן יִכָּֽרֶת־אִ֛ישׁ מֵהַ֥ר עֵשָׂ֖ו מִקָּֽטֶל׃\",\n\"מֵחֲמַ֛ס אָחִ֥יךָ יַעֲקֹ֖ב תְּכַסְּךָ֣ בוּשָׁ֑ה וְנִכְרַ֖תָּ לְעוֹלָֽם׃\",\n\"בְּיוֹם֙ עֲמׇֽדְךָ֣ מִנֶּ֔גֶד בְּי֛וֹם שְׁב֥וֹת זָרִ֖ים חֵיל֑וֹ וְנׇכְרִ֞ים בָּ֣אוּ שְׁעָרָ֗ו וְעַל־יְרוּשָׁלַ֙͏ִם֙ יַדּ֣וּ גוֹרָ֔ל גַּם־אַתָּ֖ה כְּאַחַ֥ד מֵהֶֽם׃\",\n\"וְאַל־תֵּ֤רֶא בְיוֹם־אָחִ֙יךָ֙ בְּי֣וֹם נׇכְר֔וֹ וְאַל־תִּשְׂמַ֥ח לִבְנֵֽי־יְהוּדָ֖ה בְּי֣וֹם אׇבְדָ֑ם וְאַל־תַּגְדֵּ֥ל פִּ֖יךָ בְּי֥וֹם צָרָֽה׃\",\n\"אַל־תָּב֤וֹא בְשַֽׁעַר־עַמִּי֙ בְּי֣וֹם אֵידָ֔ם אַל־תֵּ֧רֶא גַם־אַתָּ֛ה בְּרָעָת֖וֹ בְּי֣וֹם אֵיד֑וֹ וְאַל־תִּשְׁלַ֥חְנָה בְחֵיל֖וֹ בְּי֥וֹם אֵידֽוֹ׃\",\n\"וְאַֽל־תַּעֲמֹד֙ עַל־הַפֶּ֔רֶק לְהַכְרִ֖ית אֶת־פְּלִיטָ֑יו וְאַל־תַּסְגֵּ֥ר שְׂרִידָ֖יו בְּי֥וֹם צָרָֽה׃\",\n\"כִּֽי־קָר֥וֹב יוֹם־יְהֹוָ֖ה עַל־כׇּל־הַגּוֹיִ֑ם כַּאֲשֶׁ֤ר עָשִׂ֙יתָ֙ יֵעָ֣שֶׂה לָּ֔ךְ גְּמֻלְךָ֖ יָשׁ֥וּב בְּרֹאשֶֽׁךָ׃\",\n\"כִּ֗י כַּֽאֲשֶׁ֤ר שְׁתִיתֶם֙ עַל־הַ֣ר קׇדְשִׁ֔י יִשְׁתּ֥וּ כׇֽל־הַגּוֹיִ֖ם תָּמִ֑יד וְשָׁת֣וּ וְלָע֔וּ וְהָי֖וּ כְּל֥וֹא הָיֽוּ׃\",\n\"וּבְהַ֥ר צִיּ֛וֹן תִּהְיֶ֥ה פְלֵיטָ֖ה וְהָ֣יָה קֹ֑דֶשׁ וְיָֽרְשׁוּ֙ בֵּ֣ית יַֽעֲקֹ֔ב אֵ֖ת מוֹרָֽשֵׁיהֶֽם׃\",\n\"וְהָיָה֩ בֵית־יַעֲקֹ֨ב אֵ֜שׁ וּבֵ֧ית יוֹסֵ֣ף לֶהָבָ֗ה וּבֵ֤ית עֵשָׂו֙ לְקַ֔שׁ וְדָלְק֥וּ בָהֶ֖ם וַאֲכָל֑וּם וְלֹֽא־יִֽהְיֶ֤ה שָׂרִיד֙ לְבֵ֣ית עֵשָׂ֔ו כִּ֥י יְהֹוָ֖ה דִּבֵּֽר׃\",\n\"וְיָרְשׁ֨וּ הַנֶּ֜גֶב אֶת־הַ֣ר עֵשָׂ֗ו וְהַשְּׁפֵלָה֙ אֶת־פְּלִשְׁתִּ֔ים וְיָרְשׁוּ֙ אֶת־שְׂדֵ֣ה אֶפְרַ֔יִם וְאֵ֖ת שְׂדֵ֣ה שֹׁמְר֑וֹן וּבִנְיָמִ֖ן אֶת־הַגִּלְעָֽד׃\",\n\"וְגָלֻ֣ת הַֽחֵל־הַ֠זֶּ֠ה לִבְנֵ֨י יִשְׂרָאֵ֤ל אֲשֶֽׁר־כְּנַעֲנִים֙ עַד־צָ֣רְפַ֔ת וְגָלֻ֥ת יְרוּשָׁלַ֖͏ִם אֲשֶׁ֣ר בִּסְפָרַ֑ד יִֽרְשׁ֕וּ אֵ֖ת עָרֵ֥י הַנֶּֽגֶב׃\",\n\"וְעָל֤וּ מֽוֹשִׁעִים֙ בְּהַ֣ר צִיּ֔וֹן לִשְׁפֹּ֖ט אֶת־הַ֣ר עֵשָׂ֑ו וְהָיְתָ֥ה לַֽיהֹוָ֖ה הַמְּלוּכָֽה׃\"\n]\n],\n\"firstSectionRef\": \"Obadiah 1\"}\n" }, - "alt_ids": { - "type": "object", - "properties": { - "_temp_id": { - "type": "string" - } + "available_versions": { + "type": "array", + "items": { + "$ref": "#/components/schemas/v3AvailableVersionsTextJson" } }, - "properties": { - "$ref": "#/components/schemas/TopicPropertyJson", - "description": "The properties stores optional data relating to the topic, including links (if relevant) to where on can learn more about the topic. ", - "properties": { - "heNliLink": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - }, - "enNliLink": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } - } - } - }, - "example": "\"properties\": {\n \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n },\n \"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n }\n}" + "ref": { + "$ref": "#/components/schemas/ref" }, - "description": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "A description of the topic in English", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "\"description\": {\n \"en\": \"Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.\",\n \"he\": \"חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'\"\n}" + "heRef": { + "description": "Hebrew `Ref` for the segment. ", + "type": "string" }, - "categoryDescription": { - "description": "A description of the category of this topic", + "sections": { + "description": "An array which corresponds to sectionNames and represents the sections of the text requested. When sectionNames is `[\"Chapter\", \"Verse\"]` a request for chapter 4 looks like `[4]` while a request for chapter 4, verse 7 would look like `[4, 7]`. _Note, for Talmud, Dafs are represented by a string like \"42a\" or \"12b\"_", + "type": "array", + "items": {} + }, + "toSections": { + "type": "array", + "items": {} + }, + "sectionRef": { + "$ref": "#/components/schemas/ref" + }, + "heSectionRef": { "type": "string" }, - "displayOrder": { - "format": "int32", - "description": "The order in which topics are displayed on the Sefaria website, relative to other topics within their same category. ", - "type": "integer", - "example": "1" + "firstAvailableSectionRef": { + "type": "string" }, - "numSources": { - "format": "int32", - "description": "The number of text sources associated with a topic. ", - "type": "integer", - "example": "831" + "isSpanning": { + "type": "boolean" }, - "description_published": { - "description": "A boolean representing whether or not the description was published. ", - "type": "boolean", - "example": "true" + "spanningRefs": { + "type": "array", + "items": {} }, - "data_source": { - "description": "How the topic was generated, whether by `sefaria`, a user on a source sheet, or some other source. ", + "next": { + "description": "Next segment reference in sequence, if last ref, field will be `null`.", + "type": "string" + }, + "prev": { + "description": "Previous segment reference in sequence, if first ref, field will be `null`.", + "type": "string" + }, + "title": { + "description": "The title of the book these versions correspond to. ", + "type": "string" + }, + "book": { + "description": "The title of the book that the response comes from.", "type": "string", - "example": "`sefaria`" + "example": "Esther" }, - "image": { - "$ref": "#/components/schemas/TopicImgJSON", - "description": "Metadata for images associated with topics. ", - "properties": { - "image_uri": { - "type": "string" - }, - "image_caption": { - "type": "object", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - } - } + "heTitle": { + "type": "string" + }, + "primary_category": { + "type": "string" + }, + "type": { + "type": "string" + }, + "indexTitle": { + "description": "The book title", + "type": "string" + }, + "categories": { + "description": "A list of categories that a text belongs to. ", + "type": "array", + "items": { + "type": "string" }, - "example": "\"image\": {\n \"image_uri\": \"https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg\",\n \"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n }\n}" + "example": "[\n\"Tanakh\",\n\"Writings\"\n]" + }, + "heIndexTitle": { + "type": "string" + }, + "isComplex": { + "description": "Whether or not the text is a \"complex\" text or not.\n\nIn Sefaria, a complex text is any text which has a more complicated index structure beyond Chapters/Verses, (e.g. the Talmud). There are a variety of structural differences for a complex text, having to do primarily with its Index, and the way the data is stored. For more on complex texts, see the documentation here.", + "type": "boolean" + }, + "isDependant": { + "type": "boolean" + }, + "order": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "collectiveTitle": { + "description": "A shortened name of the Index for display in the connection panel (i.e. `Rashi on Genesis` will have a collective title of `Rashi`)", + "type": "string" + }, + "heCollectiveTitle": { + "description": "A Hebrew shortened name of the Index for display in the connection panel (i.e. `רש״י על בראשית` will have a collective title of `רש״י`)", + "type": "string" + }, + "alts": { + "type": "array", + "items": {} + }, + "lengths": { + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } }, - "primaryTitle": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "The primary title for a topic.", - "properties": { - "en": { - "type": "string" - }, - "he": { - "type": "string" - } - }, - "example": "{\n \"en\": \"Sukkot\",\n \"he\": \"סוכות\"\n}" + "length": { + "format": "int32", + "type": "integer" }, - "primaryTitleIsTransliteration": { - "$ref": "#/components/schemas/BillingualJSON", - "properties": { - "en": { - "type": "boolean" - }, - "he": { - "type": "boolean" - } - }, - "example": "\"primaryTitleIsTransliteration\": {\n \"en\": false,\n \"he\": false\n}" - } - }, - "example": { - "slug": "sukkot", - "titles": [ - { - "text": "Tabernacles", - "lang": "en" - }, - { - "text": "Succot", - "lang": "en" - }, - { - "text": "Sukkos", - "lang": "en" - }, - { - "text": "Succos", - "lang": "en" - }, - { - "text": "Booths", - "lang": "en" - }, - { - "text": "sukkot", - "lang": "en" - }, - { - "text": "succot", - "lang": "en" - }, - { - "text": "Succoth", - "lang": "en" - }, - { - "text": "Sukkoth", - "lang": "en" - }, - { - "text": "חג הסוכות", - "lang": "he" - }, - { - "text": "סכות", - "lang": "he" - }, - { - "text": "Sukkot", - "lang": "en", - "primary": true - }, - { - "text": "סוכות", - "lang": "he", - "primary": true + "textDepth": { + "format": "int32", + "description": "The depth of the text. For example, Genesis will have depth of `2`, since it is comprised of two layers, chapters and verses. Whereas a commentary on Genesis will have a depth of `3`, since it is organized by chapter, verse, and then specific comment on a verse. ", + "type": "integer" + }, + "sectionNames": { + "description": "An array containing the type names of the sections of this text. The length of sectionNames gives the depth of the structure of this text. For example, Kohelet `([\"Chapter\", \"Verse\"])` has depth 2, while Mishneh Torah `([\"Book\", \"Topic\", \"Section\", \"Law\"])` has depth 4. Comparing this depth to the depth of sections will show if the request was for the lowest level, or a higher level, of the text.", + "type": "array", + "items": { + "type": "string" } - ], - "alt_ids": { - "_temp_id": "סוכות" }, - "properties": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" + "addressTypes": { + "description": "A list which length reflects the depth of the text structure, with string values indicating class names for address types for each level", + "type": "array", + "items": { + "type": "string" }, - "enNliLink": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - } + "example": "[\n\"Perek\",\n\"Pasuk\"\n]" }, - "description": { - "en": "Sukkot is a weeklong celebration of the harvest in early fall. It is celebrated by the building of temporary booths — that is, sukkot — outside homes in which people eat their meals and sometimes even sleep. The booths are reminders of the transience of life and the sheltering presence of God.", - "he": "חג הסוכות, הוא חג האסיף, נמשך שבעה ימים ומצוין בחודש תשרי על-ידי בניית סוכה מחוץ לבית, בה אוכלים וחלק גם ישנים. הסוכה היא תזכורת לסוכות שבנו בני ישראל ביציאת מצרים, ומסמלת את ארעיות החיים ואת נוכחותו המגוננת של ה'" + "titleVariants": { + "description": "Various alternative titles used for the text. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n\"Est.\",\n\"Est\",\n\"Ester\",\n\"Esth.\",\n\"Esth\",\n\"Esther\"\n]" }, - "categoryDescription": {}, - "displayOrder": 4, - "numSources": 831, - "description_published": true, - "data_source": "sefaria", - "image": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", - "image_caption": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" + "heTitleVariants": { + "type": "array", + "items": { + "type": "string" } }, - "primaryTitle": { - "en": "Sukkot", - "he": "סוכות" + "index_offsets_by_depth": { + "type": "object" }, - "primaryTitleIsTransliteration": { - "en": false, - "he": false + "warnings": { + "description": "A list of objects - for any version parameter that has no result there is a readable message and warning code. \n\nCodes:\n`APINoVersion = 101`\n`APINoLanguageVersion = 102`\n`APINoSourceText = 103`\n`APINoTranslationText = 104`\n", + "type": "array", + "items": {} } + }, + "example": { + "versions": [ + { + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah", + "text": [], + "firstSectionRef": "Obadiah 1" + } + ], + "available_versions": [], + "ref": "Obadiah", + "heRef": "עובדיה", + "sections": [], + "toSections": [], + "sectionRef": "Obadiah", + "heSectionRef": "עובדיה", + "firstAvailableSectionRef": "Obadiah 1", + "isSpanning": false, + "spanningRefs": [], + "next": "Obadiah 1", + "prev": "Obadiah 1", + "title": "Obadiah", + "book": "Obadiah", + "heTitle": "עובדיה", + "primary_category": "Tanakh", + "type": "Tanakh", + "indexTitle": "Obadiah", + "categories": [ + "Tanakh", + "Prophets" + ], + "heIndexTitle": "עובדיה", + "isComplex": false, + "isDependant": false, + "order": [ + 18, + 13 + ], + "collectiveTitle": "", + "heCollectiveTitle": "", + "alts": [], + "lengths": [ + 1, + 21 + ], + "length": 1, + "textDepth": 2, + "sectionNames": [ + "Chapter", + "Verse" + ], + "addressTypes": [ + "Perek", + "Pasuk" + ], + "titleVariants": [ + "Ovadiah", + "Ob.", + "Oba.", + "Ovadyah", + "Ovadia", + "Ovadya", + "Abdias", + "Obad", + "Obadiah" + ], + "heTitleVariants": [ + "עובדיה" + ], + "index_offsets_by_depth": {}, + "warnings": [] } }, - "TopicImgJSON": { - "title": "Root Type for TopicImgJSON", - "description": "A JSON object containing the image metadata for topics with images. ", + "v3AvailableVersionsTextJson": { + "title": "Root Type for v3AvailableVersionsTextJson", + "description": "Data returned in the `available_versions` field of the `v3` `texts` API. This contains all of the available versions for a given text, not just the required versions. ", "type": "object", - "properties": { - "image_uri": { - "description": "The URL pointing to the image as hosted by Sefaria. ", - "type": "string", - "example": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg" - }, - "image_caption": { - "$ref": "#/components/schemas/BillingualJSON", - "description": "A JSON object containing the billingual caption data for an image associated with a topic.", + "allOf": [ + { + "type": "object", "properties": { - "en": { + "status": { "type": "string" }, - "he": { + "priority": { + "format": "int32", + "type": "integer" + }, + "license": { + "type": "string" + }, + "versionNotes": { + "type": "string" + }, + "formatAsPoetry": { + "type": "string" + }, + "digitizedBySefaria": { + "type": "string" + }, + "method": { + "type": "string" + }, + "heversionSource": { + "type": "string" + }, + "versionUrl": { + "type": "string" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "purchaseInformationImage": { + "type": "string" + }, + "purchaseInformationURL": { + "type": "string" + }, + "hasManuallyWrappedRefs": { + "type": "string" + }, + "actualLanguage": { + "type": "string" + }, + "languageFamilyName": { + "description": "The overarching family for the specific language detailed in `actualLanguage`. For example, `Arabic` would be the overarching `languageFamily` for `judeo-arabic`.", + "type": "string" + }, + "isBaseText": { + "type": "string" + }, + "isSource": { + "type": "boolean" + }, + "isPrimary": { + "type": "string" + }, + "direction": { + "type": "string" + }, + "language": { + "type": "string" + }, + "title": { + "description": "The title of the book.", + "type": "string", + "example": "Esther" + }, + "versionSource": { + "type": "string" + }, + "versionTitle": { "type": "string" } - }, - "example": "\"image_caption\": {\n \"en\": \"Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library\",\n \"he\": \"פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה\"\n}" + } + }, + { + "$ref": "#/components/schemas/v3TextVersionsJSON" } - }, + ], "example": { - "image_uri": "https://storage.googleapis.com/img.sefaria.org/topics/sukkot.jpg", - "image_caption": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } + "status": "locked", + "priority": 3, + "license": "CC-BY-NC", + "versionNotes": "Read the Preface to the Revised JPS Edition\n

\nRead the Notes on Gender in Translation for the Revised JPS Edition\n

\nRead a Commentary on the Hebrew word ’ish in the Revised JPS Edition", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "", + "versionNotesInHebrew": "", + "shortVersionTitle": "Revised JPS, 2023", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "https://storage.googleapis.com/sefaria-physical-editions/JPS-Tanakh-Gender-Sensitive-Edition-Cover-300x450.jpg", + "purchaseInformationURL": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "hasManuallyWrappedRefs": "", + "actualLanguage": "en", + "languageFamilyName": "english", + "isBaseText": "", + "isSource": false, + "isPrimary": "", + "direction": "ltr", + "language": "en", + "title": "Obadiah", + "versionSource": "https://jps.org/books/the-jps-tanakh-gender-sensitive-edition/", + "versionTitle": "THE JPS TANAKH: Gender-Sensitive Edition" } }, - "BillingualJSON": { - "title": "Root Type for TopicImgCaption", - "description": "A JSON object containing the Hebrew and English caption for the topic image. ", + "v3TextVersionsJSON": { + "title": "Root Type for v3TextVersionsJSON", + "description": "", "type": "object", "properties": { - "en": { - "description": "The English field for a JSON object representing billingual text. ", + "status": { + "description": "Whether or not the text is `\"locked\"` for further edits from the community. ", + "type": "string" + }, + "priority": { + "format": "float", + "description": "The priority assigned to a version of the text. A higher number will have the text appear higher within the listing of available versions for a specific text on the Sefaria website. (i.e. `Esther A` with a priority of `2`, will appear before `Esther B`, with a priority of `1`)", + "type": "number" + }, + "license": { + "description": "The license for the text, in terms of copyright, and distribution. ", "type": "string", - "example": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library" + "example": "Public Domain" }, - "he": { - "description": "The Hebrew field for a JSON object representing billingual text. ", + "versionNotes": { + "description": "Notes on the version", "type": "string", - "example": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - }, - "example": { - "en": "Detail of a painting of a sukkah. Image taken from f. 316v of Forli Siddur. 1383, Italian rite. The British Library", - "he": "פרט ציור של סוכה עם שולחן פרוש ושלוש דמויות. דימוי מתוך סידור פורלי, 1383 איטליה" - } - }, - "TopicTitlesJSON": { - "title": "Root Type for TopicTitlesJSON", - "description": "Alternative title for a topic, along with the language code representing the language of the given title. ", - "type": "object", - "properties": { - "text": { - "description": "The text of the title", + "example": "© Kehot Publication Society" + }, + "formatAsPoetry": { + "description": "A boolean indicating whether or not the text (or portions of it) are formatted as poetry.", + "type": "boolean" + }, + "digitizedBySefaria": { + "description": "An indicator of whether or not Sefaria digitized the text, versus acquiring an already digital copy of a text. ", + "type": "boolean" + }, + "method": { + "type": "string" + }, + "heversionSource": { + "type": "string" + }, + "versionUrl": { + "type": "string" + }, + "versionTitleInHebrew": { + "type": "string" + }, + "versionNotesInHebrew": { + "type": "string" + }, + "shortVersionTitle": { + "type": "string" + }, + "shortVersionTitleInHebrew": { + "type": "string" + }, + "extendedNotes": { + "type": "string" + }, + "extendedNotesHebrew": { + "type": "string" + }, + "purchaseInformationImage": { + "description": "A URL pointing to an image of the hardcopy text available for purchase.", "type": "string", - "example": "Sukkoth" + "example": "https://storage.googleapis.com/sefaria-physical-editions/touger-mishneh-torah-hilkhot-teshuvah-purchase-img.png" }, - "lang": { - "description": "The language of the title, either `en` or `he`. ", + "purchaseInformationURL": { + "description": "A URL pointing to where one can purchase a hardcopy of this text. ", "type": "string", - "example": "he" + "example": "https://moznaim.com/products/mishneh-torah-rambam" }, - "Primary": { - "description": "A field depicting whether or not the title is the primary title. Note: For any given topics, one should expect two titles with this field present and set to `true`, an English and a Hebrew primary title. The English value with `primary` set to `true` will match the string value of the `primaryTitle` field on topic. ", - "type": "boolean", - "example": "false" + "hasManuallyWrappedRefs": { + "type": "string" + }, + "actualLanguage": { + "description": "The language code for the language of the text. ", + "type": "string", + "example": "de" + }, + "languageFamilyName": { + "description": "The overarching family for the specific language detailed in `actualLanguage`. For example, `Arabic` would be the overarching family for `judeo-arabic`. ", + "type": "string" + }, + "isBaseText": { + "description": "Indicates whether or not this text is the base for a commentary (i.e. `Genesis` is a base text for `Ramban on Genesis`)", + "type": "boolean" + }, + "isSource": { + "type": "boolean" + }, + "isPrimary": { + "description": "Indicates whether or not this version of the text is determined as the primary version in the Sefaria database.", + "type": "boolean" + }, + "direction": { + "description": "The direction of the text, either `ltr` (left-to-right) or `rtl` (right-to-left). Examples of `ltr` languages include English, French and German. Examples of `rtl` languages are Hebrew and Arabic. ", + "type": "string", + "example": "ltr" + }, + "language": { + "description": "A holdover from the `v2` API which will eventually be deprecated. This used to indicate the direction of the text, with `en` indicating texts written from left-to-right, and `he` indicating texting written from right-to-left. ", + "type": "string", + "example": "`he`\n`en`" + }, + "versionSource": { + "description": "The original source of the digital text. ", + "type": "string", + "example": "http://kehot.com/" + }, + "versionTitle": { + "description": "The English title of the Version of text. ", + "type": "string", + "example": "Mischnajot mit deutscher Übersetzung und Erklärung. Berlin 1887-1933 [de]" + }, + "text": { + "description": "An array of strings containing the text of the specific version. \n\nIf a segment `Ref` was passed, the array returned will be one-dimensional and contain a string with the specific segment level text. \n\nIf a bottom level section `Ref` was passed, the array returned will be a two-dimensional array, a list of lists of strings. The outer layer of the array represents the section, and the inner arrays represent the segments. ", + "type": "array", + "items": { + "type": "string" + }, + "example": "[\n[\n\"Von welcher Zeit ab liest man das Schema. Zu Schema wird Deuter. 6, 4—9 שמע , 2. Deuter. 11, 13—21 והיה אם שמוע und 3. Numeri 15, 37—41 ויאמר gerechnet.\",\n\"da die Priester eintreten. Nämlich unreine Priester, welche nicht gebadet und gereinigt hatten und erst mit dem Erscheinen der Sterne ihre Hebe essen durften (Lev. 22, 7).\",\n\"bis zu Ende der ersten Nachtwache. Man teilte die Nacht in drei Wachen.\",\n\"Die Weisen. So oft hier der Ausdruck die Weisen vorkommt, verstehe man darunter die große Mehrzahl der Weisen, sofern sie nach allgemein geltender Ansicht entscheidet.\",\n\"Bis die Morgenröte. Säule der Morgenröte im Hebr. und Arab.\",\n\"aufsteigt. Der Grund der Meinungsverschiedenheit liegt in der Deutung des ובשכבך . R. Elieser erklärt: Wenn du dich niederlegst; dies geschieht bei den meisten Menschen bis Ende der ersten Nachtwache. Nach den Weisen und so auch nach R. Gamliel heißt ובשכבך , wenn du liegst; demnach wäre es die ganze Nacht erlaubt das Schema zu lesen, jedoch die Weisen erlauben es nur bis Mitternacht, um der Gesetzesübertretung vorzubeugen, was R. Gamliel nicht für nötig hält.\",\n\"Das Aufdampfen des Fettes und der Glieder. Stücke der Opfertiere, (Lev. 6, 2; 7, 2.)\",\n\"nur an demselben Tage gegessen werden darf. D. h. am Tage der Darbringung (Lev. 7, 15).\",\n\"Um die Menschen von der Übertretung fern zu halten. Nämlich, sie setzten eine kürzere Frist, damit man sich auf keinen Fall verspäte.\"\n],\n[\n\"Sobald man zwischen himmelblau und weiß unterscheiden kann; R. Elieser sagt: Zwischen himmelblau und lauchgrün; (und beendet das Lesen. וגומרה , wenn die Lesart richtig ist, bezieht es sich auf פרשת שמע .\",\n\"erst um drei Stunden aufzustehen. Das Gesetz ובקומך meint er, bedeute »bis Jedermann aufgestanden ist.« — Die Stunden sind hier je nach der Jahreszeit von verschiedener Länge; denn man teilte den Tag und die Nacht in je 12 Teile. Wenn also z. B. der Tag 8 und die Nacht 16 Stunden hat, so wird die Tagesstunde zu 8/12 gewöhnliche Stunden = 40 Minuten, die Nachtstunde aber zu 16/12 gewöhnliche Stunden = 80 Minuten gerechnet. Solche Stunden werden שעות זמניות = Zeitstunden genannt\",\n\"büsst nichts ein. D. h. er möge immerhin die dazu gehörigen Vor- und Nachgebete sprechen (nach Einigen jedoch nur bis Ende der. 4. Stunde) obgleich deren Zeit vorüber ist.\"\n],\n[\n\"brachte mich aber in Lebensgefahr durch Räuber. Wäre beinahe von Räubern getötet worden.\"\n],\n[\n\"Am Morgen spricht man zwei Segenssprüche voran. לפניה bezieht sich auf פרשת שמע .\",\n\"und zwei nachher. Nämlich des Morgens אהבה רבה ,יוצר אור und גאולה Des Abends מעריב גאולה ,אהבת עולם ,ערבים und השכיבנו .\",\n\"eine Schlussformel anzubringen. Die ganze Stelle von מקום שאמרו an wird hier als ein allgemeines, auf alle anderen ברכות sich auch beziehendes Gesetz mit eingeschaltet. — Unter Schlussformel versteht man einen mit ברוך anfangenden Satz, der das Ganze schliesst. Z. B. ברוך אתה ה׳ גאל ישראל .\"\n],\n[\n\"Man gedenke des Auszuges aus Ägypten auch in der Nachtzeit. D. h. es ist Pflicht auch in der Nacht פרשת ציצית zu sprechen, weil darin des Auszuges Erwähnung geschieht.\",\n\"Ich bin jetzt beinah. So nach einer Baraita im Jeruschalmi. Der babylonische Talmud jedoch sagt: R. Elasar ben Asarja sei damals nur 18 Jahre alt, aber bereits grau gewesen, wie ein Greis von siebzig Jahren. Nach Maimonides ist er durch vieles Studieren grau geworden.\"\n]\n]" + }, + "firstSectionRef": { + "description": "The first available `Ref` to the section of text passed in the API. ", + "type": "string" } }, "example": { - "text": "Tabernacles", - "lang": "en", - "primary": false + "status": "locked", + "priority": 2, + "license": "CC-BY-SA", + "versionNotes": "Miqra According to the Masorah (MAM) is a digital Hebrew edition of the Tanakh based on the Aleppo Codex and related manuscripts. It is designed for readers, and as such it contains added elements to aid vocalization of the text. For instance: When an accent is marked in an unstressed syllable, an extra accent is added in the proper place (pashta, zarqa, segol, telisha). Legarmeih and paseq are visibly distinguished. Qamaz qatan is indicated by its designated Unicode character (alternatives are documented where traditions differ about its application).
The text of MAM is fully documented. The complete introduction to the edition (Hebrew) explains the types of editorial decisions that have been made and the reasons for them (English abstract). In addition, every word in the Bible about which there is some textual concern or ambiguity includes a documentation note; these notes can be viewed conveniently here. If an error is discovered, it may be reported to User:Dovi at Hebrew Wikisource. Please check the documentation notes before reporting an error.", + "formatAsPoetry": "", + "digitizedBySefaria": "", + "method": "", + "heversionSource": "", + "versionUrl": "", + "versionTitleInHebrew": "מקרא על פי המסורה", + "versionNotesInHebrew": "", + "shortVersionTitle": "", + "shortVersionTitleInHebrew": "", + "extendedNotes": "", + "extendedNotesHebrew": "", + "purchaseInformationImage": "", + "purchaseInformationURL": "", + "hasManuallyWrappedRefs": "", + "actualLanguage": "he", + "languageFamilyName": "hebrew", + "isBaseText": true, + "isSource": true, + "isPrimary": true, + "direction": "rtl", + "language": "he", + "versionSource": "https://he.wikisource.org/wiki/%D7%9E%D7%A9%D7%AA%D7%9E%D7%A9:Dovi/%D7%9E%D7%A7%D7%A8%D7%90_%D7%A2%D7%9C_%D7%A4%D7%99_%D7%94%D7%9E%D7%A1%D7%95%D7%A8%D7%94", + "versionTitle": "Miqra according to the Masorah", + "text": [], + "firstSectionRef": "Obadiah 1" } }, - "TopicPropertyJson": { - "title": "Root Type for TopicPropertyJson", - "description": "The JSON object containing information about a topic's properties", + "LinkObj": { + "title": "Root Type for LinkObj", + "description": "A single link returned by the link (and related[?]) APIs", "type": "object", "properties": { - "heNliLink": { - "$ref": "#/components/schemas/NLILinkJSON", - "description": "A link to the Hebrew page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", - "properties": { - "value": { - "type": "string" - }, - "dataSource": { - "type": "string" - } + "_id": { + "type": "string" + }, + "index_title": { + "description": "The cannonical title of the text in the Sefaria library.", + "type": "string" + }, + "category": { + "description": "The primary category this ref belongs to on Sefaria.", + "type": "string" + }, + "type": { + "description": "An arbitrary string assigned to the connection to identify it. Most commonly `commentary`, `reference`, or an empty string. ", + "type": "string" + }, + "ref": { + "$ref": "#/components/schemas/ref" + }, + "anchorRef": { + "description": "The submitted `ref` in the GET request at times may fall within a more encompassing ranged ref that includes multiple text segments. The `anchorRef` is that complete range the that the link is associated with, and will contain within it the specific `ref` that was passed. ", + "type": "string", + "example": "\"Esther 3:15-4:17\"" + }, + "anchorRefExpanded": { + "description": "An array of strings, where each string is a segment level `ref` of the `ref` passed in as a parameter. If a segment level `ref` is passed in, this array will have a length of 1, and only contain that segment level `ref`. If the `ref` passed in is ranged, this array will contain each of the segment level `ref`s within that range. \n\nFor example, if someone was searching for links for `Esther 4.14-15`, the `anchorRefExpanded` would contain `Esther 4.14` and `Esther 4.15`.", + "minItems": 1, + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" }, - "example": " \"heNliLink\": {\n \"value\": \"https://www.nli.org.il/he/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" + "example": "\"anchorRefExpanded\": [\n \"Esther 4:14\",\n \"Esther 4:15\"\n]" }, - "enNliLink": { - "$ref": "#/components/schemas/NLILinkJSON", - "description": "A link to the English page on the website of the National Library of Israel which corresponds to the given topic, so users can learn more. ", + "sourceRef": { + "$ref": "#/components/schemas/ref", + "description": "The connecting link for the submitted `ref`" + }, + "sourceHeRef": { + "$ref": "#/components/schemas/ref" + }, + "anchorVerse": { + "format": "int32", + "type": "integer" + }, + "sourceHasEn": { + "type": "boolean" + }, + "compDate": { + "description": "The estimated year of completion of the work according to the Gregorian calendar. If its length is zero the completion date is unknown. If its length is one, then the completion date is that single year. If its length is 2 then the date is a potential range with the first int in the array is the lower end of the range and the latter the higher. ", + "type": "array", + "items": { + "format": "int32", + "type": "integer" + } + }, + "commentaryNum": { + "format": "double", + "type": "number" + }, + "collectiveTitle": { + "type": "object", "properties": { - "value": { + "en": { "type": "string" }, - "dataSource": { + "he": { "type": "string" } - }, - "example": "\"enNliLink\": {\n \"value\": \"https://www.nli.org.il/en/discover/judaism/holidays/sukkot\",\n \"dataSource\": \"sefaria\"\n}" - } - }, - "example": { - "heNliLink": { - "value": "https://www.nli.org.il/he/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" + } }, - "enNliLink": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" - } - } - }, - "NLILinkJSON": { - "title": "Root Type for NLILinkJSON", - "description": "JSON for storing NLI links related to data in the Sefaria database. ", - "type": "object", - "properties": { - "value": { - "description": "A link to a corresponding NLI page to learn more. ", - "type": "string", - "example": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot" + "he": { + "description": "The default text written in RTL characters for the query (Usually Hebrew). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text.\n", + "type": "string" }, - "dataSource": { - "description": "The source of the topic data, whether user-created or Sefaria-created. ", - "type": "string", - "example": "`sefaria`" + "heVersionTitle": { + "description": "The title of the work in English for where the default `he` text came from.", + "type": "string" + }, + "heLicense": { + "description": "A string of text documenting the license for the text in Hebrew.", + "type": "string" + }, + "heVersionTitleInHebrew": { + "description": "The title of the work in Hebrew for where the default `he` text came from.", + "type": "string" + }, + "text": { + "description": "The default text written in LTR characters for the query (Usually English). It is structured as a JaggedArray (nested arrays), with the lowest level being an array of strings with some html text.", + "type": "array", + "items": {} + }, + "versionTitle": { + "description": "A descriptive string which describes what version of a text this is. Is it from a particular printing or edition of a book? An online resource? This string should describe it in English", + "type": "string" + }, + "license": { + "description": "A string of text documenting the license for the text in English.", + "type": "string" + }, + "versionTitleInHebrew": { + "description": "A descriptive string which describes what version of a text this is. Is it from a particular printing or edition of a book? An online resource? This string should describe it in Hebrew.", + "type": "string" } }, "example": { - "value": "https://www.nli.org.il/en/discover/judaism/holidays/sukkot", - "dataSource": "sefaria" + "_id": "578b4ad1d6e4a90d260c2d9a", + "index_title": "Tosafot Yom Tov on Mishnah Peah", + "category": "Commentary", + "type": "commentary", + "ref": "Tosafot Yom Tov on Mishnah Peah 4:2:1", + "anchorRef": "Mishnah Peah 4:2", + "anchorRefExpanded": [ + "Mishnah Peah 4:2" + ], + "sourceRef": "Tosafot Yom Tov on Mishnah Peah 4:2:1", + "sourceHeRef": "תוספות יום טוב על משנה פאה ד׳:ב׳:א׳", + "anchorVerse": 2, + "sourceHasEn": false, + "compDate": [ + 1613, + 1617 + ], + "commentaryNum": 2.0001, + "collectiveTitle": { + "en": "Tosafot Yom Tov", + "he": "תוספות יום טוב" + }, + "he": "[*ואחד אומר לחלק לזה שומעין וכו'. שאפילו הוא זקן ותש כח או חולה שהרי מה שאמר לחלק מפני חלישותו הוא אפילו הכי שומעין לו כך מצאתי בפירוש הנ\"ל]: \n", + "heVersionTitle": "Mishnah, ed. Romm, Vilna 1913", + "heLicense": "Public Domain", + "heVersionTitleInHebrew": "משנה, מהדורת בית דפוס ראם, וילנא 1913", + "text": [] } } }