Limnoria/plugins/Dict/README.rst
Valentin Lorentz cd02444f87 supybot-plugin-doc: Add labels for all command and config variables
So they can be referenced from elsewhere in the doc.
2021-04-06 00:33:07 +02:00

66 lines
2.0 KiB
ReStructuredText

.. _plugin-Dict:
Documentation for the Dict plugin for Supybot
=============================================
Purpose
-------
Commands that use the dictd protocol to define words.
In order to use this plugin you must have the following modules
installed:
* dictclient: http://quux.org:70/devel/dictclient
Usage
-----
This plugin provides a function to look up words from different
dictionaries.
.. _commands-Dict:
Commands
--------
.. _command-Dict-dict:
dict [<dictionary>] <word>
Looks up the definition of <word> on the dictd server specified by the supybot.plugins.Dict.server config variable.
.. _command-Dict-dictionaries:
dictionaries takes no arguments
Returns the dictionaries valid for the dict command.
.. _command-Dict-random:
random takes no arguments
Returns a random valid dictionary.
.. _command-Dict-synonym:
synonym <word> [<word> ...]
Gets a random synonym from the Moby Thesaurus (moby-thesaurus) database. If given many words, gets a random synonym for each of them. Quote phrases to have them treated as one lookup word.
Configuration
-------------
supybot.plugins.Dict.default
This config variable defaults to "*", is network-specific, and is channel-specific.
Determines the default dictionary the bot will ask for definitions in. If this value is '*' (without the quotes) the bot will use all dictionaries to define words.
supybot.plugins.Dict.public
This config variable defaults to "True", is not network-specific, and is not channel-specific.
Determines whether this plugin is publicly visible.
supybot.plugins.Dict.server
This config variable defaults to "dict.org", is not network-specific, and is not channel-specific.
Determines what server the bot will retrieve definitions from.
supybot.plugins.Dict.showDictName
This config variable defaults to "True", is network-specific, and is channel-specific.
Determines whether the bot will show which dictionaries responded to a query, if the selected dictionary is '*'.