diff --git a/collect/add-entry-using-an-id.md b/collect/add-entry-using-an-id.md index 80336ae42..e2232d971 100644 --- a/collect/add-entry-using-an-id.md +++ b/collect/add-entry-using-an-id.md @@ -100,3 +100,9 @@ To return a reference, the publication needs to have a DOI. ID search is carried out using the \(Request for Comments number\) \(RFC\) of the IETF database. +### zbMATH Open + +[zbMATH Open](https://zbmath.org/) is an abstracting and reviewing service in pure and applied mathematics. Its database contains about 4 million bibliographic entries with reviews or abstracts currently drawn from about 3,000 journals and book series, and 180,000 books. The coverage starts in the 18th century and is complete from 1868 to the present by the integration of the "Jahrbuch über die Fortschritte der Mathematik" database \([about](https://zbmath.org/about/)\). + +ID search is carried out using the Zbl number. + diff --git a/collect/import-using-online-bibliographic-database.md b/collect/import-using-online-bibliographic-database.md index 6fcc1ee73..32b126707 100644 --- a/collect/import-using-online-bibliographic-database.md +++ b/collect/import-using-online-bibliographic-database.md @@ -4,8 +4,10 @@ description: Using online databases to search for references # Searching externally using Online Services +To fetch entries from an online database, choose **View → Web search**, and the search interface will appear in the side pane. Select the database you want to search \(e.g. arXiv\) in the dropdown menu. Enter the words of your query, and press Enter or the **Search** button. The results are displayed in the [import inspection dialog](../import/importinspectiondialog.md). JabRef is not intended to be a tool for mass download of citations. The purpose of the Web search is to easily gather a few entries directly from within JabRef. If you use the search functionality to extensively you might get blocked \(for some time\). To fetch entries from an online database, choose **View → Web search**, and the search interface will appear in the side pane. Select the database you want to search \(e.g. arXiv\) in the dropdown menu. Note that it might be necessary to scroll downwards to find certain fetchers. An example for this is provided in the image below. Then enter the words of your query, and press Enter, or the **Search** button. The results are displayed in the [import inspection dialog](import/importinspectiondialog.md). +Some of the databases support advanced search queries. These are described on the detail page of the database. ![](../.gitbook/assets/select-fetcher-in-menu.png) Some databases support advanced search queries. These are described on the detail page of the database. @@ -20,27 +22,66 @@ However, it is still possible to import hundreds or even thousands of entries fr If you need to use an HTTP proxy server, you can configure JabRef to use a proxy using the "Network" preferences \(**Options → Preferences → Network**\). +## Search Syntax + +JabRef searches the databases by using the specified keywords. +One can use quotes (`"`) to keep words togehter: An example is `"process mining"`. +It is also possible to restrict the search to dedicated fields: + +Thereby, JabRef supports following fields: + +| field | meaning | +| -- | -- | +| `author` | The author of the work | +| `title` | The title of the work | +| `journal` | The title of the journal of the work | +| `year` | The year in which the work was published | +| `year-range` | The year range (e.g., `1999-2001`) the work was published | +| `doi` | The document object identifier of the work | + +One can usually combine different searches using the Boolean operators `AND` and `OR`. +Thereby, the default operator is `OR`. + +Examples: + +* `author:smith and author:jones`: search for references with authors "smith" and "jones" +* `author:smith or author:jones`: search for references with either author "smith" or author "jones" +* `author:smith and not title:processor`: search for author "smith" and omit references with "processor" in the title + +Technial note: The search syntax is adapted from [Apache Lucene](https://lucene.apache.org/core/2_9_4/queryparsersyntax.html). +JabRef takes the Lucene syntax and transforms it to the syntax required by the supported databases. + ## Supported databases +### ACM Portal + +Currently disabled, because ACM changed their API. See for details. + +The [ACM Portal](https://dl.acm.org) includes two databases \([Wikipedia](https://en.wikipedia.org/wiki/Association_for_Computing_Machinery#Portal_and_Digital_Library)\): + +* the **ACM Digital Library** is a text collection of every article published by the [Association for Computing Machinery](https://www.acm.org), including over 60 years of archives from articles, magazines and conference proceedings. +* the **Guide to Computing Literature** that is a bibliographic collection from major publishers in computing with over one million entries. + ### arXiv [ArXiv](https://arxiv.org/) is a repository of scientific preprints in the fields of mathematics, physics, astronomy, computer science, quantitative biology, statistics, and quantitative finance \([Wikipedia](https://en.wikipedia.org/wiki/ArXiv)\). ### CiteSeerX -[CiteSeerX](http://csxstatic.ist.psu.edu/home) is a public search engine for scientific and academic papers primarily with a focus on computer and information science. However, CiteSeerX has been expanding into other scholarly domains such as economics, physics, and others \([Wikipedia](https://en.wikipedia.org/wiki/CiteSeer)\). +[CiteSeerX](http://csxstatic.ist.psu.edu/home) is a public search engine for scientific and academic papers primarily with a focus on computer and information science. However, CiteSeerX has been expanding into other scholarly domains such as economics, physics and others \([Wikipedia](https://en.wikipedia.org/wiki/CiteSeer)\). -### Collection of Computer Science Bibliographies +### Collection of Computer Science Bibliographies (CCSB) -The [Collection of Computer Science Bibliographies](https://liinwww.ira.uka.de/bibliography/) is a public search engine for bibliographies of scientific literature in computer science. +The [Collection of Computer Science Bibliographies](https://liinwww.ira.uka.de/bibliography/) is a public search +engine for bibliographies of scientific literature in computer science. -> You may use Lucene syntax, available fields are: ti \(title\), au \(author\), yr \(publications year\). In short: the default operator is 'OR', use '+' and '–' operators to specify \('+'\) required and \('–'\) forbidden words. Wildcards: '?' – single letter, and '\*' – part of the word \(at the end of a word\), '~' – specified at the end of a word makes approximate match \(allows typos, but takes many seconds to process\) +### Crossref / Unpaywalll -### Crossref +[Unpaywall](https://unpaywall.org) is an open database with over 20 million free scholarly articles harvested from over 50,000 journals and open-access repositories around the globe. Sources for these articles include repositories run by renowned universities, governments, and scholarly societies. Unpaywall is integrated into thousands of existing search engines, library platforms, and information products, making articles easy to find, track, and use for your scholarly communication needs. -{% hint style="info" %} -To be detailed. -{% endhint %} +The Unpaywall database has a very simple structure: it has one record for each article with a Crossref DOI. It harvests from many sources to find Open Access content, and then matches this content to these DOIs using content fingerprints. So for any given DOI, we know about any OA versions that exist anywhere. + +To fetch entries from Unpaywall indirectly through Crossref, choose **Search → Web search**, and the search interface will appear in the side pane. Select **Crossref** in the dropdown menu. To start a search, enter the words of your query, and press Enter or the **Fetch** button. ### DBLP @@ -48,95 +89,104 @@ To be detailed. ### DOAJ -[DOAJ \(Directory of Open Access Journals\)](http://doaj.org/) is a database covering more than 10000 open access journals covering all areas of science, technology, medicine, social science, and humanities \([Wikipedia](https://en.wikipedia.org/wiki/Directory_of_Open_Access_Journals)\). +[DOAJ \(Directory of Open Access Journals\)](http://doaj.org/) is a database covering more than 10000 open access journals covering all areas of science, technology, medicine, social science and humanities \([Wikipedia](https://en.wikipedia.org/wiki/Directory_of_Open_Access_Journals)\). -It is possible to limit the search by adding a field name to the search, as **field:text**. The supported fields are: +It is possible to limit the search by adding a field name to the search, as **field:text**. The supported fields area: -* title: The title of the article -* doi: The DOI of the article -* issn: The ISSN of the journal -* publisher: The publisher of the journal -* abstract: The abstract of the article +| key | description | +| -- | -- | +| `title` | The title of the article | +| `doi` | The DOI of the article | +| `issn` | The ISSN of the journal | +| `publisher` | The publisher of the journal | +| `abstract` | The abstract of the article | -### GVK +### Google Scholar -[GVK](https://gso.gbv.de), the GBV Union Catalogue, is a multimaterial bibliographic database of seven German federal states. It covers 41.5 million records of books, conference proceedings, periodicals, dissertations, microfilms, and electronic resources. +(Currently not working, because Google changed their API) -#### Advanced search +[Google Scholar](https://scholar.google.com/) is a freely accessible database that indexes the full text or metadata of scholarly literature across an array of publishing formats and disciplines. Google Scholar index includes most peer-reviewed online academic journals and books, conference papers, theses and dissertations, preprints, abstracts, technical reports, and other scholarly literature, including court opinions and patents \([Wikipedia](https://en.wikipedia.org/wiki/Google_Scholar)\). -You can simply enter words/names/years you want to search for, or you can specify search keys. Supported keys are: +#### Traffic limitations -* all - all words. Not specifying a search key results in an "all" search -* tit - title words -* per - authors, editors, etc. -* thm - topics -* slw - keywords -* txt - tables of content -* num - numbers, e.g. ISBN -* kon - names of conferences -* ppn - Pica Production Numbers of the GVK -* bkl - Basisklassifikation-numbers -* erj - year of publication +Google scholar can block "automated" crawls which generate too much traffic in a short time. To unblock your IP, doing a Google scholar search in your browser might help. You will be asked to show that you are not a robot \(a CAPTCHA challenge\). If no CAPTCHA appears, or JabRef is still blocked after performing a search in the browser, you can also change your IP address manually or wait for some hours to get unblocked again. -#### Notes +Thus, the Google Scholar fetcher is not the best way to obtain lots of entries at the same time. The [JabRef browser extension](../jabref-browser-extension.md) might be an alternative to download the bibliographic data directly from the browser. -* queries can be combined with "and". The use of "and" is optional, though. -* in many cases, you can use the truncation sign "?" -* spaces in person names are not supported yet. Please use the truncation sign ? after the first name for several given names. E.g. "per Maas,jan?" +### GVK -#### Sample queries +[GVK](https://gso.gbv.de), the GBV Union Catalogue, is a multimaterial bibliographic database of seven German federal states. It covers 41.5 million records of books, conference proceedings, periodicals, dissertations, microfilms and electronic resources. -* "marx kapital" -* "per grodke and tit db2" -* "per Maas,jan?" +#### Advanced search -### Google Scholar +You can simply enter words / names / years you want to search for, or you can specify search fields. -[Google Scholar](https://scholar.google.com/) is a freely accessible database that indexes the full text or metadata of scholarly literature across an array of publishing formats and disciplines. Google Scholar index includes most peer-reviewed online academic journals and books, conference papers, theses and dissertations, preprints, abstracts, technical reports, and other scholarly literature, including court opinions and patents \([Wikipedia](https://en.wikipedia.org/wiki/Google_Scholar)\). +Supported fields are: -#### Traffic limitations +| field | description | +| -- | -- | +| `all` | all words. Not specifYing a search key results in an "all" search | +| `title` | title words (converted to GVK's `tit` field) | +| `author` | Searches author, editors, etc. (converted to GVK's `per` field) | +| `journal` | The journal (converted to GVK's `zti` field) | +| `year` | The year of publication (converted to GVK's `erj` field) | +| `thm` | topics | +| `slw` | key words | +| `txt` | tables of content | +| `num` | numbers, e.g. ISBN | +| `kon` | names of conferences | +| `ppn` | Pica Production Numbers of the GVK | +| `bkl` | Basisklassifikation-numbers | -Google Scholar can block "automated" crawls that generate too much traffic in a short time. To unblock your IP, doing a Google scholar search in your browser might help. You will be asked to show that you are not a robot \(a CAPTCHA challenge\). If no CAPTCHA appears, or JabRef is still blocked after performing a search in the browser, you can also change your IP address manually or wait for some hours to get unblocked again. +Year ranges are not supported. In case a year range is provided, it is ignored. +Otherwise, GVK returns no results. -Thus, the Google Scholar fetcher is not the best way to obtain lots of entries at the same time. The [JabRef browser extension](jabref-browser-extension.md) might be an alternative to download the bibliographic data directly from the browser. +#### Notes -### IEEEXplore +* queries can be combined with `and`. The use of `and` is optional, though. +* in many cases you can use the truncation sign `?` +* spaces in person names are not supported yet. Please use the truncation sign `?` after the first name for several given names. E.g. `per Maas,jan?` -[IEEEXplore](https://ieeexplore.ieee.org/) is a scholarly research database that indexes, abstracts, and provides full-text for articles and papers on computer science, electrical engineering and electronics. IEEEXplore comprises over 180 journals, over 1,400 conference proceedings, more than 3,800 technical standards, over 1,800 eBooks and over 400 educational courses \([Wikipedia](https://en.wikipedia.org/wiki/IEEE_Xplore)\) +#### Sample queries + +* `marx kapital` +* `author:grodke and title:db2` +* `author:"Maas,jan?"` -Details on the supported fields is available at [https://developer.ieee.org/docs/read/Metadata\_API\_details](https://developer.ieee.org/docs/read/Metadata_API_details). JabRef passes the constructed query as `querytext`. For instance, `thesaurus_terms` can be used to search for IEEE-specific keywords on publications. +### IEEEXplore + +[IEEEXplore](http://ieeexplore.ieee.org/Xplore/home.jsp) is a scholarly research database that indexes, abstracts, and provides full-text for articles and papers on computer science, electrical engineering and electronics. IEEEXplore comprises over 180 journals, over 1,400 conference proceedings, more than 3,800 technical standards, over 1,800 eBooks and over 400 educational courses \([Wikipedia](https://en.wikipedia.org/wiki/IEEE_Xplore)\) ### INSPIRE -[INSPIRE-HEP](https://inspirehep.net/?ln=en) is an open-access digital library for the field of high energy physics \([Wikipedia](https://en.wikipedia.org/wiki/INSPIRE-HEP)\). +[INSPIRE-HEP](https://inspirehep.net/?ln=en) is an open access digital library for the field of high energy physics \([Wikipedia](https://en.wikipedia.org/wiki/INSPIRE-HEP)\). #### Query syntax -The INSPIRE-HEP search function merely passes your search queries onto the INSPIRE-HEP web search, so you should build your queries in the same way, except omitting the _find_ or _fin_ command. This help page will only give a brief introduction to the search queries. More extensive help on searching INSPIRE-HEP can be found on the page [http://inspirehep.net/info/hep/search-tips](http://inspirehep.net/info/hep/search-tips) . - -Your query can be composed of several parts, combined using `and` and `or` as logical operators. Each part is composed of a letter or word indicating the type of field to search, followed by a space and the text to search for. +The INSPIRE-HEP search function merely passes your search queries onto the INSPIRE-HEP web search, so you should build your queries in the same way. +INSPIRE supports the fielded search too. +See for advanced help. The following list shows some of the field indicators that can be used: -* _a_ or _author_: search author names -* _t_ or _title_: search in title -* _j_: journal. Here either the common abbreviation or the 5 letter CODEN abbreviation for a journal can be used. Volume and page can also be included, separated by commas. For instance, _j Phys. Rev.,D54,1_ looks in the journal Phys. Rev., volume D54, page 1. -* _k_: search in keywords - -#### Example queries - -* _a smith and a jones_: search for references with authors "smith" and "jones" -* _a smith or a jones_: search for references with either author "smith" or author "jones" -* _a smith and not t processor_: search for author "smith" and omit references with "processor" in the title +| field | description | +| -- | -- | +| `author` | search author names | +| `title` | search in title | +| `journal` | Here either the common abbreviation or the 5 letter CODEN abbreviation for a journal can be used. Volume and page can also be included, separated by commas. For instance, _j Phys. Rev.,D54,1_ looks in the journal Phys. Rev., volume D54, page 1. | +| `collection` | The collecion | +| `fulltext` | Search in the fulltext | +| `k` | search in keywords | ### Jstor [Jstor](https://jstor.org) is an online database with access to more than 12 million journal articles, books, and sources in 75 disciplines. [About](https://about.jstor.org/) -It is possible to limit the search by adding a field name to the search, such as `field:"text"`. The supported fields are: +It is possible to limit the search by adding a field name to the search, such as `field:"text"`. -* `ti`: The title of the article -* `au`: an author of the article +* `title`: The title of the article +* `author`: an author of the article +* `journal`: journal title (sent as `pt` to Jstor) * `pt`: publication title ### MathSciNet @@ -147,6 +197,9 @@ It is possible to limit the search by adding a field name to the search, such as [MEDLINE](https://www.nlm.nih.gov/bsd/pmresources.html) is a bibliographic database of life sciences and biomedical information. It includes bibliographic information for articles from academic journals covering medicine, nursing, pharmacy, dentistry, veterinary medicine, and health care. MEDLINE also covers much of the literature in biology and biochemistry, as well as fields such as molecular evolution \([Wikipedia](https://en.wikipedia.org/wiki/MEDLINE)\). +The Medline syntax is completely different form the Lucene syntax. +One cannot use fielded search there. + There are two ways of specifying which entries to download: 1. Enter one or more MEDLINE IDs \(separated by comma/semicolon\) in the text field. @@ -175,7 +228,48 @@ To be detailed. [Springer](https://www.springer.com/) \(aka Springer Science+Business Media\) is a global publishing company that publishes books, e-books, and peer-reviewed journals in science, technical and medical publishing. Springer also hosts a number of scientific databases, including SpringerLink, Springer Protocols, and SpringerImages \([Wikipedia](https://en.wikipedia.org/wiki/Springer_Science%2BBusiness_Media)\). -### zbMATH +### zbMATH Open + +[zbMATH Open](https://zbmath.org/) is an abstracting and reviewing service in pure and applied mathematics. Its database contains about 4 million bibliographic entries with reviews or abstracts currently drawn from about 3,000 journals and book series, and 180,000 books. The coverage starts in the 18th century and is complete from 1868 to the present by the integration of the "Jahrbuch über die Fortschritte der Mathematik" database \([about](https://zbmath.org/about/)\). + +#### Structured Search + +You cannot use the same query syntax as in the one-line search at zbmath.org; +you have to stick with the Apache Lucence syntax. + This means that your query can be composed of several terms, combined by the logical operators ` AND ` and ` OR `. + Queries are case-insensitive. Further operators that can be used are ` NOT` for logical negation, + `*` for a right wildcard, `" "` for exact phrase matches, and parentheses `( )` to group terms. + Optionally, it is possible to add a field name in the form field:text to limit the search results. The supported fields are: + +| field | description | +| -- | -- | +| `author` | Author, editor - sent in the `au` field | +| `title` | Author, editor - sent in the `ti` field | +| `journal` | Journal - sent in the `so` field | +| `year` | Year - sent in the `py` field | +| `yearrange` | Year range - sent in the `py` field | +| `cc` | MSC code | +| `dt` | document type (possible values are `j` for journal articles, `b` for books, `a` for book articles) | +| `an` | the zbl id of the document | +| `ai` | internal author identifier | +| `la` | language either as a string or as [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) language code | +| `ab` | search for term in reviews or abstracts | +| `rv` | reviewer | +| `sw` | software | +| `en` | external identifier | +| `br` | biographical reference | -[zbMATH](https://www.zbmath.org/) is a reviewing service providing reviews and abstracts for articles in pure and applied mathematics \([Wikipedia](https://en.wikipedia.org/wiki/Zentralblatt_MATH)\). +#### Examples +* [`algebra*](https://zbmath.org/?q=algebra*): Searches for publications containing a term starting with algebra (e.g. algebra, algebras, algebraic, etc.) in any field. +* [`title:"Graph Theory"`](https://zbmath.org/?q=ti%3A+%E2%80%9CGraph+Theory%E2%80%9D): Searches for publications with the exact phrase *Graph Theory* in their `title` field. +* [`an:0492.90056`](https://zbmath.org/?q=an%3A0492.90056): Searches for the document with zbl number *0492.90056*. +* [`author:Berge and title:"Graph Theory"`](https://zbmath.org/?q=au%3A+Berge+%26+ti%3A+%E2%80%9CGraph+Theory%E2%80%9D): Searches for entries written by *Berge* with `Graph Theory` in their **title** field. +* [`dt:b author:Berge`](https://zbmath.org/?q=dt%3A+b+au%3A+Berge): Searches for all books written by Berge. +* [`title:"Graph Theory" yearrange:2010-2020`](https://zbmath.org/?q=ti%3A+%E2%80%9CGraph+Theory%E2%80%9D+py%3A+2010-2020): Searches for documents containing the exact phrase `Graph Theory` in their **title** that are published between *2010* and *2020*. +* [`so:Combinatorica`](https://zbmath.org/?q=so%3A+Combinatorica): Searches for documents published in the journal `Combinatorica`. +* [`cc:"(05C|90C)"`](https://zbmath.org/?q=cc%3A+%2805C%7C90C%29): Searches for documents with **MSC code** in `05C` or `90C`. +* [`la:"es | pt"`](https://zbmath.org/?q=la%3A+es+%7C+pt): Searches for documents written in Spanish or Portuguese. +* [`sw:python`](https://zbmath.org/?q=sw%3Apython): Searches for publications using the **software** `python`. +* [`en:arXiv`](https://zbmath.org/?q=en%3AarXiv): Searches for entries with a link to an `arXiv` preprint. +* [`br:"Claude Berge"`](https://zbmath.org/?q=br%3AClaude+Berge): Searches for publications with biographical information on `Claude Berge`.