In this document we provide a general introduction on how to useGecco as well as a more in-depth tour of features.
Quick-start withGecco: quick searches
The web interface of Gecco is meant to allow the user toperform searches on the corpus and navigate the results. The interfacehas been both built for expressivity of the searches, as well asrapidity to access common parts of the corpus.
TODO
Viewing a list of documents
If you have looked for a set of document (eg. Enkomi),you will be taken to a page listing all the documents in the set. Thepicture of the tablet – in real size if this information is available –will be displayed and below its name. Clicking on it takes you to its
Viewing a single document
When viewing a single document, Gecco displays its metadata(title, find-place, size, number of signs) as well as an interactiveimage of the tablet. There are two interactive modes:
Sign view: In Sign View, all sign occurrences known toGecco on the tablet are highlighted, with a color depending onits function in the tablet. Clicking on a particular sign reveals moreinformation about the sign. The color code is:
blue and purple: syllabograms, ie. signsbelonging to a word. We use two colors to be able to visuallydistinguish word boundaries: two signs in the same word have the samecolor, so an alternation blue/purple marks the boundary of aword.
yellow: transaction sign
green: logogram
orange: fraction sign
red: erasure
Word view: In word view, only syllabograms are coloured.When hovering one syllabogram, all the syllabograms belonging to theword are highlighted. Clicking on it displays information about the wordand allows accessing the chart of that word.
Viewing sign attestations
When looking for a set of sign attestations (eg. all attestations ofthe same), all the attestations are displayed, by default sorted byfind-place. The sign is cropped out of its document by default (but aparameter of the search allows displaying the attestation in context).Clicking on an attestation takes you to the document containing it.
Viewing word attestations
As for sign attestations, all attestations are displayed, but incontext this time. This means the tablet is displayed and theattestation is highlighted within it.
Complex searches
Beyond these quick searches, Gecco also offers thepossibility of crafting more complex searches. In the homepage, there are links towards building a new document search, a newsign search (for sign attestations) and word search (for wordattestations). In all these cases, it leads to a page where a complexsearch can be input.
A complex search has two components:
The search criteria. Only those items matchingall search criteria are part of the result. All searchforms come with some predefinite criteria such as find-place.
The grouping criteria. This allows to choose how the results aregrouped or sorted together.
In both cases, a given criteria can be removed by click on the ⊝ onits right.
Search criteria
Search criteria specify conditions on items. These criteria are builtinteractively from the properties of the kind of items we are searching:for instance, if we are crafting a document search, a criterion could beconcerned with its width, or if we are looking for a sign attestation,with its reading. Such properties can be composed arbitrarily to leadcomplex criterion.
TODO
Group criteria
The lower part of the interface is dedicated to organising the searchresults. It is possible to give a list of grouping criteria that allowto group and sort the items (documents, sign attestations or wordattestations depending on the search) by properties. The first thing todo is to pick a criterion (by default: find-place), and choose apossibility:
- Group results which have the same value for the property together,and sort the group either by the property value (eg. by the alphabeticorder on find-places) or by the size of the group
- Sort results according to this property.
It is possible to specify several such grouping criterion, which arethen applied in order to make groups within groups.