Merge branch 'howto_home_procedure_ES' into 'master'

Home page translated + Added translations procedure.-

See merge request disroot/howto!153
This commit is contained in:
Fede.- 2019-08-17 07:04:13 +02:00
commit b7ad38bc74
22 changed files with 110 additions and 1 deletions

25
pages/01.home/home.es.md Normal file
View File

@ -0,0 +1,25 @@
---
title: Inicio
content:
items:
'@taxonomy':
category: [topic]
order:
by: default
dir: asc
pagination: true
---
### Bienvenid@s al sitio de Manuales y Tutoriales de Disroot.
El objetivo principal de este sitio es orientarte a través de los varios servicios de **Disroot**.
Cubrir todos los servicios, con todas las características provistas por **Disroot**, para todas las plataformas y/o Sistemas Operativos es un proyecto muy ambicioso, que demanda mucho tiempo y requiere mucho trabajo. Pensamos que podría ser beneficioso no solo para nuestros usuarios y usuarias (disrooters) sino para toda comunidad de Software Libre y de Código Abierto que use los mismos programas o similares.
Para hacerlo, toda ayuda de los y las disrooters es siempre necesaria y bienvenida. Así que, si piensas que falta un tutorial, que no la información no es correcta o puede mejorarse, por favor, contáctanos o (mejor aún) empieza a escribir una guía o tutorial tú mismo.<br>
Utilizamos **[Git](https://es.wikipedia.org/wiki/Git)**, así que podrías simplemente enviar un "*pull request*" (*petición de validación*) a nuestro repositorio. Si no estás familiarizada/o con esta herramienta, puedes enviar cambios o sugerencias via Etherpad o correo electrónico. [**Aquí**](/contribute/git) hay una guía muy simple de git.<br>
Adicionalmente, estamos construyendo un glosario para ayudar a todos aquellos que no están familiarizados con algunos términos y conceptos. Puedes verlo [aquí](/glossary).
Comencemos...

View File

@ -1,5 +1,5 @@
---
title: How-to Contribute: Choose the way
title: "How-to Contribute: Choose the way"
published: true
visible: true
updated:
@ -32,6 +32,8 @@ Through the forum you can upload, write or share a how-to and also make suggesti
You can communicate with us at our **Disroot** How-To's XMPP Room.<br><br>**Technical level required**: very basic.
----
### [Disroot Translations](/contribute/translations_procedure)
If you want to collaborate by translating **Disroot HowTo** to your language, please, check this guide.
### [Disroot's How-To style guide](/contribute/styleguide)
Some basic guidelines about the content and style criteria for the how-to's.

View File

@ -0,0 +1,82 @@
---
title: Translation Procedure
published: true
visible: true
updated:
taxonomy:
category:
- docs
tags:
- contribute
- style
page-toc:
active: true
---
# Why a translation procedure?
We think that the possibility of making information accessible to all in their own languages is fundamental in order to encourage and promote collective thoughts and actions. So coordinating the amount of information to be translated is an important task.
The translations procedure consist of **four** main steps.
## First: One-time steps
1. Register an account at https://git.fosscommunity.in/users/sign_in
2. Open a terminal and start git<br>
`git init`<br>
3. Setup the git username and email<br>
`git config --global user.email user@email`<br>
`git config --global user.name "User Name"`<br>
## Second: Selecting a section to be translated
1. Login at [**Disroot Translations Board**](https://board.disroot.org/project/fede-disroot-translations/timeline)
2. Select the **Epic** (*the set of User Stories*) corresponding to the language into which you are going to translate
3. Select the **User Story** (*the section to be translated*) and **assign** it to yourself<br>
![](en/assign.gif)
## Third: Working on translations
1. **Clone the Disroot Howto repository**<br>
a. Navigate to the folder where you're going work in (or open the terminal in the folder)<br>
b. Clone the repository<br>
`git clone https://git.fosscommunity.in/disroot/howto`
2. **Open Atom text editor**<br>
a. Go to **File**, select **Add Project Folder** and browse to the folder where the project was cloned.<br>
![](en/atom_interface1.png)<br>
b. Create a branch (the branch should have this format: site_section.to.be.translated_LAnguage<br>
For example:<br>
howto_contribute_git_ES<br>
howto_email_webmail_IT<br>![](en/branch_01.gif)<br>
c. Start working on the translations<br>
d. Save as "filename.your-language-code.md"<br>
For example, if you were working on a french translation of a file named as "docs.md", you have to save it as "docs.fr.md"
3. **Sending the translation**<br>
Once your work is done, you'll have to "commit" your changes. A commit is a set of files created of modified. To commit your changes need to:<br>
a. Make sure all files are saved<br>
b. Stage all the files you've modified and want to commit to the server<br>
c. Write a commit message (a short and very specific summary of what has been changed)<br>
d. Hit **Commit** button<br>
![](en/commit.gif)<br>
Once the files are commited, you have to "push" (send) them to the server:<br>
e. Open **Push/Pull** popup window<br>
![](en/pull_push.png)<br>
f. Press **Push**<br>
![](en/push.gif)<br>
## Fourth: Requesting the merge of the Translations
Final step is to request the merge of your work into the master branch. This means that once your finished and sent the translation, you need to request **Disroot Translation Team** to check if it's all right to finally add it to the site.<br>
1. Login to https://git.fosscommunity.in<br>
At the top right you'll see a **Create Merge Request** button that will open the merge request form, click on it
2. Add a title
3. Add a descripton
4. Make sure the source branch is the one you want to merge from (the one you've been working on)
5. Make sure the target branch is the one you want to merge to (usually Master branch)
6. Check the box **Delete source branch when merge request is accepted** if you're completely sure your work is done, this way chances of confusing subsequent translations are avoided.
If there's any issue, Admins could request you to correct something. Once all the corrections are made and the documentation meets the **Disroot** guidelines, your merge request will be pulled to the master.
To have a better overview on working with git and Atom, please check [**this tutorial**](https://howto.disroot.org/en/contribute/git/how-to-use-git).

Binary file not shown.

After

Width:  |  Height:  |  Size: 443 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 287 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 537 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 531 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

View File

Before

Width:  |  Height:  |  Size: 191 KiB

After

Width:  |  Height:  |  Size: 191 KiB

View File

Before

Width:  |  Height:  |  Size: 127 KiB

After

Width:  |  Height:  |  Size: 127 KiB

View File

Before

Width:  |  Height:  |  Size: 80 KiB

After

Width:  |  Height:  |  Size: 80 KiB