Context Search 作者： Olivier de Broqueville, Carl Scheller

Firefox add-on to search selected text in a web page using your favorite search engines.


What data do we collect?
This extension doesn't collect any personal data whatsoever. It merely forwards the domain names of your favourite search engines to APIs hosted on Heroku for the sole purpose of retrieving and displaying favicons for your search engines.


How does it work?

1. Select some text on a webpage
2. Right click the selection (or Alt-click to launch the grid of favicons)
3. A context menu appears, displaying a list of search engines chosen in the extension's preferences
4. Click on the search engine with which you’d like to search for the selected text

The search results will appear as defined in the extension's preferences page.

The extension includes an EXIF viewer. To view the EXIF tags associated with an image, right-click on the image and select: "View EXIF tags..". If present, the EXIF tags will appear in the sidebar along with a colour histogram. Another extension, Context Search Lite, has been released with the same functionality as Context Search but without the Exif Viewer,

Managing search engines
To manage your favorite search engines, you can go to the preferences page of Context Search. You can reach this page by opening the extensions page (Add-on Manager) where all your add-ons are listed and then clicking on the "Preferences" button.

1. The checkbox at the start of a line determines whether the search engine should appear in the context menu.
2. The next item on the line contains the name of the search engine and is followed by a keyword.
3. This keyword is used in the url address bar (or omnibox) after the word “cs “ and before the search terms (e.g. to search for linux using the search engine Wikipedia, you would type: ‘cs w linux’, where w is the keyword assigned to Wikipedia).
4. The second checkbox specifies whether you’d like to use the search engine in a “multi-search”. A “multi-search” is a search performed using multiple search engines and can be selected in the context menu.
5. The checkbox is followed by the search query string. This is the generic url you would use to perform a search. Search query strings may contain the parameters %s or {searchTerms} where you'd like your search terms to appear, i.e. the selected text.
6. Click on and drag the move icon to the left of the trash icon to move each search engine up or down in the list.
7. Click on the trash icon to remove a search engine from the list.

You can also import a JSON file containing your own list of search engines. It is strongly recommended to export your customised list of search engines as a backup in case anything goes wrong.

How to perform a search in the omnibox
In the omnibox (or url address bar), type 'cs ' (without the quotes, and where cs stands for Context Search) followed by the keyword you have chosen for your seaarch engine in the extension's preferences, e.g. 'w ' (again without quotes) for Wikipedia, followed by your search term(s).

Here is an example: cs w atom

The above will search for the word 'atom' in Wikipedia.

Please report issues, bugs and features requests at GitHub: https://github.com/odebroqueville/contextSearch/issues

Special thanks to the following contributors for the translations

• Geoffrey De Belie for the Dutch translation
• Krzysztof Galazka for the Polish translation
• Sergio Tombesi for the Italian and Spanish translations
• Fushan Wen for the Chinese translation

Code made by others used in this extension

• exif.js v2.3.0 originally by Jacob Seidelin and modified by Bart van der Wal which can be found on Github: https://github.com/exif-js/exif-js/blob/v2.3.0/exif.js
• 2 libraries from RGraph v5.20 by Richard Heyes: Rgraph.svg.common.core.js which may be found here: https://www.rgraph.net/libraries/src/RGraph.svg.common.core.js and RGraph.svg.line.js which may be found here: https://www.rgraph.net/libraries/src/RGraph.svg.line.js
• SortableJS v1.10.1 minified with many contributors, which can be found on GitHub here: https://github.com/SortableJS/Sortable/blob/1.10.1/Sortable.min.js and the source code here: https://github.com/SortableJS/Sortable/releases

Donations are welcome
If you like the extension, a small donation would be greatly appreciated as a contribution to the cost of hosting the APIs on Heroku used to retrieve the search engines favicons. Thank you.