Limnoria/plugins/DDG/README.rst

73 lines
2.0 KiB
ReStructuredText
Raw Normal View History

.. _plugin-DDG:
Documentation for the DDG plugin for Supybot
============================================
Purpose
-------
Searches for results on DuckDuckGo's web search.
Usage
-----
Searches for results on DuckDuckGo.
Example::
2021-07-04 01:42:13 +02:00
<+jlu5> %ddg search eiffel tower
<@Atlas> The Eiffel Tower is an iron lattice tower located on the Champ de Mars in Paris. It was named after the engineer Gustave Eiffel, whose company designed and built the tower. - <https://en.wikipedia.org/wiki/Eiffel_Tower>
.. _commands-DDG:
Commands
--------
2021-04-17 20:09:33 +02:00
.. _command-ddg-search:
search <text>
Searches for <text> on DuckDuckGo's web search.
2021-04-17 20:09:33 +02:00
.. _conf-DDG:
Configuration
-------------
2021-04-17 20:09:33 +02:00
.. _conf-supybot.plugins.DDG.maxResults:
2021-04-22 00:29:15 +02:00
supybot.plugins.DDG.maxResults
This config variable defaults to "4", is network-specific, and is channel-specific.
Determines the maximum number of results the bot will respond with.
2021-04-17 20:09:33 +02:00
.. _conf-supybot.plugins.DDG.public:
2021-04-22 00:29:15 +02:00
supybot.plugins.DDG.public
This config variable defaults to "True", is not network-specific, and is not channel-specific.
Determines whether this plugin is publicly visible.
2021-04-17 20:09:33 +02:00
.. _conf-supybot.plugins.DDG.region:
2021-04-22 00:29:15 +02:00
supybot.plugins.DDG.region
This config variable defaults to "", is network-specific, and is channel-specific.
Set the DDG search region to return results for the language/country of your choice. E.g. 'us-en' for United States. https://duckduckgo.com/params
2021-04-17 20:09:33 +02:00
.. _conf-supybot.plugins.DDG.searchFilter:
2021-04-22 00:29:15 +02:00
supybot.plugins.DDG.searchFilter
This config variable defaults to "moderate", is network-specific, and is channel-specific.
Determines what level of search filtering to use by default. 'active' - most filtering, 'moderate' - default filtering, 'off' - no filtering Valid strings: active, moderate, and off.
2021-04-17 20:09:33 +02:00
.. _conf-supybot.plugins.DDG.showSnippet:
2021-04-22 00:29:15 +02:00
supybot.plugins.DDG.showSnippet
This config variable defaults to "True", is network-specific, and is channel-specific.
Determines whether the bot will show a snippet of each resulting link. If False, it will show the title of the link instead.