doc: Fetch latest manual

Signed-off-by: James Valleroy <jvalleroy@mailbox.org>

doc/manual/en/Apache_userdir.raw.wiki

@@ -1,6 +1,8 @@
 #language en
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[es/FreedomBox/Manual/Apache_userdir|Español]] -~
+##TAG:TRANSLATION-HEADER-START
+~- [[FreedomBox/Manual/Apache_userdir|English]] - [[es/FreedomBox/Manual/Apache_userdir|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
+##TAG:TRANSLATION-HEADER-END
 
 <<TableOfContents()>>
 
@@ -8,21 +10,19 @@
 
 == User Websites ==
 
-=== What is User websites? ===
+'''Available since''': version 0.9.4
 
-User websites is a module of the Apache webserver enabled to allow users defined in the !FreedomBox system to expose a set of static files on the !FreedomBox filesystem as a website to the local network and/or the internet according to the network and firewall setup.
+=== What is User Websites? ===
 
-||||<tablestyle="border:1px solid black;width: 80%">'''Application basics'''||
-||Category|| File sharing ||
-||Available since version || 0.9.4||
-||Upstream project website || https://httpd.apache.org/docs/2.4/mod/mod_userdir.html||
-||Upstream end user documentation || https://httpd.apache.org/docs/2.4/howto/public_html.html||
+User websites is a standard location for webservers to allow host users to expose static files on the filesystem as a website to the local network and/or the internet according to the network and firewall setup.
+
+The standard webserver in !FreedomBox is Apache and this is implemented by means of a specific Apache module.
 
 === Screenshot ===
 
 /* Add when/if an interface is made for FreedomBox */
 
-=== Using User websites ===
+=== Using User Websites ===
 
 The module is always enabled and offers no configuration from the !FreedomBox web interface. There is no configuration or status page shown for this module in the !FreedomBox web interface.
 
@@ -31,12 +31,97 @@ To serve documents, place the files in the designated directory in a !FreedomBox
 This directory is: '''public_html'''
 
 Thus the absolute path for the directory of a user named fbx with home directory in /home/fbx will be '''/home/fbx/public_html'''.
-User websites will serve documents placed in this directory when requests for documents with the URI path "~fbx" are received. For the the example.org domain thus a request for the document example.org/~fbx/index.html will transfer the file in /home/fbx/public_html/index.html.
+User websites will serve documents placed in this directory when requests for documents with the URI path "~fbx" are received. For the the `example.org` domain thus a request for the document `example.org/~fbx/index.html` will transfer the file in `/home/fbx/public_html/index.html`.
 
 
-=== Using SFTP to create public_html and upload documents ===
+=== Creating public_html folder and uploading documents ===
 
-/* To be written */
+==== Visually from Linux ====
+
+Linux standard desktop file managers use to support remote filesystem access through SFTP out of the box. Among others, Gnome's Nautilus, KDE/Plasma's Dolphin and XFCE's Thunar do so. This standarization allows for very easy, similar and straightforward procedures:
+
+ 1. Connect with the file manager to your !FreedomBox:
+    * Gnome's Nautilus:
+      1. To lauch Nautilus you can seek its archive icon, or search ether its name or the word "file".
+      1. At the bottom of the left pane you'll find an option "+ Other locations".
+      1. It leads you to a list of locations. Find "`freedombox SFTP server`" (english literal for all desktop languages). Click on it.
+      1. The first time you'll be asked for your user and password. Enter your !FreedomBox user and its password. The dialog will also offer you some options to remember it for some time.
+    * Plasma file manager AKA Dolphin:
+      1. Click on the location bar at the top of the window.
+      1. Input `ftp://freedombox.local`
+      1. The first time you'll be asked for your user and password. Enter your !FreedomBox user and its password. The dialog will also offer you some option to remember it.
+    * XFCE's Thunar:
+      1. Type this into the browser bar: `sftp://username@freedombox.local`, replacing the 'username' placeholder with '''your''' actual !FreedomBox username.
+      1. I guess the first time you'll be asked for your password. Enter your !FreedomBox user's password.
+ 1. You should be shown !FreedomBox filesystem. Enter the `home` folder and then enter you user's subfolder.
+ 1. If there's no `public_html` folder, create it: right mouse button click, etc.
+ 1. Drag your file(s) and drop it/'em into the  `public_html` folder.
+ 1. You should now be able to navigate your browser to the corresponding url and see the files.
+
+==== Visually from Other Plattforms ====
+
+If you want to use graphical free software clients, install:
+ * [[https://filezilla-project.org|FileZilla]] or [[https://winscp.net/eng/index.php|WinSCP]] for Windows.
+ * [[https://filezilla-project.org|FileZilla]] for Mac.
+ * Spider or Ghost Commander, available in [[https://f-droid.org|F-Droid]] application repository for Android.
+
+Their usage will be similar to that described for Linux desktops.
+
+/* Describe how to use privative plattfor-native remote location connectivity? */
+
+==== With a Command Line Interface (CLI) ====
+
+Usually any Unix system, including Linux in all (most) of its flavours and Mac, provide the standard utilities [[https://linux.die.net/man/1/ssh|ssh]], [[https://linux.die.net/man/1/scp|scp]] and [[https://linux.die.net/man/1/sftp|sftp]]. FreeDOS provides SSH2DOS. No need to install anything. It's already there!
+
+Examples:
+
+Connect to !FreedomBox via SSH:
+ 1. (replacing `username` with a valid !FreedomBox user name and `freedombox.local` with your !FreedomBox's domain name or IP): {{{
+$ ssh username@freedombox.local
+}}}
+ 1. If your data is ok and your !FreedomBox reachable, the first time you'll be asked to confirm its signature.
+ 1. Then you'll be asked for the password of your !FreedomBox user.
+ 1. Then you'll be shown the welcome banner with the !FreedomBox's buttefly logo in ASCII art (''painted'' with characters).
+ 1. The prompt changes to `username@freedombox:~$`.
+
+Once connected create your website folder with:
+ {{{
+username@freedombox:~$ mkdir ~/public_html
+}}}
+
+...or one for another user:
+ 1. use the `sudo` preffix like {{{
+username@freedombox:~$ sudo mkdir /home/<the_other_user>/public_html
+}}}, and introduce your password.
+ 1. When you create a folder, by default it belongs to you no matter where it is created. Thus you'll then need to set its ownership to the other user: {{{
+username@freedombox:~$ sudo chown <the_other_user>:<the_other_user> /home/<the_other_user>/public_htm
+}}}
+ 1. Better check it before you disconnect that `public_html' is listed among the contents of the other user's home folder.
+ {{{
+username@freedombox:~$ ls -l /home/<the_other_user>
+...
+drwxr-xr-x  2 <the_other_user> <the_other_user>   4096 jan 29 17:39  public_html
+...
+}}}. The name of the other user must appear '''twice''' in the `public_html` line and its permissions should be '''`drwxr-xr-x`'''.
+
+Then any user can upload their files to their respective folders with any of the graphical clients. Ask them to check it.
+
+It is a good security practice to exit instead of to just wait for the connection to time out:
+ {{{
+username@freedombox:~$ exit
+}}}
+
+If then you want to also upload the web content through the command line you can
+{{{
+$ scp path/to/files username@freedombox.local:public_html/
+}}}. It will ask your password in !FreedomBox. You should then be able to navigate your browser to the corresponding url and see the files.
+
+Learn more about ssh, scp and sftp with `$ man ssh`, `$ man scp` and `$ man sftp`.
+
+
+=== External Links ===
+ * Upstream project website: https://httpd.apache.org/docs/2.4/mod/mod_userdir.html
+ * User documentation: https://httpd.apache.org/docs/2.4/howto/public_html.html
 
 ## END_INCLUDE
 

doc/manual/en/Calibre.raw.wiki

@@ -17,7 +17,7 @@ calibre is an e-book management solution. You can organize your e-books into col
 
 Moving your calibre library from your desktop to your !FreedomBox has the benefit of being able to access your e-books from any device on the local network or through the Internet.
 
-Only users who are members of the ''calibre'' group have access to the libraries. You can assign users to this group via the system app ''users and groups''.
+Only users who are members of the ''calibre'' group have access to the libraries. You can assign users to this group via the system app [[FreedomBox/Manual/Users| users and groups]].
 
 You might be familiar with the e-book reader shipped with the calibre application on your desktop. The server version of calibre that's installed on your !FreedomBox has a web-based e-book reader with similar look and feel. This allows you to read your e-books from any device with a web browser.
 

doc/manual/en/Firewall.raw.wiki

@@ -26,7 +26,7 @@ For details on how network interfaces are configured by default, see the [[Freed
 
 === Opening Custom Ports ===
 
-Cockpit app provides advanced management of firewall. Both !FreedomBox and Cockpit operate over firewalld and are hence compatible with each other. In particular, Cockpit can be used to open custom services or ports on !FreedomBox. This is useful if you are manually running your own services in addition to the services provided by !FreedomBox on the same machine.
+[[FreedomBox/Manual/Cockpit|Cockpit]] app provides advanced management of firewall. Both !FreedomBox and Cockpit operate over firewalld and are hence compatible with each other. In particular, Cockpit can be used to open custom services or ports on !FreedomBox. This is useful if you are manually running your own services in addition to the services provided by !FreedomBox on the same machine.
 
 {{attachment:firewalld-cockpit.png}}
 

doc/manual/en/OpenVPN.raw.wiki

@@ -1,7 +1,7 @@
 #language en
 
 ##TAG:TRANSLATION-HEADER-START
-~- [[FreedomBox/Manual/OpenVPN|English]] - [[es/FreedomBox/Manual/OpenVPN|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
+~- [[de/FreedomBox/Manual/OpenVPN|Deutsch]] - [[FreedomBox/Manual/OpenVPN|English]] - [[es/FreedomBox/Manual/OpenVPN|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
 ##TAG:TRANSLATION-HEADER-END
 
 <<TableOfContents()>>

doc/manual/en/Privoxy.raw.wiki

@@ -37,16 +37,16 @@ Watch the [[attachment:Privoxy_Installation.webm|screencast]] on how to setup an
 
 === Advanced Users ===
 
- 1. The default installation should provide a reasonable starting point for most. There will undoubtedly be occasions where you will want to adjust the configuration, that can be dealt with as the need arises. 
+The default installation should provide a reasonable starting point for most. There will undoubtedly be occasions where you will want to adjust the configuration, that can be dealt with as the need arises. 
 
- 1. While using Privoxy, you can see its configuration details and documentation at http://config.privoxy.org/ or http://p.p.
-
- 1. To enable changing these configurations, you first have to change the value of `enable-edit-actions` in `/etc/privoxy/config` to `1`. Before doing so, read carefully the manual, especially:   
-   ''Access to the editor can not be controlled separately by "ACLs" or HTTP authentication, so that everybody who can access Privoxy can modify its configuration for all users. This option is not recommended for environments with untrusted users. Note that malicious client side code (e.g Java) is also capable of using the actions editor and you shouldn't enable this options unless you understand the consequences and are sure your browser is configured correctly.''
-
- 1. Now you find an `EDIT` button on the configuration screen in `http://config.privoxy.org/`.
-
- 1. The [[https://www.privoxy.org/user-manual/quickstart.html|Quickstart]] is a good starting point to read on how to define own blocking and filtering rules.
+ 1. Plan first:
+    * While using Privoxy, you can see its configuration details and documentation at http://config.privoxy.org/ or http://p.p.
+    * The [[https://www.privoxy.org/user-manual/quickstart.html|Quickstart]] is a good starting point to read on how to define own blocking and filtering rules.
+    * Read carefully the manual, especially this '''security warning''':   
+       ''Access to the editor can not be controlled separately by "ACLs" or HTTP authentication, so that everybody who can access Privoxy can modify its configuration for all users. This option is not recommended for environments with untrusted users. Note that malicious client side code (e.g Java) is also capable of using the actions editor and you shouldn't enable this options unless you understand the consequences and are sure your browser is configured correctly.''
+ 1. Only when you are ready, perform the changes:
+    1. To enable changing these configurations, you first have to change the value of `enable-edit-actions` in `/etc/privoxy/config` to `1`. 
+    1. Now you find an `EDIT` button on the configuration screen in `http://config.privoxy.org/`.
 
 
 === External links ===

doc/manual/en/ReleaseNotes.raw.wiki

@@ -10,6 +10,29 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
 
 The following are the release notes for each !FreedomBox version.
 
+== FreedomBox 21.2 (2021-02-05) ==
+
+=== Highlights ===
+
+ * calibre: Fix freedombox.local inaccessible after enabling app
+ * matrix-synapse: Install python3-psycopg2 from backports
+
+=== Other Changes ===
+
+ * backups: schedule: tests: Fix failures due to long test run
+ * jsxc: Fix issues with jQuery >= 3.5.0
+ * locale: Update translations for Bengali, Dutch, French, German, Hungarian, Italian, Polish, Russian, Spanish, Swedish, Turkish
+ * mediawiki: Fix app installation process doesn't display status information
+ * mediawiki: Set default logo to mediawiki.png
+ * minidlna: Implement force upgrading from older version
+ * minidlna: Minor refactor of media directory handling
+ * plinth: Show running spinner when app installation is in progress
+ * radicale: Allow older 2.x release to upgrade to 3.x
+ * roundcube: Allow upgrade to 1.4.*
+ * tests: Update functional tests default config
+ * upgrades: Add notifications for dist upgrade
+ * upgrades: Increment version for !MatrixSynapse 1.26
+
 == FreedomBox 21.1 (2021-01-25) ==
 
 === Highlights ===

doc/manual/en/TinyTinyRSS.raw.wiki

@@ -1,6 +1,8 @@
 #language en
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[es/FreedomBox/Manual/TinyTinyRSS|Español]] -~
+##TAG:TRANSLATION-HEADER-START
+~- [[FreedomBox/Manual/TinyTinyRSS|English]] - [[es/FreedomBox/Manual/TinyTinyRSS|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
+##TAG:TRANSLATION-HEADER-END
 
 <<TableOfContents()>>
 

doc/manual/en/Transmission.raw.wiki

@@ -1,6 +1,8 @@
 #language en
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[es/FreedomBox/Manual/Transmission|Español]] -~
+##TAG:TRANSLATION-HEADER-START
+~- [[FreedomBox/Manual/Transmission|English]] - [[es/FreedomBox/Manual/Transmission|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
+##TAG:TRANSLATION-HEADER-END
 
 <<TableOfContents()>>
 

doc/manual/en/Upgrades.raw.wiki

@@ -10,7 +10,7 @@
 
 !FreedomBox can automatically install security updates.  On the ''Update'' page of the ''System'' section in !FreedomBox web interface you can turn on automatic updates. This feature is enabled by default and there is no manual action necessary.  It is strongly recommended that you have this option enabled to keep your !FreedomBox secure.
 
-Updates are performed every day at night.  If you wish to shutdown !FreedomBox every day after use, keep it running at night once a week or so to let the automatic updates happen.  Alternatively, you can perform manual updates as described below.
+Updates are performed every day at night according to you local time zone. You can set the time zone with [[FreedomBox/Manual/DateTime|Date & Time]].  If you wish to shutdown !FreedomBox every day after use, keep it running at night once a week or so to let the automatic updates happen.  Alternatively, you can perform manual updates as described below.
 
 Note that once the updates start, it may take a long time to complete. During automatic update process that runs every night or during manual update process, you will not be able to install apps from !FreedomBox web interface.
 

doc/manual/en/WireGuard.raw.wiki

@@ -1,6 +1,8 @@
 #language en
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[es/FreedomBox/Manual/WireGuard|Español]] -~
+##TAG:TRANSLATION-HEADER-START
+~- [[FreedomBox/Manual/WireGuard|English]] - [[es/FreedomBox/Manual/WireGuard|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
+##TAG:TRANSLATION-HEADER-END
 
 <<TableOfContents>>
 

doc/manual/en/ejabberd.raw.wiki

@@ -40,9 +40,15 @@ Once you have a Domain Name, you can tell your !FreedomBox to use it by setting
 
 Please note that [[FreedomBox/Manual/PageKite|PageKite]] does not support the XMPP protocol at this time.
 
+=== Use Let's encrypt certificate for ejabberd ===
+
+If your !FreedomBox server uses a Let's Encrypt certificate, you will also want to use it for ejabberd. To do so, as your !FreedomBox admin, go to '''System''' > '''Let's Encrypt''', and select the checkbox at `Use certificate for ejabberd`:
+
+{{attachment:certificate-for-ejabberd.png|Use of certificate for Ejabberd}}
+
 === Registering FreedomBox users to use XMPP ===
 
-Currently, all users created through !FreedomBox will be able to login to the XMPP server. You can add new users through the System Users and Groups module. It does not matter which Groups are selected for the new user.
+Currently, all users created through !FreedomBox will be able to login to the XMPP server. You can add new users through the System module [[FreedomBox/Manual/Users|Users and Groups]]. It does not matter which Groups are selected for the new user.
 
 === Port Forwarding ===
 
@@ -56,12 +62,62 @@ If your !FreedomBox is behind a router, you will need to set up port forwarding
  * !FreedomBox provides a web client: [[FreedomBox/Manual/JSXC|JSXC]].
  * [[https://xmpp.org/software/clients.html|XMPP clients]] are available for various desktop and mobile platforms.
 
+==== Mobile clients ====
+
+You can download an XMPP client for your smartphone or tablet among the ones listed below.
+
+===== Conversations (Android) =====
+
+[[https://conversations.im/|Conversations]] is an Android XMPP client available on [[https://f-droid.org/packages/eu.siacs.conversations|F-Droid]] or the [[https://play.google.com/store/apps/details?id=eu.siacs.conversations|Play Store]]. In addition to text messaging, you can use Conversations to send images and have group chats.
+
+||<tablestyle="background:transparent; margin: 0 0 1em 1em;" style="text-align: center; padding:0.5em; border-style:none;"> {{attachment:conversations-first-screen.png|Conversations - First screen|width=200}} {{attachment:conversations-login.png|Conversations - Login|width=200}} {{attachment:conversations-add-contacts.png|Conversations - Add contacts|width=200}}||
+
+''From left to right: (1) First screen - (2) Login screen - (3) Add contacts.''
+
+When first starting the Conversations app, you will be asked whether you want to create a new account or if you want to use an existing account. Choose "I already have an account" (1)
+
+With ejabberd installed, the !FreedomBox provides an XMPP account for every !FreedomBox user. Additional (non-admin) !FreedomBox user accounts can be created under '''System''' > [[FreedomBox/Manual/Users|Users and Groups]].
+
+Once logged into a FreedomBox/XMPP account (2), the Conversation app provides a + button that brings up a few choices to contact other people (3).
+
+==== Desktop clients ====
+
+===== Gajim (Windows, MacOS, Linux) =====
+
+[[https://gajim.org/|Gajim]] is a XMPP open-source client for the desktop, available for Windows, MacOS and Linux. This application is available in Debian, and for other operating systems you can download it from [[https://gajim.org/download/|this page]] and find instructions about installation.
+
+||<tablestyle="background:transparent; margin: 0 0 1em 1em;" style="text-align: center; padding:0.5em; border-style:none;"> {{attachment:gajim-first-screen.png|Gajim - First screen|width=300}} {{attachment:gajim-login.png|Gajim - Login|width=300}} {{attachment:gajim-main-window.png|Gajim - Main Window|width=200}}||
+
+''From left to right: (1) First screen - (2) Login screen - (3) Main window''
+
+A popup shows up right after you start Gajim for the first time (1), asking you to either login to your XMPP (!FreedomBox) account or to register for a new account. 
+When you choose to login, after clicking "Forward", you will be asked a Jabber ID and a password (2): you have to enter your !FreedomBox account and password here.
+
+Finally, after logging in successfully, you will see the main Gajim screen (3). From there, you can add a contact (''Account'' > ''Add contact...'') then you can start a conversation (''Gajim'' > ''Start chat'').
+
+===== Dino (Linux) =====
+
+[[https://dino.im/|Dino]] is another XMPP free software client for the desktop. It is available for [[https://github.com/dino/dino/wiki/Distribution-Packages||multiple Linux distributions]].
+
+||<tablestyle="background:transparent; margin: 0 0 1em 1em;" style="text-align: center; padding:0.5em; border-style:none;"> {{attachment:dino-first-screen.png|Dino - First screen|width=200}} {{attachment:dino-login.png|Dino - Login|width=300}} {{attachment:dino-start-conversation.png|Dino - Start a conversation|width=200}}||
+
+''From left to right: (1) First screen - (2) Login screen - (3) Start conversation''
+
+When first starting Dino after installation, click on the `Setup account` button. You will be then asked your `JID`: this is your !FreedomBox account. Enter it then click `Next` (2). Alternatively, you can click on `Create account` if you don't have a !FreedomBox account.
+
+Once you have logged in, you will be able to either start a conversation with one of your XMPP contacts or to join a channel (3).
+
 
 === External links ===
 
  * Website: https://www.ejabberd.im
  * User documentation: https://docs.ejabberd.im
 
+Clients' sites:
+ * Conversations: https://conversations.im
+ * Gajim: https://gajim.org
+ * Dino: https://github.com/dino/dino
+
 
 ## END_INCLUDE
 

doc/manual/es/Apache_userdir.raw.wiki

@@ -1,28 +1,26 @@
 #language es
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: [[FreedomBox/Manual/Apache_userdir|English]] - Español -~
+<<Include(FreedomBox/Manual/Apache_userdir, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
 
 <<TableOfContents()>>
 
 ## BEGIN_INCLUDE
 
-== Sitios Web de Usuario (User websites) ==
+== Sitios web de usuario (User Websites) ==
 
-=== ¿Qué es User websites? ===
+'''Disponible desde''': versión 0.9.4
 
-''User websites'' es un módulo del servidor web ''Apache'' habilitado para permitir a los usuarios definidos en el sistema !FreedomBox exponer un conjunto de archivos del sistema de ficheros de !FreedomBox como sitio web a la red local y/o a internet de acuerdo a la configuración de la red y el cortafuegos.
+=== ¿Qué es User Websites? ===
 
-||||<tablestyle="border:1px solid black;width: 80%">'''Datos básicos de la aplicación'''||
-||Categoría|| Compartición de archivos ||
-||Disponible desde la versión || 0.9.4||
-||Sitio web del proyecto original || https://httpd.apache.org/docs/2.4/mod/mod_userdir.html||
-||Documentación original de usuario || https://httpd.apache.org/docs/2.4/howto/public_html.html||
+''User Websites'' es una ubicación del sistema de ficheros prefijada para que los servidores web permitan a los usuarios del sistema anfitrión exponer archivos estáticos a modo de sitio web a la red local y/o a internet de acuerdo a la configuración de la red y el cortafuegos.
+
+El servidor web predeterminado en !FreedomBox es Apache e implementa esto mediante un módulo específico.
 
 === Captura de pantalla ===
 
 /* Añadir cuando/si se crea un interfaz para FreedomBox */
 
-=== Usar User websites ===
+=== Usar User Websites ===
 
 El módulo está siempre activado y el interfaz web de !FreedomBox no ofrece configuración ni página de estado para este módulo.
 Para servir documentos con el módulo solo se necesita poner los documentos en un subdirectorio designado '''`/home/<un_usuario_de_plinth>/public_html`'''.
@@ -30,9 +28,94 @@ Para servir documentos con el módulo solo se necesita poner los documentos en u
 `User websites` servirá los archivos que haya en este directorio cuando se reciban peticiones con la URI `~<un_usuario_de_freedombox>`. Por tanto para un dominio `ejemplo.org` con un usuario `pepe` una petición `ejemplo.org/~pepe/index.html` transferirá el fichero `/home/pepe/public_html/index.html`.
 
 
-=== Usar SFTP para crear public_html y subir archivos ===
+===  Crear la carpeta public_html y subir documentos ===
 
-/* Pendiente de redactar */
+==== Visualmente desde Linux ====
+
+Los administradores de archivos predeterminados de los escritorios Linux suelen soportar de serie el acceso a sistemas de ficheros remotos mediante SFTP. Entre otros, Nautilus en Gnome, Dolphin en KDE/Plasma y Thunar en XFCE. Esta estandarización permite usar procedimientos muy fáciles, similares y obvios:
+
+ 1. Conectar con el administrador de archivos a tu !FreedomBox:
+    * Nautilus en Gnome:
+      1. Para lanzar Nautilus puedes buscar su icono de archivador, o buscar su nombre o la palabra "archivo".
+      1. Al final del panel izquierdo encontrarás la opción "+ Otras ubicaciones".
+      1. Te lleva a una lista de ubicaciones. Encuentra "`freedombox SFTP server`" (así, en inglés) y dale.
+      1. La primera vez se te pedirán usuario y contraseña. Introduce tu usuario de !FreedomBox y su contraseña. El diálogo te ofrecerá algunas opciones para recordarlos un cierto tiempo.
+    * Administrador de archivos de Plasma, alias Dolphin:
+      1. Haz clic en la barra de ubicación en el extremo superior de la ventana.
+      1. Introduce `ftp://freedombox.local`
+      1. La primera vez se te pedirán usuario y contraseña. Introduce tu usuario de !FreedomBox y su contraseña. El diálogo te ofrecerá alguna opción para recordarlos.
+    * Thunar en XFCE:
+      1. Teclea esto en la barra de navegación: `sftp://usuario@freedombox.local`, reemplazando 'usuario' por el nombre real de '''tu''' usuario en !FreedomBox.
+      1. Imagino que la primera vez se te pedirán usuario y contraseña. Introduce tu usuario de !FreedomBox y su contraseña.
+ 1. Se te debería mostrar el sistema de ficheros de !FreedomBox. Entra en la carpeta `home` y luego entra en la subcarpeta de su usuario.
+ 1. Si no hay una carpeta `public_html` créala: clic con el botón derecho del ratón, etc.
+ 1. Arrastra tu(s) archivo(s) a la carpeta `public_html`.
+ 1. Deberías poder ir con tu navegador a la URL correspondiente y ver tus archivos.
+
+==== Visualmente desde otras plataformas ====
+
+Si quieres emplear clientes gráficos que sean software libre, instala:
+ * [[https://filezilla-project.org|FileZilla]] o [[https://winscp.net/eng/index.php|WinSCP]] para Windows.
+ * [[https://filezilla-project.org|FileZilla]] para Mac.
+ * Spider o Ghost Commander, disponibles ambos en el repositorio de aplicaciones libres para Android [[https://f-droid.org|F-Droid]].
+
+Su uso es similar al descrito para los escritorios Linux.
+
+/* ¿Describir cómo usar conectividad nativa a ubicaciones remotas de plataformas privativas? */
+
+==== Mediante interfaz de linea de órdenes (CLI) ====
+
+Normalmente cualquier sistema Unix, incluyendo a Linux en (casi) todos sus sabores y a Mac, traen de serie las utilidades [[https://linux.die.net/man/1/ssh|ssh]], [[https://linux.die.net/man/1/scp|scp]] y [[https://linux.die.net/man/1/sftp|sftp]]. FreeDOS trae SSH2DOS. ¡No hace falta instalar nada. Ya está todo ahí!
+
+Ejemplos:
+
+Conectar con !FreedomBox mediante SSH:
+ 1. (reemplazando `usuario` por un nombre de usuario válido en !FreedomBox y `freedombox.local` por el nombre de dominio o la IP de tu !FreedomBox): {{{
+$ ssh usuario@freedombox.local
+}}}
+ 1. Si tus datos son correctos y tu !FreedomBox está accesible la primera vez se te pedirá confirmar su identificación.
+ 1. Luego se te pedira el usuario de !FreedomBox y su contraseña.
+ 1. A continuación se te mostrará el mensaje de bienvenida con el logotipo de la mariposa de !FreedomBox's en arte ASCII (dibujada con letras).
+ 1. El prompt cambia a `usuario@freedombox:~$`.
+
+Una vez conectado crea la carpeta de tu sitio web mediante:
+ {{{
+usuario@freedombox:~$ mkdir ~/public_html
+}}}
+
+...o crea la del sitio de otro usuario:
+ 1. Usa el prefijo `sudo` así: {{{
+usuario@freedombox:~$ sudo mkdir /home/<el_otro_usuario>/public_html
+}}}, e introduce tu contraseña.
+ 1. Al crear una carpeta, por defecto te pertenece a tí la crees donde la crées. Por tanto, necesitarás poner como dueño al otro usuario: {{{
+usuario@freedombox:~$ sudo chown <el_otro_usuario>:<el_otro_usuario> /home/<el_otro_usuario>/public_htm
+}}}
+ 1. Antes de desconectar mejor verificas que `public_html' se muestra entre los contenidos de la carpeta `home` del otro usuario.
+ {{{
+usuario@freedombox:~$ ls -l /home/<el_otro_usuario>
+...
+drwxr-xr-x  2 <el_otro_usuario> <el_otro_usuario>   4096 jan 29 17:39  public_html
+...
+}}}. El nombre del otro usuario tiene que aparecer '''por duplicado''' en la línea de `public_html` y sus permisos deben ser '''`drwxr-xr-x`'''.
+
+Ahora el otro usuario puede subir sus archivos con cualquiera de los clientes gráficos. Pídeles que lo comprueben.
+
+Es una buena práctica de seguridad salir en vez de esperar simplemente a que la conexión caduque:
+ {{{
+usuario@freedombox:~$ exit
+}}}
+
+Si quieres emplear la linea de órdenes también para subir contenido puedes
+{{{
+$ scp ruta/a/los/archivos usuario@freedombox.local:public_html/
+}}}. Te pedirá tu contraseña en !FreedomBox. A continuación deberías poder ir con tu navegador a la URL correspondiente y ver tus archivos.
+
+Más acerca de ssh, scp y sftp con `$ man ssh`, `$ man scp` y `$ man sftp`.
+
+
+=== Enlaces externos ===
+ * Sitio web del proyecto original: https://httpd.apache.org/docs/2.4/mod/mod_userdir.html
+ * Documentación de uso: https://httpd.apache.org/docs/2.4/howto/public_html.html
 
 ## END_INCLUDE
 

doc/manual/es/Calibre.raw.wiki

@@ -15,7 +15,7 @@ Calibre es una solución para administrar libros electrónicos. Puedes organizar
 
 Trasladar tu biblioteca desde el escritorio a !FreedomBox te permite acceder a tus libros desde cualquier dispositivo de la red local o desde Internet.
 
-Sólo los usuarios del grupo ''calibre'' tienen acceso a las bibliotecas. Puedes asignar usuarios a este grupo mediante la aplicación del sistema ''Usuarios y grupos''. 
+Sólo los usuarios del grupo ''calibre'' tienen acceso a las bibliotecas. Puedes asignar usuarios a este grupo mediante la aplicación del sistema [[es/FreedomBox/Manual/Users|Usuarios y grupos]]. 
 
 Quizá ya estés familiarizado con el lector de libros para escritorio que viene con Calibre. El servidor Calibre que se instala en tu !FreedomBox viene con un lector web con aspecto similar, lo que te permite leer tus libros desde cualquier dispositivo con navegador web.
 

doc/manual/es/Firewall.raw.wiki

@@ -26,7 +26,7 @@ Para más detalles acerca de como se configuran por defecto los interfaces de re
 
 === Abrir Puertos Propios ===
 
-Cockpit proporciona administración avanzada de cortafuegos. Ambos, !FreedomBox y Cockpit operan sobre firewalld y son por tanto compatibles entre sí. En particular, Cockpit se puede usar en !FreedomBox para abrir servicios o puertos. Esto resulta útil si además de los servicios proporcionados por !FreedomBox estás ejecutando manualmente tus propios servicios en la misma máquina.
+[[es/FreedomBox/Manual/Cockpit|Cockpit]] proporciona administración avanzada de cortafuegos. Ambos, !FreedomBox y Cockpit operan sobre firewalld y son por tanto compatibles entre sí. En particular, Cockpit se puede usar en !FreedomBox para abrir servicios o puertos. Esto resulta útil si además de los servicios proporcionados por !FreedomBox estás ejecutando manualmente tus propios servicios en la misma máquina.
 
 {{attachment:firewalld-cockpit.png}}
 

doc/manual/es/OpenVPN.raw.wiki

@@ -126,7 +126,7 @@ Los siguientes servicios '''funcionan''' con OpenVPN:
  * [[es/FreedomBox/Manual/Tor|Tor Socks]],
  * [[es/FreedomBox/Manual/Shadowsocks|Shadowsocks]],
  * [[es/FreedomBox/Manual/I2P|I2P Proxy]] and
- * [[FreedomBox/Manual/Samba|Samba]].
+ * [[es/FreedomBox/Manual/Samba|Samba]].
 
 Algunos servicios '''no''' funcionan aún con OpenVPN:
  * Avahi,

doc/manual/es/Privoxy.raw.wiki

@@ -35,16 +35,16 @@ Mira el [[attachment:Privoxy_Installation.webm|vídeo]] acerca de como configura
 
 === Usuarios Avanzados ===
 
- 1. La instalación de serie debería proporcionar un punto de partida razonable para la mayoría de los usuarios. Indudablemente habrá ocasiones en las que quieras ajustar la configuración. Eso se puede afrontar cuando surja la necesidad. 
+La instalación de serie debería proporcionar un punto de partida razonable para la mayoría de los usuarios. Indudablemente habrá ocasiones en las que quieras ajustar la configuración. Eso se puede afrontar cuando surja la necesidad. 
 
- 1. Con Privoxy activado puedes ver su documentación y los detalles de su configuración en `http://config.privoxy.org/` o en `http://p.p`.
-
- 1. Para habilitar los cambios en estas configuraciones primero tienes que cambiar el valor de ''habilitar-acciones-de-edición'' en `/etc/privoxy/config` a `1`. Antes de hacerlo lee el manual con atención, especialmente:   
-   ''No se puede controlar por separado el accesso al editor por "ACLs" o authenticación HTTP, así que cualquiera con acceso a Privoxy puede modificar la configuración de todos los usuarios. Esta opción no se recomienda para entornos con usuarios no confiables. Nota que un código de cliente malicioso (p.ej. Java) también puede usar el editor de acciones y no deberías habilitar estas opciones a no ser que entiendas las consecuencias y estés seguro de que los navegadores están correctamente configurados.''
-
- 1. Ahora encontrarás un botón `EDITAR` en la pantalla de configuración de `http://config.privoxy.org/`.
-
- 1. La [[https://www.privoxy.org/user-manual/quickstart.html|Guía rápida]] es un buen punto de partida para leer acerca de cómo definir reglas de bloqueo y filtrado propias.
+ 1. Planifica primero:
+    * Con Privoxy activado puedes ver su documentación y los detalles de su configuración en `http://config.privoxy.org/` o en `http://p.p`.
+    * La [[https://www.privoxy.org/user-manual/quickstart.html|Guía rápida]] es un buen punto de partida para leer acerca de cómo definir reglas de bloqueo y filtrado propias.
+    * Lee el manual con atención, especialmente esre '''aviso de seguridad''':   
+      ''No se puede controlar por separado el accesso al editor por "ACLs" o authenticación HTTP, así que cualquiera con acceso a Privoxy puede modificar la configuración de todos los usuarios. Esta opción no se recomienda para entornos con usuarios no confiables. Nota que un código de cliente malicioso (p.ej. Java) también puede usar el editor de acciones y no deberías habilitar estas opciones a no ser que entiendas las consecuencias y estés seguro de que los navegadores están correctamente configurados.''
+ 1. Solo cuando ya estés preparado, realiza los cambios:
+    1. Para habilitar los cambios en estas configuraciones primero tienes que cambiar el valor de ''habilitar-acciones-de-edición'' en `/etc/privoxy/config` a `1`.
+    1. Ahora encontrarás un botón `EDITAR` en la pantalla de configuración de http://config.privoxy.org/.
 
 
 === Enlaces externos ===

doc/manual/es/ReleaseNotes.raw.wiki

@@ -10,6 +10,29 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
 
 The following are the release notes for each !FreedomBox version.
 
+== FreedomBox 21.2 (2021-02-05) ==
+
+=== Highlights ===
+
+ * calibre: Fix freedombox.local inaccessible after enabling app
+ * matrix-synapse: Install python3-psycopg2 from backports
+
+=== Other Changes ===
+
+ * backups: schedule: tests: Fix failures due to long test run
+ * jsxc: Fix issues with jQuery >= 3.5.0
+ * locale: Update translations for Bengali, Dutch, French, German, Hungarian, Italian, Polish, Russian, Spanish, Swedish, Turkish
+ * mediawiki: Fix app installation process doesn't display status information
+ * mediawiki: Set default logo to mediawiki.png
+ * minidlna: Implement force upgrading from older version
+ * minidlna: Minor refactor of media directory handling
+ * plinth: Show running spinner when app installation is in progress
+ * radicale: Allow older 2.x release to upgrade to 3.x
+ * roundcube: Allow upgrade to 1.4.*
+ * tests: Update functional tests default config
+ * upgrades: Add notifications for dist upgrade
+ * upgrades: Increment version for !MatrixSynapse 1.26
+
 == FreedomBox 21.1 (2021-01-25) ==
 
 === Highlights ===

doc/manual/es/TinyTinyRSS.raw.wiki

@@ -1,6 +1,6 @@
 #language es
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: [[FreedomBox/Manual/TinyTinyRSS|English]] - Español -~
+<<Include(FreedomBox/Manual/TinyTinyRSS, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
 
 <<TableOfContents()>>
 

doc/manual/es/Transmission.raw.wiki

@@ -1,6 +1,6 @@
 #language es
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: [[FreedomBox/Manual/Transmission|English]] - Español -~
+<<Include(FreedomBox/Manual/Transmission, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
 
 <<TableOfContents()>>
 

doc/manual/es/Upgrades.raw.wiki

@@ -10,7 +10,7 @@
 
 !FreedomBox puede instalar actualizaciones de seguridad automaticamente. Esta funcionalidad viene activada por defecto y no hace falta ninguna acción manual.  Puedes activar las actualizaciones automaticas desde el interfaz web de !FreedomBox en la página ''Actualización'' de la sección ''Sistema''. Se recomienda encarecidamente que tengas esta opción habilitada para mantener tu !FreedomBox segura.
 
-Las actualizaciones se efectúan cada noche. Si quieres apagar tu !FreedomBox cada día después de usarla, déjala ejecutando una noche a la semana más o menos para permitir que ocurran las actualizaciones automaticas. Otra posibilidad es ejecutar actualizaciones manuales como se describe más adelante.
+Las actualizaciones se efectúan cada noche según el huso horario local. Puedes establecerlo mediante [[es/FreedomBox/Manual/DateTime|Fecha y Hora]]. Si quieres apagar tu !FreedomBox cada día después de usarla, déjala ejecutando una noche a la semana más o menos para permitir que ocurran las actualizaciones automaticas. Otra posibilidad es ejecutar actualizaciones manuales como se describe más adelante.
 
 Nota que una vez comiencen las actualizaciones podría llevarles mucho tiempo completarse. Durante el proceso de actualización (ya sea el automático nocturno o el manual), no podrás instalar aplicaciones desde el interfaz web de !FreedomBox.
 

doc/manual/es/WireGuard.raw.wiki

@@ -1,6 +1,6 @@
 #language es
 
-~- [[DebianWiki/EditorGuide#translation|Translation(s)]]: [[FreedomBox/Manual/WireGuard|English]] - Español -~
+<<Include(FreedomBox/Manual/WireGuard, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
 
 <<TableOfContents>>
 

doc/manual/es/ejabberd.raw.wiki

@@ -38,9 +38,15 @@ Una vez tengas ya tu Nombre de Dominio puedes decirle a tu !FreedomBox que lo us
 
 Ten en cuenta que de momento [[es/FreedomBox/Manual/PageKite|PageKite]] no soporta el protocolo XMPP.
 
+=== Usar certificado Let's encrypt para ejabberd ===
+
+Si tu servidor !FreedomBox usa certificado Let's Encrypt querrás emplearlo también para ejabberd. Para ello, ve como admin de !FreedomBox a '''Sistema''' > '''Let's Encrypt''' y marca la caja `Usar certificado para ejabberd`:
+
+{{attachment:FreedomBox/Manual/ejabberd/certificate-for-ejabberd.png|Uso de certificado para Ejabberd}}
+
 === Habilitar a usuarios para usar XMPP ===
 
-Actualmente todos los usuarios creados con !FreedomBox podrán ingresar al servidor XMPP. Puedes añadir usuarios nuevos con el módulo de "Usuarios y Grupos del Sistema". Los grupos seleccionados para el usuario nuevo no importan.
+Actualmente todos los usuarios creados con !FreedomBox podrán ingresar al servidor XMPP. Puedes añadir usuarios nuevos con el módulo [[es/FreedomBox/Manual/Users|Usuarios y Grupos]] del Sistema. Los grupos seleccionados para el usuario nuevo no importan.
 
 === Enrutado de Puertos ===
 
@@ -54,12 +60,61 @@ Si tu !FreedomBox está detrás de un router tendrás que configurar en él la r
  * !FreedomBox proporciona un cliente web: [[es/FreedomBox/Manual/JSXC|JSXC]].
  * Hay [[https://xmpp.org/software/clients.html|clientes XMPP]] disponibles para varias platformas de escritorio y móviles.
 
+==== Clientes para móvil ====
+
+Puedes descargar uno de los cliente XMPP para tu smartphone o tableta listados a continuación.
+
+===== Conversations (Android) =====
+
+[[https://conversations.im/|Conversations]] es un cliente XMPP para Android disponnible en [[https://f-droid.org/packages/eu.siacs.conversations|F-Droid]] o en la [[https://play.google.com/store/apps/details?id=eu.siacs.conversations|Play Store]]. Además de para mensajería de texto  puedes usar Conversations para enviar imágenes y tener conversaciones grupales.
+
+||<tablestyle="background:transparent; margin: 0 0 1em 1em;" style="text-align: center; padding:0.5em; border-style:none;"> {{attachment:FreedomBox/Manual/ejabberd/conversations-first-screen.png|Conversations - Primera pantalla|width=200}} {{attachment:FreedomBox/Manual/ejabberd/conversations-login.png|Conversations - Pantalla de acceso|width=200}} {{attachment:FreedomBox/Manual/ejabberd/conversations-add-contacts.png|Conversations - Añadir contactos|width=200}}||
+
+''De izquierda a derecha: (1) Primera pantalla - (2) Pantalla de acceso - (3) Añadir contactos.''
+
+All abrir Conversations por primera vez se te preguntará si quieres crear una cuenta nueva o si quieres usar una que tengas. Selecciona "Ya tengo una cuenta" (1).
+
+Con ejabberd instalado !FreedomBox proporciona una cuenta XMPP a cada usuario. Se pueden crear usuarios (no-administradores) !FreedomBox en ''Sistema'' -> [[es/FreedomBox/Manual/Users|Usuarios y Grupos]].
+
+Una vez ingresado en tu cuenta !Freedombox/XMPP la app Conversation proporciona un botón + que ofrece varias opciones para contactar a otra gente (3).
+
+==== Clientes de escritorio ====
+
+===== Gajim (Windows, MacOS, Linux) =====
+
+[[https://gajim.org/|Gajim]] es un cliente libre de XMPP en el escritorio para Windows, MacOS y Linux. Esta aplicación está disponible en Debian, y para otros sistemas operativos puedes descargarla desde [[https://gajim.org/download/|esta página]] y encontrar instrucciones para instalarla.
+
+||<tablestyle="background:transparent; margin: 0 0 1em 1em;" style="text-align: center; padding:0.5em; border-style:none;"> {{attachment:FreedomBox/Manual/ejabberd/gajim-first-screen.png|Gajim - Primera pantalla|width=300}} {{attachment:FreedomBox/Manual/ejabberd/gajim-login.png|Gajim - Pantalla de acceso|width=300}} {{attachment:FreedomBox/Manual/ejabberd/gajim-main-window.png|Gajim - Pantalla principal|width=200}}||
+
+''De izquierda a derecha: (1) Primera pantalla - (2) Pantalla de acceso - (3) Pantalla principal.''
+
+Al arrancar Gajim por primera vez aparece un diálogo (1) pidiendo ingresar a tu cuenta XMPP (!FreedomBox) o registrar una nueva. 
+Al elegir ingresar, tras hacer clic en "Siguiente" se te pide tu Jabber ID y contraseña (2): aquí tienes que introducir tu cuenta en !FreedomBox y su contraseña.
+
+Finallmente, tras ingresar con éxito verás la pantalla principal de Gajim (3). Desde aquí puedes añadir contactos (''Cuenta'' > ''Añadir contacto...'') e iniciar conversaciones (''Gajim'' > ''Empezar conversación'').
+
+===== Dino (Linux) =====
+
+[[https://dino.im/|Dino]] es un cliente libre para XMPP en el escritorio. Está disponible en [[https://github.com/dino/dino/wiki/Distribution-Packages||múltiples distribuciones Linux]].
+
+||<tablestyle="background:transparent; margin: 0 0 1em 1em;" style="text-align: center; padding:0.5em; border-style:none;"> {{attachment:FreedomBox/Manual/ejabberd/dino-first-screen.png|Dino - Primera pantalla|width=200}} {{attachment:FreedomBox/Manual/ejabberd/dino-login.png|Dino - Pantalla de acceso|width=300}} {{attachment:FreedomBox/Manual/ejabberd/dino-start-conversation.png|Dino - Comenzar una conversación|width=200}}||
+
+''De izquierda a derecha: (1) Primera pantalla - (2) Pantalla de acceso - (3) Comenzar una conversación
+
+Tras la instalación, al abrir Dino por primera vez haz clic en el botón `Configurar cuenta`. Se te pedirá tu `JID`: es tu usuario en !FreedomBox. Introdúcelo y haz clic en `Seguir` (2). O puedes hacer clic en `Crear cuenta` si no tienes usuario en !FreedomBox.
+
+Una vez ingreses podrás comenzar una conversación con algún contacto XMPP o unirte a un canal (3).
 
 === Enlaces externos ===
 
  * Sitio web: https://www.ejabberd.im
  * Documentación de uso: https://docs.ejabberd.im
 
+Sitios de aplicaciones cliente:
+ * Conversations: https://conversations.im
+ * Gajim: https://gajim.org
+ * Dino: https://dino.im
+
 
 ## END_INCLUDE