====== How to Search the ISTC ====== \\ see also our [[briefguide]] with a lot of sample queries \\ \\ ===== 1. Searching ===== {{ :help:istc:search_2.png?642x61 | ISTC search box}} \\ You may perform a free-text search just by entering a search term into the search box and hitting "search". Your search will return all the records that contain the given search term in any of their fields. \\ \\ {{ :help:istc:search_3.png?642x61 | ISTC search box}} \\ To get more precise search results, you can combine any number of search terms or even use logical (boolean) operators. \\ \\ {{ :help:istc:search_4.png?642x61 | ISTC search box}} \\ While your search terms could be upper or lower case (or any combination thereof), the logical operators must always be written in capitals. Truncation and wildcards can be used within and at the end of a search term: an asterisk (*****) replaces an arbitrary number of characters, a question mark (**?**) replaces exactly one character. If you want to search for two or more words that appear next to each other in a specific order (phrase search), enclose your search term in quotation marks (**"**). \\ \\ {{ :help:istc:search_5.png?642x61 |ISTC search box}} \\ The search engine also supports [[https://en.wikipedia.org/wiki/Regular_expression|regular expressions]] as search terms. The syntax of regular expressions might be a bit complex and difficult to learn, but once mastered, it enables you to formulate rather elaborate queries. \\ \\ {{ :help:istc:search_7.png?642x61 |ISTC search box}} \\ You may also search for words that are similar to your search term by adding a tilde (**~**). The similarity measure ([[https://en.wikipedia.org/wiki/Damerau%E2%80%93Levenshtein_distance|Damerau-Levenshtein distance]]) defaults to 2. You may specify a similarity measure by adding it after the tilde (e.g. ''ethica~1''). \\ \\ {{ :help:istc:search_6.png?642x61 |ISTC search box}} \\ In order to find records where your search term appears only in a certain field, add the field's name to the search term followed by a colon. Please note that there must be no blank before or after the colon. If your search term consists of multiple parts, enclose them by parentheses, e.g. ''title:(ethica nicomachum)'' or ''title:(ethica OR poetica)''. When searching for phrases, use quotation marks: ''title:"ethica ad nicomachum"''. In the ISTC the following fields are available for searching: ^ author: | The author of publication (Marc field 100) | ^ date: | The year of publication (Marc field 008)((You can search for date ranges ''date:[1480 TO 1490]]'' or for books that have been printed before ''date:<1480'' or after ''date:>1480'' a certain year)) | ^ format: | The bibliographic format (Marc field 300) | ^ id: | The ISTC id (Marc field 001) | ^ heading: | The uniform heading used when the publication has no author (Marc field 130) | ^ language: | The language of the publication (Marc field 008). This is a 3 letter code from the [[https://www.loc.gov/marc/languages/|Marc Code List for Languages]] | ^ location: | Name of the holding institution and country where the holding institution is located (2-letter code) | ^ location_count: | Number of institutions that hold a copy of the described edition.((e.g. search for ''location_count:1'' to find unique copies, or ''location_count:>1'' of non-unique copies )) | ^ place: | Place of printing/publication as given in the imprint statement (Marc field 260) as well as the modern name form and common variants. \\ To search for editions printed in a certain country, use the two letter iso code (e.g. ''place:nl'' for all editions printed in the Netherlands)\\ \\ Some frequently used codes are:\\ BE Belgium\\ DE Germany\\ FR France\\ IT Italy\\ GB United Kingdom\\ NL The Netherlands\\ US United States | ^ printer: | Printer/publisher as given in the imprint statement (Marc field 260) | ^ reference: | Bibliographic reference (Marc field 510) | ^ shelfmark: | British Library shelfmark | ^ title: | Title of the publication (Marc field 245) | \\ \\ When searching for countries (e.g. with ''place:'' for country of publication), the ISO 3166-1 codes must be used: |BE|Belgium| |DE|Germany| |FR|France| |IT|Italy| |GB|United Kingdom| |NL|The Netherlands| |US|United States| \\ [[https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes|a full list of ISO 3166-1 codes can be found here]] \\ \\ For more elaborate search options see also the full documentation of the [[https://lucene.apache.org/core/2_9_4/queryparsersyntax.html|Apache Lucene Query Syntax]]. ===== 2. Customize your Results Display ===== \\ {{ :help:istc:search_8.png?742x300 | Custom Search}} \\ The appearance of your search results can be changed by selecting **Customise Results Display** from the **More...** menu. You may select or unselect the [[https://en.wikipedia.org/wiki/Faceted_search|facets]] that are displayed with the result set, change the number of hits that are shown per page or apply a different sorting method. \\ \\ {{ :help:istc:search_9.png?742x140 | Custom Search}} \\ When selecting ''custom'' from the menu **display mode**, you can choose the fields of a record that should be displayed. This allows you also to customize the download of your result set in Excel/CSV. ===== 3. Using Alphabetical Browse Lists ===== \\ {{ :help:istc:search_10.png?742x230 |Browse lists}} \\ \\ Alphabetical browse lists show the content of all the occurrences of typically one field in the database (for example all occurrences of the author field) in an alphabetically sorted list, similar to an index in a printed book. Clicking on one of the entries will perform a search for exactly this content in the given field. To open the browse list at a certain position in the alphabet, just type the beginning of the word and hit **Browse**. To navigate forward and back through the alphabet, use the buttons at the bottom of the browse list. The alphabetical browse lists are case-insensitive, i.e. you can use upper and lower case characters interchangeably. //Please note that the number given in front of an entry indicates the occurrences of a field/term combination, while the number of hits given in the result list is the count of records where this combination occurs. This is almost always the same, but may differ in very few cases.// The following browse lists are available for ISTC: ^Author |The author of a publication| ^Shelfmark (British Library) |Shelfmarks of the copies held by the British Library | ^Publication Year |The publication year in numeric form| ^Format |The bibliographical format (e.g. ** 8° **) | ^Printer/Publisher |Name of the printer or publisher as given in the imprint statement | ^Place of Publication |Place of Publication/Printing as given in the imprint statement. Multiple places generate separate index entries. | ^ISTC No. |The ISTC record id | ^Holdings Institution |Names of Holding Institutions | ^Publication Year |The publication year as it appears in the imprint statement | ^References |Bibliographic reference | ^Title |The title of the publication | ^Country and Holding Institution |Names of Holding Institutions sorted by country name| ===== 4. Bookmarks and Search History ===== \\ During your current session, the system keeps a log of your last 20 searches. You can access it from the menu **History**. \\ \\ {{ :help:istc:search_11.png?742x300 | Bookmark records}} \\ You can add records to your personal bookmarks by clicking the bookmark icon on the top right of a record display (both in the result set and in a record's full display). To view your bookmarks, click **Bookmarks** in the main menu. ===== 5. Downloading Records ===== You can download the records of your result set by selecting **Download** from the **More...** menu. The default set size for downloads is 100 and the download starts with the first record that is displayed on your screen. (I.e. if your result set consists of several pages and you have already navigated to the second page, the download will start with the first record on the second page.) If your set is larger than 100 records, you can download it in several chunks. Set the "items per page" value to 100 (**More.../Custom Search**) to make navigation through the set easier. The following formats are available: * **YAML (plain text)**: Records as they are stored in the database in [[https://en.wikipedia.org/wiki/YAML|YAML-Format]]. * **Excel (csv)**: To download the data as a [[https://en.wikipedia.org/wiki/Comma-separated_values|CSV-File]], you need to select the fields that should be exported first (see above //2. Customize your Result Display//), otherwise you'll only get a list with record IDs. Please note, that a semicolon is used as a delimiter. * **Excel (for editing)**: All fields of a record as stored in the database in the following format: ''record id ; full field name ; value''. Each field is exported to a separate row, the data delimiter is a semicolon. Within the field name, the hierarchical field groups are separated by a dot, while the array index of repeated fields or field groups is added after a colon. * **Marc21 (text)**: A Marc21 representation of the record as plain text. * **Marc21 (ISO)**: A Marc21 representation of the record in ISO 2709 format. \\ //see here for [[:help:istc:editing:main|editing the ISTC]] //