Guías & Traducciones de Disroot
· Involúcrate y contribuye ·
Este repositorio contiene los archivos del **Proyecto Howto de Disroot** y la información para crear, modificar y traducir esos archivos.
El principal objetivo del **Proyecto Howto de Disroot** es la creación, mantenimiento y accesibilidad de guías para usuarias y usuarios, tutoriales y configuraciones de los diferentes servicios y software que ofrece la plataforma **Disroot**. Y también proveer las herramientas, instrucciones y procedimientos para cualquiera que quiera contribuir creando, modificando y traduciendo estas guías.
# Prerrequisitos
- a. Software necesario
- b. Cuenta en una instancia **Gitea**
- c. Solicitar acceso a nuestros repositorios
- d. Configurar tu nombre de usuari@ y correo
Para poder obtener una copia del proyecto en un máquina local y comenzar a trabajar, debes seguir estas instrucciones.
## a. Software necesario:
Primero, necesitas tener instalado el siguiente software.
- ## git
Un sistema de control de versiones para el seguimiento de los cambios que son implementados en las guías y traducciones mientras están siendo escritas.
[**¿Qué es git?**](https://es.wikipedia.org/wiki/Git)
· [**Descarga e instrucciones de instalación**](https://git-scm.com/downloads)
- ## Un editor de texto con soporte para archivos con formato markdown
_Software sugerido:_:
· **VSCodium**, una versión gestionada por la comunidad con licencia libre del editor VS Code de Microsoft. [[**Descarga e intrucciones de instalación**](https://vscodium.com/)]
· **Neovim**, un editor de texto hiperextensible basado en Vim. [[**Descarga e instrucciones de instalación**](https://github.com/neovim/neovim/wiki/Installing-Neovim)]
· **Kate Editor**, un editor lleno de características. [[**Descarga e instrucciones de instalación**](https://kate-editor.org/es/get-it/)]
## b. Una cuenta de Gitea
Para poder enviar los cambios que realizas a las guías, ya sea traduciendo, editando o escribiéndolas, necesitas tener una cuenta en una instancia de **Gitea**.
Para registrar una cuenta en la instancia donde están nuestros repositorios, ve [**aquí**](https://git.disroot.org/user/sign_up).
## c. Solicitar acceso a nuestro repositorio
Para poder registrar cambios en los repositorios git de **Disroot**, necesitarás solicitar acceso. Esto se realiza desde la página de git de nuestro proyecto.
## d. Configurar nombre de usuari@ y correo
Esto es necesario para poder enviar tu trabajo desde tu máquina local al repositorio remoto. Para configurar el nombre de usuari@ de git y el correo
- abre una terminal e inicia git
`git init`
- Tipea, y completa con tu información, los siguientes comandos:
`git config --global user.email "usuario@email"`
`git config --global user.name "Tu nombre de usuario"`
# 2. Creando / Traduciendo guías
El proceso de creación o traducción de guías no es difícil y requiere solo un poco de práctica para aprender.
El procedimiento es bastante simple:
1. Consigue una copia de los archivos sobre los que vas a trabajar;
2. trabaja localmente en tu computadora sobre los archivos,
3. y una vez que has terminado, envíalos.
Lo primero que hay que hacer es clonar el repositorio, esto significa hacer una copia local de los archivos remotos. Todo el trabajo será realizado sobre esta copia.
## a. Clonar el repositorio
Un repositorio git es una carpeta de proyecto que contiene los archivos creados o a ser traducidos y el registro histórico detallado de los cambios.
Para clonar el repositorio, abre una terminal en el directorio donde te gustaría clonarlo. Una vez allí utilizarás el comando `git clone`, una instrucción para clonar un repositorio escribiendo su dirección. En nuestro caso sería:
`git clone https://git.disroot.org/Disroot/Howto`
Una vez que el repositorio ha sido copiado a nuestro disco duro, verás un directorio `howto` que contiene todos los archivos del proyecto. Luego se puede mover a cualquier lugar en tu computadora.
## Instrucciones para crear / traducir
Una vez que tengas copiado el repositorio en tu máquina, puedes comenzar a crear, editar y/o traducir siguiendo los pasos descritos en estas guías:
- [Cómo contribuir al proyecto Howto de **Disroot**](https://howto.disroot.org/es/contribute)
- [Procedimiento para Guías y Traducciones](https://howto.disroot.org/es/contribute/procedure)
# 3. Licencia
La documentación de **Disroot's Howto** está bajo una licencia [Atribución-CompartirIgual 4.0 Internacional de Creative Commons](https://creativecommons.org/licenses/by-sa/4.0/deed.es)