Merge branch 'master' into NC_Cospend

This commit is contained in:
meaz 2021-04-08 04:52:43 +00:00
commit 360840e8a9
15 changed files with 183 additions and 127 deletions

View File

@ -1,11 +1,11 @@
---
title: 'Nextcloud: Exporting News'
title: 'Exporting News feeds'
published: true
indexed: true
updated:
last_modified: "June 2020"
last_modified: "April, 2021"
app: Nextcloud
app_version: 18
app_version: 20
taxonomy:
category:
- docs
@ -19,16 +19,23 @@ page-toc:
active: false
---
Exporting your news feeds and your subscriptions is as easy as in case of any **Nextcloud** app.
# Exporting News feeds
- Login to the [cloud](https://cloud.disroot.org)
- Select the **News** app
Exporting news feeds and subscriptions is a pretty straightforward procedure.
![](en/select.gif)
1. Login to the [cloud](https://cloud.disroot.org)
- Select Settings on the bottom of the left side-bar.
- Depending on your needs you can either decided to export:
- Your subscriptions (OPML) - This is specially useful if you want to change your News feed (RSS reader) provider or if you simply would like to have a backup of current news site list.
- Unread/Starred articles - If you want to export the article content themselves either for offline use, archive purpose or migration. Note read articles get removed in regular intervals.
2. Select the **News** app
![](en/export.gif)
![](en/select.gif)
3. Select **Settings** on the bottom of the left side-bar.
![](en/export.gif)
4. Depending on your needs you can either decided to export:
- **Your subscriptions (OPML)** - This is specially useful if you want to change your News feed (RSS reader) provider or if you simply would like to have a backup of current news site list.<br> _[**OPML**](https://en.wikipedia.org/wiki/OPML) is a type of format widely used by existing news feed readers for importing and exporting subscriptions list._
- **Unread/Starred articles** - This is the option to export the content of the articles themselves, either for offline reading, archiving or migration. <br>_[**JSON**](https://en.wikipedia.org/wiki/JSON) is a text format for data exchange._
When you click **Export** the browser will ask you where you want to save the file, select a location and finally **Save**.

View File

@ -1,36 +1,41 @@
---
title: Nextcloud: Exportando información de Noticias
title: "Exportar feeds de Noticias"
published: true
indexed: true
updated:
last_modified: "Julio 2019"
last_modified: "Abril, 2021"
app: Nextcloud
app_version: 15
app_version: 20
taxonomy:
category:
- docs
tags:
- usuario
- nube
- noticias
- rgdp
tags:
- usuario
- nube
- noticias
- rgdp
visible: true
page-toc:
active: false
---
Exportar tus fuentes de noticias y suscripciones es sencillo como en cualquiera de las aplicaciones de **Nextcloud**.
# Exportar feeds de Noticias
Exportar fuentes de noticias y suscripciones es un procedimiento bastante sencillo.
1. Inicia sesión en la [nube](https://cloud.disroot.org)
2. Selecciona la aplicación **Noticias**
![](es/select_app.gif)
![](es/seleccionar_app.gif)
3. Selecciona Ajustes, abajo a la izquierda, en la barra lateral.
3. Selecciona **Ajustes**, abajo a la izquierda, en la barra lateral.
5. Dependiendo de tus necesidades, puedes elegir exportar:
- Tus suscripciones (OPML): Esto es especialmente útil si quieres cambiar tu proveedor de fuentes de noticias (lector RSS) o simplemente tener un respaldo de la actual lista de sitios de noticias.
- Artí­culos Sin leer/Favoritos: Si quieres exportar el contenido mismo del artí­culo ya sea para leerlo fuera de lí­nea, con el propósito de archivarlo o de migrar. Los artí­culos leí­dos son removidos en forma regular.
![](es/exportar.gif)
![](es/export.gif)
4. Dependiendo de tus necesidades, puedes elegir exportar:
- **Tus suscripciones (OPML):** Esto es especialmente útil si quieres cambiar tu proveedor de fuentes de noticias (lector RSS) o simplemente tener un respaldo de la actual lista de sitios de noticias.<br> _[**OPML**](https://es.wikipedia.org/wiki/OPML) es un tipo de formato muy utilizado por los actuales lectores de feeds de noticias para importar y exportar listas de suscripciones._
- **Artí­culos Sin leer/Favoritos (JSON):** Esta es la opción para exportar el contenido mismo de los artículos, ya sea para leerlos fuera de lí­nea, para archivarlos o para migrar.<br> _[**JSON**](https://es.wikipedia.org/wiki/JSON) es un formato de texto para intercambio de datos._
Al hacer click en **Exportar** el navegador te preguntará donde quieres guardar el archivo, selecciona una ubicación y finalmente **Guardar**.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 105 KiB

After

Width:  |  Height:  |  Size: 159 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 217 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 60 KiB

View 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.

View 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**.

Binary file not shown.

After

Width:  |  Height:  |  Size: 140 KiB

View 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

Binary file not shown.

After

Width:  |  Height:  |  Size: 117 KiB

View File

@ -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.

View File

@ -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)