doc: Fetch latest manual

Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
This commit is contained in:
James Valleroy 2023-04-10 20:33:55 -04:00
parent eda9c6a846
commit 7748499e3f
No known key found for this signature in database
GPG Key ID: 77C0C75E7B650808
6 changed files with 80 additions and 3 deletions

View File

@ -50,6 +50,20 @@ GNOME "Passwords and Keys" utility can be used to store the username and passwor
Though your repositories are primarily hosted on your own !FreedomBox, you can
configure a repository on another Git hosting system like GitLab as a mirror.
=== Enabling/Disabling Features ===
In !FreedomBox, some of the default features of gitweb have been changed:
* Enabled: Blame feature to show what revision and author last modified each line of a file
* Enabled: Pickaxe feature to list the commits that introduced or removed a given string
* Enabled: Highlight feature to perform syntax highlighting on blobs
* Disabled: Snapshot feature that provides a download of a compressed tar file for a given revision (due to high resource usage).
These features can be changed on a per-repository bases by an administrator by editing the git configuration file for the repository on !FreedomBox. See manual page for gitweb.conf(5) for more details on syntax and features. For example, to re-enable the snapshot feature on `myrepo` repository, login to a !FreedomBox terminal via SSH or web console as administrator and edit the file `/var/lib/git/myrepo/config` to contain the following section:
{{{
[gitweb]
snapshot = tgz
}}}
=== External links ===

View File

@ -121,7 +121,7 @@ If you get an error such as `configuration error: invalid 1th argument to “pro
=== Accessing internal services ===
After connecting to OpenVPN, you will be able to access !FreedomBox services that are only meant to be accessed on internal networks. This is in addition to being able to access external services. This can be done by using the IP address 10.91.0.1 as the host name for these services.
After connecting to OpenVPN, you will be able to access !FreedomBox services that are only meant to be accessed on internal networks. This is in addition to being able to access external services. This can be done by using the IP address 10.91.0.1 as the host name for these services (for example, use smb://10.91.0.1 instead of smb://freedombox.local to access Samba shares).
The following services are known to '''work''':
* [[FreedomBox/Manual/Privoxy|Privoxy]],

View File

@ -8,6 +8,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 23.6.1 (2023-04-10) ==
* coturn: Prevent package removal when roundcube is uninstalled
* datetime: Re-implement backup/restore for timezone
* gitweb: Disable snapshot feature
* gitweb: Make globally configured features overridable per-repository
* locale: Update translations for Bulgarian, French
== FreedomBox 23.7 (2023-03-27) ==
=== Highlights ===
* matrixsynapse: Add token based registration verification
* mediawiki: Allow setting site language code
=== Other Changes ===
* container: Fix resizing disk image containing multiple partitions
* container: Force pip to install packages to system environment
* container: Increase wait time to accommodate slower architectures
* locale: Update translations for Bulgarian
* tests: functional: Fix setting first ethernet connection as internal
== FreedomBox 23.6 (2023-03-13) ==
* /etc/issue: Update message to reflect that all users can login

View File

@ -36,10 +36,27 @@ Tu nombre de usuario y contraseña se cifrarán. Quien monitorize el tráfico de
'''Para usuarios de GNOME (Avanzado)'''
La utilidad "Contraseñas y claves" de GNOME se puede emplear para almacenar el usuario y su contraseña. Más detalles de cómo hacerlo en esta [[https://stackoverflow.com/questions/36585496/error-when-using-git-credential-helper-with-gnome-keyring-as-sudo/40312117#40312117|respuesta en StackOverflow]].
=== Réplicas Espejo ===
=== Réplicas espejo ===
Aunque tus repositorios se albergan principalmente en tu propia !FreedomBox puedes configurar un repositorio en otro servicio de alojamiento Git como GitLab a modo de copia espejo.
=== (Des)habilitar funciones ===
Algunas funciones que en gitweb vienen de serie se han cambiado en !FreedomBox:
* Habilitada: Funcionalidad ''blame'' para mostrar qué quién y en qué revisión modificó cada línea de un fichero.
* Habilitada: Funcionalidad ''pickaxe'' para listar los commits que introdujeron o eliminaron una cadena de texto dada.
* Habilitada: Funcionalidad de resaltado de sintaxis para los blobs.
* Deshabilitada: Funcionalidad de instantánea que descarga un fichero comprimido tar con una revisión dada (por su alto consumo de recursos).
Un administrador puede ajustar estas selecciones editando el fichero de configuration de git de cada repositorio en !FreedomBox. Más detalles de sintaxis y funciones en la página man de gitweb.conf(5).
Por ejemplo, para rehabilitar las instantánes en el repositorio `mirepo`, ingresa como administrador al terminal de !FreedomBox por SSH o consola web y edita el fichero `/var/lib/git/mirepo/config`
para que contenga la sección siguiente:
{{{
[gitweb]
snapshot = tgz
}}}
=== Enlaces externos ===
* Documentación de uso: https://git-scm.com/docs/gitweb

View File

@ -119,7 +119,7 @@ $ sudo nmcli connection import type openvpn file /ruta/a/<USUARIO>.ovpn
=== Acceso a servicios internos ===
Tras conectar por OpenVPN, podrás acceder a algunos servicios !FreedomBox restringidos a acceso interno, además de a los de acceso externo. Esto se puede hacer usando la dirección IP 10.91.0.1 como hostname para esos servicios.
Tras conectar por OpenVPN, podrás acceder a algunos servicios !FreedomBox restringidos a acceso interno, además de a los de acceso externo. Esto se puede hacer usando la dirección IP 10.91.0.1 como hostname para esos servicios. (Por ejemplo, usa `smb://10.91.0.1` en vez de `smb://freedombox.local` para acceder a carpetas compartidas Samba).
Los siguientes servicios '''funcionan''' con OpenVPN:
* [[es/FreedomBox/Manual/Privoxy|Privoxy]],

View File

@ -8,6 +8,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 23.6.1 (2023-04-10) ==
* coturn: Prevent package removal when roundcube is uninstalled
* datetime: Re-implement backup/restore for timezone
* gitweb: Disable snapshot feature
* gitweb: Make globally configured features overridable per-repository
* locale: Update translations for Bulgarian, French
== FreedomBox 23.7 (2023-03-27) ==
=== Highlights ===
* matrixsynapse: Add token based registration verification
* mediawiki: Allow setting site language code
=== Other Changes ===
* container: Fix resizing disk image containing multiple partitions
* container: Force pip to install packages to system environment
* container: Increase wait time to accommodate slower architectures
* locale: Update translations for Bulgarian
* tests: functional: Fix setting first ethernet connection as internal
== FreedomBox 23.6 (2023-03-13) ==
* /etc/issue: Update message to reflect that all users can login