![logo](images/tf.png)

# Text-Fabric

A corpus of ancient texts and linguistic annotations represents a large body of knowledge.
Text-Fabric makes that knowledge accessible to programmers and non-programmers.

Text-Fabric is machinery for processing such corpora as annotated graphs.

## Straight to ...

* Release notes (`tf.about.releases`)
* Install (`tf.about.install`)
* FAQ (`tf.about.faq`)
* Browser (`tf.about.browser`)
* Search Client (`tf.about.clientmanual`) simplified (`tf.about.manual`)
* Use (`tf.about.use`)
* Volumes and collections (`tf.about.volumes`)
* Search (`tf.about.searchusage`)
* API (`tf.cheatsheet`)
* Corpora (`tf.about.corpora`)
* Data sharing (`tf.about.datasharing`)
* Data Structures and Algorithms
  (`tf.about.datamodel`, `tf.about.searchdesign`, `tf.about.displaydesign`)
* File Format (`tf.about.fileformats`, `tf.about.optimizations`)
* Converting to TF (`tf.convert.walker`, `tf.convert.mql`)
* Exporting data and reimporting it with enrichments (`tf.convert.recorder`)
* Dataset manipulation (`tf.dataset.modify` and `tf.dataset.nodemaps.Versions`)
* Crossing versions of datasets (`tf.dataset.nodemaps`)
* Code Organisation (`tf.about.code`)

## Author

**Author**:
[Dirk Roorda](https://pure.knaw.nl/portal/en/persons/dirk-roorda)

Cite Text-Fabric as
[DOI: 10.5281/zenodo.592193](https://doi.org/10.5281/zenodo.592193).

## Acknowledgements

Text-Fabric is a matter of putting a few good ideas by others into practice.

While I wrote most of the code,
a product like Text-Fabric is unthinkable without the contributions
of avid users that take the trouble to give feedback and file issues,
and have the zeal and stamina to hold on
when things are frustrating and bugs overwhelming,
and give encouragement when they are happy.

In particular thanks to

* Andrea Scharnhorst
* Cale Johnson
* Camil Staps
* Christian Høygaard-Jensen
* Christiaan Erwich
* Cody Kingham
* Ernst Boogert
* Eliran Wong
* Gyusang Jin
* Henk Harmsen
* James Cuénod
* Johan de Joode
* Kyoungsik Kim
* Martijn Naaijer
* Stephen Ku
* Wido van Peursen

<img src="images/DANS-logo.png" width="200">

## More resources

Tutorials:

* [BHSA](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/bhsa/start.ipynb)
* [DSS](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/dss/start.ipynb)
* [OldBabylonian](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/oldbabylonian/start.ipynb)
* [OldAssyrian](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/oldassyrian/start.ipynb)
* [Uruk](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/uruk/start.ipynb)
* [Q'uran](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/quran/start.ipynb)
* and more: [all tutorials](https://nbviewer.jupyter.org/github/annotation/tutorials/tree/master/)

---

Papers:

* [Coding the Hebrew Bible](https://doi.org/10.1163/24523666-01000011)
* [Parallel Texts in the Hebrew Bible, New Methods and Visualizations ](https://arxiv.org/abs/1603.01541)
* [The Hebrew Bible as Data: Laboratory - Sharing - Experiences](https://www.ubiquitypress.com/site/chapters/10.5334/bbi.18/)
   (preprint: [arxiv](https://arxiv.org/abs/1501.01866))
* [LAF-Fabric: a data analysis tool for Linguistic Annotation Framework with an application to the Hebrew Bible](https://arxiv.org/abs/1410.0286)
* [Annotation as a New Paradigm in Research Archiving](https://arxiv.org/abs/1412.6069)

---

Presentations:

[Hands on with Dead Sea Scrolls, Old Babylonian Tablets, and the Q'uran](https://nbviewer.jupyter.org/github/annotation/tutorials/blob/master/lorentz2020/start.ipynb)
(Lorentz Leiden 2020)

[Text-Fabric in Context](https://www.slideshare.net/dirkroorda/tf-incontext) (Lorentz Leiden 2020)

[Data Analysis in Ancient Corpora](https://www.slideshare.net/dirkroorda/ancient-corpora-analysis) (Cambridge 2019, with Cody Kingham)

[Text-Fabric as IKEA logistics](https://nbviewer.jupyter.org/github/ETCBC/lingo/blob/master/presentations/Copenhagen2018.ipynb) (Copenhagen 2017)

Here is a motivational [presentation](http://www.slideshare.net/dirkroorda/text-fabric), given just before [SBL 2016](https://global-learning.org/mod/forum/discuss.php?d=22)
in the Lutheran Church of San Antonio.