3
0
mirror of https://github.com/pragma-/pbot.git synced 2025-01-11 12:32:37 +01:00

README.md: try rearranging some sections

This commit is contained in:
Pragmatic Software 2020-01-07 18:55:50 -08:00
parent ac9bd957fd
commit eeec6a6863

103
README.md
View File

@ -3,35 +3,31 @@ PBot
PBot is a versatile IRC Bot written in Perl PBot is a versatile IRC Bot written in Perl
<!-- md-toc-begin --> <!-- md-toc-begin -->
* [Features](#features)
* [Advanced Interpreter](#advanced-interpreter)
* [Factoids](#factoids)
* [Code Factoids](#code-factoids)
* [Plugins](#plugins)
* [Modules](#modules)
* [Channel management](#channel-management)
* [Admin management](#admin-management)
* [Useful IRC command improvements](#useful-irc-command-improvements)
* [Easy configuration](#easy-configuration)
* [Installation / Quick Start](#installation--quick-start) * [Installation / Quick Start](#installation--quick-start)
* [Documentation](#documentation) * [Documentation](#documentation)
* [Features](#features)
* [Factoids](#factoids)
* [Code Factoids](#code-factoids)
* [Useful IRC command improvements](#useful-irc-command-improvements)
* [Channel management](#channel-management)
* [Plugins](#plugins)
* [Modules](#modules)
* [Admin management](#admin-management)
* [Easy configuration](#easy-configuration)
* [Advanced Interpreter](#advanced-interpreter)
<!-- md-toc-end --> <!-- md-toc-end -->
Installation / Quick Start
--------------------------
To get up-and-running quickly, check out the [Quick Start guide](https://github.com/pragma-/pbot/blob/master/doc/QuickStart.md).
Documentation
-------------
See the [PBot documentation](https://github.com/pragma-/pbot/tree/master/doc) for more information.
Features Features
-------- --------
### Advanced Interpreter
PBot has an advanced command interpreter with useful functionality.
* piping
* command substitution
* command separation
* inline commands
* $variable interpolation
* aliases
* and more!
### Factoids ### Factoids
PBot has factoids with advanced features. PBot has factoids with advanced features.
@ -57,6 +53,28 @@ any language! This is one of PBot's most powerful features.
How is this safe? Because the code is executed within a virtual machine that How is this safe? Because the code is executed within a virtual machine that
has been configured to fall-back to a previously saved state whenever it times out. has been configured to fall-back to a previously saved state whenever it times out.
### Useful IRC command improvements
* `mode` command can take wildcards, e.g. `mode +ov foo* bar*` to op nicks beginning with `foo` and voice nicks beginning with `bar`
* `unban <nick>` and `unmute <nick>` can remove all bans/mutes matching `<nick>`'s hostmask or account
* `ban` and `mute` will intelligently set banmasks; also supports timeouts
* `ban` and `mute` can take a comma-separate list of nicks. Will intelligently group them into multiple `MODE +bbbb` commands
* `kick` can take a comma-separated list of nicks. also accept wildcards
* and much, much, more
### Channel management
PBot can perform the expected channel management tasks.
* opping/deopping, etc
* channel-mode tracking
* user hostmask/alias tracking
* ban-evasion detection
* flood detection
* whitelisting, blacklisting, etc
* spam/advertisement detection
* and much, much more
### Plugins ### Plugins
PBot can dynamically load and unload Perl modules to alter its behavior. PBot can dynamically load and unload Perl modules to alter its behavior.
@ -102,20 +120,6 @@ Module | Description
[Urban Dictionary](modules/urban) | Search Urban Dictionary for definitions. [Urban Dictionary](modules/urban) | Search Urban Dictionary for definitions.
[Manpages](modules/man.pl) | Display a concise formatting of manual pages (designed for C functions) [Manpages](modules/man.pl) | Display a concise formatting of manual pages (designed for C functions)
### Channel management
PBot can perform the expected channel management tasks.
* opping/deopping, etc
* channel-mode tracking
* user hostmask/alias tracking
* ban-evasion detection
* flood detection
* whitelisting, blacklisting, etc
* spam/advertisement detection
* and much, much more
### Admin management ### Admin management
PBot has easy admin management via simple built-in commands. PBot has easy admin management via simple built-in commands.
@ -125,16 +129,6 @@ PBot has easy admin management via simple built-in commands.
* admins can be set to be permanently logged-in * admins can be set to be permanently logged-in
* admin abilities configured by admin-levels * admin abilities configured by admin-levels
### Useful IRC command improvements
* `mode` command can take wildcards, e.g. `mode +ov foo* bar*` to op nicks beginning with `foo` and voice nicks beginning with `bar`
* `unban <nick>` and `unmute <nick>` can remove all bans/mutes matching `<nick>`'s hostmask or account
* `ban` and `mute` will intelligently set banmasks; also supports timeouts
* `ban` and `mute` can take a comma-separate list of nicks. Will intelligently group them into multiple `MODE +bbbb` commands
* `kick` can take a comma-separated list of nicks
* `kick` can also accept wildcards
* and much, much, more
### Easy configuration ### Easy configuration
PBot's settings are contained in a central registry of key/value pairs grouped by sections. PBot's settings are contained in a central registry of key/value pairs grouped by sections.
@ -145,11 +139,16 @@ These settings can easily be configured via several methods:
* simple built-in commands (`regset`, `regunset`, etc) * simple built-in commands (`regset`, `regunset`, etc)
* editing the [`$data_dir/registry`](data/registry) plain-text JSON file * editing the [`$data_dir/registry`](data/registry) plain-text JSON file
Installation / Quick Start ### Advanced Interpreter
--------------------------
To get up-and-running quickly, check out the [Quick Start guide](https://github.com/pragma-/pbot/blob/master/doc/QuickStart.md). PBot has an advanced command interpreter with useful functionality.
* piping
* command substitution
* command separation
* inline commands
* $variable interpolation
* aliases
* and more!
Documentation
-------------
See the [PBot documentation](https://github.com/pragma-/pbot/tree/master/doc) for more information.