--- /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
+<http://wodka.lubin.pl:8010> 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 <netprobe@gmail.com> 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.
+
--- /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
+<http://www.selenic.com/mercurial/wiki/>.
+
+[[!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
+
--- /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_.
+
--- /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
--- /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
--- /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 <xmpp:mcabber@conf.lilotux.net>
+ 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/
+
--- /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: <https://bitbucket.org/georgri/mcabber-modules/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-avatar/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-avatar/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-avatar/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-avv/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-avv/index/>
+
+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: <http://mcabber.com/hg/>
+
+Simple module to beep on **all** messages. Available in mcabber 0.10.0. Serves the
+purpose of example for module writing HOWTO.
+
+## clock
+
+* URL: <http://hg.lilotux.net/mcabber-modules/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-cmd/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-cmd/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-cmd/>
+
+Provides command `/cmd`, that sends output of specified shell command to current buddy.
+
+## commands (custom)
+
+* URL: <https://github.com/hirthwork/mcabber-commands/>
+
+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: <http://hg.lilotux.net/mcabber-modules/>
+
+Trivial module; adds a command `#` to ignore a line. This module is part of the
+mcabber-modules repository.
+
+## disco
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-disco/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-disco/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-disco/>
+
+Module adds `/disco` command, that sends service discovery requests.
+
+## env
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-env/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-env/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-env/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-patches/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-patches/index/>
+* Mirror: <http://hg.lilotux.net/mcabber-experimental/>
+
+Modularization of legacy mcabber eventcmd script. Available in experimental
+version of mcabber.
+
+## eventcmd-ng
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-eventcmd-ng/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-eventcmd-ng/index/>
+
+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: <http://hg.lilotux.net/mcabber-modules/>
+
+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: <http://hg.lilotux.net/mcabber-modules/>
+
+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: <http://www.freakysoft.de/repos/mcabber-modules/>
+
+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: <https://github.com/alkino/mcabber-jingle>
+* HG Mirror: <http://hg.lilotux.net/mod-mcabber-jingle/>
+
+Jingle modules written by Alkino during the GSoC 2010. Contains a file transfer
+module (IBB support).
+
+## killpresence
+
+* URL: <http://hg.lilotux.net/mcabber-modules/>
+
+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: <http://hg.lilotux.net/mcabber-modules/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-lua/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-lua/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-lua/>
+
+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: <http://isbear.org.ua/hg/isbear/lua-lm/>
+* Homepage: <http://isbear.org.ua/docs/lua-lm/index/>
+* Mirror: <http://hg.lilotux.net/lua-lm/>
+
+## marking
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-marking/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-marking/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-marking/>
+
+Adds ability to mark several buddies and do some command for each of these
+buddies. Provides commands `/mark` and `/marked`.
+
+## mpd
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-mpd/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-mpd/index/>
+
+Provides information about currently playing song for modules like PEP.
+
+## mucignore
+
+* URL: <https://github.com/hirthwork/mcabber-mucignore/>
+
+Simple plugin to ignore users in MUC conferences.
+
+## pep
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-pep/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-pep/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-pep/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-templatecmd/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-templatecmd/index/>
+
+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 <filename_here> .` - this module is for you.
+
+## uptime
+
+* URL: <http://isbear.org.ua/hg/isbear/mcabber-uptime/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-uptime/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-uptime/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-urlopen/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-urlopen/index/>
+
+Looks for urls in incoming messages and prints them to log and/or calls shell
+command to handle them.
+
+## xttitle
+
+* URL: <http://mcabber.com/hg/>
+
+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: <http://isbear.org.ua/hg/isbear/mcabber-yaubil/>
+* Homepage: <http://isbear.org.ua/docs/mcabber-yaubil/index/>
+* Mirror: <http://hg.lilotux.net/mod-mcabber-yaubil/>
+
+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
+ `<install prefix>/share/doc/libmcabber-<modulename>/`), 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
--- /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
+
--- /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
+
--- /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
+
--- /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<tab>` 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 <<EOF
+ > 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
+
--- /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 @@
+<!-- FIXME -->
+[[!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/
+
--- /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 @@
+<!-- FIXME -->
+[[!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
+
--- /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/
+
--- /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 @@
+
+<!-- FIXME: this page contains some multimarkdown definition lists quirks with blocks -->
+[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/
+
--- /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 <http://snapshot.debian.org/> 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"]]
--- /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
+
--- /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
+
--- /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<tab>`.
+
+# Одна бесіда із декількома контактами
+
+(Для цього вам знадобиться версія 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 <<EOF
+ > 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
+
--- /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/
+