Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
resources:cerl_thesaurus:editing:newinterface [2018/06/14 18:20] – [3.1 Types of entities] jahnke | resources:cerl_thesaurus:editing:newinterface [2020/01/27 12:30] – [3.2 Headings and Names] jahnke | ||
---|---|---|---|
Line 59: | Line 59: | ||
{{ : | {{ : | ||
- | Changing your preferred interface language on your account page, takes effect only after you log out and log in again. To change the interface language for the immedeately, click the link labelled " | + | Changing your preferred interface language on your account page, takes effect only after you log out and log in again. To change the interface language |
- | Please note that not all databases within the hosting environment are available in all languages. If you select a language which is available for the CERL Thesaurus and then switch to a different database that does not support that language, the system will try the language you've set as " | + | Please note that not all databases within the hosting environment are available in all languages. If you select a language which is available for the CERL Thesaurus and then switch to a different database that does not support that language, the system will try the language you've set as " |
Line 78: | Line 78: | ||
==== 2.1 Full text search ==== | ==== 2.1 Full text search ==== | ||
{{ : | {{ : | ||
- | Probably the easiest approach to searching the CT is to use one or more terms in the full text search field. A full text search in the new environment will typically yield more hits than in the previous system, due to different indexing principles applied to the data. (To let your search mimic the behaviour of the old system, see below.) | + | Probably the easiest approach to searching the CT is to use one or more terms in the full text search field. A full text search in the new environment will typically yield more hits than in the previous system, due to different indexing principles applied to the data. (To let your search mimic the behaviour of the old system, |
- | As a default your search result will be grouped the types of entities it contains: Corporate Names, Imprint Names, Places and Persons. Each group will display the first 25 hits and a link to the full set, if available. | + | As a default your search result will be grouped |
You may click a heading in these list to access the full record. | You may click a heading in these list to access the full record. | ||
Clicking on "Show all ... records" | Clicking on "Show all ... records" | ||
- | To bookmark a record, click the bookmark icon in the top right corner of the record. You can access your bookmarked records from the item " | + | To bookmark a record, click the bookmark icon in the top right corner of the record's full display or the short list that appears when clicking on "Show all ... records" |
Line 123: | Line 123: | ||
|related_to|search for records that link to the given record id. There is a number of search keys that allow for more detailled searches for certain relationship types, which are not listed here. \\ '' | |related_to|search for records that link to the given record id. There is a number of search keys that allow for more detailled searches for certain relationship types, which are not listed here. \\ '' | ||
|sign|search within the sign/ | |sign|search within the sign/ | ||
- | |type|search for a certain record type \\ type:cnp| | + | |type|search for a certain record type \\ '' |
- | |year_end|search for entities whose activity or existence ended before, in or after a certain year \\ '' | + | |year_end|search for entities whose activity or existence ended before, in or after a certain year \\ '' |
|year_start|search for entities whose activity or existence started before, in or after a certain year \\ '' | |year_start|search for entities whose activity or existence started before, in or after a certain year \\ '' | ||
Line 134: | Line 134: | ||
The last 20 searches you have performed (or records you've consulted in full display) are recorded in your search history and can be seen from the item " | The last 20 searches you have performed (or records you've consulted in full display) are recorded in your search history and can be seen from the item " | ||
- | The search history is associated with the current session. If you don't do anything in the web interface for more than two hours, logout or if you clear your browser cookies, the session will be terminated and the search history will be no longer available. Data associated with terminated sessions is deleted from the server after 24 hours. | + | The search history is associated with the current session. If you don't do anything in the web interface for more than two hours, logout or if you clear your browser cookies, the session will be terminated and the search history will be no longer available. |
Line 158: | Line 158: | ||
==== 3.2 Headings and Names ==== | ==== 3.2 Headings and Names ==== | ||
- | + | {{ : | |
The CERL Thesaurus records the preferred name forms of an entity as they are used in CERL Member libraries. Heading forms differ according to the language used for cataloguing and the cataloguing rules applied. The CERL Thesaurus does not declare one of these name forms as authoritative, | The CERL Thesaurus records the preferred name forms of an entity as they are used in CERL Member libraries. Heading forms differ according to the language used for cataloguing and the cataloguing rules applied. The CERL Thesaurus does not declare one of these name forms as authoritative, | ||
- | Variant name forms do now have an additional code, indicating the type of the name form (**$0** in **4xx** fields). This code is mandatory. If in doubt, use '' | + | Variant name forms do now have an additional code, indicating the type of the name form (**$0** in **4xx** fields). This code is mandatory |
For a detailed description of the various fields and the input convention applying see: | For a detailed description of the various fields and the input convention applying see: | ||
Line 177: | Line 176: | ||
See also: [[:: | See also: [[:: | ||
- | 3.3 Sources | + | ==== 3.3 Sources |
- | 3.4 Notes and Biographical Data | + | The CERL Thesaurus records three types of sources for the information given in a record: reference works, editions printed/ |
- | 3.5 Related Places | + | There is no prescribed syntax or a controlled list of abbreviations for reference works in the "Found In" field. |
- | 3.6 Other Related Entities (Persons, Printers, Corporate Bodies) | + | The CERL Thesaurus is neither a bibliographic database nor a provenance database, so editions and copies are recorded only as sources of evidence. Complete lists of works printed, written or owned by an entity can be provided elsewhere (e.g. HPB, HPB-Item, MEI etc) and a link can be made from the Thesaurus record instead. |
+ | |||
+ | For a detailed description of the available fields and the input convention applying see: | ||
+ | |||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | Sources that apply to a specific piece of information only (such as bibliographic data or an individual variant name form) are recorded in that particular field. | ||
+ | |||
+ | ==== 3.4 Notes and Biographical Data ==== | ||
+ | |||
+ | There are four categories of (public) notes in a CERL Thesaurus record: | ||
+ | |||
+ | //**General notes**// can hold any information on the described entity that does not fit in any of the other categories. | ||
+ | |||
+ | // | ||
+ | |||
+ | In the form based editor biographical data and date of activities are two separate fields, while in the (Unimarc-based) "CT Internal Format" | ||
+ | |||
+ | Any other information about a person' | ||
+ | |||
+ | Any aspect of the entity' | ||
+ | |||
+ | Unless controlled vocabulary or codes are used, all note fields are free-text fields, which means that the language of the note is always indicated. Note fields also provide a subfield to record the source the information is taken from. | ||
+ | |||
+ | For a detailed description of the available fields and the input convention applying see: | ||
+ | |||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | |||
+ | ==== 3.5 Related Places ==== | ||
+ | Records for persons, printers and corporate entities can be linked to places where they have lived or have been active in any way. The type of relationship between such an entity and a place can be specified as well, which facilitates more sophisticated search queries (for example for persons that went to school in a given place). It is possible to record also an address together with the place name. | ||
+ | |||
+ | There can also be a relationship between two places. Currently it is possible to describe a place as being a part of another, larger place, for example a village that is nowadays part of a larger city. | ||
+ | |||
+ | There are a number of place name records that do not describe an individual place but a place name that is the name for a number of places. These records are marked as being "used for more than one entity" | ||
+ | |||
+ | If there is no further specification of how a place is related to the entity described in the record, ' | ||
+ | |||
+ | For a detailed description of the input convention applying see: | ||
+ | |||
+ | * [[: | ||
+ | |||
+ | ==== 3.6 Other Related Entities (Persons, Printers, Corporate Bodies) | ||
+ | |||
+ | CERL Thesaurus records for persons, printers and corporate bodies can link to other records for any of these entity types to indicate family relationships, | ||
+ | |||
+ | Records for places can only link to other places, not to persons, printers or corporate bodies (while any of these can link to a place record). | ||
+ | |||
+ | For a detailed description of the available fields and the input convention applying see: | ||
+ | |||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | In the Unimarc-based //CT Internal Format// three different fields are used, depending on the type of entity the link points to. In the form based editor there is only one (complex) data entry field for links to persons, printers and corporate bodies. Here the type of the target entity is selected from the drop down list. | ||
+ | ==== 3.7 Signs, Marks, Devices ==== | ||
+ | |||
+ | Any sign, image or mark associated with a given entity can be described in the records for persons, corporate bodies and printers. This could be provenance marks, library stamps, printers devices etc. Signs, particularly printers' | ||
+ | |||
+ | * [[: | ||
+ | |||
+ | |||
+ | Images of the actual entities themselves (e.g. portraits) can be added as well. It is however not possible to upload image data to the CERL Thesaurus server, instead a link to an external resource is set. When doing so, make sure that the intellectual property rights of others are not violated. For a detailed description of the input convention applying see: | ||
+ | |||
+ | * [[: | ||
+ | |||
+ | |||
+ | ==== 3.8 External Resources ==== | ||
+ | |||
+ | Apart from linking to images of printers' | ||
+ | |||
+ | The other kind of links are displayed in the right column and express a certain type of relationship between the described entity and the external resource. This could be: | ||
+ | |||
+ | * a bibliographic record in a library catalogue (or similar database) | ||
+ | * a search for books owned by the described person or corporate body in an external database | ||
+ | * a portrait/ | ||
+ | * any entry in an online encyclopedia (e.g. Wikipedia) or biographic lexicon about the described entity | ||
+ | * the entry for the described entity in another authority file | ||
+ | |||
+ | For a detailed description of the available fields and the input convention applying see: | ||
+ | |||
+ | * [[: | ||
+ | * [[: | ||
- | 3.7 Signs, Marks, Devices | ||
- | 3.8 External Resources | ||
==== 3.9 Geographic Coordinates ==== | ==== 3.9 Geographic Coordinates ==== | ||
Line 205: | Line 289: | ||
- | 3.10 Other Formats | + | ==== 3.10 Other Formats |
+ | {{ : | ||
+ | Internally, CERL Thesaurus records are stored as JSON objects. From the web interface, the (actual) internal format of a record can be retrieved in JSON or YAML. For compatiblity reasons the interface also supports the old "CT Internal Format" | ||
+ | |||
+ | Additionally CT data can be retrieved in RDF as well (RDF/XML, Turtle or JSON-LD) to use it in Linked Data applications. There are, however, a few pieces of information that are currently not translated into RDF, so RDF description sets are marginally less complete than records in the (JSON-based) internal format or the old (Unimarc-based) "CT Internal Format" | ||
===== 4 Editing the CERL Thesaurus ===== | ===== 4 Editing the CERL Thesaurus ===== | ||
Line 280: | Line 369: | ||
To find potential duplicates, search for '' | To find potential duplicates, search for '' | ||
- | The duplicate candidate records are shown in the right column. The first (white) one is the record you started with; sinc this is the record the other are finally merged into, you cannot deselect it from deduplication. | + | The duplicate candidate records are shown in the right column. The first (white) one is the record you started with; since this is the record the other are finally merged into, you cannot deselect it from deduplication. |
//**Please note:** If there are many duplicate candidates it might be easier to check the records one by one. To do that, you start with “Hide all” (which turns all candidates grey) and then re‐activate the first candidate and see if it is a duplicate or not. If it’s not, uncheck it and go to the next. If it is, you could click the other button next to the check mark (the one with the three stripes on it) to switch the record’s colour to white before you proceed with the next record. So you’d know that everything that’s white is checked and “ok” and the amount of different colours is a little less confusing.// | //**Please note:** If there are many duplicate candidates it might be easier to check the records one by one. To do that, you start with “Hide all” (which turns all candidates grey) and then re‐activate the first candidate and see if it is a duplicate or not. If it’s not, uncheck it and go to the next. If it is, you could click the other button next to the check mark (the one with the three stripes on it) to switch the record’s colour to white before you proceed with the next record. So you’d know that everything that’s white is checked and “ok” and the amount of different colours is a little less confusing.// |
resources/cerl_thesaurus/editing/newinterface.txt · Last modified: 2023/12/11 15:13 by jahnke