mirror of
https://github.com/Mikaela/Limnoria-doc.git
synced 2024-11-27 06:49:28 +01:00
2461 lines
84 KiB
Plaintext
2461 lines
84 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
||
# Copyright (C) 2003-2015, the Limnoria/Gribble/Supybot contributors
|
||
# This file is distributed under the same license as the Limnoria package.
|
||
# FIRST AUTHOR <EMAIL@ADDRESS>, 2016.
|
||
#
|
||
msgid ""
|
||
msgstr ""
|
||
"Project-Id-Version: Limnoria 0.83\n"
|
||
"Report-Msgid-Bugs-To: \n"
|
||
"POT-Creation-Date: 2016-02-24 21:01+0100\n"
|
||
"PO-Revision-Date: 2016-02-24 21:25+0100\n"
|
||
"Last-Translator: Valentin Lorentz <progval+l10n@progval.net>\n"
|
||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||
"MIME-Version: 1.0\n"
|
||
"Content-Type: text/plain; charset=utf-8\n"
|
||
"Content-Transfer-Encoding: 8bit\n"
|
||
"Generated-By: Babel 2.2.0\n"
|
||
"Language: fr\n"
|
||
"X-Generator: Poedit 1.6.10\n"
|
||
|
||
#: ../../use/capabilities.rst:5
|
||
msgid "Capabilities"
|
||
msgstr "Capacités"
|
||
|
||
#: ../../use/capabilities.rst:8 ../../use/configuration.rst:6
|
||
#: ../../use/getting_started.rst:8
|
||
msgid "Introduction"
|
||
msgstr "Introduction"
|
||
|
||
#: ../../use/capabilities.rst:10
|
||
msgid ""
|
||
"Ok, some explanation of the capabilities system is probably in order. With "
|
||
"most IRC bots (including the ones I've written myself prior to this one) "
|
||
"\"what a user can do\" is set in one of two ways. On the *really* simple "
|
||
"bots, each user has a numeric \"level\" and commands check to see if a user "
|
||
"has a \"high enough level\" to perform some operation. On bots that are "
|
||
"slightly more complicated, users have a list of \"flags\" whose meanings are "
|
||
"hardcoded, and the bot checks to see if a user possesses the necessary flag "
|
||
"before performing some operation. Both methods, IMO, are rather arbitrary, "
|
||
"and force the user and the programmer to be unduly confined to less "
|
||
"expressive constructs."
|
||
msgstr ""
|
||
"Ok, il est temps d’expliquer le fonctionnement du système de capacités. "
|
||
"Pour la plupart des bots IRC (y compris certains que j’ai moi-même écrits "
|
||
"avant celui), « ce qu’un-e utilisateur-trice peut faire » peut être défini "
|
||
"de deux façons différentes. Pour les bots *très* simples, chacun-e a un "
|
||
"« niveau » et les commandes vérifies si le niveau d’un-e utilisateur-trice "
|
||
"est assez élevé pour effectuer telle ou telle opération. Pour les bots "
|
||
"légèrement plus évolués, les utilisateurs-trices ont une liste de "
|
||
"« flags » (drapeaux, étiquettes) dont la signifie est intégrée au bot, qui "
|
||
"vérifie que la personne qui veut effectuer une opération les a. Les deux "
|
||
"méthodes sont, à mon avis, assez arbitraires, et forcent les utilisateurs-"
|
||
"trices et développeurs-euses à être inutilement forcé-es à utiliser des "
|
||
"constructions peu expressives.\t"
|
||
|
||
#: ../../use/capabilities.rst:20
|
||
msgid ""
|
||
"This bot is different. Every user has a set of \"capabilities\" that is "
|
||
"consulted every time they give the bot a command. Commands, rather than "
|
||
"checking for a user level of 100, or checking if the user has an 'o' flag, "
|
||
"are instead able to check if a user has the 'owner' capability. At this "
|
||
"point such a difference might not seem revolutionary, but at least we can "
|
||
"already tell that this method is self-documenting, and easier for users and "
|
||
"developers to understand what's truly going on."
|
||
msgstr ""
|
||
"Ce bot est différent. Chaque utilisateur-trice a un ensemble de "
|
||
"« capacités », qui est consulté à chaque fois qu’iel envoie une commande au "
|
||
"bot. Les commandes, plutôt que de vérifier qu’iel a un niveau de 100, ou "
|
||
"vérifier qu’iel a le flag « o », sont capables de vérifier qu’iel a la "
|
||
"capacité « owner ». Pour le moment, une telle différence ne semble pas "
|
||
"révolutionnaire, mais on peut déjà constater que cette méthode est plus "
|
||
"explicite, et plus facile pour les personnes qui s’en servent et développent "
|
||
"pour comprendre ce qu’il se passe vraiment."
|
||
|
||
#: ../../use/capabilities.rst:29 ../../use/capabilities.rst:127
|
||
msgid "User Capabilities"
|
||
msgstr "Capacité utilisateur-trice"
|
||
|
||
#: ../../use/capabilities.rst:30
|
||
msgid "What the heck can these capabilities DO?"
|
||
msgstr "Que permettent donc les capacités de faire ?"
|
||
|
||
#: ../../use/capabilities.rst:32
|
||
msgid ""
|
||
"If that was all, well, the capability system would be *cool*, but not many "
|
||
"people would say it was *awesome*. But it **is** awesome! Several things "
|
||
"are happening behind the scenes that make it awesome, and these are things "
|
||
"that couldn't happen if the bot was using numeric userlevels or single-"
|
||
"character flags. First, whenever a user issues the bot a command, the "
|
||
"command dispatcher checks to make sure the user doesn't have the "
|
||
"\"anticapability\" for that command. An anticapability is a capability "
|
||
"that, instead of saying \"what a user can do\", says what a user *cannot* "
|
||
"do. It's formed rather simply by adding a dash ('-') to the beginning of a "
|
||
"capability; 'rot13' is a capability, and '-rot13' is an anticapability."
|
||
msgstr ""
|
||
"Si c’était tout, eh bien, le système de capacités serait *cool*, mais peu de "
|
||
"gens diraient *génial*. Mais il **est** génial ! Plusieurs choses arrivent "
|
||
"derrière le décors pour que ça soit génial, et ce sont des choses qui "
|
||
"n’arrivent pas avec les bots qui utilisent des niveaux numériques ou des "
|
||
"flags d’un seul caractère. Premièrement, quand quelqu’un envoie une "
|
||
"commande au bot, le dispatcher de commande vérifie qu’iel n’a pas "
|
||
"l’« anticapacité » pour cete commande. Une anticapacité est une capacité "
|
||
"qui, plutôt que de dire ce que quelqu’un peut faire, dit ce que cette "
|
||
"personne ne peut *pas* faire. Elle est formée simplement en ajoutant un "
|
||
"tirer (« - ») au début du nom de la capacité : « rot13 » est une capacité, "
|
||
"« -rot13 » est une anticapacité.\t\t"
|
||
|
||
#: ../../use/capabilities.rst:43
|
||
msgid ""
|
||
"Anyway, when a user issues the bot a command, perhaps 'calc' or 'help', the "
|
||
"bot first checks to make sure the user doesn't have the '-calc' or the '-"
|
||
"help' (anti)capabilities before even considering responding to the user. So "
|
||
"commands can be turned on or off on a *per user* basis, offering fine-"
|
||
"grained control not often (if at all!) seen in other bots. This can be "
|
||
"further refined by limiting the (anti)capability to a command in a specific "
|
||
"plugin or even an entire plugin. For example, the rot13 command is in the "
|
||
"Filter plugin. If a user should be able to use another rot13 command, but "
|
||
"not the one in the Format plugin, they would simply need to be given '-"
|
||
"Format.rot13' anticapability. Similarly, if a user were to be banned from "
|
||
"using the Filter plugin altogether, they would simply need to be given the '-"
|
||
"Filter' anticapability."
|
||
msgstr ""
|
||
"Bref, quand quelqu’un envoie une commande au bot, par exemple « calc » ou "
|
||
"« help », le bot vérifie d’apport qu’iel n’a pas les anticapacités « -calc » "
|
||
"ou « -help » avant même de songer à lui réponse. Donc les commandes peuvent "
|
||
"être activées ou désactivées pour chaque personne, permettant un contrôle "
|
||
"fin, qui n’est pas souvent (voire jamais) possible avec d’autres bots. Cela "
|
||
"peut être raffiné encore plus en limitant les (anti)capacités à une commande "
|
||
"d’un plugin en particulier, ou à tout un plugin. Par exemple, la commande "
|
||
"rot13 est dans le plugin Filter. Si quelqu’un devrait pouvoir utilisr la "
|
||
"commande rot13 d’un autre plugin, mais pas celle du plugin Format, iel "
|
||
"aurait seulement besoin de recevoir l’anticapacité « -Format.rot13 ». "
|
||
"Similairement, si quelqu’un doit se faire bannir du plugin Filter, il suffit "
|
||
"de lui donner l’anticapacité « -Filter »."
|
||
|
||
#: ../../use/capabilities.rst:56
|
||
msgid "Channel Capabilities"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:57
|
||
msgid "What if #linux wants completely different capabilities from #windows?"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:59
|
||
msgid ""
|
||
"But that's not all! The capabilities system also supports *channel* "
|
||
"capabilities, which are capabilities that only apply to a specific channel; "
|
||
"they're of the form '#channel,capability'. Whenever a user issues a command "
|
||
"to the bot in a channel, the command dispatcher also checks to make sure the "
|
||
"user doesn't have the anticapability for that command *in that channel*, and "
|
||
"if the user does, the bot won't respond to the user in the channel. Thus "
|
||
"now, in addition to having the ability to turn individual commands on or off "
|
||
"for an individual user, we can now turn commands on or off for an individual "
|
||
"user on an individual channel!"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:69
|
||
msgid ""
|
||
"So when a user 'foo' sends a command 'bar' to the bot on channel '#baz', "
|
||
"first the bot checks to see if the user has the anticapability for the "
|
||
"command by itself, '-bar'. If so, it errors right then and there, telling "
|
||
"the user that he lacks the 'bar' capability. If the user doesn't have that "
|
||
"anticapability, then the bot checks to see if the user issued the command "
|
||
"over a channel, and if so, checks to see if the user has the "
|
||
"antichannelcapability for that command, '#baz,-bar'. If so, again, it tells "
|
||
"the user that they lack the 'bar' capability. If neither of these "
|
||
"anticapabilities are present, then the bot just responds to the user like "
|
||
"normal."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:80
|
||
msgid "Default Capabilities"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:81
|
||
msgid "So what capabilities am I dealing with already?"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:83
|
||
msgid ""
|
||
"There are several default capabilities the bot uses. The most important of "
|
||
"these is the 'owner' capability. This capability allows the person having "
|
||
"it to use *any* command. It's best to keep this capability reserved to "
|
||
"people who actually have access to the shell the bot is running on. It's so "
|
||
"important, in fact, that the bot will not allow you to add it with a "
|
||
"command--you'll have you edit the users file directly to give it to someone."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:90
|
||
msgid ""
|
||
"There is also the 'admin' capability for non-owners that are highly trusted "
|
||
"to administer the bot appropriately. They can do things such as change the "
|
||
"bot's nick, cause the bot to ignore a given user, make the bot join or part "
|
||
"channels, etc. They generally cannot do administration related to channels, "
|
||
"which is reserved for people with the next capability."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:96
|
||
msgid ""
|
||
"People who are to administer channels with the bot should have the '#channel,"
|
||
"op' capability--whatever channel they are to administrate, they should have "
|
||
"that channel capability for 'op'. For example, since I want inkedmn to be "
|
||
"an administrator in #supybot, I'll give them the '#supybot,op' capability. "
|
||
"This is in addition to their 'admin' capability, since the 'admin' "
|
||
"capability doesn't give the person having it control over channels. "
|
||
"'#channel,op' is used for such things as giving/receiving ops, kickbanning "
|
||
"people, lobotomizing the bot, ignoring users in the channel, and managing "
|
||
"the channel capabilities. The '#channel,op' capability is also basically the "
|
||
"equivalent of the 'owner' capability for capabilities involving #channel--"
|
||
"basically anyone with the #channel,op capability is considered to have all "
|
||
"positive capabilities and no negative capabilities for #channel."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:109
|
||
msgid ""
|
||
"One other globally important capability exists: 'trusted'. This is a "
|
||
"command that basically says \"This user can be trusted not to try and crash "
|
||
"the bot.\" It allows users to call commands like 'icalc' in the 'Math' "
|
||
"plugin, which can cause the bot to begin a calculation that could "
|
||
"potentially never return (a calculation like '10**10**10**10'). Another "
|
||
"command that requires the 'trusted' capability is the 're' command in the "
|
||
"'Utilities' plugin, which (due to the regular expression implementation in "
|
||
"Python (and any other language that uses NFA regular expressions, like Perl "
|
||
"or Ruby or Lua or ...) which can allow a regular expression to take "
|
||
"exponential time to process). Consider what would happen if someone gave "
|
||
"the bot the command 're [format join \"\" s/./ [dict go] /] [dict go]' It "
|
||
"would basically replace every character in the output of 'dict go' (14,896 "
|
||
"characters!) with the entire output of 'dict go', resulting in 221MB of "
|
||
"memory allocated! And that's not even the worst example!"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:124
|
||
msgid "Managing capabilities"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:129
|
||
msgid ""
|
||
"User capabilities are controlled with the ``admin capability <add|remove>`` "
|
||
"and ``channel capability <add|remove>``. Their difference is that the first "
|
||
"one is only restricted to those who have the admin capability."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:133
|
||
msgid "To make user1 admin, I would run::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:137
|
||
msgid ""
|
||
"If the bot joins on a channel where there should be ops who should't have "
|
||
"power over any other channel, I would run::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:142
|
||
msgid ""
|
||
"Note that admins cannot give anyone capability which they don't have by "
|
||
"themselves first, so user1 couldn't use ``channel capability add`` unless "
|
||
"they were made #channel,op first. The command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:148
|
||
msgid ""
|
||
"has the same effect as ``channel capability add``, but it requires user to "
|
||
"have the admin capability in addition to #channel,op."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:151
|
||
msgid ""
|
||
"If there is abusive user who shouldn't have op capability but still does for "
|
||
"one reason or another, I could run either::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:156
|
||
msgid "or::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:160
|
||
msgid ""
|
||
"Anticapabilities are checked before normal capabilities so the first command "
|
||
"would work even if user3 still had the op capability. Removing capability "
|
||
"which isn't given to user or channel adds anti-capability automatically."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:165
|
||
msgid "User capabilities can be viewed with ``user capabilities`` command."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:168
|
||
msgid "Channel"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:170
|
||
msgid ""
|
||
"Channel capabilities affect everyone on the current channel including "
|
||
"unidentified users. They are controlled with the ``channel capability <set|"
|
||
"unset>`` commands."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:173
|
||
msgid ""
|
||
"If I wanted to make everyone on the channel able to voice themselves or get "
|
||
"automatically voiced by the AutoMode plugin, I would start by unsetting the "
|
||
"default anticapability and setting the capability.::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:180
|
||
msgid ""
|
||
"Now anyone on the channel can voice themselves or if AutoMode plugin is "
|
||
"configured to voice voiced people, the will automatically get voiced on join."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:184
|
||
msgid ""
|
||
"If there was unwanted plugin or plugin which output was causing spam, Games "
|
||
"for example, I could add anticapability for it and prevent the whole plugin "
|
||
"from being used.::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:190
|
||
msgid "Note that I didn't specify any separate command after Games."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:193
|
||
msgid "Default"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:195
|
||
msgid ""
|
||
"Default capabilities affect everyone whether they are identified or not. "
|
||
"They are controlled by the ``owner defaultcapability <add|remove>`` command "
|
||
"and they arecommonly used for preventing users from adding/removing akas, "
|
||
"using Unix Progstats which disabling is asked about in supybot-wizard or "
|
||
"registering to the bot using anticapabilities.::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:206
|
||
msgid "To undo this I would simply do the opposite.::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:213
|
||
msgid ""
|
||
"Defaultcapabilities can be restored with two commands from the First is only "
|
||
"in Limnoria at the time of writing::"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:220 ../../use/getting_started.rst:325
|
||
msgid "Final Word"
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:222
|
||
msgid ""
|
||
"From a programmer's perspective, capabilties are flexible and easy to use. "
|
||
"Any command can check if a user has any capability, even ones not thought of "
|
||
"when the bot was originally written. Plugins can easily add their own "
|
||
"capabilities--it's as easy as just checking for a capability and documenting "
|
||
"somewhere that a user needs that capability to do something."
|
||
msgstr ""
|
||
|
||
#: ../../use/capabilities.rst:228
|
||
msgid ""
|
||
"From an user's perspective, capabilities remove a lot of the mystery and "
|
||
"esotery of bot control, in addition to giving a bot owner absolutely "
|
||
"finegrained control over what users are allowed to do with the bot. "
|
||
"Additionally, defaults can be set by the bot owner for both individual "
|
||
"channels and for the bot as a whole, letting an end-user set the policy they "
|
||
"want the bot to follow for users that haven't yet registered in their user "
|
||
"database. It's really a revolution!"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:3 ../../use/httpserver.rst:6
|
||
msgid "Configuration"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:7
|
||
msgid ""
|
||
"So you've got your Supybot up and running and there are some things you "
|
||
"don't like about it. Fortunately for you, chances are that these things are "
|
||
"configurable, and this document is here to tell you how to configure them."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:12
|
||
msgid ""
|
||
"Configuration of Supybot is handled via the `Config` plugin, which controls "
|
||
"runtime access to Supybot's registry (the configuration file generated by "
|
||
"the 'supybot-wizard' program you ran). The `Config` plugin provides a way "
|
||
"to get or set variables, to list the available variables, and even to get "
|
||
"help for certain variables. Take a moment now to read the help for each of "
|
||
"those commands: ``config``, ``list``, and ``help``. If you don't know how to "
|
||
"get help on those commands, take a look at the GETTING_STARTED document."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:22
|
||
msgid "Configuration Registry"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:23
|
||
msgid ""
|
||
"Now, if you're used to the Windows registry, don't worry, Supybot's registry "
|
||
"is completely different. For one, it's completely plain text. But there is "
|
||
"at least one good idea in Windows' registry: hierarchical configuration."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:28
|
||
msgid ""
|
||
"Supybot's configuration variables are organized in a hierarchy: variables "
|
||
"having to do with the way Supybot makes replies all start with `supybot."
|
||
"reply`; variables having to do with the way a plugin works all start with "
|
||
"`supybot.plugins.Plugin` (where 'Plugin' is the name of the plugin in "
|
||
"question). This hierarchy is nice because it means the user isn't inundated "
|
||
"with hundreds of unrelated and unsorted configuration variables."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:36
|
||
msgid ""
|
||
"Some of the more important configuration values are located directly under "
|
||
"the base group, `supybot`. Things like the bot's nick, its ident, etc. "
|
||
"Along with these config values are a few subgroups that contain other "
|
||
"values. Some of the more prominent subgroups are: `plugins` (where all the "
|
||
"plugin-specific configuration is held), `reply` (where variables affecting "
|
||
"the way a Supybot makes its replies resides), `replies` (where all the "
|
||
"specific standard replies are kept), and `directories` (where all the "
|
||
"directories a Supybot uses are defined). There are other subgroups as well, "
|
||
"but these are the ones we'll use in our example."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:48
|
||
msgid "Configuration Groups"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:49
|
||
msgid ""
|
||
"Using the `Config` plugin, you can list values in a subgroup and get or set "
|
||
"any of the values anywhere in the configuration hierarchy. For example, "
|
||
"let's say you wanted to see what configuration values were under the "
|
||
"`supybot` (the base group) hierarchy. You would simply issue this command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:58
|
||
msgid ""
|
||
"These are all the configuration groups and values which are under the base "
|
||
"`supybot` group. Actually, their full names would each have a 'supybot.' "
|
||
"prepended to them, but it is omitted in the listing in order to shorten the "
|
||
"output. The first entries in the output are the groups (distinguished by "
|
||
"the '@' symbol in front of them), and the rest are the configuration "
|
||
"values. The '@' symbol (like the '#' symbol we'll discuss later) is simply "
|
||
"a visual cue and is not actually part of the name."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:67
|
||
msgid "Configuration Values"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:68
|
||
msgid ""
|
||
"Okay, now that you've used the Config plugin to list configuration "
|
||
"variables, it's time that we start looking at individual variables and their "
|
||
"values."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:72
|
||
msgid ""
|
||
"The first (and perhaps most important) thing you should know about each "
|
||
"configuration variable is that they all have an associated help string to "
|
||
"tell you what they represent. So the first command we'll cover is ``config "
|
||
"help``. To see the help string for any value or group, simply use the "
|
||
"``config help`` command. For example, to see what this `supybot."
|
||
"snarfThrottle` configuration variable is all about, we'd do this::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:86
|
||
msgid "Pretty simple, eh?"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:88
|
||
msgid ""
|
||
"Now if you're curious what the current value of a configuration variable is, "
|
||
"you'll use the ``config`` command with one argument, the name of the "
|
||
"variable you want to see the value of::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:95
|
||
msgid "To set this value, just stick an extra argument after the name::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:100
|
||
msgid "Now check this out::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:105
|
||
msgid ""
|
||
"Note that we used '$' as our prefix character, and that the value of the "
|
||
"configuration variable changed. If I were to use the ``flush`` command now, "
|
||
"this change would be flushed to the registry file on disk (this would also "
|
||
"happen if I made the bot quit, or pressed Ctrl-C in the terminal which the "
|
||
"bot was running). Instead, I'll revert the change::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:116
|
||
msgid "Default Values"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:117
|
||
msgid ""
|
||
"If you're ever curious what the default for a given configuration variable "
|
||
"is, use the ``config default`` command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:123
|
||
msgid ""
|
||
"Thus, to reset a configuration variable to its default value, you can simply "
|
||
"say::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:130
|
||
msgid "Simple, eh?"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:133
|
||
msgid "Searching the Registry"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:134
|
||
msgid ""
|
||
"Now, let's say you want to find all configuration variables that might be "
|
||
"even remotely related to opping. For that, you'll want the ``config "
|
||
"search`` command. Check this out::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:144
|
||
msgid ""
|
||
"Sure, it showed all the topic-related stuff in there, but it also showed you "
|
||
"all the op-related stuff, too. Do note, however, that you can only see "
|
||
"configuration variables for plugins that are currently loaded or that you "
|
||
"loaded in the past; if you've never loaded a plugin there's no way for the "
|
||
"bot to know what configuration variables it registers."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:151
|
||
msgid "Channel-Specific Configuration"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:152
|
||
msgid ""
|
||
"Many configuration variables can be specific to individual channels. The "
|
||
"`Config` plugin provides an easy way to configure something for a specific "
|
||
"channel; for instance, in order to set the prefix chars for a specific "
|
||
"channel, do this in that channel::"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:160
|
||
msgid ""
|
||
"That'll set the prefix chars in the channel from which the message was sent "
|
||
"to '!'. Voila, channel-specific values! Also, note that when using the "
|
||
"`Config` plugin's ``list`` command, channel-specific values are preceeded by "
|
||
"a '#' character to indicate such (similar to how '@' is used to indicate a "
|
||
"group of values)."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:168
|
||
msgid "Editing the Configuration Values by Hand"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:170
|
||
msgid ""
|
||
"NOTE: **We don't recommend this and you shouldn't ever do this, you should "
|
||
"do everything with the commands in the Config plugin.**"
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:173
|
||
msgid ""
|
||
"Some people might like editing their registry file directly rather than "
|
||
"manipulating all these things through the bot. For those people, we offer "
|
||
"the ``config reload`` command, which reloads both registry configuration and "
|
||
"user/channel/ignore database configuration."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:178
|
||
msgid ""
|
||
"Just edit the interesting files and then give the bot the ``config reload`` "
|
||
"command and it'll work as expected. Do note, however, that Supybot flushes "
|
||
"its configuration files and database to disk every hour or so, and if this "
|
||
"happens after you've edited your configuration files but before you reload "
|
||
"your changes, you could lose the changes you made. To prevent this, set the "
|
||
"`supybot.flush` value to 'Off' while editing the files, and no automatic "
|
||
"flushing will occur."
|
||
msgstr ""
|
||
|
||
#: ../../use/configuration.rst:186
|
||
msgid ""
|
||
"If you cannot access the bot on IRC and your bot is running on a POSIX "
|
||
"system, you can also send it a SIGHUP signal; it is exactly the same as "
|
||
"``config reload`` (note that the Config plugin has to be loaded to do that)."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:3
|
||
msgid "Frequently Asked Questions"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:6
|
||
msgid "How do I make my Supybot connect to multiple servers?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:8
|
||
msgid "Just use the `connect` command in the `Network` plugin."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:11
|
||
msgid ""
|
||
"Why does my bot not recognize me or tell me that I don't have the 'owner' "
|
||
"capability?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:13
|
||
msgid "Because you've not given it anything to recognize you from!"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:15
|
||
msgid ""
|
||
"You'll need to identify to the bot (``help identify`` to see how that works) "
|
||
"or add your hostmask to your user record (``help hostmask add`` to see how "
|
||
"that works) for it to know that you're you."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:19
|
||
msgid ""
|
||
"You may wish to note that ``hostmask add`` can accept a password; rather "
|
||
"than identify, you can send the command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:24
|
||
msgid ""
|
||
"and the bot will add your current hostmask to your owner user (of course, "
|
||
"you should change myOwnerUser and myOwnerUserPassword appropriately for your "
|
||
"bot)."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:28
|
||
msgid ""
|
||
"For additional ways to identify to your bot, you may want to see :ref:"
|
||
"`getting-started`."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:32
|
||
msgid "What is a hostmask?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:34
|
||
msgid ""
|
||
"Each user on IRC is uniquely identified by a string which we call a "
|
||
"`hostmask`. The IRC RFC refers to it as a prefix. Either way, it consists of "
|
||
"a nick, a user, and a host, in the form ``nick!user@host``. If your Supybot "
|
||
"complains that something you've given to it isn't a hostmask, make sure that "
|
||
"you have those three components and that they're joined in the appropriate "
|
||
"manner."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:42
|
||
msgid "My bot can't handle nicks with brackets in them!"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:44
|
||
msgid ""
|
||
"It always complains about something not being a valid command, or about "
|
||
"spurious or missing right brackets, etc."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:47
|
||
msgid ""
|
||
"You should quote arguments (using double quotes, like this: ``"
|
||
"\"foo[bar]\"``) that have brackets in them that you don't wish to be "
|
||
"evaluated as nested commands. Alternatively, you can turn off nested "
|
||
"commands by setting `supybot.commands.nested` to False, or change the "
|
||
"brackets that nest commands by setting `supybot.commands.nested.brackets` to "
|
||
"some other value (like ``<>``, which can't occur in IRC nicks)."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:56
|
||
msgid "I loaded Alias before, how do I move to Aka?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:58
|
||
msgid ""
|
||
"First load both of the plugins, Aka and Alias. Then run ``aka "
|
||
"importaliasdatabase`` and ``unload Alias``. Now all your aliases should be "
|
||
"imported to the Aka plugin."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:63
|
||
msgid "I added an aka, but it doesn't work!"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:65
|
||
msgid ""
|
||
"Take a look at ``aka show <aka you added>``. If the aka the bot has listed "
|
||
"doesn't match what you're giving it, chances are you need to quote your aka "
|
||
"in order for the brackets not to be evaluated. For instance, if you're "
|
||
"adding an aka to give you a link to your homepage, you need to say::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:73
|
||
msgid "and not::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:77
|
||
msgid ""
|
||
"The first version works; the second version will always return the same url."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:81
|
||
msgid "What does 'lobotomized' mean?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:83
|
||
msgid ""
|
||
"I see this word in commands and in my `channels.conf`, but I don't know what "
|
||
"it means. What does Supybot mean when it says lobotomized?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:86
|
||
msgid ""
|
||
"A lobotomy is an operation that removes the frontal lobe of the brain, the "
|
||
"part that does most of a person's thinking. To lobotomize a bot is to tell "
|
||
"it to stop thinking--thus, a lobotomized bot will not respond to anything "
|
||
"said by anyone other than its owner in whichever channels it is lobotomized."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:92
|
||
msgid ""
|
||
"The term is certainly suboptimal, but remains in use because it was "
|
||
"historically used by certain other IRC bots, and we wanted to ease the "
|
||
"transition to Supybot from those bots by reusing as much terminology as "
|
||
"possible."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:98
|
||
msgid "Is there a way to load all the plugins Supybot has?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:100
|
||
msgid ""
|
||
"No, there isn't. Even if there were, some plugins conflict with other "
|
||
"plugins, so it wouldn't make much sense to load them. For instance, what "
|
||
"would a bot do with `Factoids`, `MoobotFactoids`, and `Infobot` all loaded? "
|
||
"Probably just annoy people :)"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:105
|
||
msgid ""
|
||
"You can also install user-contributed plugins using the PluginDownloader "
|
||
"plugin (``load PluginDownloader``). The ``repolist`` command can list "
|
||
"repositories and their contents, and the ``install`` command installs "
|
||
"plugins."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:111
|
||
msgid ""
|
||
"Is there a command that can tell me what capability another command requires?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:113
|
||
msgid "No, there isn't, and there probably never will be."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:115
|
||
msgid ""
|
||
"Commands have the flexibility to check any capabilities they wish to check; "
|
||
"while this flexibility is useful, it also makes it hard to guess what "
|
||
"capability a certain command requires. We could make a solution that would "
|
||
"work in a large majority of cases, but it wouldn't (and couldn't!) be "
|
||
"absolutely correct in all circumstances, and since we're anal and we hate "
|
||
"doing things halfway, we probably won't ever add this partial solution."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:124
|
||
msgid "Why doesn't `Karma` seem to work for me?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:126
|
||
msgid ""
|
||
"`Karma`, by default, doesn't acknowledge karma updates. If you check the "
|
||
"karma of whatever you increased/decreased, you'll note that your increment "
|
||
"or decrement still took place. If you'd rather `Karma` acknowledge karma "
|
||
"updates, change the `supybot.plugins.Karma.response` configuration variable "
|
||
"to \"True\"."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:133
|
||
msgid "Why won't Supybot respond to private messages?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:135
|
||
msgid ""
|
||
"The most likely cause is that your bot has a mode blocking messages from "
|
||
"unregistered users. Around Sept. 2005, for example, Freenode added a user "
|
||
"mode where registered users could set ``+R``, which `blocks`_ private "
|
||
"messages from unregistered users. So, the reason you aren't seeing a "
|
||
"response from your Supybot is likely:"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:141
|
||
msgid ""
|
||
"Your Supybot is not registered with NickServ, you are registered, and you "
|
||
"have set the +R user mode for yourself."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:144
|
||
msgid ""
|
||
"or: you have registered your Supybot with NickServ, you aren't registered, "
|
||
"and your Supybot has the +R user mode set."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:148
|
||
msgid "Can users with the admin capability change the configuration?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:150
|
||
msgid ""
|
||
"Currently, no. Feel free to make your case to us as to why a certain "
|
||
"configuration variable should only require the `admin` capability instead of "
|
||
"the `owner` capability, and if we agree with you, we'll change it for the "
|
||
"next release."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:156
|
||
msgid "How can I make my Supybot log my IRC channel?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:158
|
||
msgid ""
|
||
"To log all the channels your Supybot is in, simply load the `ChannelLogger` "
|
||
"plugin, which is included in the main distribution."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:162
|
||
msgid "How do I get channel modes when writing a plugin?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:164
|
||
msgid ""
|
||
"I want to know who's an op in a certain channel, or who's voiced, or what "
|
||
"the modes on the channel are. How do I do that?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:167
|
||
msgid ""
|
||
"Everything you need is kept in a `ChannelState` object in an `IrcState` "
|
||
"object in the `Irc` object your plugin is given. To see the ops in a given "
|
||
"channel, for instance, you would do this::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:173
|
||
msgid ""
|
||
"To see a dictionary mapping mode chars to values (if any), you would do "
|
||
"this::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:178
|
||
msgid "From there, things should be self-evident."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:181
|
||
msgid "Can Supybot connect through a proxy server?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:183
|
||
msgid ""
|
||
"Limnoria can connect to specific network using socks proxy, simply set the "
|
||
"configuration variable `supybot.networks.<network>.socksproxy`. For "
|
||
"specifying proxy which is used for HTTP requests, set the configuration "
|
||
"variable `supybot.protocols.http.proxy`."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:188
|
||
msgid ""
|
||
"Supybot also works with transparent proxy server helpers like tsocks_ that "
|
||
"are designed to proxy-enable all network applications, and Supybot does work "
|
||
"with these."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:193
|
||
msgid "Why can't Supybot find the plugin I want to load?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:195
|
||
msgid ""
|
||
"Why does my bot say that 'No plugin \"foo\" exists.' when I try to load the "
|
||
"foo plugin?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:198
|
||
msgid ""
|
||
"First, make sure you are typing the plugin name correctly. ``@load foo`` "
|
||
"may not be the same as ``@load Foo`` depending on your Supybot version "
|
||
"[#plugindir]_. If that is not the problem,"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:202
|
||
msgid ""
|
||
"Yes, it used to be the same, but then we moved to using directories for "
|
||
"plugins instead of a single file. Apparently, that makes a difference to "
|
||
"Python."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:207
|
||
msgid "I've found a bug, what do I do?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:209
|
||
msgid "Submit your bug at our `issue tracker`_."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:212
|
||
msgid "Is Python installed?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:214
|
||
msgid ""
|
||
"I run Windows, and I'm not sure if Python is installed on my computer. How "
|
||
"can I find out for sure?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:217
|
||
msgid ""
|
||
"Python isn't commonly installed by default on Windows computers. If you "
|
||
"don't see it in your start menu somewhere, it's probably not installed."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:221
|
||
msgid ""
|
||
"The easiest way to find out if Python is installed is simply to `download "
|
||
"it`_ and try to install it. If the installer complains, you probably "
|
||
"already have it installed. If it doesn't, well, now you have Python "
|
||
"installed."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:227
|
||
msgid ""
|
||
"Can I make Supybot silent, but still working on channel (as titlesnarfer or "
|
||
"something)?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:229
|
||
msgid ""
|
||
"With lobotomy, the bot stops doing everything on the channel. If you want it "
|
||
"to not reply to commands, but still work as titlesnarfer or similar, you can "
|
||
"configure it to not respond to anything."
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:233
|
||
msgid "Globally::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:241
|
||
msgid "Or just for one channel::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:250
|
||
msgid "How to make a connection secure?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:252
|
||
msgid "First, you should make the bot use SSL for each network::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:256
|
||
msgid ""
|
||
"Then, you must update the server port for the network the bot connects to "
|
||
"(this is usually 6697, but some networks use a different one)::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:261
|
||
msgid ""
|
||
"In the previous command, you must of course replace `irc.network.com` with "
|
||
"the hostname of a server of the network. You could either check out the "
|
||
"network's website, or get the current one, with this command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:268
|
||
msgid "How to make Limnoria use Python 3 instead of Python 2?"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:270
|
||
msgid "First, uninstall Limnoria::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:274
|
||
msgid "Or, if you did not install Limnoria as root::"
|
||
msgstr ""
|
||
|
||
#: ../../use/faq.rst:278
|
||
msgid ""
|
||
"Then, follow the :ref:`install guide <use-install>`. In short, just run "
|
||
"this::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:5
|
||
msgid "Getting Started with Supybot"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:10
|
||
msgid ""
|
||
"Ok, so you've decided to try out Supybot. That's great! The more people "
|
||
"who use Supybot, the more people can submit bugs and help us to make it the "
|
||
"best IRC bot in the world :)"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:14
|
||
msgid ""
|
||
"You should have already read through our install document (if you had to "
|
||
"manually install) before reading any further. Now we'll give you a "
|
||
"whirlwind tour as to how you can get Supybot setup and use Supybot "
|
||
"effectively."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:19
|
||
msgid "Initial Setup"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:21
|
||
msgid ""
|
||
"Now that you have Supybot installed, you'll want to get it running. The "
|
||
"first thing you'll want to do is run supybot-wizard. Before running supybot-"
|
||
"wizard, you should be in the directory in which you want your bot-related "
|
||
"files to reside. The wizard will walk you through setting up a base config "
|
||
"file for your Supybot. Once you've completed the wizard, you will have a "
|
||
"config file called botname.conf. In order to get the bot running, run "
|
||
"``supybot botname.conf``."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:30
|
||
msgid "Listing Commands"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:32
|
||
msgid ""
|
||
"Ok, so let's assume your bot connected to the server and joined the channels "
|
||
"you told it to join. For now we'll assume you named your bot 'supybot' (you "
|
||
"probably didn't, but it'll make it much clearer in the examples that follow "
|
||
"to assume that you did). We'll also assume that you told it to join "
|
||
"#channel (a nice generic name for a channel, isn't it? :)) So what do you "
|
||
"do with this bot that you just made to join your channel? Try this in the "
|
||
"channel::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:41
|
||
msgid ""
|
||
"Replacing 'supybot' with the actual name you picked for your bot, of course. "
|
||
"Your bot should reply with a list of the plugins it currently has loaded. "
|
||
"At least `Admin`, `Channel`, `Config`, `Misc`, `Owner`, and `User` should be "
|
||
"there; if you used supybot-wizard to create your configuration file you may "
|
||
"have many more plugins loaded. The list command can also be used to list "
|
||
"the commands in a given plugin::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:50
|
||
msgid ""
|
||
"will list all the commands in the `Misc` plugin. If you want to see the "
|
||
"help for any command, just use the help command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:57
|
||
msgid ""
|
||
"Sometimes more than one plugin will have a given command; for instance, the "
|
||
"\"list\" command exists in both the Misc and Config plugins (both loaded by "
|
||
"default). List, in this case, defaults to the Misc plugin, but you may want "
|
||
"to get the help for the list command in the Config plugin. In that case, "
|
||
"you'll want to give your command like this::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:65
|
||
msgid ""
|
||
"Anytime your bot tells you that a given command is defined in several "
|
||
"plugins, you'll want to use this syntax (\"plugin command\") to disambiguate "
|
||
"which plugin's command you wish to call. For instance, if you wanted to "
|
||
"call the Config plugin's list command, then you'd need to say::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:72
|
||
msgid "Rather than just 'list'."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:75
|
||
msgid "Making Supybot Recognize You"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:77
|
||
msgid ""
|
||
"For making the bot to identify to services, please see :ref:`identifying to "
|
||
"services. <identifying-to-services>`"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:79
|
||
msgid ""
|
||
"If you ran the wizard, then it is almost certainly the case that you already "
|
||
"added an owner user for yourself. If not, however, you can add one via the "
|
||
"handy-dandy 'supybot-adduser' script. You'll want to run it while the bot "
|
||
"is not running (otherwise it could overwrite supybot-adduser's changes to "
|
||
"your user database before you get a chance to reload them). Just follow the "
|
||
"prompts, and when it asks if you want to give the user any capabilities, say "
|
||
"yes and then give yourself the 'owner' capability, restart the bot and "
|
||
"you'll be ready to load some plugins!"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:88
|
||
msgid ""
|
||
"Now, in order for the bot to recognize you as your owner user, you'll have "
|
||
"to identify with the bot."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:91
|
||
msgid ""
|
||
"Open up a query window in your irc client ('/query' should do it; if not, "
|
||
"just know that you can't identify in a channel because it requires sending "
|
||
"your password to the bot). Then type this::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:97
|
||
msgid ""
|
||
"And follow the instructions; the command you send will probably look like "
|
||
"this, with 'myowneruser' and 'myuserpassword' replaced::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:102
|
||
msgid ""
|
||
"The bot will tell you that 'The operation succeeded' if you got the right "
|
||
"name and password. Now that you're identified, you can do anything that "
|
||
"requires any privilege: that includes all the commands in the Owner and "
|
||
"Admin plugins, which you may want to take a look at (using the list and help "
|
||
"commands, of course). One command in particular that you might want to use "
|
||
"(it's from the User plugin) is the 'hostmask add' command: it lets you add a "
|
||
"hostmask to your user record so the bot recognizes you by your hostmask "
|
||
"instead of requiring you always to identify with it before it recognizes "
|
||
"you. Use the 'help' command to see how this command works. Here's how I "
|
||
"often use it::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:114
|
||
msgid ""
|
||
"You may not have seen that '[hostmask]' syntax before. Supybot allows "
|
||
"nested commands, which means that any command's output can be nested as an "
|
||
"argument to another command. The hostmask command from the Misc plugin "
|
||
"returns the hostmask of a given nick, but if given no arguments, it returns "
|
||
"the hostmask of the person giving the command. So the command above adds the "
|
||
"hostmask I'm currently using to my user's list of recognized hostmasks. I'm "
|
||
"only required to give mypassword if I'm not already identified with the bot."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:122
|
||
msgid ""
|
||
"It might often be better to specify the hostmask by yourself instead of "
|
||
"nesting the hostmask command as the hostmask command gives your exact "
|
||
"hostmask of that moment meaning ``nick!ident@host`` which means that you "
|
||
"will get unidentified if you change your nickname."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:127
|
||
msgid ""
|
||
"I (Mikaela) often specify hostmasks in two other forms depending on the "
|
||
"situation which I go through in next subtopics."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:131
|
||
msgid "Wildcard nick"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:133
|
||
msgid ""
|
||
"In case my username and host stay the same or there aren't bots on same "
|
||
"server which could get identified as me to other bots, I use::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:138
|
||
msgid ""
|
||
"I only recommend this if there is ident server configured and the IRC "
|
||
"network checks for it."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:142
|
||
msgid "Host only"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:144
|
||
msgid ""
|
||
"In case I am the only one who has the same host (cloaks/vhosts on many "
|
||
"networks which have account in them, (for example freenode) or server where "
|
||
"no one else has access and no bots share it either), I use::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:150
|
||
msgid ""
|
||
"Mycloak at freenode is usually in format ``unaffiliated/accountname``. You "
|
||
"can usually request hostmasks using HostServ, ``/msg HostServ help``, or "
|
||
"asking on help channel of your IRC network, in case of freenode that is "
|
||
"#freenode. OFTC is exception to this and uses ``/msg NickServ set cloak "
|
||
"on``, but whatever your network users, you can ask it on their help channel."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:158
|
||
msgid "Limnoria"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:160
|
||
msgid "Limnoria has two additional methods to identify. GPG and NickAuth."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:163
|
||
msgid "GPG"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:165
|
||
msgid ""
|
||
"First you must associate your GPG key with your Limnoria account. The gpg "
|
||
"add command takes two arguments, key id and key server."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:168
|
||
msgid ""
|
||
"My key is 0x0C207F07B2F32B67 and it's on keyserver pool.sks-keyservers.net "
|
||
"so and now I add it to my bot::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:174
|
||
msgid "Now I can get token to sign so I can identify::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:179
|
||
msgid "Then I follow the instructions and sign my token in terminal::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:183
|
||
msgid ""
|
||
"Note that I sent the output to curl with flags to directly send the "
|
||
"clearsigned content to sprunge.us pastebin. Curl should be installed on most "
|
||
"of distributions and comes with msysgit. If you remove the curl part, you "
|
||
"get the output to terminal and can pastebin it to any pastebin of your "
|
||
"choice. Sprunge.us has only plain text and is easy so I used it in this "
|
||
"example."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:190
|
||
msgid "And last I give the bot link to the plain text signature::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:196
|
||
msgid "NickAuth"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:198
|
||
msgid ""
|
||
"This requires you to load the NickAuth plugin (see next section of this page "
|
||
"for loading plugins)."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:201
|
||
msgid ""
|
||
"NickAuth allows you to identify to the bot using your NickServ account. "
|
||
"First I add my NickServ account name which I can see with \"/whois Mikaela "
|
||
"Mikaela\" (because my current nick is Mikaela). It gives me something like::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:206
|
||
msgid ""
|
||
"Now I tell the bot add my NickServ account Mikaela to my bot user on "
|
||
"freenode. The syntax is [<network>] <bot-username> <NickServ-account>::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:212
|
||
msgid ""
|
||
"Next time when I identify to NickServ I will get identified automatically if "
|
||
"the bot sees that I was identified when I joined. This requires server to "
|
||
"support extended-join and WHOX. Most of modern networks support them, but if "
|
||
"your bot is using some bouncer, it might not support them."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:217
|
||
msgid ""
|
||
"Automatic identification doesn't work always even when it's supported, but "
|
||
"when it fails, I can always use the NickAuth Auth command to identify to the "
|
||
"bot::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:227
|
||
msgid "Loading Plugins"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:229
|
||
msgid ""
|
||
"Let's take a look at loading other plugins. If you didn't use supybot-"
|
||
"wizard, though, you might do well to try it before playing around with "
|
||
"loading plugins yourself: each plugin has its own configure function that "
|
||
"the wizard uses to setup the appropriate registry entries if the plugin "
|
||
"requires any."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:234
|
||
msgid ""
|
||
"If you do want to play around with loading plugins, you're going to need to "
|
||
"have the owner capability."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:237
|
||
msgid ""
|
||
"Remember earlier when I told you to try ``help load``? That's the very "
|
||
"command you'll be using. Basically, if you want to load, say, the Games "
|
||
"plugin, then ``load Games``. Simple, right? If you need a list of the "
|
||
"plugins you can load, you'll have to list the directory the plugins are in "
|
||
"(using whatever command is appropriate for your operating system, either "
|
||
"'ls' or 'dir')."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:244
|
||
msgid "Understanding the help syntax"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:246
|
||
msgid ""
|
||
"The syntax of a command describes how to run a command. The syntax is given "
|
||
"by the help command. Some examples:"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:263
|
||
msgid "help [<plugin>] [<command>]"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:251
|
||
msgid "This is the help of :ref:`command-plugin-help`."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:253
|
||
msgid ""
|
||
"The chevrons mean you have to replace <plugin> and <command> by a plugin "
|
||
"name and a command name."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:256
|
||
msgid "The brackets mean the argument they wrap is **optional**."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:258
|
||
msgid "So, the fellowing commands are correct::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:268
|
||
msgid "ping takes no arguments"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:266
|
||
msgid "This is the help for :ref:`command-misc-ping`."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:268
|
||
msgid "I think it is clear enough."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:278
|
||
msgid "join <channel> [<key>]"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:271
|
||
msgid "This is the help for :ref:`command-admin-join`."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:273
|
||
msgid "It requires a channel name, and the channel key is optional."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:275
|
||
msgid "This two commands are ok::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:286
|
||
msgid "utilities last <text> [<text> ...]"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:281
|
||
msgid ""
|
||
"This is the help for :ref:`command-utilities-last`. By the way, there is "
|
||
"another ``last`` command in the `Misc` plugin, which doesn't do the same "
|
||
"thing, that's why you need to give the plugin name."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:285
|
||
msgid ""
|
||
"You have to give at least one argument, but you can give as many as you wish."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:289
|
||
msgid "Getting More From Your Supybot"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:291
|
||
msgid ""
|
||
"Another command you might find yourself needing somewhat often is the 'more' "
|
||
"command. The IRC protocol limits messages to 512 bytes, 60 or so of which "
|
||
"must be devoted to some bookkeeping. Sometimes, however, Supybot wants to "
|
||
"send a message that's longer than that. What it does, then, is break it "
|
||
"into \"chunks\" and send the first one, following it with ``(X more "
|
||
"messages)`` where X is how many more chunks there are. To get to these "
|
||
"chunks, use the `more` command. One way to try is to look at the default "
|
||
"value of `supybot.replies.genericNoCapability` -- it's so long that it'll "
|
||
"stretch across two messages::"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:317
|
||
msgid ""
|
||
"So basically, the bot keeps, for each person it sees, a list of \"chunks\" "
|
||
"which are \"released\" one at a time by the `more` command. In fact, you "
|
||
"can even get the more chunks for another user: if you want to see another "
|
||
"chunk in the last command jemfinch gave, for instance, you would just say "
|
||
"`more jemfinch` after which, his \"chunks\" now belong to you. So, you "
|
||
"would just need to say `more` to continue seeing chunks from jemfinch's "
|
||
"initial command."
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:327
|
||
msgid ""
|
||
"You should now have a solid foundation for using Supybot. You can use the "
|
||
"`list` command to see what plugins your bot has loaded and what commands are "
|
||
"in those plugins; you can use the 'help' command to see how to use a "
|
||
"specific command, and you can use the 'more' command to continue a long "
|
||
"response from the bot. With these three commands, you should have a strong "
|
||
"basis with which to discover the rest of the features of Supybot!"
|
||
msgstr ""
|
||
|
||
#: ../../use/getting_started.rst:334
|
||
msgid ""
|
||
"Do be sure to read our other documentation and make use of the resources we "
|
||
"provide for assistance; this website and, of course, #supybot on irc."
|
||
"freenode.net if you run into any trouble!"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:3
|
||
msgid "Using the HTTP server"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:8
|
||
msgid "The HTTP server comes with a couple of additional variables:"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:10
|
||
msgid ""
|
||
":ref:`supybot.servers.http.favicon`: Path to the file which is shown to "
|
||
"browsers as favicon."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:12
|
||
msgid ""
|
||
":ref:`supybot.servers.http.hosts4`: The IPv4 addresses where the bot will "
|
||
"bind. In most of the cases, you will use 0.0.0.0 (everything) or 127.0.0.1 "
|
||
"(restricted to local connections). Defaults to 0.0.0.0"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:15
|
||
msgid ""
|
||
":ref:`supybot.servers.http.hosts6`: The IPv6 addresses where the bot will "
|
||
"bind. Defaults to empty."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:17
|
||
msgid ""
|
||
":ref:`supybot.servers.http.keepAlive`: Determines whether the HTTP server "
|
||
"will run even if has nothing to serve. Defaults to False, because the daemon "
|
||
"might require changing the port, if it is already taken."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:20
|
||
msgid ""
|
||
":ref:`supybot.servers.http.port`: The port the bot will bind. May not work "
|
||
"if the number is below 1024. Defaults to 8080 (alternative HTTP port)."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:25
|
||
msgid "Using the server"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:27
|
||
msgid ""
|
||
"At the root of the server, you will find a list of the plugins that have a "
|
||
"Web interface, and a link to them. Each plugin has one or more "
|
||
"subdirectories of its own."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:31
|
||
msgid ""
|
||
"You may also want to run Apache httpd or Nginx in front of Supybot's HTTP "
|
||
"server, if you want to use subdomains or load balancing."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:34
|
||
msgid ""
|
||
"Here is an example of Apache httpd configuration (I didn't test it with the "
|
||
"rewrite, please notify me whether it works or not):"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:48
|
||
msgid ""
|
||
"Here is an example of the Nginx configuration. Create a new site ``/etc/"
|
||
"nginx/sites-enabled/bot``:"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:67
|
||
msgid ""
|
||
"Note that any HTTP server which can provide a reverse proxy service can be "
|
||
"configured to act as an intermediary or front end for the Limnoria HTTP "
|
||
"server. Configuring these alternatives is left as an exercise to the system "
|
||
"administrator (who ought to be familiar enough with it already)."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:75
|
||
msgid "Templates"
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:77
|
||
msgid ""
|
||
"Among the plugins which use the HTTP server, some use the standard templates "
|
||
"system which allows you to edit page templates in a standard way (for other "
|
||
"plugins, check their documentation)."
|
||
msgstr ""
|
||
|
||
#: ../../use/httpserver.rst:81
|
||
msgid ""
|
||
"Templates are located in the `data/web/` folder. There is a folder per "
|
||
"plugin (and a `generic` folder, which holds generic pages), and all file "
|
||
"names end with `.example`, which is the default template provided by the "
|
||
"plugin. To customize it, rename it to remove `.example` (for instance: ``mv "
|
||
"fooplugin/foopage.html.example fooplugin/foopage.html``) and edit it (either "
|
||
"do it intuitively or check the plugin documentation to see how it handles "
|
||
"its templates)."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:5
|
||
msgid "Identifying the bot to services"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:7
|
||
msgid ""
|
||
"The different methods listed here are in the order how they are usually "
|
||
"recommended by network operators."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:10
|
||
msgid ""
|
||
"Please also note that SASL and CertFP are only fully supported on Limnoria. "
|
||
"Gribble has imported partial SASL support (only PLAIN)."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:14
|
||
msgid "Registering to services"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:16
|
||
msgid ""
|
||
"You can safely jump over this section if your bot is already registered to "
|
||
"services."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:19
|
||
msgid ""
|
||
"First start by checking what is the syntax for registering with ``/msg "
|
||
"nickserv help register``. It returns you something like this (Atheme 7.2.4)::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:25
|
||
msgid "Assuming that that is the syntax, we can register the bot with::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:29
|
||
msgid ""
|
||
"Note that the email address must be correct. Next check that ``/msg nickserv "
|
||
"info bot`` doesn't say something about being unverified. If it does, go to "
|
||
"the email address and run::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:35
|
||
msgid ""
|
||
"Now your bot should be successfully registered and you can move to setting "
|
||
"up automatic identifying below. If you need to identify to services now, ``/"
|
||
"msg nickserv help identify`` and following the syntax (I am still assuming "
|
||
"that you are on Atheme 7.2.4) ``owner ircquote nickserv identify username "
|
||
"password``."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:42
|
||
msgid "SASL PLAIN"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:44
|
||
msgid ""
|
||
"*To use SASL EXTERNAL, you must only configure CertFP and it's attempted "
|
||
"automatically.* SASL PLAIN is identifying using username and password, SASL "
|
||
"EXTERNAL is identifying by using CertFP which is explained later on this "
|
||
"document. It doesn't need username or password to be configured."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:49
|
||
msgid ""
|
||
"Note that SASL isn't supported on all networks. As the only way to check if "
|
||
"SASL is supported is either ``/quote CAP LS`` (which usually gets eaten by "
|
||
"bouncers) or connecting to the network and seeing if it works, we recommend "
|
||
"always configuring SASL and whoising the bot to see if it worked. If it "
|
||
"didn't work, you might want to ask the network operators about their SASL "
|
||
"support and request them to start supporting it."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:56
|
||
msgid ""
|
||
"SASL is widely agreed as the best method to identify to services as it "
|
||
"identifies you before anyone (other than IRC operators) can see that you are "
|
||
"connected. To enable SASL, simply::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:63
|
||
msgid ""
|
||
"where you of course replace AccountName and P455w0rd with your actual "
|
||
"NickServ account name and password. Remember to replace ``<network>`` with "
|
||
"the real network name like ``freenode``."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:68
|
||
msgid "CertFP"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:70
|
||
msgid ""
|
||
"You can test if CertFP is supported by services simply by doing ``/msg "
|
||
"NickServ cert``. If you get an error about \"Insufficient parameters for CERT"
|
||
"\", CertFP is supported, and if you get an error about unknown command, it's "
|
||
"not supported."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:75
|
||
msgid ""
|
||
"CertFP identifies you to services using a client (SSL) certificate and "
|
||
"naturally requires an SSL connection. It doesn't identify you as soon as "
|
||
"SASL, but unlike SASL, it identifies you even when services return from a "
|
||
"netsplit, unlike any other mechanism."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:80
|
||
msgid ""
|
||
"First you must generate a certificate, and the easiest method is probably "
|
||
"using OpenSSL which you should have even on Windows if you installed with "
|
||
"pip::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:85
|
||
msgid ""
|
||
"Now you should have a ``<BOT>.pem`` file in the directory where you ran the "
|
||
"command, presumably your home directory and you only tell your bot where to "
|
||
"find it and tell NickServ that it belongs to you. Note that you should "
|
||
"replace ``<BOT>`` with the account name of your bot."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:90
|
||
msgid "You have two choices, using the same certificate on all networks::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:94
|
||
msgid "or only on one or more network where it's manually configured::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:98
|
||
msgid ""
|
||
"And lastly, you must tell the services what is your certificate fingerprint, "
|
||
"which you can find out with::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:103
|
||
msgid ""
|
||
"This results in something like ``05dd01fedc1b821b796d0d785160f03e32f53fa8`` "
|
||
"which you tell your bot to tell services::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:109
|
||
msgid "Or if your bot identifies as you, you can do that by yourself with::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:114
|
||
msgid ""
|
||
"Remember to replace ``05dd01fedc1b821b796d0d785160f03e32f53fa8`` with your "
|
||
"own fingerprint! Next time your bot connects, it should get identified "
|
||
"automatically."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:119
|
||
msgid "SASL ECDSA-NIST256P-CHALLENGE"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:121
|
||
msgid "First you must ECDSA key for the bot to use::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:125
|
||
msgid "and get the public key using::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:129
|
||
msgid ""
|
||
"After getting the public key, you must tell your bot to use it and tell "
|
||
"services about it (just like with CertFP/SASL EXTERNAL)::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:136
|
||
msgid ""
|
||
"and after reconnecting, the bot should successfully identify using SASL "
|
||
"ECDSA-NIST256P-CHALLENGE."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:139
|
||
msgid ""
|
||
"*NOTE:* You can use ``ecdsa pubkey`` to get the public key, but you cannot "
|
||
"generate the key pair using it as pyecdsa doesn't support ecdsatool "
|
||
"generated keys."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:144
|
||
msgid "Server password"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:146
|
||
msgid ""
|
||
"Many networks support identifying using ``username:password`` as server "
|
||
"password. If this is the case with your network (anything that uses a "
|
||
"charybdis-like IRCd), this should work for you. Note that this identifies "
|
||
"you after SASL so, your real host might be seen. To do this, simply::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:153
|
||
msgid ""
|
||
"Replace ``<network>`` with the name of network, for example ``freenode`` and "
|
||
"username:password with your real username and password."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:157
|
||
msgid "ZNC"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:159
|
||
msgid "If you wish to connect your bot to ZNC, the recommended way is::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:164
|
||
msgid ""
|
||
"The identifier is free text to describe which client your Limnoria is. It "
|
||
"came with ZNC 1.6.0 and is completely optional. ``<network>`` again has been "
|
||
"there since ZNC 1.0 which is very old and has multiple security issues that "
|
||
"have been fixed since then. You should always run the latest release."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:170
|
||
msgid "Services plugin"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:172
|
||
msgid ""
|
||
"The Services plugin comes with Supybot and should be an easy way to identify "
|
||
"your bot, but SASL and ``username:password`` as server password are "
|
||
"recommended over it. Start by loading Services with::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:178
|
||
msgid "and then tell it what NickServ and ChanServ are called::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:183
|
||
msgid ""
|
||
"Remember to replace NickServ/ChanServ with their real names if they have a "
|
||
"different name on any network. Note that they must have the same name on all "
|
||
"networks, and you must have the same password on all networks."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:187
|
||
msgid "Now you can set your password::"
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:191
|
||
msgid ""
|
||
"makes the bot attempt identifying as Bot using password P455w0rd. Replace "
|
||
"them with your real nickname and password. Note that if you have multiple "
|
||
"nicknames, you must run ``services password`` for them all."
|
||
msgstr ""
|
||
|
||
#: ../../use/identifying_to_services.rst:195
|
||
msgid ""
|
||
"If your bot happens to get a nickname that isn't configured, it won't know "
|
||
"how to identify. You might be able to avoid this issue by loading "
|
||
"NickCapture, (``load NickCapture``) which attempts to regain the primary "
|
||
"nick, when it's possible, and when it regains the primary nick, the "
|
||
"identification should work."
|
||
msgstr ""
|
||
|
||
#: ../../use/index.rst:5
|
||
msgid "The Supybot user guide"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:7
|
||
msgid "Installing Limnoria"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:9
|
||
msgid ""
|
||
"This is the \"easy to follow\" guide to installing Limnoria. The "
|
||
"installation documentation provided with the supybot distribution is really "
|
||
"quite good already, but since people keep coming to IRC, asking a repeating "
|
||
"pattern of questions, we thought it would be a good idea to expand it a bit "
|
||
"to make it a little more of a \"foolproof guide\"."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:17
|
||
msgid "Limnoria is a modified version of Supybot."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:20
|
||
msgid "Dependencies"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:22
|
||
msgid ""
|
||
"The only mandatory dependency is `Python`_ 2.6 or greater. However, it is "
|
||
"highly recommended you use Python 3.4 or greater."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:25
|
||
msgid ""
|
||
"You may also install chardet and feedparser, which are used by Limnoria if "
|
||
"they are available."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:28
|
||
msgid ""
|
||
"The remaining of this guide will assume you have Python 3. If you don't, "
|
||
"replace `python3` by `python` in the given commands"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:34
|
||
msgid "Installation: UNIX/Linux/BSD"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:37 ../../use/install.rst:157
|
||
msgid "Install Python"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:39
|
||
msgid ""
|
||
"Python will usually come by installed by default in your distribution. If "
|
||
"not, grab the appropriate packages from the distribution's repository."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:42
|
||
msgid ""
|
||
"If you're installing Python using your distribution's packages, you may need "
|
||
"a ''python-dev'' or ''python-devel'' package installed, too. To see if this "
|
||
"is the case, open up a terminal, start python, and run:"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:50
|
||
msgid ""
|
||
"If it works, you're good to go. Otherwise, install the `python3-dev` or "
|
||
"`python3-devel` package and try again."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:53
|
||
msgid ""
|
||
"You may also install \"manually\" by downloading the source archive from "
|
||
"http://python.org, and compiling it. That is outside the scope of this "
|
||
"guide, however."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:58
|
||
msgid "Install Limnoria"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:60
|
||
msgid ""
|
||
"In the next section of this guide we will use `pip`_, which is a generic way "
|
||
"of installing Python software."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:63
|
||
msgid ""
|
||
"There are some :ref:`alternative install methods <alternative-install>` at "
|
||
"the bottom of this guide, if you don't want to use `pip`."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:69
|
||
msgid "Global installation (with root access)"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:71
|
||
msgid "If you do not have root access, skip this section."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:73
|
||
msgid ""
|
||
"If you are logged in as root, you can remove ``sudo`` from the install "
|
||
"commands."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:76
|
||
msgid ""
|
||
"*In case you want to use the testing branch which might be more up-to date "
|
||
"BUT LESS TESTED, replace ``master`` with ``testing`` in the commands.*"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:79
|
||
msgid ""
|
||
"First we install Limnoria's optional dependencies (you can skip this step, "
|
||
"but some features won't be available)::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:84
|
||
msgid "And then Limnoria itself::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:88
|
||
msgid ""
|
||
"If you have an error saying `No module named pip`, install `pip` using your "
|
||
"package manager (the package is usually named `python3-pip`)."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:92
|
||
msgid "Local installation (without root access)"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:94
|
||
msgid "If you have followed the previous section, skip this one."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:96
|
||
msgid ""
|
||
"Simply add ``--user`` to the end of both commands. First we install "
|
||
"requirements (you can skip it, but some features won't be available) and "
|
||
"then Limnoria itself.::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:103
|
||
msgid "You might need to add $HOME/.local/bin to your PATH.::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:108
|
||
msgid ""
|
||
"If you have an error saying `No module named pip`, install `pip` using this "
|
||
"guide: https://pip.pypa.io/en/stable/installing/"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:112
|
||
msgid "Configure Supybot"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:114
|
||
msgid ""
|
||
"We are now ready to configure Supybot. Supybot creates quite a few auxiliary "
|
||
"files/directories to store its runtime data. It is thus recommended to "
|
||
"create an empty directory from which you'll be running supybot, to keep all "
|
||
"the data in a nice dedicated location. For example, you may create a "
|
||
"'runbot' directory inside your home directory."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:120
|
||
msgid ""
|
||
"Now you can cd to your 'runbot' directory, and from within it run ``supybot-"
|
||
"wizard``, which will walk you through a series of questions to generate the "
|
||
"bot config file."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:124
|
||
msgid ""
|
||
"One thing to make sure to do in the wizard, to make your life easier down "
|
||
"the line, is to select **y** for the *Would you like to add an owner user "
|
||
"for your bot?* question, and actually create the owner user. Remember that "
|
||
"password, so that you can later ''identify'' with the bot on IRC and "
|
||
"administer it."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:129
|
||
msgid ""
|
||
"Once you generate the config file, which will be named ``yourbotnick.conf`` "
|
||
"(where \"yourbotnick\" is the nick you have chosen for your bot in the "
|
||
"wizard), it will be placed in your 'runbot' directory. (As long as you leave "
|
||
"the default answer to the ''Where would you like to create these "
|
||
"directories?'' question.)"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:134
|
||
msgid "Now to start the bot, run, still from within the 'runbot' directory::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:138 ../../use/install.rst:234
|
||
msgid "And watch the magic!"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:140
|
||
msgid ""
|
||
"For a tutorial on using and managing the bot from here on, see the "
|
||
"`Supybook`_."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:145
|
||
msgid "Installation: OS X"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:147
|
||
msgid ""
|
||
"The steps are essentially the same as those of the previous section, except "
|
||
"there are no repositories. Grab the latest python installer for OS X from "
|
||
"http://python.org, and follow the rest of the steps."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:152
|
||
msgid "Installation: Windows"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:159
|
||
msgid ""
|
||
"Download the latest **Python 3** installer from https://www.python.org, "
|
||
"3.5.1, as of 2016-01-26) and run it to install Python."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:162
|
||
msgid ""
|
||
"Installing Python is mostly clicking next, but in the next screen remember "
|
||
"the destination directory where you installed Python. These instructions "
|
||
"refer to it as ``C:\\Python35\\`` which is the current name on 2016-01-26."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:166
|
||
msgid ""
|
||
"Then you are asked to customize your installation. Click the drive on left "
|
||
"side of \"Python\" text and select \"Entire feature will be installed on "
|
||
"local hard drive\"."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:170
|
||
msgid "Now Python installs itself which may take several minutes."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:172
|
||
msgid ""
|
||
"Python should be now installed and you can check that the \"python\" command "
|
||
"points to correct python. Open ``cmd.exe`` (press the Windows button on your "
|
||
"keyboard and type \"cmd.exe\") and run ``where python`` and the toppernmost "
|
||
"entry should be ``C:\\Python35\\python.exe``."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:178
|
||
msgid "Install git"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:180
|
||
msgid ""
|
||
"In order to install the latest Limnoria from the git repository, you need "
|
||
"git in your %PATH%. You can get it from http://git-scm.com/."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:183
|
||
msgid ""
|
||
"In the \"Adjusting your PATH environment\", select the last option, \"Use "
|
||
"Git and optional Unix tools from the Windows Command Prompt\" or you will "
|
||
"have issues in the next step."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:188
|
||
msgid "Install Supybot"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:190
|
||
msgid ""
|
||
"Now we are ready to install Limnoria and it's requirements. Open ``cmd.exe`` "
|
||
"as **Administrator** (right click it in the previous place) and run::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:197
|
||
msgid ""
|
||
"We are now ready to configure Supybot. Supybot creates quite a few auxiliary "
|
||
"files/directories to store its runtime data. It is thus recommended to "
|
||
"create an empty directory from which you'll be running supybot, to keep all "
|
||
"the data in a nice dedicated location. For example, you may create a ``C:"
|
||
"\\Users\\<username>\\runbot`` for this purpose."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:204
|
||
msgid ""
|
||
"Now you open cmd.exe as **normal user**, and create and cd into your runbot "
|
||
"directory::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:210
|
||
msgid "and from within it run ``supybot-wizard``::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:214
|
||
msgid ""
|
||
"which will walk you through a series of questions to generate the bot config "
|
||
"file."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:217
|
||
msgid ""
|
||
"One thing to make sure to do in the wizard, to make your life easier down "
|
||
"the line, is to select *y* for the *Would you like to add an owner user for "
|
||
"your bot?* question, and actually create the owner user. Remember that "
|
||
"password, so that you can later ''identify'' with the bot on IRC and "
|
||
"administer it."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:223
|
||
msgid ""
|
||
"Once you generate the config file, which will be named ``yourbotnick.conf`` "
|
||
"(where ``yourbotnick`` is the nick you have chosen for your bot in the "
|
||
"wizard), it will be placed in your ``runbot`` directory. (As long as you "
|
||
"leave the default answer to the *Where would you like to create these "
|
||
"directories?* question.)"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:229
|
||
msgid ""
|
||
"Now to start the bot, run, still from within the ``C:\\users\\<username>"
|
||
"\\runbot`` directory::"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:236
|
||
msgid ""
|
||
"This guide has been mainly written by nanotube (Daniel Folkinshteyn), and is "
|
||
"licensed under the Creative Commons Attribution ShareAlike 3.0 Unported "
|
||
"license and/or the GNU Free Documentation License v 1.3 or later."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:247
|
||
msgid "Alternative install methods"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:249
|
||
msgid ""
|
||
"If you know what you are doing and you don't want to use pip, you can use "
|
||
"one of these methods:"
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:252
|
||
msgid "Download a .deb or .rpm package at `ProgVal's build repo`_."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:253
|
||
msgid ""
|
||
"Use `git`_ to clone the `Limnoria repository`_ and follow the instructions "
|
||
"in `Limnoria's README.md`_."
|
||
msgstr ""
|
||
|
||
#: ../../use/install.rst:255
|
||
msgid ""
|
||
"Click the \"Download ZIP\" button at the `Limnoria repository`_. Then, "
|
||
"extract the zipball to some temporary directory, and ``cd`` into the "
|
||
"`Limnoria-master` directory which contains the extracted code."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:3
|
||
msgid "Security in Limnoria"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:5
|
||
msgid ""
|
||
"Some security features are disabled by default. We know this is arguable, "
|
||
"but enabling them would make it quite hard to start using the bot. This "
|
||
"guide is for people who want to enable these features to make their bot as "
|
||
"secure as possible."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:13
|
||
msgid ""
|
||
"Limnoria (or Gribble or Supybot) have never been audited by a security "
|
||
"professional. We do the best we can to make it secure, but we cannot "
|
||
"guarantee it is completely safe."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:19
|
||
msgid "Trust in network operators"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:21
|
||
msgid ""
|
||
"As you may know, it is possible to do anything from IRC, including loading "
|
||
"the Unix plugin and using the `@call` command. The only safeguard is "
|
||
"checking the user calling the commands is authenticated as the owner of the "
|
||
"bot; and network operators are able to spoof hostmasks and collect your "
|
||
"password, thus allowing them to execute commands as the owner."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:28
|
||
msgid ""
|
||
"Although network operators of most well-known IRC networks are not known to "
|
||
"do that, you should be aware of that risk."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:35
|
||
msgid "Network connections / SSL"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:38
|
||
msgid "Background on SSL certification validation"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:40
|
||
msgid ""
|
||
"It is often believed using SSL magically makes impossible any attack on your "
|
||
"connection (from the bot to the server). It is true that it prevents passive "
|
||
"eavesdropping, but other attack methods are still possible."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:45
|
||
msgid ""
|
||
"The main one involves man-in-the-middle, ie. someone acting as a proxy "
|
||
"between you (your bot, in that case) and the IRC network. If certificates "
|
||
"are not validated, the attacker can allow you to connect to itself using "
|
||
"their own SSL certificate, and you would never know about it."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:50
|
||
msgid ""
|
||
"This is why it is important to check the SSL certificate of the server you "
|
||
"connect to: an attacker cannot spoof a certificate, or the trust of a "
|
||
"Certificate Authority in a network's certificates."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:54
|
||
msgid ""
|
||
"Of course, this assumes there is no bug in your SSL library, the network's, "
|
||
"and the protocols involved."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:58
|
||
msgid "Certificate validation in Limnoria"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:60
|
||
msgid ""
|
||
"Until version 2016.02.24, Limnoria did not support certificate validation. "
|
||
"Starting from this version, it is possible, but disabled by default, in "
|
||
"order to not break existing bot when updating."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:64
|
||
msgid "Certificate validation can be enabled using this command::"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:68
|
||
msgid ""
|
||
"Available validation mechanisms are Certification Authorities and "
|
||
"fingerprint checking."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:72
|
||
msgid "Certificate Authorities"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:74
|
||
msgid ""
|
||
"By default, Limnoria only checks certificates using CA certificates "
|
||
"installed on your system. However, some networks use a CA that is not "
|
||
"trusted by your system, such as CACert."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:78
|
||
msgid "Limnoria allows you to add a CA certificate for a network::"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:82
|
||
msgid ""
|
||
"Note that you are responsible for making sure this is the right certificate "
|
||
"for the CA, and trust this CA to sign correctly certificates valid for the "
|
||
"network's hostname(s)."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:88
|
||
msgid "Fingerprint checking"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:90
|
||
msgid ""
|
||
"Alternatively, for networks that do not use a CA, you can give Limnoria the "
|
||
"list of fingerprints of certificates used by the network::"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:95
|
||
msgid ""
|
||
"Adding fingerprints will disable CA verifications (useful if you do not want "
|
||
"to trust CAs)."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:98
|
||
msgid ""
|
||
"Note that you are responsible for giving the correct list of fingerprints."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:103
|
||
msgid "Supported python versions"
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:105
|
||
msgid "Fingerprint checking is available in all Python versions."
|
||
msgstr ""
|
||
|
||
#: ../../use/security.rst:107
|
||
msgid ""
|
||
"CA validation is available in Python 2, starting on 2.7.9; and Python 3, "
|
||
"starting on 3.4."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:5
|
||
msgid "Restarting the bot automatically"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:7
|
||
msgid ""
|
||
"This page documents the different ways to automatically restart your bot in "
|
||
"case of crash or system reboot or anything that can make the bot quit."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:10
|
||
msgid "Note that you only need to use one."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:13
|
||
msgid "supybot-botchk"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:15
|
||
msgid ""
|
||
"supybot-botchk is a script that comes with Supybot which restarts the bot if "
|
||
"it quits or system reboots or anything that causes the bot to quit. It's "
|
||
"placed to crontab so cron will run it with scheduled intervals."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:20
|
||
msgid "How to use it?"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:23
|
||
msgid "Configuring the bot"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:25
|
||
msgid ""
|
||
"Start by telling your bot to write a pidfile somewhere where it can write "
|
||
"and restart the bot. For example::"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:30
|
||
msgid ""
|
||
"where <username> is replaced with the system username and <bot> is replaced "
|
||
"with the name of the bot."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:34
|
||
msgid "crontab"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:36
|
||
msgid ""
|
||
"After the pidfile is configured, you can modify crontab. First you should "
|
||
"copy the output of::"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:41
|
||
msgid ""
|
||
"and open crontab with ``EDITOR=nano crontab -e`` and paste the output of "
|
||
"previous command to the first lines which don't have comments. This should "
|
||
"be on top. You will probably also want to configure locale and timezone "
|
||
"which happens by adding the following lines::"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:58
|
||
msgid "NOTE: Lines starting with # are comments and don't need to be written."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:60
|
||
msgid ""
|
||
"Now you finally add the bot. If you have multiple bots, simply add separate "
|
||
"lines for them all::"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:65
|
||
msgid ""
|
||
"If you needed to use diferent environment for other bot, you could specify "
|
||
"that on the same line. For example, my other bot uses en_US.utf8 as locale "
|
||
"and UTC as timezone::"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:71
|
||
msgid ""
|
||
"Note that environment doesn't need to be specified on supybot-botchk line "
|
||
"unless it differs from globally specified environment which we added as the "
|
||
"first thing to crontab."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:75
|
||
msgid ""
|
||
"Now you can save the crontab by pressing ``CTRL + O`` answering ``y`` and "
|
||
"then quitting nano with ``CTRL + X``."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:78
|
||
msgid ""
|
||
"If you are wondering what ``*/5 * * * *`` means, it simply means \"run this "
|
||
"every five minutes every day\". The 5 can be replaced with any other number "
|
||
"and there are also ``@hourly`` etc. which can be used on it's place, but you "
|
||
"most likely won't want to wait hour or more if your bot crashes."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:84
|
||
msgid "systemd service"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:86
|
||
msgid ""
|
||
"You need root access as no one has got this to work as user service yet. You "
|
||
"must also use systemd as your init."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:89
|
||
msgid ""
|
||
"Create a new file ``/etc/systemd/system/<BOTNAME>.service`` with the "
|
||
"following content replacing things were suitable::"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:107
|
||
msgid ""
|
||
"Now you should run ``systemctl daemon-reload`` to make systemd aware of "
|
||
"changed files and ``systemctl enable <BOTNAME>.service`` to make the bot "
|
||
"start on boot etc. and ``systemctl start <BOTNAME>.service`` to start the "
|
||
"bot."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:112
|
||
#, python-format
|
||
msgid ""
|
||
"Remember to check the ``Ènvironment`` line. You can get your PATH with "
|
||
"``printf 'PATH=%s\\n' \"$PATH\"``."
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:116
|
||
msgid "Some commands"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:118
|
||
msgid "autostart on boot: ``systemctl enable <BOTNAME>.service``"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:119
|
||
msgid "disable autostart on boot: ``systemctl disable <BOTNAME>.service``"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:120
|
||
msgid "start the bot: ``systemctl start <BOTNAME>.service``"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:121
|
||
msgid "stop the bot: ``systemctl stop <BOTNAME>.service``"
|
||
msgstr ""
|
||
|
||
#: ../../use/supybot-botchk.rst:122
|
||
msgid "reload config files: ``systemctl reload <BOTNAME>.service``"
|
||
msgstr ""
|