# HG changeset patch # User Myhailo Danylenko # Date 1494784680 -10800 # Node ID 1e57279b82b1b47e7cf5ab9c6b6deb61b165523e # Parent eff7327bcabe7b9e7c2d8709243a9c2e262349eb Add wiki content diff -r eff7327bcabe -r 1e57279b82b1 Buildbot.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Buildbot.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,44 @@ + +From the Buildbot project page: + +> The BuildBot is a system to automate the compile/test cycle required by most +> software projects to validate code changes. By automatically rebuilding and +> testing the tree each time something has changed, build problems are +> pinpointed quickly, before other developers are inconvenienced by the failure. +> The guilty developer can be identified and harassed without human +> intervention. By running the builds on a variety of platforms, developers who +> do not have the facilities to test their changes everywhere before checkin +> will at least know shortly afterwards whether they have broken the build or +> not. Warning counts, lint checks, image size, compile time, and other build +> parameters can be tracked over time, are more visible, and are therefore +> easier to improve. +> +> The overall goal is to reduce tree breakage and provide a platform to run +> tests or code-quality checks that are too annoying or pedantic for any human +> to waste their time with. Developers get immediate (and potentially public) +> feedback about their changes, encouraging them to be more careful about +> testing before checkin. + +The webstatus display of mcabber buildbot is available at + there are several views accessible on the page +showing information about current and past builds. Command output is logged so +if there is a build problem You will be able to see the log files directly via +the web interface. + +Anyone can join the buildbot farm. If You are interested in commiting Your +resources to make sure that mcabber compiles across a wider range of platforms +then please contact me via email at or jabber +[mulander@uaznia.net](xmpp:mulander@uaznia.net). + +Contact mulander if You notice any problems with the Buildbot or the appropriate +administrator if the problem relates to a specific Build slave. + +For now mcabber doesn't have any tests that the bot could automatically run but +it's planned to add some in the long run. + +The mcabber-lm repository was setup first as it is supposed to be merged soon +into the official repository. If time allows more build slaves will be setup for +other forks of the project. + +This page will be constantly updated with more specific details. + diff -r eff7327bcabe -r 1e57279b82b1 Building_mcabber_from_Mercurial.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Building_mcabber_from_Mercurial.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,52 @@ +[[!meta title="Bulding MCabber from Sources"]] + +A short explanation on how to use Mercurial to keep up-to-date with the latest +development version of mcabber. More info on Mercurial can be found on +. + +[[!toc]] + +# Download + +First, clone the Mercurial reporitory: + + % hg clone http://mcabber.com/hg/ mcabber-hg + +# Prepare + +Go into the `mcabber` directory, and build the `configure` script (you will need +the _autotools_ software installed): + + % cd mcabber-hg/mcabber + % ./autogen.sh + +Now you can use the configure script, as usual. You can use `--enable-hgcset` to +add the Mercurial changeset to mcabber's version string. + + % ./configure --enable-hgcset + +If you want to install in your own home-directory instead of system-wide, append +`--prefix=$HOME`: + + % ./configure --enable-hgcset --prefix=$HOME + +# Compile + +To compile the source code, run: + + % make + +And to install it (you will probably need to be root to do this if you are doing +a system-wide installation): + + % make install + +# Update + +If you want to update mcabber source code later, just pull from the repository, +update and compile again: + + % hg pull -u + % make + % make install + diff -r eff7327bcabe -r 1e57279b82b1 Chat_Mode.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Chat_Mode.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,17 @@ + +# Introduction to Chat Mode + +Enter **Chat Mode** to open the messages buffers. + +When the _chat mode_ is disabled, the current conversation is hidden, and moving +in the roster won't open every buffers and won't set the "unread" messages as +read. (As a consequence, it will be much faster...) + +The _chat mode_ allows jumping between the few buddies with whom you are +conversing with the `/roster alternate` command described in the manual page +(and online help), without having to manually scroll back and forth. + +Use `Enter` to enable _chat mode_ and `Escape` to disable it. _Please note that +there is a delay after pressing `Esc`, so you have to wait a little before +pressing another key_. + diff -r eff7327bcabe -r 1e57279b82b1 FAQ.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/FAQ.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,75 @@ + +[[!meta title="Frequently Asked Questions"]] + +MCabber won't connect. It says `jab_start: SSL negotiation failed: self signed certificate`. +: Use `ssl_verify = 0` in the configuration file, or set the certificates + options correctly. + With mcabber >=0.10 the option name is `ssl_ignore_checks`. + +How do I connect to my Google Talk account? +: With mcabber >=0.10, setting the `jid` variable should work. + With mcabber 0.9, it should work with the following options: + + set username = your.email@gmail.com + set server = talk.google.com + set ssl = 1 + set ssl_verify = 0 + +I want to bind a key, how do I know the code number? +: If the key is available, the key code will be displayed in the log window when + you hit that key. + +How do I create a group? +: Use `/move`, if the target group doesn't exist it will be created. + +How can I set a transparent background? +: Seti `color_background = default`. + +How do I use PGP encryption? +: Please see the [[OpenPGP]] page. + +How do I use OTR encryption? +: Someone wrote a small [HowTo][otr_howto]. + +How to retrieve mcabber source using Mercurial? +: See [[Building_mcabber_from_Mercurial]]. + +How comes the cursor is not at the end of line (EOL) when I use the Up and Down arrows? +: By default these keys are bound to `iline + hist_beginning_search_bwd/hist_beginning_search_fwd`, which is very useful once + you get used to it. Of course you can rebind the keys (259, 258) to + `iline hist_prev/hist_next` if you don't like this behaviour... + +Can I get rid of this timeout after hitting Escape? +: You can decrease the timeout value by setting the (Ncurses) environment + variable `ESCDELAY` (for example `export ESCDELAY=25; mcabber`). With mcabber > + 0.9.5 there is an `escdelay` option. + +How can I prevent mcabber from scrolling when I receive a message? +: See `/buffer scroll_lock` and `scroll_unlock`. You can bind a key to `buffer + scroll_toggle` too. + +Can I use a transport with mcabber? +: You cannot register with mcabber. However, once you're registered, you can log + into and out of transports by sending presence to them (see `/status_to`). + +MCabber says `WARNING: Bad permissions`! What are "good" permissions for mcabber? +: MCabber expects its directory to be 700 (`rwx------`) and your configuration + file should be 600 (`rw-------`) to ensure that nobody else can read it. + +Fifo does not work in version >= 0.10.2! (also url regex) +: In 0.10.2 fifo and url regex were put into a separate from mcabber modules. + Module can be loaded with command `/module load fifo` (or `url_regex` + respectively). This command can also be put into your `mcabberrc` to load them + automatically at startup. Note, however, that you must set parameters for the + module before loading it. + +I have a feature request! +: Come and tell us in the mcabber MUC room. + +I want to make a donation... +: Really? Get my email/jid from the sources and contact me! ;-) + There's also a PayPal button on [MCabber's homepage][mcabber]. + +[mcabber]: http://mcabber.com/ +[otr_howto]: http://www.fsfe.org/es/fellows/smc/weblog/mcabber_and_otr diff -r eff7327bcabe -r 1e57279b82b1 Getting_Started.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Getting_Started.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,70 @@ + +[[!toc]] + +# Download + +Get the latest mcabber release from the [official website][mcabber]. It's +usually a bzipped tarball, for example `mcabber-0.9.10.tar.bz2`. +Untar it: + + % tar xvjf mcabber-0.9.10.tar.bz2 + % cd mcabber-0.9.10 + +# Install + +Note: if you do not want to make a system-wide installation, you can use the +`--prefix` option. + + % ./configure + % make + % make install + +OpenBSD users: you'll probably want to add `--enable-sigwinch` as there is no +default SIGWINCH handler. + +# First run + +You could launch mcabber with no configuration file, but then you would have to +set the options manually. The simpler way is to copy the sample configuration +file provided with the source tree: + + % mkdir ~/.mcabber + % chmod 0700 ~/.mcabber + % cp mcabberrc.example ~/.mcabber/mcabberrc + +Now, edit the configuration file. You need to set your username and server (or +only the `jid` option, starting from mcabber 0.10.0). (Note: if you want to use +SSL/TLS encryption, have a look at the `ssl_verify` or `ssl_ignore_checks` +options). + +Ok, you should be able to launch mcabber now! + +# It's running... Now how does it work?? + +The mcabber screen is divided into 4 regions. The **roster**, alias +**buddylist**, is on the left. The **chat window**, or chat buffer, is on the +right. The **input line** lies at the bottom of the screen, under a small **log +window**. Two status lines surround the log window. The bottom status line is +the "main status line" and reflects mcabber general status. The other line is +the "chat status line" and shows the status of the currently selected buddy. To +display buddies chat buffers, you will have to enter [[Chat_Mode]]. You can +enter _chat mode_ by pressing enter, and leave _chat mode_ with the ESC key. +Simply sending a message will also enable _chat mode_. Use PageUp/PageDown to +move inside the roster. + +Take a look at the small [User Guide][userguide] to get a quick overview. + +All commands in mcabber have an online help (use `/help` or `/help command`)! + +# Configuration etc. + +Read The (F) [Manpage][mcabber_man] for more details, and the [sample +configuration file][sample_rc] to see all the available options. You can use the +online help (command `/help`). If mcabber's help files have been translated into +your language, you can set the corresponding `lang` option (see the config. +file). + +[mcabber]: http://mcabber.com/ +[userguide]: http://mcabber.com/files/mcabber_guide.pdf +[mcabber_man]: http://lilotux.net/~mikael/mcabber/files/mcabber.1.html +[sample_rc]: https://bitbucket.org/McKael/mcabber-crew/raw/tip/mcabber/mcabberrc.example diff -r eff7327bcabe -r 1e57279b82b1 Hacking.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Hacking.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,27 @@ + +# Contributions + +* You can join the mcabber MUC conference room + if you have some suggestions/questions, or if you are interested in mcabber + development. + + _Contributions are very welcome, do not hesitate!_ +* You can use the [Mercurial repository][] if you want to use the latest version + or hack on mcabber. See [[Building_mcabber_from_Mercurial]]. +* There is a [mirror repository][] on Bitbucket. +* There is also a [crew repository][] for main contributors as well as an [Issue + Tracker][]. +* New versions are usually announced on the [Freshmeat][] website; there is no + mailing list at the moment. +* See the [[TODO]] list, to get an idea of the features that are "in the queue". +* There is a [[Buildbot]] setup for the mcabber-lm repository - You can order + the build slaves to perform a compilation of a specific commit. +* There is a [[Modules]] page with a list of existing modules for development + version (0.10.0) of mcabber. + +[Mercurial repository]: http://mcabber.com/hg/ +[mirror repository]: http://bitbucket.org/McKael/mcabber/ +[crew repository]: http://bitbucket.org/McKael/mcabber-crew/ +[Issue Tracker]: http://www.bitbucket.org/McKael/mcabber-crew/issues/?status=new&status=open +[Freshmeat]: http://freshmeat.net/projects/mcabber/ + diff -r eff7327bcabe -r 1e57279b82b1 Modules.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Modules.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,334 @@ + +[[!toc levels=2]] + +# Overview + +Starting from version 0.10.0, mcabber supports dynamic loading of modules. It +introduces the command `/module` with subcommands to load, unload and obtain +info on modules. This command is allowed during initialization time, so you can +specify it in your mcabberrc. Modules are searched in the directory specified in +mcabber variable `modules_dir`, that you should set before issuing these +commands. Default module installation/loading directory is `/usr/lib/mcabber`. + +The API is still experimental and likely to be changed, but there is a short +HOWTO about writing your own modules in `doc/` subdirectory of mcabber source. +It contains up-to-date information on module-related routines that mcabber +offers and some examples. + +# Existing modules + +Right now the following modules are available (if you know of some other +modules, feel free to add them to list below): + +## antispam + +* URL: + +Enables simple question-based antispam-bot which asks predefined question to +every unsubscribed buddy, expecting them to give the right predefined answer. +Currently you may change the standard question/answer only by changing the +source code. + +## avatar + +* URL: +* Homepage: +* Mirror: + +This module implements avatar publishing/retrieving via pep/pubsub. It informs +you when your buddies publish their avatars via pep and provides command +`/avatar` to publish your own. But this is not all: It also will actually show +you buddy's avatar! Yes, it is aalib :) + +Note: this module should eventually merge with pep (at least partially) + +## avv + +* URL: +* Homepage: + +Advanced version verification (or something like that, I now cannot recollect +initial meaning of this abbreviature). Alternative module loading system, that +allows flexible module compatibility determination. It splits API, provided by +mcabber into a set of smaller APIs. This allows to omit module update, when +major API change have not changed used by this module mini-APIs. Also, module +information is now stored separately, in usual text file, that may be adapted by +hand to user environment. Fallback legacy module loading scheme is not yet +implemented :( + +## beep + +* URL: + +Simple module to beep on **all** messages. Available in mcabber 0.10.0. Serves the +purpose of example for module writing HOWTO. + +## clock + +* URL: + +This module uses the 'info' option to display the date and time in the status +bar. This module is part of the mcabber-modules repository. + +## cmd + +* URL: +* Homepage: +* Mirror: + +Provides command `/cmd`, that sends output of specified shell command to current buddy. + +## commands (custom) + +* URL: + +Allows to add commands with dynamic completion lists, based on regexp-matching +over incoming buddy messages (a bit similar to urlopen). Useful for +microblogging. + +## comment + +* URL: + +Trivial module; adds a command `#` to ignore a line. This module is part of the +mcabber-modules repository. + +## disco + +* URL: +* Homepage: +* Mirror: + +Module adds `/disco` command, that sends service discovery requests. + +## env + +* URL: +* Homepage: +* Mirror: + +Tampering with mcabber's environment. This module can be useful for development +and debugging, as well as for on-the-fly changing of some parameters, like +`AAOPTS` for aalib, used in avatar module. Also provides way to change current +working directory. + +## eventcmd + +* URL: +* Homepage: +* Mirror: + +Modularization of legacy mcabber eventcmd script. Available in experimental +version of mcabber. + +## eventcmd-ng + +* URL: +* Homepage: + +Another approach for eventcmd. It passes arguments to script as environment +variables, so, you can use `$jid` instead of `$1`. Because of this it is more +flexible for future changes (see hooks description in HOWTO). Though, it is not +officially approved new interface for eventcmd - it is only my vision of it. + +## extsay + +* URL: + +If you use the [screen][] utility, this module will let you open your editor in +a new screen window, and will send the message once you exit the editor. Check +the [README][extsay-readme] file! This module is part of the mcabber-modules +repository. + +## fifo + +Modularization of mcabber FIFO. Allows recreation of fifo in run-time by +reloading module. This module has been merged into mcabber development tree +(0.10.2-dev). + +## info_msgcount + +* URL: + +Displays the number of unread messages (buffers) in the status bar. This module +relies on the `info` option, so it cannot be used with the clock module +described above. This module is part of the mcabber-modules repository. + +## ignore_auth + +* URL: + +Ignores subscription requests from every jid matching configurable regexs. Adds +the command ignore_auth to add a regex to the list (`/ignore_auth .*@icq`). The +option ignore_auth can be used to disable/enable this feature temporily +(`/set ignore_auth = 1`). This module is part of the forked mcabber-modules +repository from franky. + +## jingle + +* URL: +* HG Mirror: + +Jingle modules written by Alkino during the GSoC 2010. Contains a file transfer +module (IBB support). + +## killpresence + +* URL: + +Adds two commands, killpresence and killchatstates, that can be used repectively +to ignore the current presence from a fulljid (e.g. to kill a "ghost") and to +reset the chat state status of an online contact. This module is part of the +mcabber-modules repository. + +## lastmsg + +* URL: + +Stores highlighted messages received in MUC rooms while you are away. When +you're back, you can use the command `/lastmsg` you display them. This module is +part of the mcabber-modules repository. + +## lua + +* URL: +* Homepage: +* Mirror: + +Lua interface module for mcabber. Adds `/lua` command (and much more in example +scripts). Needs much more work, but already usable. + +Example scripts for this module extensively use lua bindings for loudmouth, +`lua-lm`. It can be found here: + +* URL: +* Homepage: +* Mirror: + +## marking + +* URL: +* Homepage: +* Mirror: + +Adds ability to mark several buddies and do some command for each of these +buddies. Provides commands `/mark` and `/marked`. + +## mpd + +* URL: +* Homepage: + +Provides information about currently playing song for modules like PEP. + +## mucignore + +* URL: + +Simple plugin to ignore users in MUC conferences. + +## pep + +* URL: +* Homepage: +* Mirror: + +Suite of modules to publish and process PEP (Personal Eventing Protocol) tune, +mood, geoloc and activity events. + +## si + +Stream initiation (file transfer profile) module. Uses streams module for its +transfer methods, thus, it now supports both IBB and SOCKS5 Bytestreams. +Provides command `/si`. + +**Note:** Stalled in the process of rewrite/update, contact +[me](xmpp:isbear@jabber.kiev.ua), if you are interested in picking it up. + +## streams + +In-Band and SOCKS5 Bytestreams implementation. Adds command `/stream`. It +supports IBB native session initiation and bare SCOKS5 Bytestream requests and +can send/receive files this way. Though, this module is, probably, the only +implementation, that supports such file transfer methods, so you will be unable +to use this module alone to exchange files with, other clients. However this +module is designed with ability to be used by other modules as transfer pipe, +so, there is si/file-transfer module to transfer files in more convenient way. +This module should be considered still in beta stage, but yet already usable. + +**Note:** Stalled in the process of rewrite/update, contact +[me](xmpp:isbear@jabber.kiev.ua), if you are interested in picking it up. + +## templatecmd + +* URL: +* Homepage: + +Allows to define alias-like commands with shell-like positional arguments +substitution. Provides command `/templatecmd`. If you're searching for a way to +define alias for `/send_to -f .` - this module is for you. + +## uptime + +* URL: +* Homepage: +* Mirror: + +Module to show mcabber uptime. It can either determine full mcabber process +uptime from linux `/proc` filesystem or just count time from module loading +moment. + +## urlopen + +* URL: +* Homepage: + +Looks for urls in incoming messages and prints them to log and/or calls shell +command to handle them. + +## xttitle + +* URL: + +Displays the number of unread messages in the X Terminal Title. The option +`xttitle_short_format` can be set to use a very short title. + +## yaubil + +* URL: +* Homepage: +* Mirror: + +Yet Another Useless Built-In Language. Provides `/eval`, `/if`, `/then`, +`/else`, `/let` and `/multi` commands. Probably most useful amongst them is +`/multi`. If, breaking my expectations, this module becomes useful and famous +(presence of beard may cause this), I promise, that I'll improve +string/parentheses parsing, add loops and maybe even switch to tree-producing +parser with operators precedence. + +# Notes on modules, written by isbear, aka Mykhailo Danylenko + +* I use cmake as build system, it allows me to quickly generate debian packages + (not too accurate, but at least it is package). See README for a brief + description how to build module. +* Most modules need more work - to add flexibility, providing mcabber variables, + that control module behaviour, to check for resource releasing in extreme + situations, etc. +* Most modules, that provide some command also include help file for them (in + English). You may need to adjust variable help_dirs, if you have installed + module with another prefix than mcabber itself to be able to use this help + files. +* Every module contains file modulename.rc (by default it will be installed into + `/share/doc/libmcabber-/`), that contains list of + all mcabber variables introduced by this module with descriptions and load + commands, necessary to get this module loaded (i.e. first load commands for + modules, that are required for this module to work, then load command for this + module itself). +* If you have found a bug in module, please contact me by mail or jabber (both + can be found in README file). +* Unfortunately, most of the modules are now kinda unmaintained (if you need + something - ping me, and I'll try to do something about that, but no + guarantees). Adoption requests are warmly welcomed. + +[screen]: http://www.gnu.org/software/screen/ +[extsay-readme]: http://hg.lilotux.net/mcabber-modules/raw-file/tip/extsay-ng/README diff -r eff7327bcabe -r 1e57279b82b1 OpenPGP.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/OpenPGP.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,77 @@ +[[!meta title="MCabber OpenPGP support"]] + +[[!toc]] + +MCabber supports OpenPGP by implementing the [[!xep 0027]] protocol. When used, +status messages (presence) are signed and message bodies can be encrypted. + +When a client supports OpenPGP, it signs presences (status messages). This is +the only way for a client to advertise its support of PGP. Messages are +encrypted when sent to such clients. + +There is currently no indication of whether the message being sent will be +encrypted (or is there?) It is also unknown what happens when a message is +sent to a client with multiple active resources, when not all of them support +encryption or if they use different keys (please document). + +MCabber supports OpenPGP since version 0.9.0. This page explains how to set it +up. + +# Building mcabber with OpenPGP support + +Note: You need `libgpgme` > 1.0.0 (for example, `libgpgme11` & `libgpgme11-dev` +in Debian) to build mcabber with OpenPGP support. + +# Enabling OpenPGP + +Once mcabber is built with PGP support, you will have to set it up. + +In the configuration file, enable `pgp` and set `pgp_private_key` to your key +id. Your key id can be found with the following command: + + gpg --list-keys --keyid-format long your_name + +Example (in `$HOME/.mcabber/mcabberrc`): + + set pgp = 1 + set pgp_private_key = "E3E6A9C1A6A013D3" + +# Encrypting messages + +Now when you start mcabber, it should ask for your passphrase (unless you put +it in your configuration file or you use `gpg-agent`). + +If you want to know if a contact is using PGP, select the contact and use +`/info`. If (s)he is, it should display something like + + PGP key id: E2C4C9A1601A5A4 + Last PGP signature: unknown + +The signature is "unknown", because we don't have the contact's key. We could +get it with `gpg`, for example. + + gpg --recv-keys E2C4C9A1601A5A4 + +Then, wait for the next presence message. + +If the contact has your key and you have their key, you should have +bidirectional encrypted messages. + +# Per-contact settings + +You can provide a PGP key to be used for a given Jabber user or disable PGP on +a per-account basis, using the command `/pgp`. If you provide a KeyId for a +contact, it will be compared to the key the contact uses to sign their +presence/messages and it will be used for all outgoing encrypted messages (by +default, mcabber will use the contact signature's key). + + /pgp disable foo@bar.org + /pgp setkey bar@foo.net C9940A9BB0B92210 + +The command `/pgp` can be used in the configuration file (without the leading /). + +Example (in `$HOME/.mcabber/mcabberrc`): + + pgp disable foo@bar.org + pgp setkey bar@foo.net C9940A9BB0B92210 + diff -r eff7327bcabe -r 1e57279b82b1 Packages.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Packages.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,91 @@ + +[[!toc]] + +# Arch Linux + +MCabber is in the community package repositories. Just enable it and install via +pacman: + + pacman -S mcabber + +# Debian + +Mario Iseli is maintaining an official Debian package, which was successfully +released with Debian Etch on 08 Apr 2007 (0.8.3). Note: After installing the +package, you need to set up a personal configuration file; see the documentation +and the sample `mcabberrc` file in the `/usr/share/doc/mcabber/` directory. See +the [Debian mcabber package page][debianpkg]. + +Fresh mcabber versions for stable and oldstable distributions also available +[here][wasteland]. + +# Ubuntu + +Debian packages by Mario Iseli are synced to Ubuntu. See the [Ubuntu mcabber +package page][ubuntupkg]. + +Fresh mcabber versions for stable and oldstable LTS distributions also available +[here][wasteland]. + +# Red Hat / Fedora + +For Red Hat/Fedora Core users, Dries Verachtert is building a set of RPM +packages. You can find them [here][driespkg1] or [here][driespkg2]. + +Michael Fleming is also maintaining packages for Fedora Core 6 (in Fedora +Extras) as well as Fedora 7 and up (in the core "Everything" repository) + +You only need to enable the Fedora Extras repository for Core 6 to get access - +no extra configuration is needed for Fedora 7+. `yum install mcabber` installs +the package and it's dependencies. + +# Slackware + +Thanks to Eric Hameleers, mcabber is now officially part of Slackware. + +# Gentoo + +Thanks to Philip M. White, there is now an official [Gentoo Portage][]. + +If you want to use the development version found on the Mercurial repository, +you can use the [Berkano Overlay][]. You can [browse the overlay][berkanoweb] +too. + +# FreeBSD + +Vsevolod Stakhov has created a [FreeBSD port][]. + +# pkgsrc + +MCabber is also available in [pkgsrc][pkgsrcse]. However, it's only available +[pkgsrc-wip][] till now. + +# Optware + +Cross compiled ipk for small NAS devices to be installed under `/opt`. +See [Optware][optware-wiki]. + +# Mac OS X + +There is a mcabber [Fink][] package in the Fink unstable tree. + +There is also a port available in the [MacPorts][] repository. + +**Remember** that you need to press the additional SHIFT key on Mac OS X for +PageDown. That means FN-SHIFT-CursorDown for moving in the roster. + +[debianpkg]: http://packages.debian.org/mcabber +[ubuntupkg]: http://packages.ubuntu.org/mcabber +[wasteland]: https://wasteland.ml +[driespkg1]: http://dag.wieers.com/packages/mcabber/ +[driespkg2]: http://dries.ulyssis.org/rpm/packages/mcabber/info.html +[Gentoo Portage]: http://www.gentoo-portage.com/net-im/mcabber/ +[Berkano Overlay]: http://tinyurl.com/yurgo6 +[berkanoweb]: http://svn.liveforge.org/berkano/trunk/ +[FreeBSD port]: http://www.freshports.org/net-im/mcabber/ +[pkgsrcse]: http://pkgsrc.se/wip/mcabber +[pkgsrc-wip]: http://pkgsrc-wip.sourceforge.net/ +[optware-wiki]: http://www.nslu2-linux.org/wiki/Optware/ +[Fink]: http://pdb.finkproject.org/pdb/package.php/mcabber +[MacPorts]: http://www.macports.org + diff -r eff7327bcabe -r 1e57279b82b1 TODO.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/TODO.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,5 @@ + +See the [TODO][] file in the mcabber mercurial repository. + +[TODO]: http://mcabber.com/hg/index.cgi/raw-file/tip/mcabber/TODO + diff -r eff7327bcabe -r 1e57279b82b1 Tips_And_Tricks.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Tips_And_Tricks.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,148 @@ + +[[!toc]] + +# Multi-line messages + +You can send multi-line messages with the `/msay` command (see the [manpage][] +for usage details). + +You can bind `/msay toggle` and/or `/msay toggle_verbatim` so that you can +switch quickly to/from multi-line mode: + + # Alt-m to switch to/from multi-line mode + bind M109 = msay toggle + # Alt-M to switch to/from _verbatim_ multi-line mode + bind M77 = msay toggle_verbatim + +With mcabber 0.10 you can try the module extsay if you're using the screen +utility (see the [[Modules]] page). + +# Jump to a contact + +You can use `/roster search` to jump to a contact in your roster. You can even +bind a key, for example if you talk very often with john.doe@jabber.foo, you can +bind the F1 key: + + bind 265 = roster search john.doe + +**Note:** this command only looks for the contact in the displayed buddy, so if you +hide offline buddies it won't find a disconnected contact. + +You may want to create an alias for this command, if you use it a lot: + + alias rsearch = roster search + +With the completion, you only need to type `/rs` now. + +# One history for multiple buddies + +(You'll need mcabber >=0.9.2 for that feature) +You're using jabber with several transports and you have some buddies who are +using more than one chat protocol? mcabber is able to share one history file +between all of them. + +Let's say you have a contact abc@jabber.org and abc@icq.jabber.org. First of +all, you have to merge both histories with `merge_history.py`, so that old data +won't be lost. + + $ cd ~/.mcabber/histo/ + $ merge_history abc\@jabber.org abc\@icq.jabber.org > abc + $ mv abc abc\@jabber.org + $ rm abc\@icq.jabber.org + +Now you have to create a symlink(abc@icq.jabber.org -> abc@jabber.org): + + $ ln -sf abc\@jabber.org abc\@icq.jabber.org + +After a restart, mcabber will load the history only once for both contacts. Both +JIDs are sharing this history now. Commands relating to the chat buffer, such as +`/buffer scroll_lock/purge/clean` on one buddy will change the buffer of the +other buddy as well (because it's internally the same buffer). + +Of course it is possible to link more than two buddies to one history... :) + +# Indication of transported buddies availability + +Using FIFO feature and eventcmd script you can mark transported buddies with +different color, when transport is not connected. In `mcabberrc`: + + color roster clear + color roster * * green + color roster dn_? * brightblack + color roster * *@icq.jabber.org red + color roster dn_? *@icq.jabber.org red + +This will mark transported buddies as unavailable initially. Then in +`eventcmd.sh`, when processing `STATUS` event ( `"$1" = 'STATUS'` ) + + if [ "$3" = 'icq.jabber.org' ]; then + if [ "$2" = '_' ]; then + echo "color roster * *@icq.jabber.org red" > ~/.mcabber/fifo + echo "color roster dn_? *@icq.jabber.org red" > ~/.mcabber/fifo + else + echo "color roster * *@icq.jabber.org white" > ~/.mcabber/fifo + echo "color roster dn_? *@icq.jabber.org brightblack" > ~/.mcabber/fifo + fi + fi + +This will change their color, when transport becomes available/unavailable. + +# Delayed actions (eg message for 'dnd' buddy) + +You can delay some action until buddy becomes available or some other event +happens. Add to `eventcmd.sh`: + + if [ -f ~/.mcabber/jobs/"$1_$2_$3" ]; then + cat ~/.mcabber/jobs/"$1_$2_$3" > ~/.mcabber/fifo + rm ~/.mcabber/jobs/"$1_$2_$3" + fi + +and create jobs dir: + + $ mkdir ~/.mcabber/jobs/ + +Then you can do something like this: + + $ cat > ~/.mcabber/jobs/STATUS_O_buddy@jabber.org < say_to -q buddy@jabber.org Hi, this is a jobbed message + > say_to -q buddy@jabber.org Please, when you will have free time, do this and that. + > EOF + +That will not bother buddy while he is 'dnd', and you won't have to keep your +message in mind. + +# Folding groups on start + +With a hooks feature you can fold infrequently used groups (eg transports and +other services) on startup. In `mcabberrc`: + + set hook-post-connect = source ~/.mcabber/post-connect.rc + set hook-pre-disconnect = source ~/.mcabber/pre-disconnect.rc + +and in `~/.mcabber/post-connect.rc`: + + group fold Transports + group fold Old + +# Auto-Away and Screen + +So, we all want an auto-away but love to keep mcabber ticking away in a screen +session. By putting the following into your `~/.logout` (or `~/.bash_logout` if +you use BASH), you should get what you are looking for: + + # mcabber auto-away - probably a Linux only solution as we use /proc + if [ -p .mcabber/mcabber.fifo ]; then + MCABBER_PID=$(pgrep -u $USER mcabber) + if [ -n $MCABBER_PID ]; then + MCABBER_STY=$(cat /proc/$MCABBER_PID/environ | tr '\0' '\n' | grep '^STY=' | cut -d'=' -f2) + + if [ -n $MCABBER_STY ]; then + if [ -z "$(screen -list | grep $MCABBER_STY.*\(Attached\))" ]; then + echo /status notavail > .mcabber/mcabber.fifo + fi + fi + fi + fi + +[manpage]: http://www.lilotux.net/~mikael/mcabber/files/mcabber.1.html + diff -r eff7327bcabe -r 1e57279b82b1 de/index.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/de/index.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,175 @@ + +[[!meta title="DE Main Page"]] + +[MCabber][home] ist ein konsolenbasiertes Jabberprogramm, veröffentlicht unter +GNU GPL. + +Translations: [Hauptseite englisch](/), [[Hauptseite Russisch|/ru]] (Russian), +[[Hauptseite Französisch|/fr]] (French). + +[[!toc]] + +# Features + +* mcabber ist ein textbasiertes Jabberprogramm mit Funktionen wie **SSL** + Unterstützung, **Nachrichten Logging/History**, Kommando + **vervollständigung**, und externen **Aktionen (trigger)**. +* mcabber unterstützt die folgenden Plattformen: **GNU/Linux**, **FreeBSD**, + **Mac OS X** and **Cygwin**. +* Die folgenden JEP's werden in der Entwicklerversion unterstützt: + + - [[!xep 0012]] - Last Activity + - [[!xep 0022]] - Message Events + - [[!xep 0027]] - Current Jabber OpenPGP Usage + - [[!xep 0030]] - Service Discovery (partial) + - [[!xep 0045]] - Multi-User Chat + - [[!xep 0048]] - Bookmark Storage + - [[!xep 0049]] - Private XML Storage + - [[!xep 0054]] - vcard-temp (retrieval only) + - [[!xep 0085]] - Chat State Notifications + - [[!xep 0086]] - Error Condition Mappings + - [[!xep 0090]] - Entity Time + - [[!xep 0091]] - Delayed Delivery + - [[!xep 0092]] - Software Version + - [[!xep 0115]] - Entity Capabilities + - [[!xep 0145]] - Annotations + - [[!xep 0146]] - Remote Controlling Clients (partial) + - [[!xep 0184]] - Message Delivery Receipts + - [[!xep 0199]] - XMPP Ping (answering only) + - [[!xep 0202]] - Entity Time + - [[!xep 0203]] - Delayed Delivery + - [[!xep 0249]] - Direct MUC Invitations (partial) + - [[!xep 0280]] - Message Carbons + +# Los gehts... + +* Runterladen + + - Hol dir das aktuellste Paket von der [offiziellen Website][home]. Es ist ein + mit bzip gepacktes Tar-Archiv, zum Beispiel 'mcabber-0.8.3.tar.bz2'. + - Entpack es: + + % tar xvjf mcabber-0.8.3.tar.bz2 + % cd mcabber-0.8.3 + +* Installieren + + - Hinweis: Wenn du mcabber nicht systemweit installieren willst kannst du die + `--prefix` Option für configure benutzen um das Zielverzeichniss der + Installation anzugeben. + + % ./configure + % make + % make install + +* Erster Start + + Du kannst mcabber ohne Konfigurationsdatei starten aber dann musst du die + Konfigurationsoptionen bei jedem Start von Hand setzen. Einfacher geht es wenn + du die Beispielskonfiguration, die mit den Quellen mitgeliefert wird, in dein + Home-Verzeichniss kopierst: + + % mkdir ~/.mcabber + % chmod 0700 ~/.mcabber + % cp mcabberrc.example ~/.mcabber/mcabberrc + + Jetzt kannst du die Datei editieren. Gesetzt werden müssen `username` und + `server`. (Hinweis: Wenn du SSL benutzen willst vergiss nicht die `ssl_verify` + Option anzuschauen) Jetzt solltest du mcabber starten können! + +* Es läuft... aber wie funktioniert es? + + Der mcabber Bildschirm ist in 4 Bereiche geteilt. Die Kontaktliste(Roster) + links. Das "Chat-Fenster" oder "Buffer" rechts. Die Eingabezeile ist am + unteren Ende des Bildschirms unter einem kleinen "Nachrichten Fenster" + (LogWindow). Das "Nachrichtenfenster" ist von zwei "Log-Fenstern" umgeben. + Die untere Statuszeile ist die Hauptstatuszeile, sie zeigt den die Meldungen + die mcabber betreffen an. Die zweite Statuszeile zeigt nur die Meldungen für + den Chatpartner an. + Um die einzelnen Chatfenster anzuzeigen musst Du in den + [[Chatmodus|Chat_Mode]] wechseln. Mit _Enter_ wird in den _Chatmodus_ + gewechselt, dieser kann mit der _ESC_ Taste wieder verlassen werden. Sobald Du + eine Nachricht schreibst wird automatisch in den _Chatmodus_ gewechselt. + Auf der Kontaktliste(Roster) wird mit _BildHoch/BildRunter_ navigiert. + +* Für mehr Details solltest du die Manpage lesen. In der Beispielkonfiguration + werden alle möglichen Einstellungen gezeigt. + + Außerdem kannst Du die Onlinehilfe (command `/help`) verwenden. Wenn die + Hilfedateien von mcabber in deine Sprache übersetzt wurden kannst du die + `lang` Option einstellen (siehe Konfigurationsdatei). + +# Pakete + +Möglicherweise existieren [[Pakete|Packages]] für dein Betriebssystem, so dass +du mcabber nicht übersetzen musst. + +# Entwicklung + +* Du kannst an der mcabber Multi-User-Chat Konferenz im Raum + [mcabber@conf.lilotux.net](xmpp:mcabber@conf.lilotux.net) teilnehmen wenn du + Anregungen oder Fragen hast oder einfach nur an der Entwicklung interessiert + bist. + + _Contributions are very welcome, do not hesitate!_ + +* Wenn du die aktuellste Version benutzen willst oder mcabber hacken kannst du das + [Mercurial repository][] nutzen, Siehe [[Building_mcabber_from_Mercurial]]. + +# FAQ + +MCabber will sich nicht verbinden. `jab_start: SSL negotiation failed: self signed certificate` wird als Fehlermeldung ausgegeben. +: Setze `ssl_verify` in der Konfigurationsdatei auf 0 oder richte die Optionen + die das Zertifikat betreffen korrekt ein. + +Wie verbinde ich mich zu meinem Google-Talk-Konto? +: Sollte mit den folgenden Einstellungen funktionieren: + + set username = your.email@gmail.com + set server = talk.google.com + set ssl = 1 + set ssl_verify = 0 + +Ich will eine Taste neu belegen, wie finde ich den Tastencode heraus? +: Wenn die Taste nicht belegt ist wird der Tastencode in der Statuszeile + angezeigt. + +Wie erstelle ich eine Gruppe? +: Mit `/move` kannst du einen Kontakt in eine Gruppe verschieben, falls diese + nicht existent ist wird sie erstellt. + +Wie richte ich einen transparenten Hintergrund ein? +: Mit `color_background = default`. + +Kann ich PGP Verschlüsselung nutzen? +: Lies bitte die [[OpenPGP]] Seite. + +Wie bekomme ich den MCabber Quelltext über Mercurial? +: Du liest nicht richtig! Das wurde bereits erwähnt, + [[Die aktuellste Version übersetzen|Building_mcabber_from_Mercurial]]. + +Ich habe einen Vorschlag für eine neue Option! +: Besuch uns doch im MCabber MUC und sag es uns dort. + +Ich würde gerne spenden... +: Wirklich? Such meine Emailadresse oder JID im Quelltext und kontaktiere + mich! ;-) + Auf der MCabber Webseite gibt es auch einen PayPal-Knopf. + +# Tips + +Schau dir auch die [[Tips und Tricks|Tips_And_Tricks]] Seite an, vielleicht +findest du nützliche Hinweise. + +# Links + +* [Offizielle Webseite][home] +* [Jabber Software Foundation][jabberorg] +* [[!wikipedia Jabber desc="Jabber in Wikipedia"]] +* MUC: [mcabber-de@conf.lilotux.net](xmpp:mcabber-de@conf.lilotux.net) +* gebe ein: `/room join mcabber-de@conf.lilotux.net` + +[home]: http://mcabber.com/ +[jabberorg]: http://www.jabber.org/ +[Mercurial repository]: http://www.lilotux.net/~mikael/mcabber/hg/ + diff -r eff7327bcabe -r 1e57279b82b1 fr/index.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/fr/index.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,151 @@ + +[[!meta title="FR Main Page"]] + +[MCabber][home] est un client Jabber en mode console, publié sous licence +GNU GPL. + +[[!toc]] + +# Fonctionnalités + +* mcabber est un client Jabber incluant les fonctionnalités suivantes: support + de **SSL**, **journalisation des discussions**, **complètement** des + commandes, déclenchement d'**actions externes**. Il supporte également **PGP** + et **OTR** pour le chiffrement des messages ainsi que **Aspell/Enchant** pour + la vérification d'orthographe. +* mcabber fonctionne actuellement sur les plate-formes suivantes: **GNU/Linux**, + **FreeBSD**, **Mac OS X** et **Cygwin**. +* Les spécifications Jabber suivantes sont supportées (dans la version de + développement): + + - [[!xep 0012]] - Last Activity + - [[!xep 0022]] - Message Events + - [[!xep 0027]] - Current Jabber OpenPGP Usage + - [[!xep 0030]] - Service Discovery (partial) + - [[!xep 0045]] - Multi-User Chat + - [[!xep 0048]] - Bookmark Storage + - [[!xep 0049]] - Private XML Storage + - [[!xep 0054]] - vcard-temp (retrieval only) + - [[!xep 0085]] - Chat State Notifications + - [[!xep 0086]] - Error Condition Mappings + - [[!xep 0090]] - Entity Time + - [[!xep 0091]] - Delayed Delivery + - [[!xep 0092]] - Software Version + - [[!xep 0115]] - Entity Capabilities + - [[!xep 0145]] - Annotations + - [[!xep 0146]] - Remote Controlling Clients (partial) + - [[!xep 0184]] - Message Delivery Receipts + - [[!xep 0199]] - XMPP Ping (answering only) + - [[!xep 0202]] - Entity Time + - [[!xep 0203]] - Delayed Delivery + - [[!xep 0249]] - Direct MUC Invitations (partial) + - [[!xep 0280]] - Message Carbons + +# Pour commencer + +Si mcabber est déjà disponible, en paquet ou autre, pour votre environnement, +vous pouvez passer les deux premiers paragraphes (téléchargement et +installation). + +* Téléchargement + + - Télécharger la dernière version de mcabber depuis le site officiel. C'est + habituellement un fichier avec l'extension .tar.bz2, comme + "mcabber-0.8.3.tar.bz2". + - Le décompresser: + + % tar xvjf mcabber-0.8.3.tar.bz2 + % cd mcabber-0.8.3 + +* Installation + + Remarque: si vous souhaitez faire une installation locale, vous pouvez + utiliser l'option `--prefix`. + + % ./configure + % make + % make install + +* Première utilisation + + Vous pouvez lancer mcabber sans fichier de configuration, il faudra alors + paramétrer les options manuellement. Pour créer un fichier de configuration + rapidement, copiez et renommez le fichier exemple fourni avec les sources: + + % mkdir ~/.mcabber + % chmod 0700 ~/.mcabber + % cp mcabberrc.example ~/.mcabber/mcabberrc + + Ensuite, éditez le fichier. Renseignez votre login et le serveur Jabber. + (Remarque: si vous voulez activer le chiffrement SSL, consultez l'option + "ssl_verify"). + + Okay! Vous devriez pouvoir lancer mcabber maintenant! + +* Ça tourne... mais comment ça marche?? + + La fenêtre mcabber est divisée en 4 zones. Le _roster_, alias _buddylist_ + (liste de contacts), se trouve à gauche, et la zone de discussion, ou _chat + buffer_, à droite. La zone de commandes est au bas de la fenêtre, sous la zone + d'informations. + + Deux barres d'état entourent la zone d'informations. La barre d'état + inférieure est la "barre d'état principale" et reflète l'état général du + logiciel (votre état, en somme). L'autre barre est la "barre d'état de la + discusion" et affiche l'état du contact actuellement sélectionné. + + Pour afficher l'historique des discussions, vous devrez rentrer en mode + discussion (_Chat Mode_). Pour activer ce mode, appuyez sur la touche Entrée, + pour en sortir appuyez sur la touche ESC. Envoyer un message permet aussi + d'activer le mode discussion. + + Utilisez les touches PageUp/PageDown pour vous déplacer dans le roster. + +* Lisez la [page de manuel][manpage] pour plus de détails, ainsi que le fichier + de configuration pour connaître toutes les options disponibles. + + Vous pouvez utiliser l'aide en ligne (commande `/help`). Si les fichiers + d'aide de mcabber ont été traduits dans votre langue, vous pouvez choisir la + langue via l'option `lang` (voir le fichier config). + +* Vous pouvez consulter le lien suivant pour un [petit guide][] en français. + +# Développement + +* Vous pouvez rejoindre la salle de conférence (_MUC room_) de mcabber + [mcabber@conf.lilotux.net](xmpp:mcabber@conf.lilotux.net) si vous avez des + suggestions/questions, ou si le développement de mcabber vous intéresse + (attention, conférence en anglais). + + _Les contributions sont bienvenues, n'hésitez pas!_ + +* Vous pouvez utiliser le [dépôt Mercurial][main_repo] si vous voulez utiliser + la dernière version ou développer mcabber. Cf. + [[Building_mcabber_from_Mercurial]] (en anglais). + +* Vous pouvez consulter la page [[TODO]], pour voir les fonctionnalités futures + (ou du moins demandées). + +# FAQ + +La foire aux questions n'a pas été traduite. + +# Trucs et Astuces + +Vous pouvez consulter la page [[Tips_And_Tricks]] (anglais) pour quelques conseils +(peut-être) intéressants. + +# Liens + +* [Page officielle de MCabber][home] +* [Jabber Software Foundation][jabberorg] +* [XMPP Standards Foundation][xsf] +* [[!wikipedia Jabber desc="Jabber sur Wikipedia"]] + +[home]: http://mcabber.com/ +[main_repo]: http://mcabber.com/hg/ +[xsf]: http://www.xmpp.org/xsf/ +[jabberorg]: http://www.jabber.org/ +[manpage]: http://www.lilotux.net/~mikael/mcabber/files/mcabber.1.html +[petit guide]: http://www.linuxpedia.fr/doku.php/internet/mcabber + diff -r eff7327bcabe -r 1e57279b82b1 index.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/index.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,81 @@ + +[MCabber][home] is a console-based Jabber client, released under the GNU GPL. + +Translations: [[German|de]], [[French|fr]], [[Russian|ru]], [[Ukrainian|uk]]. + +[[!toc]] + +# Features + +* mcabber is a text Jabber client including features such as **SSL/TLS/SASL** + support, **history logging**, commands **completion**, external **actions + triggers** and **dynamic modules**. It also has **PGP**, **OTR** + ([Off-the-Record Messaging][otr]) and **Aspell/Enchant** support. +* mcabber is reported to run on the following platforms: **GNU/Linux**, + **FreeBSD**, **OpenBSD**, **Mac OS X** and **Cygwin**. +* The following Jabber specifications are supported (in the development + version): + + - [[!xep 0012]] - Last Activity + - [[!xep 0022]] - Message Events + - [[!xep 0027]] - Current Jabber OpenPGP Usage + - [[!xep 0030]] - Service Discovery (partial) + - [[!xep 0045]] - Multi-User Chat + - [[!xep 0048]] - Bookmark Storage + - [[!xep 0049]] - Private XML Storage + - [[!xep 0054]] - vcard-temp (retrieval only) + - [[!xep 0085]] - Chat State Notifications + - [[!xep 0086]] - Error Condition Mappings + - [[!xep 0090]] - Entity Time + - [[!xep 0091]] - Delayed Delivery + - [[!xep 0092]] - Software Version + - [[!xep 0115]] - Entity Capabilities + - [[!xep 0145]] - Annotations + - [[!xep 0146]] - Remote Controlling Clients (partial) + - [[!xep 0184]] - Message Delivery Receipts + - [[!xep 0199]] - XMPP Ping (answering only) + - [[!xep 0202]] - Entity Time + - [[!xep 0203]] - Delayed Delivery + - [[!xep 0249]] - Direct MUC Invitations (partial) + - [[!xep 0280]] - Message Carbons + +# Getting started + +Have a look at the [[Getting_Started]] page for help on running mcabber for the +first time. + +You can read the small [User Guide][userguide] as well to get a quick overview. + +# Modules + +MCabber >= 0.10.0 supports dynamic [[Modules]] (a.k.a. plugins). + +# Tips + +See the [[Tips_And_Tricks]] page for some (maybe) useful advice. Don't forget to +check the [[Frequently_Asked_Questions|FAQ]]. + +# Download + +You can download mcabber tarballs from the [main site][home]. + +Maybe there exist mcabber [[package|Packages]] for your operating system. + +# Development + +See the [[Hacking]] page for information on helping with the development of +mcabber. + +# Links + +* [MCabber official homepage][home] +* [XMPP Standards Foundation][xsf] +* [[!wikipedia Jabber desc="Jabber on Wikipedia"]] +* [Jabber.org IM service][jabberorg] + +[home]: http://mcabber.com/ +[otr]: http://www.cyberpunks.ca/otr/ +[userguide]: http://mcabber.com/files/mcabber_guide.pdf +[xsf]: http://www.xmpp.org/xsf/ +[jabberorg]: http://www.jabber.org/ + diff -r eff7327bcabe -r 1e57279b82b1 ru/index.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/ru/index.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,199 @@ + + +[MCabber][home] - это консольный Jabber-клиент, созданный под лицензией GNU GPL. + +[[!toc]] + +# Особенности + +* mcabber - это текстовый Jabber-клиенкт включающий в себя такие функции как: + поддержка **SSL**, **история переписки** (конференции), **автодополнение** + команд и возможность создания **собственных команд** (триггеров). +* mcabber работает на следующих платформах: **GNU/Linux**, **FreeBSD**, + **NetBSD**, **Mac OS X** и **Cygwin**. +* Следующие Jabber-спецификации поддерживаются (в последней версии): + + - [[!xep 0012]] - просмотр последних действий Last Activity + - [[!xep 0022]] - события на сообщения Message Events + - [[!xep 0027]] - поддержка OpenPGP Current Jabber OpenPGP Usage + - [[!xep 0030]] - обзор служб (частично) Service Discovery (partial) + - [[!xep 0045]] - конференции Multi-User Chat + - [[!xep 0048]] - хранение закладок Bookmark Storage + - [[!xep 0049]] - приватное хранение XML Private XML Storage + - [[!xep 0054]] - работа с VCard (только получение) vcard-temp (retrieval only) + - [[!xep 0085]] - уведомление о статусе Chat State Notifications + - [[!xep 0086]] - Error Condition Mappings + - [[!xep 0090]] - Entity Time + - [[!xep 0091]] - отложенная доставка Delayed Delivery + - [[!xep 0092]] - версия программного обеспечения Software Version + - [[!xep 0115]] - Entity Capabilities + - [[!xep 0145]] - аннотации Annotations + - [[!xep 0146]] - Remote Controlling Clients (partial) + - [[!xep 0184]] - Message Delivery Receipts + - [[!xep 0199]] - XMPP Ping (answering only) + - [[!xep 0202]] - Entity Time + - [[!xep 0203]] - Delayed Delivery + - [[!xep 0249]] - Direct MUC Invitations (partial) + - [[!xep 0280]] - Message Carbons + +# Вводная часть + +* Загрузка + + - Получите последнюю версию mcabber c [официального сайта][home]. Обычно это + сжатый bzip архив tar (например, "mcabber-0.9.1.tar.bz2"). + - Распакуйте его: + + % tar xvjf mcabber-0.9.1.tar.bz2 + % cd mcabber-0.9.1 + +* Установка + + Примечание: если Вы не хотите устанавливать mcabber в системную папку, + используйте ключ `--prefix`. + + % ./configure + % make + % make install + +* Первый запуск + + Вы можете запустить mcabber без файла конфигурации, но тогда Вам придется + вводить данные настройки вручную. Самый простой способ это скопировать файл + конфигурации, распространяемый с исходным кодом программы: + + % mkdir ~/.mcabber + % chmod 0700 ~/.mcabber + % cp mcabberrc.example ~/.mcabber/mcabberrc + + Теперь отредактируйте файл конфигурации. Вы должны задать Ваши имя + пользователя и сервер. (Примечание: если Вы хотите использовать + SSL-шифрование, взгляните на опции `ssl` и `ssl_verify` в файле конфигурации). + + Теперь можно запускать mcabber! + + Рабочее окно mcabber(1) поделено на 4 области. **Список контактов**, + **псевдонимы пользователей** (слева). **Окно чата (конференции)** (справа). + **Строка ввода команд и сообщений** (внизу, под маленьким **окном журнала + событий**). + + Две строки с информацией о статусе обрамляют **окно журнала событий**. Нижняя + строка статуса - это "строка основного статуса" и отображает общий статус + mcabber'а. Другая строка (сверху окна журнала событий) это **статус чата + (конференции)** и отображает статус текущего пользователя. + + Чтобы увидеть окно чата (конференции), Вы должны войти в [[режим чата + (конференции)|Chat_Mode]]. Вы можете войти в режим _чата (конференции)_ нажав + "Enter" и покинуть этот режим нажав клавишу "ESC". Простая отправка сообщений + так же работает в _режиме чата (конференции)_. + + Используйте PageUp/PageDown для перемещения по списку контактов. + +* Прочитайте [Manpage][manpage-ru] (на русском) для получения дополнительной + информации и пример файла конфигурации, чтобы увидеть все возможные опции. + + Если mcabber поддерживает Ваш язык, Вы можете установить его, используя опцию + `lang` в файле конфигурации. + +# Разработка + +* Если у Вас есть вопросы или предложения, Вы можете присоединиться к конфереции + (MUC Jabber) MCabber по адресу: + [mcabber@conf.lilotux.net](xmpp:mcabber@conf.lilotux.net) + + _Помощь всегда приветствуется, не стесняйтесь!_ + +* Если Вы заинтересованы в развитии mcabber`а или хотите иметь последнюю + разрабатываемую или ее хак, взгляните на [репозитарий Mercurial][main_repo]. + +# FAQ + +MCabber не хочет соединяться с сервером. Выдает ошибку: `jab_start: SSL negotiation failed: self signed certificate`. +: Используйте опцию `ssl_verify = 0` в файле конфигурации и выставьте + правильные опции сертификата. + +Как я могу подключиться к моему аккаунту на Google Talk? +: Должно работать со следующими опциями: + + set username = your.email@gmail.com + set server = talk.google.com + set ssl = 1 + set ssl_verify = 0 + +Я хочу назначить определенную клавишу на выполнение команды, как мне узнать ее код? +: Если код клавиши доступен, то он будет показан в окне истории, когда Вы + нажмете нужную клавишу. + +Как мне создать группу пользователей? +: Используйте команды `/move`, если указанной группы нет - она будет создана + автоматически. + +Как мне сделать прозрачный фон? +: Установите `color_background = default`. + +Могу ли я использовать PGP-шифрование? +: Смотрите страницу [[OpenPGP]]. + +MCabber под NetBSD? +: Версия mcabber'а 0.9.1 включена в дерево pkgsrc под NetBSD, если же вы + хотите установить mcabber под NetBSD из исходников (c поддержкой + OpenPGP-шифрования) предварительно следует установить пакет gpgme-1.0.3nb3 + и curses версии не старее чем ncursesw-5.6. Далее, в случае привязки к + OpenSSL, имеющемуся базовой системе, а не к gnutls, инсталляция происходит + следующим образом: + + $ export CFLAGS='-I/usr/pkg/include' + $ export LDFLAGS='-L/usr/pkg/lib' + $ ./configure --with-ssl --with-openssl=/usr/lib --with-gpgme-prefix=/usr/pkg --enable-gpgme + $ make + $ make install + +(Инсталляция произойдёт в каталог `/usr/local`, но в случае надобности +параметр `prefix`, отвечающий за выбор каталога, может быть изменён). +Примечание: справделиво для версии 0.9.1 + +Как отключить идентифицирующую меня информацию в mcabber (показ названия и версии клиента, версии ОС и имени ресурса)? +: Чтобы убрать показ поля `Name` при запросе версии клиента нужно + перекомпилировать исходник, предварительно закомментировав в файле + `jab_iq.c` строки под нимером 1510 и 1511 (для версии 0.9.6): + + //xmlnode_insert_cdata(xmlnode_insert_tag(myquery, "name"), PACKAGE_NAME, -1); + //xmlnode_insert_cdata(xmlnode_insert_tag(myquery, "version"), ver, -1); + +Затем, требуется прописать в конфигурационном файле: + + set iq_version_hide_os = 1 + set resource = myresource + +Следует заметить, что значение опции `resource` нельзя оставить пустым: в +противном случае она будет равна `mcabber`. + +Как мне получить исходные коды mcabber используя Mercurial? +: Вы невнимательны! Я уже говорил, смотрите + [[исходные коды на Mercurial|Bulding_mcabber_from_Mercurial]]. + +Уменя есть просьба\предложение! +: Прекрасно! Приходите и расскажите о нем в конференции mcabber! + +Я хочу помочь материально... +: Что, серьезно? Воспользуйтесь моей почтой или jid и свяжитесь со мной! ;-) + +# Советы + +Смотри раздел [[Tips_And_Tricks]], может и поможет что нибудь. + +# Links + +* [MCabber домашняя страница][home] +* [MCabber домашняя страница на русском + manpage][home-ru] +* [Jabber Software Foundation][jabberorg] +* [[!wikipedia Jabber desc="Jabber в Wikipedia"]] + +[home]: http://mcabber.com/ +[home-ru]: http://linsovet.com/mcabber_mainpage_ru +[manpage-ru]: http://zenwalk.info/index.php?itemid=18 +[main_repo]: http://mcabber.com/hg/ +[otr]: http://www.cyberpunks.ca/otr/ +[userguide]: http://mcabber.com/files/mcabber_guide.pdf +[jabberorg]: http://www.jabber.org/ + diff -r eff7327bcabe -r 1e57279b82b1 shortcuts.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/shortcuts.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,36 @@ +* [[!shortcut name=xep url="http://xmpp.org/extensions/xep-%s.html" desc="XEP-%s"]] + +* [[!shortcut name=google url="https://encrypted.google.com/search?q=%s"]] +* [[!shortcut name=archive url="http://web.archive.org/*/%S"]] +* [[!shortcut name=gmap url="https://maps.google.com/maps?q=%s"]] +* [[!shortcut name=gmsg url="https://groups.google.com/groups?selm=%s"]] +* [[!shortcut name=wikipedia url="https://en.wikipedia.org/wiki/%W"]] +* [[!shortcut name=wikitravel url="https://wikitravel.org/en/%s"]] +* [[!shortcut name=wiktionary url="https://en.wiktionary.org/wiki/%s"]] +* [[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="Debian bug #%s"]] +* [[!shortcut name=deblist url="https://lists.debian.org/debian-%s" desc="debian-%s@lists.debian.org"]] +* [[!shortcut name=debpkg url="http://packages.debian.org/%s"]] +* [[!shortcut name=debpkgsid url="http://packages.debian.org/sid/%s"]] +* [[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]] +* [[!shortcut name=debmsg url="https://lists.debian.org/msgid-search/%s"]] +* [[!shortcut name=debrt url="https://rt.debian.org/Ticket/Display.html?id=%s"]] +* [[!shortcut name=debss url="http://snapshot.debian.org/package/%s/"]] + * Usage: `\[[!debss package]]` or `\[[!debss package/version]]`. See for details. +* [[!shortcut name=debwiki url="https://wiki.debian.org/%S"]] +* [[!shortcut name=debcve url="https://security-tracker.debian.org/tracker/%S"]] + * also supports Debian bug numbers, packages and whatever the [security tracker](https://security-tracker.debian.org/tracker/) supports. +* [[!shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] +* [[!shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] +* [[!shortcut name=gnomebug url="https://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]] +* [[!shortcut name=linuxbug url="https://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]] +* [[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]] +* [[!shortcut name=gnulist url="https://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]] +* [[!shortcut name=iki url="http://ikiwiki.info/%S/"]] +* [[!shortcut name=rfc url="https://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]] +* [[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=*&Database=*&Query=%s"]] +* [[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]] +* [[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]] +* [[!shortcut name=cve url="https://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]] +* [[!shortcut name=man url="http://manpages.debian.org/%s"]] +* [[!shortcut name=ubupkg url="http://packages.ubuntu.com/%s"]] +* [[!shortcut name=pkgsrc url="http://pkgsrc.se/%S"]] diff -r eff7327bcabe -r 1e57279b82b1 uk/FAQ.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/uk/FAQ.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,80 @@ +[[!meta title="ЧАПи"]] + +MCabber не з'єднується. Він видає повідомлення `jab_start: SSL negotiation failed: self signed certificate`. +: Встановіть `ssl_verify = 0` у файлі налаштувань, щоб заборонити перевірку + достовірності сертифікату або ж правильно встановіть параметри, що + стосуються сертифікату. + +Як мені під'єднатися до Google Talk? +: Наступний набір опцій має працювати: + + set username = your.email@gmail.com + set server = talk.google.com + set ssl = 1 + set ssl_verify = 0 + +Я хочу призначити дію клавіші, як мені дізнатися її код? +: Якщо клавіші не призначено ніякої дії, коли ви натиснете її, MCabber + надрукує її код у вікно повідомлень. + +Як мені створити групу? +: Просто використовуйте команду переносу `/move`, якщо відповідної групи + призначення не існує, її буде створено. + +Як мені зробити фон прозорим? +: Встановіть `color_background = default`. + +Як використовувати PGP-шифрування? +: Дивіться сторінку про [[OpenPGP]]. + +Як використовувати OTR-шифрування? +: Хтось на цю тему написав маленьке [ЯКЦЕ][otr_howto]. + +Як отримати сирці MCabber із Mercurial? +: Див. [[Побудова MCabber із Mercurial|Building_mcabber_from_Mercurial]]. + +Чому курсор не ставиться в кінець рядка коли я перегортаю історію вводу? +: Зазвичай клавішам вверх та вниз призначено дії + `iline hist_beginning_search_bwd/hist_beginning_search_fwd`, тобто пошук за + початком фрази перед курсором, що є дуже зручним, коли ви до цього звикнете. + Але, якщо вам це не подобається, ви можете призначити цим клавішам + (259, 258) дії `hist_prev/hist_next`. + +Як позбутися затримки після натиснення ESC? +: Ви можете зменшити затримку, встановивши змінну оточення `ESCDELAY` (це + змінна Ncurses). Наприклад, export `ESCDELAY=25; mcabber`. + У версіях MCabber > 0.9.5 також є опція `escdelay`. + +Як заборонити прокрутку при отриманні повідомлення? +: Див. довідку до `/buffer scroll_lock` та `scroll_unlock`. + Також можна призначити клавішу для `buffer scroll_toggle`. + +Чи можна використовувати транспорти із MCabber? +: Ви не зможете зареєструватися там із MCabber. Втім, якщо ви вже + зареєстровані, ви можете їх активувати, надсилаючи їм повідомлення про + присутність (в т.ч. див. `/status_to`). + +MCabber пише `WARNING: Bad permissions!` Які права доступу "гарні"? +: Директорія ~/.mcabber повинна мати права доступу 700 (`rwx------`), а файл + налаштувань повинен мати права 600 (`rw-------`), щоб ніхто інший окрім + власника не міг прочитати його (там може бути пароль!). + +У 0.10.2 не працює fifo! (також url regex) +: У 0.10.2 `fifo` та `url regex` винесли у окремі від mcabber модулі. Модуль + можна завантажити комадною `/module load fifo` (або `url_regex` відповідно). + Також ці команди можна всатвити у ваш `mcabberrc`, щоб модулі + завантажувалися автоматично. Зауважте, що при цьому параметри модуля мають + вказуватися до його завантаження. + +У мене є побажання щодо розвитку MCabber! +: Заходьте у кімнату багатокористувацької балачки, й поділіться з нами. + +Я хотів би підтримати MCabber грошима... +: Що, дійсно? Знайдіть мою поштову чи jabber-адресу у сирцях, й напишіть мені! + ;-) + Також можна це зробити через PayPal + (кнопка на сайті [домівки MCabber][home]). + +[home]: http://mcabber.com/ +[otr_howto]: http://www.fsfe.org/es/fellows/smc/weblog/mcabber_and_otr + diff -r eff7327bcabe -r 1e57279b82b1 uk/Getting_Started.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/uk/Getting_Started.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,62 @@ +[[!meta title="Початок роботи"]] + +[[!toc]] + +# Звантаження + +* Звантажте останню версію MCabber з [офіційного веб-сайту][home]. Зазвичай це + tar-архів, стиснутий bzip, наприклад, 'mcabber-0.8.3.tar.bz2'. +* Розпакуйте його: + + % tar xvjf mcabber-0.8.3.tar.bz2 + % cd mcabber-0.8.3 + +# Встановлення + +**Зауваження:** Якщо ви не бажаєте встановлювати MCabber загальносистемно, ви +маєте вказати параметр `--prefix`. + + % ./configure + % make + % make install + +**Користувачам OpenBSD:** Скоріше за все вам доведеться додати параметр +`--enable-sigwinch`, бо за звичайної конфігурації цей сигнал не буде +оброблятися. + +# Перший запуск + +Ви можете запускати MCabber без конфігураційного файлу, але тоді вам доведеться +кожного разу встановлювати усі параметри власноруч. Набагато легше скопіювати +приклад конфігураційного файлу, що йде із сирцями програми: + + % mkdir ~/.mcabber + % chmod 0700 ~/.mcabber + % cp mcabberrc.example ~/.mcabber/mcabberrc + +Тепер його треба відредагувати. Ви можете вказати ім'я користувача й ваш +jabber-сервер. (Зауваження: Якщо вам потрібно використовувати SSL-шифрування, +зверніть увагу на опцію `ssl_verify`) + +Ну що ж, ніби все, тепер ви можете запустити MCabber. + +# Добре, він запустився... Але як у ньому працювати?? + +MCabber ділить екран на чотири частини. **Список контактів** зліва, **вікно +бесіди** зправа й **вікно повідомлень** із **рядком вводу** внизу. Вікно +повідомлень обмежене двома рядками статусу: знизу показується ваш статус, а +зверху - статус наразі обраного контакту. Щоб побачити буфер розмови, вам треба +увійти у [[режим розмови|Chat_Mode]]. Увійти в нього можна натиснувши ввід +(Enter), а вийти - натиснувши ESC. Рухатися по списку контактів можна за +допомогою клавіш PageUp та PageDown. + +# Додаткові налаштування + +За детальнішою інформацією дивіться [man-сторінку][manpage]. Приклад +конфігураційного файлу містить усі доступні налаштування. Також є вбудована +команда довідки `/help`. Якщо довідку було перекладено на зручну для вас мову, +ви можете встановити параметр `lang` (наприклад, `set lang = uk`). + +[home]: http://mcabber.com/ +[manpage]: http://www.lilotux.net/~mikael/mcabber/files/mcabber.1.html + diff -r eff7327bcabe -r 1e57279b82b1 uk/Tips_And_Tricks.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/uk/Tips_And_Tricks.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,153 @@ +[[!meta title="Поради й рецепти"]] + +[[!toc]] + +# Багаторядкові повідомлення + +Ви можете надсилати багаторядкові повідомлення за допомогою команди `/msay` +(див. [man-сторінку][manpage]). + +Ви можете призначити клавіші до `/msay toggle` та (чи) до `/msay +toggle_verbatim`, щоб мати змогу швидко перемикати багаторядковий режим: + + # Alt-m для перемикання в/із багаторядкового режиму + bind M109 = msay toggle + # Alt-M для перемикання в/із verbatim-багаторядкового режиму + bind M77 = msay toggle_verbatim + +# Швидкий перехід до контакту + +Ви можете використовувати команду `/roster search` для переходу до визначеного +контакту у списку. Або навіть призначати для цього клавіші, наприклад, якщо ви +дуже багато розмовляєте із john.doe@jabber.foo, ви можете призначити F1: + + bind 265 = roster search john.doe + +**Зауваження:** Ця команда шукає лише серед видимих контактів, отож якщо ви +ввімкнули приховування відсутніх у мережі контактів, вона може нічого не знайти, +якщо контакт поза мережею. + +Або ви можете визначити скорочення для цієї команди, якщо ви часто її +використовуєте із різними параметрами: + + alias rsearch = roster search + +Тепер, завдяки доповненню команд, вам треба набрати лише `/rs`. + +# Одна бесіда із декількома контактами + +(Для цього вам знадобиться версія MCabber не менша за 0.9.2) +Ви використовуєте jabber з декількома транспортами, й маєте контакти, які +використовують декілька різних систем? MCabber може вести один журнал бесід для +них усіх. + +Скажімо, у вас є контакти abc@jabber.org та abc@icq.jabber.org. Спочатку вам +треба об'єднати існуючі файли журналів за допомогою `merge_history.py`. + + $ cd ~/.mcabber/histo/ + $ merge_history abc\@jabber.org abc\@icq.jabber.org > abc + $ mv abc abc\@jabber.org + $ rm abc\@icq.jabber.org + +Тепер треба створити символічне посилання +(`abc@icq.jabber.org -> abc@jabber.org`): + + $ ln -sf abc\@jabber.org abc\@icq.jabber.org + +Після перезавантаження MCabber завантажить журнал бесіди лише один раз для двох +контактів. Обидва контакти будуть мати однакові буфери бесід. Команди, які +працюють із буфером бесіди, як то `/buffer scroll_lock/purge/clean`, виконані на +одному контакті, вплинуть й на буфер іншого, бо насправді це один і той же +буфер. + +Таким чином можна зібрати до купи скільки завгодно контактів, не тільки два... +:) + +# Показ доступності контактів із транспорту + +За допомогою FIFO та скрипта обробки подій ви можете позначати контакти із +транспорту іншим кольором коли транспорт відключено. У `mcabberrc`: + + color roster clear + color roster * * green + color roster dn_? * brightblack + color roster * *@icq.jabber.org red + color roster dn_? *@icq.jabber.org red + +Це позначить контакти як недоступні на початку. Тоді у `eventcmd.sh`, там де +обробляється подія `STATUS` (`"$1" = 'STATUS') + + if [ "$3" = 'icq.jabber.org' ]; then + if [ "$2" = '_' ]; then + echo "color roster * *@icq.jabber.org red" > ~/.mcabber/fifo + echo "color roster dn_? *@icq.jabber.org red" > ~/.mcabber/fifo + else + echo "color roster * *@icq.jabber.org white" > ~/.mcabber/fifo + echo "color roster dn_? *@icq.jabber.org brightblack" > ~/.mcabber/fifo + fi + fi + +Цей код змінюватиме забарвлення контактів кожен раз, як транспорт змінюватиме +свій статус. + +# Відкладені дії (наприклад, повідомлення для контакту у 'dnd') + +Ви можете відкласти виконання якоїсь дії до тих пір, доки контакт не стане +готовим її прийняти (або доки не трапиться якась інша подія). Додайте до +`eventcmd.sh`: + + if [ -f ~/.mcabber/jobs/"$1_$2_$3" ]; then + cat ~/.mcabber/jobs/"$1_$2_$3" > ~/.mcabber/fifo + rm ~/.mcabber/jobs/"$1_$2_$3" + fi + +Та створіть директорію для відкладених завдань: + + $ mkdir ~/.mcabber/jobs/ + +Тепер ви можете робити речі на кшталт цієї: + + $ cat > ~/.mcabber/jobs/STATUS_O_buddy@jabber.org < say_to -q buddy@jabber.org Привіт! Це автоматичне повідомлення. + > say_to -q buddy@jabber.org Будь ласка, коли звільнишся, зроби те-то й те-то. + > EOF + +Отож ви не будете турбувати контакт, доки він перебуває у `dnd`, і в той же час +вам не треба тримати це повідомлення в голові. + +# Згортання груп при старті + +Використовуючи hook'и ви можете згортати рідко використовувані групи контактів +(наприклад, група транспортів та інших технічних контактів) при старті. У +`mcabberrc`: + + set hook-post-connect = source ~/.mcabber/post-connect.rc + set hook-pre-disconnect = source ~/.mcabber/pre-disconnect.rc + +А в `~/.mcabber/post-connect.rc`: + + group fold Технічні + group fold Старі + +# Автоматична зміна статусу при від'єднанні screen + +Якщо ви хочете встановлювати відповідний статус, коли ви закриваєте термінал з +screen, в якому запущений mcabber, додайте до вашого `~/.logout` (або +`~/.bash_logout`, якщо ви користуєтеся BASH): + + # mcabber auto-away - скоріше за все, працюватиме лише в Linux, бо використовується /proc + if [ -p .mcabber/mcabber.fifo ]; then + MCABBER_PID=$(pgrep -u $USER mcabber) + if [ -n $MCABBER_PID ]; then + MCABBER_STY=$(cat /proc/$MCABBER_PID/environ | tr '\0' '\n' | grep '^STY=' | cut -d'=' -f2) + + if [ -n $MCABBER_STY ]; then + if [ -z "$(screen -list | grep $MCABBER_STY.*\(Attached\))" ]; then + echo /status notavail > .mcabber/mcabber.fifo + fi + fi + fi + fi + +[manpage]: http://www.lilotux.net/~mikael/mcabber/files/mcabber.1.html + diff -r eff7327bcabe -r 1e57279b82b1 uk/index.mdwn --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/uk/index.mdwn Sun May 14 20:58:00 2017 +0300 @@ -0,0 +1,79 @@ +[[!meta title="Головна сторінка"]] + +[MCabber][home] - це консольний клієнт jabber, що розповсюджується під +ліцензією GNU GPL. + +Ця сторінка іншими мовами: [English](/), [[Русский|/ru]], [[Français|/fr]], +[[Deutsch|/de]]. + +[[!toc]] + +# Можливості + +* mcabber це текстовий клієнт із підтримкою SSL, збереженням записів бесід, + доповненням команд та можливістю зовнішнього реагування на події. Також він + підтримує шифрування за допомогою PGP і OTR ([Off-the-Record Messaging + (Спілкування без запису)][otr]) та перевірку правопису, використовуючи Aspell. +* mcabber тестувався на платформах GNU/Linux, FreeBSD, OpenBSD, Mac OS X та + Cygwin. +* Стандарти Jabber, що підтримуються розробницькою версією: + + - [[!xep 0012]] - Остання активність + - [[!xep 0022]] - Події повідомлень + - [[!xep 0027]] - Поточне використання OpenPGP у Jabber + - [[!xep 0030]] - Дослідження сервісів (частково) + - [[!xep 0045]] - Багатокористувацький чат + - [[!xep 0048]] - Зберігання нотаток + - [[!xep 0049]] - Зберігання приватних записів XML + - [[!xep 0054]] - Візитівки (тимчасовий) (лише отримання) + - [[!xep 0085]] - Сповіщення про набір повідомлень + - [[!xep 0086]] - Відповідність позначень помилок + - [[!xep 0090]] - Час об'єкту + - [[!xep 0091]] - Затримана доставка + - [[!xep 0092]] - Версія програми + - [[!xep 0115]] - Можливості об'єкта + - [[!xep 0145]] - Нотатки + - [[!xep 0146]] - Дистанційний контроль клієнтів (частково) + - [[!xep 0184]] - Message Delivery Receipts + - [[!xep 0199]] - XMPP Ping (лише відповідь) + - [[!xep 0202]] - Час об'єкта + - [[!xep 0203]] - Сповіщення про затриману доставку + - [[!xep 0249]] - Direct MUC Invitations (partial) + - [[!xep 0280]] - Message Carbons + +# З чого почати? + +Сторінка [[Початок роботи|Getting_Started]] містить керівництво з запуску +MCabber в перший раз. + +Також ви можете прочитати маленьке [керівництво користувача][userguide]. + +# Пакунки + +Інформацію про відомі збірки mcabber під різні операційні системи наведено на +сторінці [[пакунки|Packages]]. Можливо ваша теж є серед них! + +# Розробка + +Як можна допомогти у розробці MCabber розказано на сторінці +[[розробка|Hacking]]. + +# Поради + +Сторінка [[Поради й рецепти|Tips_And_Tricks]] містить деякі рецепти, які можуть +стати вам у нагоді. Також не забудьте переглянути +[[часто задавані питання|FAQ]]. + +# Посилання + +* [Офіційна домівка MCabber][home] +* [Jabber Software Foundation][jabberorg] +* [XMPP Standards Foundation][xsf] +* [[!wikipedia Jabber desc="Jabber у Вікіпедії"]] + +[home]: http://mcabber.com/ +[otr]: http://www.cyberpunks.ca/otr/ +[userguide]: http://mcabber.com/files/mcabber_guide.pdf +[xsf]: http://www.xmpp.org/xsf/ +[jabberorg]: http://www.jabber.org/ +