Search with Xapian Guide - Revision history

Th.lauke@arcor.de: formatting improved

2019-10-16T14:38:34Z

formatting improved

Kgoetz: adding categories

2018-09-12T01:27:33Z

adding categories

← Older revision		Revision as of 01:27, 12 September 2018
Line 1:		Line 1:
			[[Category: Howto]]
			[[Category: Work in Progress]]

	If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can take advantage of some useful features to make more effective queries. You should be able to tell whether you have Xapian search enabled by checking whether you have the option ''by relevance match'' in the list of ordering options. This in itself can be useful, as it will rank results where the words you are searching for occur more frequently, which can be useful if the words are likely to match against a lot of items.		If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can take advantage of some useful features to make more effective queries. You should be able to tell whether you have Xapian search enabled by checking whether you have the option ''by relevance match'' in the list of ordering options. This in itself can be useful, as it will rank results where the words you are searching for occur more frequently, which can be useful if the words are likely to match against a lot of items.

Drn@ecs.soton.ac.uk at 16:36, 25 July 2017

2017-07-25T16:36:23Z

← Older revision		Revision as of 16:36, 25 July 2017
Line 18:		Line 18:
	science NEAR/15 mathematics		science NEAR/15 mathematics

	== More complex queries ===		== More complex queries ==
	You can combine the above three features in various ways:		You can combine the above three features in various ways:
	"supply change management" NEAR business		"supply change management" NEAR business

Drn@ecs.soton.ac.uk at 16:36, 25 July 2017

2017-07-25T16:36:04Z

← Older revision		Revision as of 16:36, 25 July 2017
Line 1:		Line 1:
	If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can ~~make use~~ of ~~the Xapian search syntax~~ to make more ~~complex~~ queries~~, which needing to use advanced search~~. ~~This may~~ be ~~useful if~~ you have ~~another website~~ you ~~wish to search your EPrints repository with a specific filter on~~ the ~~results returned (e.g. only results for a particular faculty~~ of ~~department)~~. ~~Below is a guide to some of~~ the ~~syntax that~~ can be ~~used with Xapian-based search~~.		If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can take advantage of some useful features to make more effective queries. You should be able to tell whether you have Xapian search enabled by checking whether you have the option ''by relevance match'' in the list of ordering options. This in itself can be useful, as it will rank results where the words you are searching for occur more frequently, which can be useful if the words are likely to match against a lot of items.

	== Specific Phrases ==		== Specific Phrases ==
	If you want to search for a specific phrase then ensure the whole phrase is within quote marks~~, e.g~~ :		If you want to search for a specific phrase then ensure the whole phrase is within quote marks:
	"supply change management"		"supply change management"

	== Some words but not others ==		== Some words but not others ==
	If you prepend the words you want to find with a '''+''' and the words you do not want to find with a ''''-'''~~. E.g.~~		If you prepend the words you want to find with a '''+''' and the words you do not want to find with a '''-''':
	+science -engineering +mathematics		+science -engineering +mathematics

Line 24:		Line 24:
	+"supply change management" -science		+"supply change management" -science

	Xapian has a much more complex query syntax than this but this is not directly available for the simple search web interface (e.g. http://example.eprints.org/cgi/search/simple). However, it is possible to create a separate search interface (available through a web browser or directly over HTTP without a human-readable web interface) that would allow you do even more specific or complex searches as described at https://xapian.org/docs/queryparser.html.		Xapian has a much more complex query syntax than this but this is not directly available for the simple search web interface (e.g. http://example.eprints.org/cgi/search/simple). However, it would be possible to create a separate search interface (available through a web browser or directly over HTTP without a human-readable web interface) that would allow you do even more specific or complex searches as described at https://xapian.org/docs/queryparser.html.

Drn@ecs.soton.ac.uk: Drn@ecs.soton.ac.uk moved page Xapian Search Syntax to Search with Xapian Guide without leaving a redirect: better title

2017-07-25T16:30:49Z

Drn@ecs.soton.ac.uk moved page Xapian Search Syntax to Search with Xapian Guide without leaving a redirect: better title

← Older revision	Revision as of 16:30, 25 July 2017
(No difference)

Drn@ecs.soton.ac.uk: Added some useful help on using Xapian Search

2017-07-25T16:29:41Z

Added some useful help on using Xapian Search

← Older revision		Revision as of 16:29, 25 July 2017
Line 1:		Line 1:
	If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can make use of the Xapian search syntax to make more complex queries, which needing to use advanced search. This may be useful if you have another website you wish to search your EPrints repository with a specific filter on the results returned (e.g. only results for a particular faculty of department). Below is a guide to some of the syntax that can be used with Xapian-based search.		If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can make use of the Xapian search syntax to make more complex queries, which needing to use advanced search. This may be useful if you have another website you wish to search your EPrints repository with a specific filter on the results returned (e.g. only results for a particular faculty of department). Below is a guide to some of the syntax that can be used with Xapian-based search.

	== Specific ~~fields~~ ==		== Specific Phrases ==
			If you want to search for a specific phrase then ensure the whole phrase is within quote marks, e.g :
			"supply change management"

	==~~= Text only =~~==		== Some words but not others ==
			If you prepend the words you want to find with a '''+''' and the words you do not want to find with a ''''-'''. E.g.
			+science -engineering +mathematics

	~~Search for~~ phrase ~~'''science'''~~ in ~~the field '''title'''~~		== This word near another word ==
	~~title:(~~science)		If you put the phrase NEAR between the two words then it will find matches where the words have 10 or less words in between:
			science NEAR mathematics

	~~Search for~~ the ~~phrase '''smith''' in the field '''creators_name'''~~		If you want to find two words that are near or further apart then you can add /n (where n is a number or words between the two words):
	~~creators_name:(smith)~~		science NEAR/3 mathematics

			science NEAR/15 mathematics

	~~Exact multiple word phrases~~ can ~~also be search for, such at~~ the ~~phrase '''biological science'''~~ in ~~the field '''abstract'''~~		== More complex queries ===
	~~abstract:(biological~~ science)		You can combine the above three features in various ways:
			"supply change management" NEAR business
	~~The field names that can be searched under~~ to ~~match~~ a ~~text phrase are~~ as ~~follows~~:
	* abstract		+"supply change management" -science
	* contributors_name
	* creators_name		Xapian has a much more complex query syntax than this but this is not directly available for the simple search web interface (e.g. http://example.eprints.org/cgi/search/simple). However, it is possible to create a separate search interface (available through a web browser or directly over HTTP without a human-readable web interface) that would allow you do even more specific or complex searches as described at https://xapian.org/docs/queryparser.html.
	* divisions
	* editors_name
	* subjects
	* title
	* type



	~~== AND ==~~

	~~== OR ==~~

	~~== NOT ==~~

	~~== ANDs and ORs ==~~

	~~== More complex queries ==~~

Drn@ecs.soton.ac.uk: Added some content for specific fields text o

2017-07-21T09:18:59Z

Added some content for specific fields text o

← Older revision		Revision as of 09:18, 21 July 2017
Line 1:		Line 1:
	If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can make use of the Xapian search syntax to make more complex queries, which needing to use advanced search. This may be useful if you have another website you wish to search your EPrints repository with a specific filter on the results returned (e.g. only results for a particular faculty of department). Below is a guide to some of the syntax that can be used with Xapian-based search.		If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can make use of the Xapian search syntax to make more complex queries, which needing to use advanced search. This may be useful if you have another website you wish to search your EPrints repository with a specific filter on the results returned (e.g. only results for a particular faculty of department). Below is a guide to some of the syntax that can be used with Xapian-based search.

			== Specific fields ==

			=== Text only ===

			Search for phrase '''science''' in the field '''title'''
			title:(science)

			Search for the phrase '''smith''' in the field '''creators_name'''
			creators_name:(smith)

			Exact multiple word phrases can also be search for, such at the phrase '''biological science''' in the field '''abstract'''
			abstract:(biological science)

			The field names that can be searched under to match a text phrase are as follows:
			* abstract
			* contributors_name
			* creators_name
			* divisions
			* editors_name
			* subjects
			* title
			* type



	== AND ==		== AND ==

Drn@ecs.soton.ac.uk at 09:07, 21 July 2017

2017-07-21T09:07:05Z

← Older revision		Revision as of 09:07, 21 July 2017
Line 7:		Line 7:
	== NOT ==		== NOT ==

	== ANDs and ORs ==d		== ANDs and ORs ==

	== More complex queries ==		== More complex queries ==

Drn@ecs.soton.ac.uk: Added page

2017-07-21T09:06:43Z

Added page

New page

If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can make use of the Xapian search syntax to make more complex queries, which needing to use advanced search. This may be useful if you have another website you wish to search your EPrints repository with a specific filter on the results returned (e.g. only results for a particular faculty of department). Below is a guide to some of the syntax that can be used with Xapian-based search.

== AND ==

== OR ==

== NOT ==

== ANDs and ORs ==d

== More complex queries ==

← Older revision		Revision as of 14:38, 16 October 2019
Line 2:		Line 2:
	[[Category: Work in Progress]]		[[Category: Work in Progress]]

	If your repository has Xapian search enabled for "Simple Search" (e.g. http://example.eprints.org/cgi/search/simple). Then you can take advantage of some useful features to make more effective queries. You should be able to tell whether you have Xapian search enabled by checking whether you have the option ''by relevance match'' in the list of ordering options. This in itself can be useful, as it will rank results where the words you are searching for occur more frequently, which can be useful if the words are likely to match against a lot of items.		If your repository has Xapian search enabled for "Simple Search" (e.g. <nowiki>http://example.eprints.org/cgi/search/simple</nowiki>). Then you can take advantage of some useful features to make more effective queries. You should be able to tell whether you have Xapian search enabled by checking whether you have the option ''by relevance match'' in the list of ordering options. This in itself can be useful, as it will rank results where the words you are searching for occur more frequently, which can be useful if the words are likely to match against a lot of items.

	== Specific Phrases ==		== Specific Phrases ==
Line 9:		Line 9:

	== Some words but not others ==		== Some words but not others ==
	If you prepend the words you want to find with a ~~'''~~+~~'''~~ and the words you do not want to find with a ~~'''~~-~~'''~~:		If you prepend the words you want to find with a <code>+</code> and the words you do not want to find with a <code>-</code>:
	+science -engineering +mathematics		+science -engineering +mathematics

	== This word near another word ==		== This word near another word ==
	If you put the phrase NEAR between the two words then it will find matches where the words have 10 or less words in between:		If you put the phrase <code>NEAR</code> between the two words then it will find matches where the words have 10 or less words in between:
	science NEAR mathematics		science NEAR mathematics

	If you want to find two words that are near or further apart then you can add /n (where n is a number or words between the two words):		If you want to find two words that are near or further apart then you can add <code>/''n''</code> (where ''n'' is a number of words between the two words):
	science NEAR/3 mathematics		science NEAR/3 mathematics

Line 22:		Line 22:

	== More complex queries ==		== More complex queries ==
	You can combine the above three features in various ways:		You can ''combine'' the above three features in various ways:
	"supply change management" NEAR business		"supply change management" NEAR business

	+"supply change management" -science		+"supply change management" -science

	Xapian has a much more complex query syntax than this but this is not directly available for the simple search web interface (e.g. http://example.eprints.org/cgi/search/simple). However, it would be possible to create a separate search interface (available through a web browser or directly over HTTP without a human-readable web interface) that would allow you do even more specific or complex searches as described at https://xapian.org/docs/queryparser.html.		Xapian has a much more complex query syntax than this but this is not directly available for the simple search web interface (e.g. <nowiki>http://example.eprints.org/cgi/search/simple</nowiki>). However, it would be possible to create a separate search interface (available through a web browser or directly over HTTP without a human-readable web interface) that would allow you do even more specific or complex searches as described at https://xapian.org/docs/queryparser.html.