Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more detailed description on zbMATH #342

Closed
wants to merge 5 commits into from

Conversation

ibe-314
Copy link
Contributor

@ibe-314 ibe-314 commented Jan 5, 2021

I added a more detailed description of the zbMATH Search. Furthermore, I added information for the id based search via zbMATH JabRef/jabref#7298.

ibe-314 and others added 3 commits December 10, 2020 14:48
* **ab**: search for term in reviews or abstracts
* **rv**: reviewer

#### Examples
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These examples are directly taken from the help page of zbmath.org. I believe we are not allowed to do so (because of copyright). Please, provide new examples or link to the zbmath help page.

Copy link
Contributor Author

@ibe-314 ibe-314 Jan 5, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I deleted the examples that where taken from the zbmath help page and added some new ones.

@ibe-314
Copy link
Contributor Author

ibe-314 commented Jan 6, 2021

Hi, the new complex search in JabRef 5.2 does not support the zbmath fields. Thus the structured query I described in this PR does not work anymore with JabRef 5.2 (but they work with 5.1), see JabRef/jabref#7298. I will change my PR accordingly. Is there a description of the new JabRef query syntax? Then I could test which zbmath fields still work.

@ibe-314 ibe-314 closed this Jan 6, 2021
@koppor
Copy link
Member

koppor commented Jan 6, 2021

@DominikVoigt Could you provide a quick pointer to @ibe-314? I did not found a PR on the complex search here... Maybe, we need to add some supported terms?

@koppor
Copy link
Member

koppor commented Jan 6, 2021

@ibe-314 You can leave your PR open. I just flag it as "draft" meaning "work in progress". This allows it to be easy discoverable.

@koppor koppor reopened this Jan 6, 2021
@koppor koppor marked this pull request as draft January 6, 2021 20:31
@koppor koppor changed the title Patch 1 Add more detailed description on zbMATH Jan 6, 2021
@koppor
Copy link
Member

koppor commented Jan 7, 2021

@ibe-314 Thank you for the pull request. @DominikVoigt and I prioritist our work and work on a refined implementation of our queries. We will support zbMath from the beginning. We will update the documentation accordingly. Thereby, we will use your pull request as basis. Nothing left todo on your side.

@koppor
Copy link
Member

koppor commented Feb 8, 2021

I merged the text into the PR #348. I adapted the text to our new general search syntax.

#### 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 |

#### 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. The **and-operator &** is default and can be omitted.
* [`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`.

@koppor koppor closed this Feb 8, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants