searching.gmi (2655B)
1 {% include 'fragments/header.gmi' %} 2 3 4 {% include 'fragments/documentation-toc.gmi' %} 5 6 7 ## Documentation: Searching 8 9 ### Filters 10 11 To improve the quality of your search results, you can apply filters to constrain your search results in various dimensions. The currently implemented filters are: 12 * content_type 13 * domain 14 * charset 15 * size 16 17 To filter by one of these, simply add it to your query followed by a colon, and the value you wish to filter by. Some examples of doing so follow. 18 19 => /search?content_type%3Aapplication/pdf application/pdf 20 => /search?content_type%3Aaudio audio 21 => /search?content_type%3Aimage/jpeg image/jpeg 22 => /search?content_type%3Ainput input 23 24 => /search?domain%3Ageminiprotocol domain:geminiprotocol 25 => /search?contextual%20domain%3Agus contextual domain:gus 26 27 => /search?computers%20content_type%3Agemini%20AND%20NOT%20charset%3AUS-ASCII computers content_type:gemini AND NOT charset:US-ASCII 28 => /search?NOT%20charset%3Anone NOT charset:none 29 30 Note that size works slightly different than the other filters, as it is numeric. Typically, you will want to limit your search results to those less than, or greater than, a certain size. 31 32 => /search?computer%20AND%20size%3A%3E2000 computer AND size:>2000 33 34 For further inspiration on how to use these filters, you can visit both GUS' list of known hosts, as well as GUS' list of known content_types and charsets on the statistics page. Note that there is some nuance to the charset values, due to the fact that specifying them is optional, and if one does not specify, there is a default of utf-8 - pages that do not specify a charset have an indexed charset value of "none". 35 36 => /known-hosts GUS Known Hosts (with list of domains) 37 => /statistics GUS statistics (with list of content_types) 38 39 ### Verbose Mode 40 41 To allow greater insight into both how pages are ranking against each other, as well as when GUS crawled their content, you can enable verbose mode on any search results page. This will show the numerical score of each search result for the given query, the exact time that page was crawled, as well as its specified charset. 42 43 There is a button at the top of each search results page to toggle verbose mode on or off, but you can also specify verbose mode manually in your URLs by utilizing the below pattern. Simply add a new "v" path component to the URL preceding the "search" path component. Below is an example: 44 45 => gemini://geminispace.info/search?gemini 46 => gemini://geminispace.info/v/search?gemini 47 48 Note that verbose mode is sticky, and will persist between pages of results results, so you will need to manually toggle verbose mode off when you are finished with it.