Home | Resources | Services | Hosting | Publications | Collaboration | Joining CERL | About CERL |

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
resources:cerl_thesaurus:editing:newinterface [2018/11/22 10:07]
liventsova [4.5 Deduplicating Records]
resources:cerl_thesaurus:editing:newinterface [2020/01/27 12:34] (current)
jahnke [3.5 Related Places]
Line 59: Line 59:
 {{ :​resources:​cerl_thesaurus:​editing:​language.jpg?​300|Language}} {{ :​resources:​cerl_thesaurus:​editing:​language.jpg?​300|Language}}
  
-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 "​Language"​ in the navigation bar at the bottom of the page. A menu will pop up, which will let you choose a different language. ​+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 ​immediately,​ but only for the current session, click the link labelled "​Language"​ in the navigation bar at the bottom of the page. A menu will pop up, which will let you choose a different 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 "​preferred language"​ in your account settings, if you are logged in, or if that is not available either, the language set as default by your browser (check browser'​s help pages how to change this) or if that doesn'​t work either, it defaults to English.+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 "​preferred language"​ in your account settings, if you are logged in, or if that is not available either, the language set as default by your browser (check ​your browser'​s help pages how to change this) or if that doesn'​t work either, it defaults to English.
  
  
Line 78: Line 78:
 ==== 2.1 Full text search ==== ==== 2.1 Full text search ====
 {{ :​resources:​cerl_thesaurus:​editing:​search1.png?​300|Search}} {{ :​resources:​cerl_thesaurus:​editing:​search1.png?​300|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, ​click on "​Search for names only" in the right column afterwards; ​see below for more details.)
  
-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 ​by 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.
 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"​ will present the records of that set in a list that can be paged through using the buttons at the bottom of the page. Clicking on "Show all ... records"​ will present the records of that set in a list that can be paged through using the buttons at the bottom of the page.
  
-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 "​Bookmarks"​ in the top navigation bar.+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" ​. You can access your bookmarked records from the item "​Bookmarks"​ in the top navigation bar.
  
  
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:​cnl00032270''​| |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:​cnl00032270''​|
 |sign|search within the sign/​marks/​devices fields \\ ''​sign:​tortuga''​| |sign|search within the sign/​marks/​devices fields \\ ''​sign:​tortuga''​|
-|type|search for a certain record type \\ type:cnp| +|type|search for a certain record type \\ ''​type:cnp''​
-|year_end|search for entities whose activity or existence ended before, in or after a certain year \\ ''​year_end:>​1800''​ \\ year_end:<​1500|+|year_end|search for entities whose activity or existence ended before, in or after a certain year \\ ''​year_end:>​1800''​ \\ ''​year_end:<​1500''​|
 |year_start|search for entities whose activity or existence started before, in or after a certain year \\ ''​year_start:​[1530 TO 1560]''​| |year_start|search for entities whose activity or existence started before, in or after a certain year \\ ''​year_start:​[1530 TO 1560]''​|
  
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 "​History"​ in the top navigation bar. You can go back to a particular search or record by clicking on the query or record id. 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 "​History"​ in the top navigation bar. You can go back to a particular search or record by clicking on the query or record id.
  
-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 ====
- +{{ :​resources:​cerl_thesaurus:​editing:​ct_headings.png?​300|Headings in the CERL Thesaurus}}
 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,​ but lists them alphabetically indicating the institutions that use that particular form. Thus, there is no "CERL form" for a heading. The name form given as a headline in a record'​s full display is the first heading recorded within that record, its prominent position does not imply any indication of preference for that form. 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,​ but lists them alphabetically indicating the institutions that use that particular form. Thus, there is no "CERL form" for a heading. The name form given as a headline in a record'​s full display is the first heading recorded within that record, its prominent position does not imply any indication of preference for that form.
  
-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 ''​varn'' ​as a default+Variant name forms do now have an additional code, indicating the type of the name form (**$0** in **4xx** fields). This code is mandatory ​and defaults to ''​varn'' ​("​variant name")
  
 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: [[::​resources:​cerl_thesaurus:​editing:​formbasededitor#​complex_fields|the section on complex fields in the form based editor]] See also: [[::​resources:​cerl_thesaurus:​editing:​formbasededitor#​complex_fields|the section on complex fields in the form based editor]]
  
-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/​written by the described entity ​and books owned by the described person or corporate body.
  
-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: 
 +  
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​290]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​291]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​292]] 
 + 
 +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. 
 + 
 +//​**Biographical data**// and //**dates of activity**//​ should always hold the dates mentioned in the note also in machine readable form in a separate subfield, which can then be used for sorting records chronologically or filtering for records from a certain time period. Biographical data can also be given as  dates of existence of a corporate entity. "​Founding dates" or similar of places are not given here, though. 
 + 
 +In the form based editor biographical data and date of activities are two separate fields, while in the (Unimarc-based) "CT Internal Format"​ the same field is used with a different value at the first indicator position. 
 + 
 +Any other information about a person'​s,​ printer'​s or corporate body's academic title / degree, domain of artistic expression, intellectual responsibility for a publication,​ language(s),​ profession/​occupation,​ religious affiliation,​ title(s) of nobility, traded items or any other activity is given as an //​**activity note**//. In an activity note it is possible to use controlled vocabulary. When controlled Vocabulary is used, the corresponding URI is given as well, or, in case there is no URI, the source vocabulary is indicated.  
 + 
 +Any aspect of the entity'​s description relating to geography in any way or form is given as a //​**geographic note**//. A geographic note can also hold terms from a controlled vocabulary including their URI or a country code. Place records often indicate the country/​province/​region the place belongs to nowadays as a means of identification or disambiguation. 
 + 
 +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: 
 +  
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​300]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​340]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​350]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​356]] 
 + 
 + 
 +==== 3.5 Related Places ==== 
 +{{ :​resources:​cerl_thesaurus:​editing:​ct_related_places.png?​300|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. In the web interface, related places are plotted on a map, if the place records contain geo-coordinates. 
 + 
 +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"​ (code 3 in field 110$a) and can link out to the records for the individual places by that name. This relationship is typed as "see instead"​. 
 + 
 +If there is no further specification of how a place is related to the entity described in the record, '​act'​ (place of activity) is used for persons, corporate bodies and printers and '​relp'​ (related place) is used for places. 
 + 
 +For a detailed description of the input convention applying see: 
 +  
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​515]] 
 + 
 +==== 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,​ predecessors und successors in business, persons being members of a corporate body etc. The type of relationship is always indicated with the link to the target record. 
 + 
 +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: 
 +  
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​500]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​510]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​512]] 
 + 
 +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'​ devices, used together with or instead of an address are recorded together with the place of activity (see above). Links to images of such devices/​marks/​signs can be provided as well. For a detailed description of the input convention applying see: 
 + 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​516]] 
 + 
 + 
 +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: 
 + 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​956]] 
 + 
 + 
 +==== 3.8 External Resources ==== 
 + 
 +Apart from linking to images of printers'​ devices, provenance marks or similar, there are two types of links to external resources from within a CERL Thesaurus record. One of it can link to any type of resource that is provides further information on the described entity or is relevant in any other way. This kind of link is displayed as "​Online Resource"​ in the "More Information"​ section. 
 + 
 +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/​depiction of the described entity 
 +  * 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: 
 +  
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​856]] 
 +  * [[:​resources:​cerl_thesaurus:​editing:​format:​956]]
  
-3.7 Signs, Marks, Devices 
  
-3.8 External Resources 
  
 ==== 3.9 Geographic Coordinates ==== ==== 3.9 Geographic Coordinates ====
Line 205: Line 290:
  
  
-3.10 Other Formats+==== 3.10 Other Formats ​==== 
 +{{ :​resources:​cerl_thesaurus:​editing:​ct_rdf_turtle.png?​300|CT Record as RDF}} 
 +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"​ based on Unimarc Authorities as a working format. Data can be entered and edited equally in either the old or the new format (see below). 
 + 
 +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 =====
 resources/cerl_thesaurus/editing/newinterface.1542877671.txt.gz · Last modified: 2018/11/22 10:07 by liventsova

 

 

Recent changes RSS feed Valid XHTML 1.0 Driven by DokuWiki