mirror of
https://github.com/Mikaela/Limnoria-doc.git
synced 2024-11-30 00:09:23 +01:00
126 lines
3.4 KiB
ReStructuredText
126 lines
3.4 KiB
ReStructuredText
|
|
.. _plugin-quotegrabs:
|
|
|
|
The QuoteGrabs plugin
|
|
=====================
|
|
|
|
Getting quotes
|
|
--------------
|
|
|
|
.. _command-quotegrabs-get:
|
|
|
|
quotegrabs get [<channel>] <id>
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Return the quotegrab with the given *<id>*. *<channel>* is only necessary
|
|
if the message isn't sent in the channel itself.
|
|
|
|
.. _command-quotegrabs-quote:
|
|
|
|
quotegrabs quote [<channel>] <nick>
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Returns *<nick>*'s latest quote grab in *<channel>*. *<channel>* is only
|
|
necessary if the message isn't sent in the channel itself.
|
|
|
|
.. _command-quotegrabs-random:
|
|
|
|
quotegrabs random [<channel>] [<nick>]
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Returns a randomly grabbed quote, optionally choosing only from those
|
|
quotes grabbed for *<nick>*. *<channel>* is only necessary if the message
|
|
isn't sent in the channel itself.
|
|
|
|
.. _command-quotegrabs-list:
|
|
|
|
quotegrabs list [<channel>] <nick>
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Returns a list of shortened quotes that have been grabbed for *<nick>*
|
|
as well as the id of each quote. These ids can be used to get the
|
|
full quote. *<channel>* is only necessary if the message isn't sent in
|
|
the channel itself.
|
|
|
|
.. _command-quotegrabs-search:
|
|
|
|
quotegrabs search [<channel>] <text>
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Searches for *<text>* in a quote. *<channel>* is only necessary if the
|
|
message isn't sent in the channel itself.
|
|
|
|
(Un)quoting
|
|
-----------
|
|
|
|
.. _command-quotegrabs-ungrab:
|
|
|
|
quotegrabs ungrab [<channel>] <number>
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Removes the grab *<number>* (the last by default) on *<channel>*.
|
|
*<channel>* is only necessary if the message isn't sent in the channel
|
|
itself.
|
|
|
|
.. _command-quotegrabs-grab:
|
|
|
|
quotegrabs grab [<channel>] <nick>
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Grabs a quote from *<channel>* by *<nick>* for the quotegrabs table.
|
|
*<channel>* is only necessary if the message isn't sent in the channel
|
|
itself.
|
|
|
|
|
|
|
|
.. _plugin-quotegrabs-config:
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
.. _supybot.plugins.QuoteGrabs.randomGrabber:
|
|
|
|
supybot.plugins.QuoteGrabs.randomGrabber
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Default value: False
|
|
|
|
Determines whether the bot will randomly grab possibly-suitable quotes on occasion. The suitability of a given message is determined by ...
|
|
|
|
.. _supybot.plugins.QuoteGrabs.randomGrabber.averageTimeBetweenGrabs:
|
|
|
|
supybot.plugins.QuoteGrabs.randomGrabber.averageTimeBetweenGrabs
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Default value: 864000
|
|
|
|
Determines about how many seconds, on average, should elapse between random grabs. This is only an average value; grabs can happen from any time after half this time until never, although that's unlikely to occur.
|
|
|
|
.. _supybot.plugins.QuoteGrabs.randomGrabber.minimumCharacters:
|
|
|
|
supybot.plugins.QuoteGrabs.randomGrabber.minimumCharacters
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Default value: 8
|
|
|
|
Determines the minimum number of characters in a message for it to be considered for random grabbing.
|
|
|
|
.. _supybot.plugins.QuoteGrabs.randomGrabber.minimumWords:
|
|
|
|
supybot.plugins.QuoteGrabs.randomGrabber.minimumWords
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Default value: 3
|
|
|
|
Determines the minimum number of words in a message for it to be considered for random grabbing.
|
|
|
|
.. _supybot.plugins.QuoteGrabs.public:
|
|
|
|
supybot.plugins.QuoteGrabs.public
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Default value: True
|
|
|
|
Determines whether this plugin is publicly visible.
|
|
|