FreedomBox/doc/manual/es/GitWeb.raw.wiki
James Valleroy 97bebf1a1e
doc: Fetch latest manual
Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
2024-05-06 20:59:27 -04:00

76 lines
4.1 KiB
Plaintext

#language es
<<Include(FreedomBox/Manual/GitWeb, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
<<TableOfContents()>>
## BEGIN_INCLUDE
== GitWeb (Alojamiento simple para Git) ==
||<tablestyle="float: right;"> {{attachment:FreedomBox/Manual/GitWeb/Gitweb-icon_en_V01.png|icono de Gitweb}} ||
'''Disponible desde versión:''' 19.19
!GitWeb proporciona alojamiento Git en !FreedomBox. Proporciona un interfaz web para realizar acciones comunes sobre repositorios Git como ver archivos, diferencias, descripciones de cambio, etc.
''Git'' es un sistema de control de versiones distribuído para trazar cambios en código fuente durante el desarrollo de software. Con ''!GitWeb'' puedes hojear la historia y el contenido del código fuente, y usar la búsqueda para encontrar cambios y código específicos. También puedes clonar repositorios y subir cambios al código con un cliente Git de línea de órdenes o con múltiples clientes gráficos que hay disponibles. Y puedes compartir tu código con gente de todo el mundo.
Para aprender a usar Git visita su [[https://git-scm.com/docs/gittutorial|tutorial]].
=== Administrar los repositorios ===
Tras instalar !GitWeb se puede crear un nuevo repositorio. Se puede marcar como privado para limitar el acceso.
=== Acceso ===
Tras instalar !GitWeb se puede acceder a !GitWeb mediante el cliente web (p.ej) en {{{https://<mi_freedombox>/gitweb}}}.
=== Autenticación básica HTTP ===
Actualmente el !GitWeb de !FreedomBox solo soporta remotos HTTP(S) (no SSH). Para evitar tener que introducir la contraseña cada vez que haces pull/push al repositorio puedes editar tu remoto para incluír credenciales.
''Ejemplo:'' https://usuario:contrasena@mi.freedombox.mola/gitweb/mirepo
Tu nombre de usuario y contraseña se cifrarán. Quien monitorize el tráfico de la red solo apreciará el nombre de dominio.<<BR>>
'''Nota:''' Al usar este método tu contraseña se almacenará en claro en el fichero `.git/config` del repositorio local. Por este motivo debes crear un usuario !FreedomBox que solo tenga acceso a gitweb y no usar nunca una cuenta de administrador.
'''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 ===
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 ===
* Sitio web: https://git-scm.com
* Documentación de uso: https://git-scm.com/docs/gitweb
* Wiki de Debian: https://wiki.debian.org/CategoryGit
## END_INCLUDE
Volver a la [[es/FreedomBox/Features|descripción de Funcionalidades]] o a las páginas del [[es/FreedomBox/Manual|manual]].
<<Include(es/FreedomBox/Portal)>>
----
CategoryFreedomBox