andredelft / heidegger-index

A digital 'kaartenbak' to organize references to Heideggers work by subject

Heidegger index

https://heidegger.delve.nu/index

Add lemmas to index/heidegger-index.yml

>>> from index import add_ref
>>> add_ref('Grundriß', 'ZW', 79)
>>> add_ref('Kierkegaard, Søren', 'GA 29/30', 226, 'p')  # Referencing personal names
>>> add_ref('Sein und Zeit', 'ZEG', 63, 'w')  # Referencing works
>>> add_ref('Grundriß', 'GA 61', '159-160', ref_type='r')  # Referencing pages related to term

This function is also available als a terminal command add-ref, that can be installed using

pip install .

Usage:

$ add-ref --help

Usage: add-ref [OPTIONS] LEMMA WORK REF

Options:
  -l, --lemma-type [p|w|g]  Type of lemma (p: person, w: work, g: geographical name)
  -r, --ref-type [r]      Type of lemma (r: related)
  -b, --betacode          Convert lemma from betacode to unicode
  --help                  Show this message and exit.

E.g.:

add-ref Grundriß ZW 79
add-ref --lemma-type p 'Kierkegaard, Søren' 'GA 29/30' 226

Add relations to index/heidegger-index.yml

>>> from index import add_rel
>>> add_rel('φύσις', 'φύσει ὄντα', 'p')  # φύσις is parent of φύσει ὄντα
>>> add_rel('Aristoteles', 'De anima', 'a')  # Aristoteles is the author of De anima
>>> add_rel('μορφή', 'ὕλη', 'r')  # μορφή is related to ὕλη

This is also available via the terminal command add-rel:

$ add-rel --help

Usage: add-rel [OPTIONS] FIRST_LEMMA SECOND_LEMMA [p|a|r]

Add metadata to lemmata in index/heidegger-index.yml

A Python function to add URNs or GND id's to the lemma metadata. For now, we limit ourselves to the URNs used by Perseus and GND id's.

If the URN refers to a passage in the Perseus Digital Library this passage will be rendered on the work lemma page. The lemma will also be accessible by the URN like so: /index/lemma/example:urn:to:lemma.

If the GND id is added to a lemma it is accessible via the id in the url: /index/gnd/<thegndid>.

>>> from index import add_metadata
>>> add_metadata('urn', 'Aristoteles', 'p', 'urn:cts:greekLit:tlg0086') # Aristoteles can be found at this URN in Perseus and in the index.
>>> add_metadata('gnd', 'Goethe, Johann Wolfgang von', 'p', '118540238') # Goethe can be found at this id in the index.

A terminal command is also added:

$ add-metadata --help

Usage: add-metadata [OPTIONS] [urn|gnd] LEMMA [p|w] URN

Options:
  -f, --force  Overwrite URN if lemma already has a urn defined.

Search for an existing reference

A terminal command find-ref is provided to search through existing references. It provides flexible matching, e.g.:

$ find-ref Seienden
Beziehung zu Seiendem als Solchem
Seiende im Ganzen
Sein zu Seiendem als Seidendem

Page references

We datafy the page references based on the input string. It is matched against a regular expression that roughly looks like:

'{start}(?:-{end}|{suffix}.?)?'

Where

• start is the first page (required, integer)
• end is the last page (optional, integer)
• suffix is a suffix (optional, 'f' or 'ff')

As can be seen from the regular expression, end and suffix are optional, and cannot appear simultaneously. Valid references are, for example 123, 123-124 (make sure not to abbreviate final page numbers, like 123-4) and 12f..

Work references

The references to Heideggers works are gathered in index/works.yml in CSL YAML format. Using a citeproc processor these can be converted to a styled bibliography using the command format-refs. The output is stored in index/works.html

Django project

A Django project is included with models into which index/heidegger-index.yml can be ingested and served as a dynamic HTML page. Follow the steps below to spin up the project.

1. Install requirements:

   pip install -r requirements.txt

2. Initialize the databse:

   python manage.py migrate

3. Populate the database:

   python manage.py populate_index

4. Spin up the django project:

   python manage.py runserver

5. Navigate to http://localhost:8000.