mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-21 07:55:00 +00:00
doc: Fetch latest manual
Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
This commit is contained in:
James Valleroy
parent
f60a162a09
commit
92a022260b
@ -67,7 +67,9 @@ snapshot = tgz
|
||||
|
||||
=== External links ===
|
||||
|
||||
* User documentation: https://git-scm.com/docs/gitweb
|
||||
* Upstream project: https://git-scm.com/
|
||||
* Upstream end user documentation: https://git-scm.com/docs/gitweb
|
||||
* Debian community wikis: https://wiki.debian.org/CategoryGit
|
||||
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
@ -73,8 +73,10 @@ It is also possible to install user-contributed themes from ikiwiki's Theme Mark
|
||||
|
||||
=== External links ===
|
||||
|
||||
* Website: https://ikiwiki.info
|
||||
* Theme Market https://ikiwiki.info/theme_market/
|
||||
* Upstream project: https://ikiwiki.info
|
||||
* Upstream project user documentation: https://ikiwiki.info
|
||||
* Upstream project user forum: https://ikiwiki.info/forum/
|
||||
* Upstream project theme market https://ikiwiki.info/theme_market/
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
|
||||
@ -25,7 +25,12 @@ If your !FreedomBox is behind a router, you will need to set up port forwarding
|
||||
|
||||
=== Extenal links ===
|
||||
|
||||
* Website: https://gobby.github.io/libinfinity
|
||||
* Upstream project: https://gobby.github.io/libinfinity/
|
||||
* Upstream end user documentation: https://github.com/gobby/gobby/wiki
|
||||
|
||||
==== Client apps ====
|
||||
Client software from the Infinoted team is named, "Gobby." Links to recommended client apps, where applicable, can be found in !FreedomBox by select the Apps page, selecting the application tile, and clicking the > Client Apps button.
|
||||
|
||||
* Gobby Client Software: https://gobby.github.io/
|
||||
* Gobby Wiki: https://github.com/gobby/gobby/wiki
|
||||
|
||||
|
||||
@ -44,9 +44,11 @@ If your !FreedomBox is behind a router and you want to connect to other servers,
|
||||
|
||||
=== External links ===
|
||||
|
||||
* Website: https://www.jsxc.org
|
||||
* User documentation: https://www.jsxc.org/manual.html
|
||||
* !FreedomBox ejabberd server manual: [[FreedomBox/Manual/ejabberd|https://wiki.debian.org/FreedomBox/Manual/ejabberd]]
|
||||
* Upstream project: https://www.jsxc.org
|
||||
* Upstream end user documentation: https://www.jsxc.org/manual.html
|
||||
|
||||
==== Client apps ====
|
||||
JSXC is the client app used with [[FreedomBox/Manual/ejabberd|ejabberd server included in FreedomBox.]]
|
||||
|
||||
|
||||
## END_INCLUDE
|
||||
|
||||
@ -75,12 +75,15 @@ echo "UPDATE users SET admin=1 WHERE name='@username:domainname'" | sudo sqlite3
|
||||
|
||||
=== External links ===
|
||||
|
||||
* Matrix Website: https://matrix.org
|
||||
* Synapse section:https://github.com/element-hq/synapse
|
||||
* User documentation: https://matrix.org/docs/chat_basics/matrix-for-im/
|
||||
* Debian Matrix wiki: https://wiki.debian.org/Matrix
|
||||
* Upstream project: https://matrix.org
|
||||
* Upstream Synapse matrix server project: https://github.com/element-hq/synapse
|
||||
* Upstream user documentation: https://matrix.org/docs/chat_basics/matrix-for-im/
|
||||
* Debian community wiki: https://wiki.debian.org/Matrix
|
||||
* Video tutorial for setting up Matrix Synapse on a Cloud instance: https://youtu.be/8snpMHHbymI
|
||||
|
||||
==== Client apps ====
|
||||
Links to recommended client apps, where applicable, can be found in FreedomBox by select the Apps page, selecting the application tile, and clicking the > Client Apps button.
|
||||
* [[https://wiki.debian.org/Matrix#Clients|Clients in Debian community wiki]]
|
||||
## END_INCLUDE
|
||||
|
||||
Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages.
|
||||
|
||||
@ -36,11 +36,7 @@ To install/enable the media server you need to navigate at MiniDLNA page and
|
||||
enable it. The application is intended to be available in the internal (home) network and
|
||||
therefore it requires a network interface configured for internal traffic.
|
||||
|
||||
After installation a web page becomes available on https://<your-freedombox>/_minidlna.
|
||||
It includes information for how many files the server is detecting, how many connections
|
||||
exist etc. This is very useful if plugging external disks with media to check
|
||||
if the new media files are detected properly. If that is not happening, disabling and
|
||||
enabling the server will fix it.
|
||||
After installation a web page becomes available in the internal network at http://<your-freedombox-IP-address>:8200 (note that using mDNS name like freedombox.local doesn't work here). The web page includes information for how many files the server is detecting, how many connections exist etc. This is very useful if plugging external disks with media to check if the new media files are detected properly. If that is not happening, disabling and enabling the server will fix it.
|
||||
|
||||
=== Using MiniDLNA to play media on your devices ===
|
||||
|
||||
|
||||
@ -99,7 +99,7 @@ The Apps menu can be accessed by clicking the grid icon, next to the !FreedomBox
|
||||
|
||||
=== Help menu ===
|
||||
|
||||
The Help menu can be accessed by clicking the question mark icon in the top-right corner. It includes helpful links and the !FreedomBox manual.
|
||||
A drop-down Help menu can be accessed by clicking the question mark icon near the top-right corner. The menu includes helpful links and the !FreedomBox manual.
|
||||
|
||||
{{attachment:ui_help.png|Help|width=600}}
|
||||
|
||||
|
||||
@ -8,6 +8,42 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 24.9 (2024-04-22) ==
|
||||
|
||||
* action_utils, nextcloud: Make podman util more generic
|
||||
* config: Handle dropin config files with limited permissions
|
||||
* locale: Update translations for Albanian, Chinese (Simplified), Chinese (Traditional), Russian, Spanish, Turkish
|
||||
* nextcloud: (Note that this app is currently disabled, and not available to install.)
|
||||
* Add network interface to firewall zone after creating it
|
||||
* Add warning that the app is experimental
|
||||
* Allow backup/restore when app is disabled
|
||||
* Connect to mysql using socket instead of TCP
|
||||
* Connect to redis using Unix socket
|
||||
* Connect to slapd for LDAP using Unix socket
|
||||
* Don't fail uninstall if DB or user do not exist
|
||||
* Don't set password on redis server
|
||||
* Don't show incorrect phone region when it is not set
|
||||
* Drop a repeated creation of systemd service file
|
||||
* Ensure that database is running when running setup
|
||||
* Expand on the warning about container usage
|
||||
* Fail on errors when configuring the app
|
||||
* Fix configuring trusted proxies setting
|
||||
* Improve check used to test if installation wizard is done
|
||||
* Improve database permission granting
|
||||
* Improve setting up LDAP configuration
|
||||
* Minor changes to cron timer units
|
||||
* Minor refactoring
|
||||
* Minor update to description regarding users' usage
|
||||
* Refactor container creation code
|
||||
* Refactor setting admin password
|
||||
* Remove fail2ban jail, brute force protection present
|
||||
* Rename the systemd service names
|
||||
* Retrieve database password in a more robust way
|
||||
* Use a separate DB for redis
|
||||
* Use secrets module generate passwords
|
||||
* When backup fails, unset the maintenance mode
|
||||
* tests: functional: Disable functional tests
|
||||
|
||||
== FreedomBox 24.8 (2024-04-08) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
@ -54,6 +54,13 @@ Password managers that store their databases in files are suitable for synchroni
|
||||
|
||||
KeePassXC stores usernames, passwords etc. in files have the .kdbx extension. These kdbx files can be stored in a Syncthing shared folder to keep them synchronized on multiple machines. Free software applications which can read this file format are available for both desktop and mobile. You typically have to just point the application at the .kdbx file and enter the master password to access your stored credentials. For example, the same kdbx file can be accessed by using KeePassXC on desktop and KeePassDX on Android. KeePassXC can also be used to fill credentials into login fields in the browser by installing a browser extension.
|
||||
|
||||
==== Note-taking and Journaling ====
|
||||
|
||||
Several note-taking applications allow the notes to be stored in text files in plaintext or Markdown format. [[https://logseq.com | logseq]] is one such application that is licensed AGPLv3. It can be used to write a daily journal or discrete pages about various topics which can be linked in the form of a knowledge graph. Please note that the text is not encrypted at rest. logseq can also be used as a note-taking software by teams, instead of hosting a wiki.
|
||||
|
||||
A wiki software available on Debian desktops is [[https://zim-wiki.org | Zim]]. You can set the storage for your personal zim wiki to a Syncthing folder.
|
||||
|
||||
If your notes are only ever going to be personal, a simpler solution exists. It is called a "quine". A wiki implemented as a [[https://en.wikipedia.org/wiki/Quine_(computing) | quine]] is a single HTML file with enough embedded CSS and !JavaScript in it to make it useful for note-taking, journaling and even documentation. After editing the quine's HTML file in a web browser you can use the "Save as" feature of the browser to overwrite the existing HTML file in your Syncthing folder, each time you want to save it. Quines are the simplest note-taking/personal wiki solution that work on all operating systems with no additional software required, other than a web browser. [[https://tiddlywiki.com | TiddlyWiki]] and [[https://feather.wiki | FeatherWiki]] are popular software in this category.
|
||||
|
||||
=== External links ===
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 270 KiB After Width: | Height: | Size: 392 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 290 KiB After Width: | Height: | Size: 394 KiB |
@ -27,8 +27,8 @@ DLNA se deriva de UPnP como una forma de estandarizar interoperabilidad entre me
|
||||
|
||||
Para instalar/habilitar el servidor multimedia necesitas navegar a la página MiniDLNA y habilitarlo. Se intenta que la aplicación esté disponible en la red interna y por ello requiere asignarle un interfaz de red configurado para tráfico interno.
|
||||
|
||||
Tras la instalación queda disponible una página web en https://<tu-freedombox>/_minidlna.
|
||||
Incluye información de cuántos ficheros detecta el servidor, cuántas conexiones existen etc. Esto resulta muy útil cuando conectas discos externos con contenido para para verificar que detecta los nuevos archivos como debe. Si no ocurre así, desconectar y activar el servidor lo arreglará.
|
||||
Tras la instalación queda disponible en la red local una página web en http://<dirección_IP_de_tu_freedombox>:8200 (observa que un nombre mDNS como {{{freedombox.local}}} no funciona aquí).
|
||||
La página web incluye información de cuántos ficheros detecta el servidor, cuántas conexiones existen etc. Esto resulta muy útil cuando conectas discos externos con contenido para para verificar que detecta los nuevos archivos como debe. Si no ocurre así, desconectar y activar el servidor lo arreglará.
|
||||
|
||||
=== Usar MiniDLNA para reproducir contenidos multimedia en tus dispositivos ===
|
||||
|
||||
|
||||
@ -8,6 +8,42 @@ For more technical details, see the [[https://salsa.debian.org/freedombox-team/f
|
||||
|
||||
The following are the release notes for each !FreedomBox version.
|
||||
|
||||
== FreedomBox 24.9 (2024-04-22) ==
|
||||
|
||||
* action_utils, nextcloud: Make podman util more generic
|
||||
* config: Handle dropin config files with limited permissions
|
||||
* locale: Update translations for Albanian, Chinese (Simplified), Chinese (Traditional), Russian, Spanish, Turkish
|
||||
* nextcloud: (Note that this app is currently disabled, and not available to install.)
|
||||
* Add network interface to firewall zone after creating it
|
||||
* Add warning that the app is experimental
|
||||
* Allow backup/restore when app is disabled
|
||||
* Connect to mysql using socket instead of TCP
|
||||
* Connect to redis using Unix socket
|
||||
* Connect to slapd for LDAP using Unix socket
|
||||
* Don't fail uninstall if DB or user do not exist
|
||||
* Don't set password on redis server
|
||||
* Don't show incorrect phone region when it is not set
|
||||
* Drop a repeated creation of systemd service file
|
||||
* Ensure that database is running when running setup
|
||||
* Expand on the warning about container usage
|
||||
* Fail on errors when configuring the app
|
||||
* Fix configuring trusted proxies setting
|
||||
* Improve check used to test if installation wizard is done
|
||||
* Improve database permission granting
|
||||
* Improve setting up LDAP configuration
|
||||
* Minor changes to cron timer units
|
||||
* Minor refactoring
|
||||
* Minor update to description regarding users' usage
|
||||
* Refactor container creation code
|
||||
* Refactor setting admin password
|
||||
* Remove fail2ban jail, brute force protection present
|
||||
* Rename the systemd service names
|
||||
* Retrieve database password in a more robust way
|
||||
* Use a separate DB for redis
|
||||
* Use secrets module generate passwords
|
||||
* When backup fails, unset the maintenance mode
|
||||
* tests: functional: Disable functional tests
|
||||
|
||||
== FreedomBox 24.8 (2024-04-08) ==
|
||||
|
||||
=== Highlights ===
|
||||
|
||||
@ -54,6 +54,13 @@ Los administradores de contraseñas que almacenan sus bases de datos en ficheros
|
||||
|
||||
KeePassXC almacena usuarios, contraseñas, etc en ficheros con la extensión .kdbx. Estos ficheros .kdbx se pueden almacenar en una carpeta compartida Syncthing para mantenerlos sincronizados en multiples máquinas. Hay disponibles, tanto para escritorio como para dispositivos móviles, aplicaciones de software libre que pueden leer este formato de fichero. Habitualmente sólo tienes que apuntar la aplicación al fichero .kdbx e introducir la contraseña maestra para acceder a tus credenciales almacenadas. Por ejemplo, el mismo fichero .kdbx se puede consultar empleando KeePassXC en el escritorio y KeePassDX en Android. Instalando una extensión se puede usar también KeePassXC para rellenar credenciales en los campos de ingreso (login) en el navegador.
|
||||
|
||||
==== Anotaciones y Bitácoras ====
|
||||
|
||||
Varias aplicaciones de notas permiten guardar las notas en ficheros de texto plano o en formato _Markdown_. [[https://logseq.com | logseq]] es una de ellas, con licencia AGPLv3. Se puede usar para escribir una bitácora o páginas sueltas por temas enlazadas formando un esquema. El texto no se guarda cifrado. Un equipo puede usar logseq como software de notas en vez de un wiki.
|
||||
|
||||
[[https://zim-wiki.org|Zim]] es un software de wiki disponible en escritorios Debian. Puedes configurar el almacenaje de un wiki Zim personal para que use un carpeta Syncthing.
|
||||
|
||||
Si tus notas van a ser siempre personales, hay un solución más simple. Se llama "quine". Un wiki implemented como [[https://en.wikipedia.org/wiki/Quine_(computing)|quine]] es un único fichero HTML con CSS y !JavaScript que lo vuelven útil para tomar notas, llevar un diario o como documentación. Tras editar el fichero HTML de quine en un navegador puedes grabarlo sobreescrbiendo el fichero HTML de tu carpeta Syncthing folder. Los Quines son la solución wiki más simple para anotaciones personales que funciona en todos los sistemas operativos y que solo requiere un navegador web. [[https://tiddlywiki.com|TiddlyWiki]] y [[https://feather.wiki|FeatherWiki]] son muy populares.
|
||||
|
||||
=== Enlaces externos ===
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user