Load the Text-Fabric dataset (N1904-TF)¶

Table of content (TOC)¶

• 1 - Introduction
  • 1.1 - Text-Fabric data versions
  • 1.2 - Prerequisites / Installation
  • 1.3 - Updates
• 2 - Load Text-Fabric into memory
  • 2.1 - Load the Text-Fabric code
  • 2.2 - Load the Text-Fabric app and data
  • 2.3 - Push CSS code to the Notebook
• 3 - Notebook version

1 - Introduction ¶

Back to TOC¶

This Jupyter Notebook provides detailed instructions on how to load the CenterBLC/N1904 Text-Fabric dataset into your Python environment. This will enable you to perform linguistic analysis on the Greek New Testament (Nestle 1904, 7th edition).

1.1 - Text-Fabric data versions ¶

The CenterBLC/N1904 Text-Fabric dataset is available as a collection of files hosted on GitHub. The files in this dataset can be distinguised into two main types:

• The feature data files are stored in the directory tf where each subdirectory maps to a specific version. Each version is accompanied with release information that can be viewed here.

• The application related files are integral part of the Text-Fabric dataset and provide dataset-specific functionalities like viewtypes.

When invoking the latest version of the Text-Fabric dataset, the code downloads a single zip file instead of individual files. This file, 'complete.zip,' contains all the necessary files (and some bookkeeping files) for a specific release.

In case you want to load a specific version (other than the latest one) there may be the need to increase GitHub's rate limit. Instructions on how this can be achieved can be found in this Jupyter Notebook.

1.2 - Prerequisites / Installation¶

Before you can start using Text-Fabric, you need to set up a suitable Python environment (at least Python version 3.7.0). An example of installing a Python environment using Anaconda is demonstrated in this Jupyter Notebook. Further it is required to install the Text-Fabric package in this environment. Instructions on this are provided in this Jupyter Notebook. This setup process only needs to be done once. Afterward, the Text-Fabric code will be available for loading into your system's memory.

Besides keeping your Python environment updated, it is also advisable to periodically update your installed version of Text-Fabric to the latest or a more recent release. How to do this from within a Jupyter Notebook is demonstrated in this Notebook.

In certain situations (particularly when loading Text-Fabric datasets other than the latest version), it may also be necessary to increase the rate limit for GitHub. See this Notebook for more information.

2 - Load Text-Fabric into memory ¶

Back to TOC¶

The instructions in this section need to be executed each time you want to use Text-Fabric. They will first load the Text-Fabric code and then load the data into memory.

2.1 - Load the Text-Fabric code ¶

2.2 - Load Text-Fabric app and data ¶

The following invocation of function use() loads all features of the corpus. It creates a datastructure (in this example N1904) with associated methods and function. Collectively this is refered to as the 'Advanced API', in the 'cheat sheet' references to A.*something*. The exact name is however determend during invocation by the use() command. Hence, in this notebook references to this 'Advanced API' should be adressed as N1904.

2.3 - Push CSS code to the Notebook¶

The following code is optional. Its main function is to ensure the formatting of Text-Fabric objects, such as tables and syntax trees, is properly displayed in the online Notebook Viewer, matching the way it is shown in the Jupyter Notebook itself. It is using the getCss(app) function to collect the complete CSS code from the TF and the app.

Note: this is achieved by embedding the CSS code inside the notebook file. The content of the CSS code can be examined from this cells output (truncated):

{
   "cell_type": "code",
   "execution_count": 7,
   "id": "932992c9-3fd9-4b5a-aa22-48eb376c8622",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<style>tr.tf.ltr, td.tf.ltr, th.tf.ltr { text-align: left ! important;}\n",
       "tr.tf.rtl, td.tf.rtl, th.tf.rtl { text-align: right ! important;}\n",
       "@font-face {\n",
       "  font-family: \"Gentium Plus\";\n",

       ... etc ...

3 - Notebook version¶

Back to TOC¶