From 35775a9760d1381e12b8d25312e9e210b54a1f96 Mon Sep 17 00:00:00 2001 From: Fede Date: Sun, 1 Jan 2023 19:44:30 -0300 Subject: [PATCH] Readme Update --- README_ES.md | 88 +++++++++++++++++++++++++++++++++------------------- 1 file changed, 56 insertions(+), 32 deletions(-) diff --git a/README_ES.md b/README_ES.md index d16f0902..e5330992 100644 --- a/README_ES.md +++ b/README_ES.md @@ -1,49 +1,59 @@ -![](disroot_h2_title.png) +

-# Guías/Tutoriales y Traducciones de Disroot +![](h2.png) -| [Disroot Guías](https://howto.disroot.org/es) | [Disroot Website](https://disroot.org/es) | +

+ +

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. -## Contenidos -* [Requisitos](#requisitos) - - Software necesario - - Cuenta en una instancia **Gitea** - - Solicitar acceso a nuestros repositorios - - Configurar tu nombre de usuari@ y correo -* [Crear / Traducir Guías](#crear-traducir-guias) - - Clonar el repositorio - - Instrucciones para la Creación / Traducción -* [Licencia](#licencia) +
----- -## Requisitos +# Prerequisitos + - 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. -### 01. Software necesario: +## 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 las traducciones mientras están siendo escritas.
-[**¿Qué es git?**](https://es.wikipedia.org/wiki/Git) / [**Descarga**](https://git-scm.com/downloads) / [**Instrucciones de instalación**](https://git-scm.com/book/es/v1/Empezando-Instalando-Git) / [**Guía básica de uso de Git de Disroot**](https://howto.disroot.org/es/contribute/git/how-to-use-git) -- Un editor de texto con soporte para archivos con formato markdown
-Software sugerido: **Atom Text Editor**, un editor de código con control de versiones git integrado.
-[**Descarga e instrucciones de instalación**](https://flight-manual.atom.io/getting-started/sections/installing-atom/) +- ## 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) -### 02. Cuenta en una instancia de Gitea +- ## 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). -### 03. Solicitar acceso a nuestros repositorios +
+ +## 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. -### 04. Configurar nombre de usuari@ y correo +
+ +## 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
@@ -53,13 +63,23 @@ Esto es necesario para poder enviar tu trabajo desde tu máquina local al reposi `git config --global user.email usuario@email`
`git config --global user.name "Tu nombre de usuario"` +
-## Crear / Traducir guías + +# 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. -### Clonar el repositorio +
+ +## 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: @@ -68,12 +88,16 @@ Para clonar el repositorio, abre una terminal en el directorio donde te gustarí 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 +
+ +## 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 utilizar git para las guías de **Disroot**](https://howto.disroot.org/es/contribute/git/how-to-use-git)
+- [Cómo contribuir al proyecto Howto de **Disroot**](https://howto.disroot.org/es/contribute)
-- [Procedimiento de **Disroot** para traducciones](https://howto.disroot.org/es/contribute/translations_procedure) +- [Procedimiento para Guías y Traducciones](https://howto.disroot.org/es/contribute/procedure) -## Licencia +
+ +# 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)