GitHub/pbot
3
0
Fork 0
mirror of https://github.com/pragma-/pbot.git synced 2024-11-25 21:39:27 +01:00
Code Issues Projects Releases Wiki Activity

doc/QuickStart.md: improvements

Browse Source
This commit is contained in:
Pragmatic Software 2020-01-27 20:05:22 -08:00
parent af16cbb167
commit da2cc01bf6
1 changed files with 13 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
doc/QuickStart.md
View File

@ -25,7 +25,7 @@
* [Custom recommended IRCnet/other network settings](#custom-recommended-ircnetother-network-settings) * [Custom recommended IRCnet/other network settings](#custom-recommended-ircnetother-network-settings)
* [Regular start-up](#regular-start-up) * [Regular start-up](#regular-start-up)
* [Additional configuration](#additional-configuration) * [Additional configuration](#additional-configuration)
* [Creating your bot owner user account](#creating-your-bot-owner-user-account) * [Creating your bot owner admin account](#creating-your-bot-owner-admin-account)
* [Adding channels](#adding-channels) * [Adding channels](#adding-channels)
* [Adding other users and admins](#adding-other-users-and-admins) * [Adding other users and admins](#adding-other-users-and-admins)
* [Further Reading](#further-reading) * [Further Reading](#further-reading)
@ -114,10 +114,10 @@ command-line options. We'll show you [how to do that](#starting-pbot) soon! Firs
see what settings you should configure. see what settings you should configure.
Alternatively, you can edit the `registry` file in your cloned data-directory. Alternatively, you can edit the `registry` file in your cloned data-directory.
See the [Editing registry file](Registry.md#editing-registry-file) for more See [editing registry file](Registry.md#editing-registry-file) for more
information. information.
Here is a table of some basic initial settings you should configure: Here is a table of basic initial settings you should configure:
Registry key | Description | Default value Registry key | Description | Default value
--- | --- | ---: --- | --- | ---:
@ -202,11 +202,11 @@ The `irc.server` and `irc.port` settings are omitted because the default values
Replace the placeholders, marked `X`, with values you want to use. Note that this is just for the first-time start-up. Regular subsequent start-up needs only `data_dir` to be overridden. Replace the placeholders, marked `X`, with values you want to use. Note that this is just for the first-time start-up. Regular subsequent start-up needs only `data_dir` to be overridden.
If you have registered your botnick with Freenode's NickServ service, use this command: * If you have registered your botnick with Freenode's NickServ service, use this command:
pbot data_dir=X irc.botnick=X irc.identify_password=X irc.randomize_nick=1 general.autojoin_wait_for_nickserv=1 pbot data_dir=X irc.botnick=X irc.identify_password=X irc.randomize_nick=1 general.autojoin_wait_for_nickserv=1
Otherwise, use this one: * Otherwise, use this one:
pbot data_dir=X irc.botnick=X pbot data_dir=X irc.botnick=X
@ -215,17 +215,18 @@ The following command is based on the [Recommended settings for IRC Networks](#r
Replace the placeholders, marked `X`, with values you want to use. Note that this is just for the first-time start-up. Regular subsequent start-up needs only `data_dir` to be overridden. Replace the placeholders, marked `X`, with values you want to use. Note that this is just for the first-time start-up. Regular subsequent start-up needs only `data_dir` to be overridden.
If you want PBot to identify with a custom bot or service on IRCnet/other networks, use this command: * If you want PBot to identify with a custom bot or service on IRCnet/other networks, use this command:
pbot data_dir=X irc.botnick=X irc.server=X irc.port=X general.identify_nick=X general.op_nick=X pbot data_dir=X irc.botnick=X irc.server=X irc.port=X general.identify_nick=X general.op_nick=X
Otherwise, use this one: * Otherwise, use this one:
pbot data_dir=X irc.botnick=X irc.server=X irc.port=X pbot data_dir=X irc.botnick=X irc.server=X irc.port=X
### Regular start-up ### Regular start-up
After your initial start-up command, you only need to use the `data_dir` After your initial start-up command, you only need to use the `data_dir`
directory override when starting PBot. directory override when starting PBot. Any previously used registry overrides
are saved to your data-directory's `registry` file.
$ pbot data_dir=X $ pbot data_dir=X
@ -234,7 +235,7 @@ Once you've launched PBot, you can type directly into its terminal to execute
commands as the built-in PBot console admin user account. This will allow you commands as the built-in PBot console admin user account. This will allow you
to use admin commands to create new users or join channels. to use admin commands to create new users or join channels.
### Creating your bot owner user account ### Creating your bot owner admin account
To create your own fully privileged admin user account, use the following To create your own fully privileged admin user account, use the following
commands in the PBot terminal console. commands in the PBot terminal console.
@ -242,9 +243,9 @@ Suppose your nick is `Bob` and your hostmask is `Bob!~user@some.domain.com`.
useradd Bob global Bob!~user@*.domain.com 100 useradd Bob global Bob!~user@*.domain.com 100
This will create a level `100` admin user account named `Bob`. Note the wildcard This will create a level `100` admin user account named `Bob` that can administrate
replacing `some` in `some.domain.com`. Now as long as your connected hostmask all channels. Note the wildcard replacing `some` in `some.domain.com`. Now as long as
matches your user account hostmask, you will be recognized. your connected hostmask matches your user account hostmask, you will be recognized.
In your own IRC client, connected using the hostmask we just added, type the In your own IRC client, connected using the hostmask we just added, type the
following command: following command: