forked from Disroot/Howto
Merge pull request 'CHAT_Bridges_Gateways' (#75) from CHAT_Bridges_Gateways into master
Reviewed-on: Disroot/Howto#75 Reviewed-by: meaz <meaz@no-reply@disroot.org>
This commit is contained in:
commit
9abad28d75
83
pages/02.tutorials/04.Chat/04.Gateways/01.IRC/docs.en.md
Normal file
83
pages/02.tutorials/04.Chat/04.Gateways/01.IRC/docs.en.md
Normal file
|
@ -0,0 +1,83 @@
|
||||||
|
---
|
||||||
|
title: 'IRC'
|
||||||
|
published: true
|
||||||
|
visible: true
|
||||||
|
indexed: false
|
||||||
|
updated:
|
||||||
|
last_modified: March, 2021
|
||||||
|
app: Biboumi
|
||||||
|
app_version: 9.0
|
||||||
|
taxonomy:
|
||||||
|
category:
|
||||||
|
- docs
|
||||||
|
tags:
|
||||||
|
- chat
|
||||||
|
- xmpp
|
||||||
|
- irc
|
||||||
|
page-toc:
|
||||||
|
active: true
|
||||||
|
---
|
||||||
|
|
||||||
|
# XMPP to IRC gateway
|
||||||
|
|
||||||
|
[**IRC**](https://en.wikipedia.org/wiki/Internet_Relay_Chat) is a real time communication protocol based on text.
|
||||||
|
|
||||||
|
**Disroot Chat** allows you to connect to any **IRC** channel, on any server, using your **XMPP** client of choice. This is possible thanks to [**Biboumi**](https://biboumi.louiz.org/), a gateway that connects both protocols and allows access to IRC channels as if they were XMPP rooms. Our gateway is hosted at **irc.disroot.org**
|
||||||
|
|
||||||
|
# How does it work?
|
||||||
|
## Joining a channel
|
||||||
|
To join an **IRC** channel using your **XMPP** client, use the following schema:
|
||||||
|
|
||||||
|
`#channelname%irc.network.tld@irc.disroot.org`
|
||||||
|
|
||||||
|
For example, to join **#archlinux** channel on the **Freenode IRC** network you need to use the following format:
|
||||||
|
|
||||||
|
`#archlinux%irc.freenode.net@irc.disroot.org`
|
||||||
|
|
||||||
|
Make sure to provide the correct channel name (**#channel**) and IRC server's address (**irc.network.ltd**).<br>
|
||||||
|
**@irc.disroot.org** must remain as it is pointing to our **Biboumi**'s address.
|
||||||
|
|
||||||
|
## Private chats (1:1)
|
||||||
|
The gateway also allows private chats with IRC users (1 on 1 chat). To start a private chat with a user on IRC, you need to use the following syntax:
|
||||||
|
|
||||||
|
`nick%irc.network.tld@irc.disroot.org`
|
||||||
|
|
||||||
|
Where **nick** is the username you want to talk to.
|
||||||
|
|
||||||
|
## Nicknames
|
||||||
|
While on **XMPP** a user can have a different nickname for each room, **IRC** nicknames are server-wide, which means that a user only has one single nickname on all the channels of a server. So, the nickname you choose when joining an IRC channel on a given server will be the same in all other channels that you join on that same server.
|
||||||
|
|
||||||
|
Keep in mind that if you change your nickname on an IRC channel, it will be changed on all channels on the same server as well. To have a different nickname in a channel you are about to join, you will need to do it explicitly with the **/nick** command before joining the channel.
|
||||||
|
|
||||||
|
For example: `/nick yournickname` (most IRC servers limit the nickname to 9 characters)
|
||||||
|
|
||||||
|
# User settings
|
||||||
|
IRC settings can be configured at three different levels:
|
||||||
|
|
||||||
|
1. Transport Level: `irc.disroot.org`
|
||||||
|
2. Network Level: `irc.network.tld@irc.disroot.org`
|
||||||
|
3. Channel Level: `#channel%irc.network.tld@irc.disroot.org`
|
||||||
|
|
||||||
|
If there are common options across all the levels, priority or over-ride of those settings is set in the following way:
|
||||||
|
|
||||||
|
`1. Channel > 2. Network > 3. Transport`
|
||||||
|
|
||||||
|
## Short-term / one-shot setup
|
||||||
|
|
||||||
|
1. Join chat `#channel%irc.network.tld@irc.disroot.org`, with a chosen nick.
|
||||||
|
2. You will get messages from `irc.network.tld@irc.disroot.org`. If your nick is registered, send message `NickServ IDENTIFY password`.
|
||||||
|
3. Start chatting in `#channel`.
|
||||||
|
|
||||||
|
To setup a **different channel** on the **same network** just repeat steps 1 and 3. To setup a **different channel** but on a **different network** then repeat steps 1 to 3.
|
||||||
|
|
||||||
|
## Long-term / recurring setup
|
||||||
|
|
||||||
|
1. Add `irc.disroot.org` to your roaster.
|
||||||
|
2. Execute ad-hoc command on it, then enable history and persistence.
|
||||||
|
3. Add `irc.network.tld@irc.disroot.org` to your roaster.
|
||||||
|
4. Execute ad-hoc command on it, then add your username (nick) and password (nick password).
|
||||||
|
5. Add `#channel%irc.network.tld@irc.disroot.org` to bookmarks and then join.
|
||||||
|
6. Execute ad-hoc command on it, then enable history and persistence.
|
||||||
|
7. Start chatting in `#channel`.
|
||||||
|
|
||||||
|
To join a **different channel** on the **same network**, repeat steps 5 to 7. But if you want to join a **different channel** on a **different network** then repeat steps 3 to 7.
|
32
pages/02.tutorials/04.Chat/04.Gateways/02.Matrix/docs.en.md
Normal file
32
pages/02.tutorials/04.Chat/04.Gateways/02.Matrix/docs.en.md
Normal file
|
@ -0,0 +1,32 @@
|
||||||
|
---
|
||||||
|
title: 'Matrix bridge'
|
||||||
|
published: true
|
||||||
|
visible: true
|
||||||
|
indexed: false
|
||||||
|
updated:
|
||||||
|
last_modified: March, 2021
|
||||||
|
app: Bifrost
|
||||||
|
app_version: 0.2.0
|
||||||
|
taxonomy:
|
||||||
|
category:
|
||||||
|
- docs
|
||||||
|
tags:
|
||||||
|
- chat
|
||||||
|
- xmpp
|
||||||
|
- matrix
|
||||||
|
- bridge
|
||||||
|
page-toc:
|
||||||
|
active: false
|
||||||
|
---
|
||||||
|
|
||||||
|
# Matrix bridge
|
||||||
|
You can connect to any **Matrix** room hosted on any **Matrix** server via **Bifrost Matrix bridge** (_**which is hosted by Matrix.org**_). To join a Matrix room:
|
||||||
|
|
||||||
|
`#room#matrix.domain.tld@matrix.org`
|
||||||
|
|
||||||
|
Where `#room` is the **Matrix** room you want to join and `matrix.domain.tld` is the **Matrix server address** you want to join. Make sure to leave `@matrix.org` as it is, because it's the **Matrix bridge address**.
|
||||||
|
|
||||||
|
!! ### IMPORTANT NOTICE
|
||||||
|
!! As it is mentioned in the [**Bifrost**](https://github.com/matrix-org/matrix-bifrost)'s code page:<br>
|
||||||
|
!! ###### `This bridge is in very active development currently and intended mainly for experimentation and evaluation purposes`
|
||||||
|
!! **So please keep in mind that this "bridge" is unstable and sometimes it can be down**.
|
BIN
pages/02.tutorials/04.Chat/04.Gateways/bridges.png
Normal file
BIN
pages/02.tutorials/04.Chat/04.Gateways/bridges.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 140 KiB |
29
pages/02.tutorials/04.Chat/04.Gateways/docs.en.md
Normal file
29
pages/02.tutorials/04.Chat/04.Gateways/docs.en.md
Normal file
|
@ -0,0 +1,29 @@
|
||||||
|
---
|
||||||
|
title: 'Chat: Gateways and Bridges'
|
||||||
|
published: true
|
||||||
|
visible: true
|
||||||
|
indexed: true
|
||||||
|
updated:
|
||||||
|
taxonomy:
|
||||||
|
category:
|
||||||
|
- docs
|
||||||
|
tags:
|
||||||
|
- chat
|
||||||
|
- xmpp
|
||||||
|
page-toc:
|
||||||
|
active: true
|
||||||
|
---
|
||||||
|
|
||||||
|
# XMPP: Gateways and bridges
|
||||||
|
|
||||||
|
![](bridges.png)
|
||||||
|
|
||||||
|
On the internet there are a wide variety of networks co-existing, most of them using different hardware and running different software. One way to enable communication between them is through **gateways** and **bridges**. These allow users on different platforms to communicate with each other regardless of the protocols they use.
|
||||||
|
|
||||||
|
Currently, **Disroot Chat** allows interaction with the following protocols:
|
||||||
|
|
||||||
|
## [IRC](irc)
|
||||||
|
Learn how to use the **IRC** gateway
|
||||||
|
|
||||||
|
## [Matrix](matrix)
|
||||||
|
Learn how to use the **Matrix** bridge
|
BIN
pages/02.tutorials/04.Chat/04.Gateways/thumb.png
Normal file
BIN
pages/02.tutorials/04.Chat/04.Gateways/thumb.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 117 KiB |
|
@ -1,77 +0,0 @@
|
||||||
---
|
|
||||||
title: 'Chat Transports: IRC'
|
|
||||||
published: true
|
|
||||||
visible: true
|
|
||||||
indexed: true
|
|
||||||
updated:
|
|
||||||
app: Biboumi
|
|
||||||
app_version: 9.0
|
|
||||||
taxonomy:
|
|
||||||
category:
|
|
||||||
- docs
|
|
||||||
tags:
|
|
||||||
- chat
|
|
||||||
- xmpp
|
|
||||||
page-toc:
|
|
||||||
active: true
|
|
||||||
---
|
|
||||||
|
|
||||||
# XMPP <-> IRC
|
|
||||||
|
|
||||||
Disroot Chat provides [Biboumi](https://biboumi.louiz.org/), an IRC transport for XMPP, at irc.disroot.org.
|
|
||||||
|
|
||||||
## SYNTAX
|
|
||||||
|
|
||||||
The syntax for connecting to IRC channel is:
|
|
||||||
|
|
||||||
`#channel%irc.network.tld@irc.disroot.org`
|
|
||||||
|
|
||||||
The syntax for connecting to IRC user is:
|
|
||||||
|
|
||||||
`nick%irc.network.tld@irc.disroot.org`
|
|
||||||
|
|
||||||
## SETTINGS
|
|
||||||
|
|
||||||
Settings can be configured at three different levels, by executing ad-hoc commands on respective items:
|
|
||||||
|
|
||||||
1. IRC-Transport Level: `irc.disroot.org`
|
|
||||||
2. IRC-Network Level: `irc.network.tld@irc.disroot.org`
|
|
||||||
3. IRC-Channel Level: `#channel%irc.network.tld@irc.disroot.org`
|
|
||||||
|
|
||||||
If there are common options across all the levels, priority or over-ride of those settings happens in the order of [3] > [2] > [1].
|
|
||||||
|
|
||||||
## STEPS
|
|
||||||
|
|
||||||
### For short-term/one-shot
|
|
||||||
|
|
||||||
1. Join chat `#channel%irc.network.tld@irc.disroot.org`, with a chosen nick.
|
|
||||||
2. You'll get messages from `irc.network.tld@irc.disroot.org`. If your nick is registered, send message `NickServ IDENTIFY password`.
|
|
||||||
3. Start chatting in `#channel`.
|
|
||||||
|
|
||||||
Repeat 1 and 3, for different channel on same network.
|
|
||||||
|
|
||||||
Repeat 1 to 3, for different channel on different network.
|
|
||||||
|
|
||||||
### For long-term/recurring
|
|
||||||
|
|
||||||
1. Add `irc.disroot.org` to your roster.
|
|
||||||
2. Execute ad-hoc command on it, then enable history and persistence.
|
|
||||||
3. Add `irc.network.tld@irc.disroot.org` to your roster.
|
|
||||||
4. Execute ad-hoc command on it, then add your username (nick) and password (nick password).
|
|
||||||
5. Add `#channel%irc.network.tld@irc.disroot.org` to bookmarks and then join.
|
|
||||||
6. Execute ad-hoc command on it, then enable history and persistence.
|
|
||||||
7. Start chatting in `#channel`.
|
|
||||||
|
|
||||||
Repeat 5 to 7, if joining different channel on same network.
|
|
||||||
|
|
||||||
Repeat 3 to 7, if joining different channel on different network.
|
|
||||||
|
|
||||||
## CLIENTS
|
|
||||||
|
|
||||||
Any client can be used, although only following clients are known to support ad-hoc commands.
|
|
||||||
|
|
||||||
### Gajim
|
|
||||||
|
|
||||||
1. Right-click on the roster element.
|
|
||||||
2. Click 'Execute Command'.
|
|
||||||
3. Follow the options.
|
|
|
@ -1,23 +0,0 @@
|
||||||
---
|
|
||||||
title: 'Chat: Transports'
|
|
||||||
published: true
|
|
||||||
visible: true
|
|
||||||
indexed: true
|
|
||||||
updated:
|
|
||||||
taxonomy:
|
|
||||||
category:
|
|
||||||
- docs
|
|
||||||
tags:
|
|
||||||
- chat
|
|
||||||
- xmpp
|
|
||||||
page-toc:
|
|
||||||
active: true
|
|
||||||
---
|
|
||||||
|
|
||||||
# XMPP Transports
|
|
||||||
|
|
||||||
In XMPP realm, transports are the means to connect to different protocols.
|
|
||||||
|
|
||||||
Currently, Disroot Chat provides following transports:
|
|
||||||
|
|
||||||
1. [IRC](https://howto.disroot.org/en/tutorials/chat/transports/irc)
|
|
Loading…
Reference in a new issue