Documentation

📄️ Access the API

We will start by importing different useful libraries and define our first variables for the requests.

📄️ The endpoint "passages"

The first endpoint (passages) is the most important : it contains a list of all the epigrams. Let us have a look at it.

📄️ Pagination

As you might have noticed, all of the information are not displayed on the block above: the list is pagined and one can navigate the pages using the values of next and previous.

Let us now have a look at the data available for each epigram. Most of these data are present in the list of epigrams (alldata['results']), but each epigram has its own endpoint, structured on the basis of its book and its number.

📄️ Images of the manuscript (Codex Palatinus 23)

For each epigram, the corresponding iiif images of the manuscript can be found under the key manuscript (a high quality digitization of the codex palatinus 23 is available on the website of the Palatinate Library of Heidelberg).

📄️ Texts

Each epigram has a list of texts wich are associated to it. All the epigrams in our database should have at least the greek text. An epigram can have more than one greek editions of the text and a set of translations in different languages :

📄️ Authors

An epigram is almost always associated to one or more authors (since the attributions are often uncertain):

📄️ Keywords

Each epigram can be associated with keywords.

📄️ Cities (places)

An epigram can be associated with some places (cities or countries or whatever can have geocoordinates). Epigram 6.13 has no cities associated. Let us look to another epigram:

📄️ Scholia

On the Codex Palatinus 23, scholia are often associated to epigrams. Those scholia are also rendered on the platform and hence on the API.

📄️ Comments

An epigram can have comments, a sort of footnotes about the epigram as a whole of some part of it. These comments can be multilingual and they sometimes contain some markdown markup:

📄️ External references

An epigram can be linked to some external source. The idea of the project is to develop an edition which can take into account some "weak links" between the anthological material and some other cultural artefacts. This links are subjective and they do not want to be considered as "scientific". They can be link to a pop song, for example.