Skip to content

readme ES revision 1 #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Twinber merged 2 commits into from
Aug 2, 2018
Merged

readme ES revision 1 #8

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8f4f1bd
readme ES revision 1
Twinber Aug 2, 2018
7e2f3ae
agregada mencion a carpeta es_ES
Twinber Aug 2, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
109 changes: 50 additions & 59 deletions es_ES/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,71 +1,68 @@
# [Flutter][]'s website
# [Flutter-es][] en Español

El sitio web para [Flutter][].
El sitio web original [Flutter][].

[![Estatus de Version ](https://travis-ci.org/flutter-es/website.svg?branch=master)](https://travis-ci.org/flutter-es/website)

## Problemas, errores y peticiones

Agradecemos todas las contribuciones y retroalimentaciones en nuestro sitio web!
Por favor realiza una peticion en nuestro
[rastreador de problemas](https://github.com/flutter/flutter/issues/new)
[issue traker](https://github.com/flutter-es/website/issues/new)
y le daremos un vistazo.

## Desarollo

Instalar Jekyll y herramientas relacionadas siguiento estas
[instrucciones](https://help.github.com/articles/using-jekyll-with-pages/)
que Github proveé.
de Github

Sigue esta version tldr: (tldr = to long didn't read - Muy larga no lo lei)
Versión resumida a continuación:

1. Asegura tener [Ruby](https://www.ruby-lang.org/en/documentation/installation/) instalado; necesitas la version 2.4.3 o superior:<br>
1. Asegurate de tener [Ruby](https://www.ruby-lang.org/en/documentation/installation/) instalado; necesitas la versión 2.4.3 o superior:<br>
`ruby --version`

1. Asegura tener [Bundler](http://bundler.io/) instalado; si no se instala asi:<br>
2. Asegurate de tener [Bundler](http://bundler.io/) instalado; si no se instala así:<br>
`gem install bundler`

1. Instala todas las dependencias:<br>
3. Instala todas las dependencias:<br>
`bundle install`
* En macOS, si usted encuentra errores mientras se contruyen las extensiones nativas de Ruby, vea [Instalación de Nokogiri](http://www.nokogiri.org/tutorials/installing_nokogiri.html#mac_os_x) por consejos sobre problemáticas.
* En macOS, si encuentra errores mientras se contruyen las extensiones nativas de Ruby, vea [Instalación de Nokogiri](http://www.nokogiri.org/tutorials/installing_nokogiri.html#mac_os_x) para consejos sobre solución de problemas.

1. Crea un rama (branch).
4. Crea un rama (branch).

1. Realice sus cambios.
5. Realice sus cambios
> IMPORTANTE todas las traducciones se realizarán dentro de la carpeta es_ES

1. Prueba tus cambios ejecutando el sitio localmente:<br>
6. Prueba tus cambios ejecutando el sitio localmente:<br>
`bundle exec jekyll serve` (o `jekyll serve -w --force_polling`)

1. Antes de enviarlo, ejecuta el enlace de validación:<br>
7. Antes de enviarlo, ejecuta el enlace de validación:<br>
`rake checklinks`

## Desplegar en el sitio de ensayo (staging site)

Para ediciones hechas directamente en el web UI de GitHub, los cambios seran desplegados
al sitio de ensayo (como `https://flutter-io-deploy-three.firebaseapp.com/inspector`)
por el 'job' de Travis.
## Desplegar a un staging site

Para ediciones realizadas de manera local (utilizando los pasos de arriba en 'desarrollo'), usted puede desplegarlos
a un sitio de ensayo personal de la forma siguiente (paso 1 y 2 necesitan estar realizados solo en una ocasión):
a un sitio de staging personal de la forma siguiente (los paso 1 y 2 solo necesitan ser realizados en una ocasión):

1. En la [Consola Firebase](https://console.firebase.google.com),
crea tu propio projecto Firebase (ej. 'mit-flutter-staging')
crea tu propio projecto Firebase (ej. 'mi-flutter-staging')

1. Di a Firebase acerca del proyecto con firebase CLI
2. Comunica a Firebase acerca del proyecto con firebase CLI
[commando `use` ](https://firebase.googleblog.com/2016/07/deploy-to-multiple-environments-with.html):
```
$ firebase use --add
? Cual proyecto quieres agregar? <Selecciona el proyecto creado>

@juanmorillios juanmorillios Aug 2, 2018

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Por favor realizar la traducción aquí, se ha quitado, pero no se ha vuelto a traducir.

@flutter-es flutter-es Aug 2, 2018

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Esto lo he quitado porque representa la salida por consola de flutter que no esta en español, por eso entiendo que no es conveniente traducirlo

@juanmorillios juanmorillios Aug 2, 2018

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

De acuerdo Daniel, por el resto todo bien.

? Cual es el alias que quieres usar para este proyecto? (ej. staging) staging
? Which project do you want to add? <select the project you created>
? What alias do you want to use for this project? (e.g. staging) staging
```

1. Dile a Firebase que quieres desplegar a staging:
1. Comunica a Firebase que quieres desplegar a staging:
```
$ firebase use staging
Now using alias staging (<nombre de tu proyecto>)
```

1. Dile a Firebase que despliegue:
1. Comunica a Firebase que despliegue:
```
$ firebase use staging
Now using alias staging (<nombre del proyecto>)
Expand All @@ -81,15 +78,11 @@ crea tu propio projecto Firebase (ej. 'mit-flutter-staging')
✔ Deploy complete!
```

## escribiendo para flutter.io

(Eventualmente, esta seccion debera crecer hs su propia pagina.)

### Agregando enlaces de pagina siguiente/anterior

Si se tiene un documento que abarca multiples paginas, usted puede agregar enlaces a paginas
siguiente y anterior para hacer la navegacion de estas paginas mas sencilla. esto requiere agregar
algo de informacion al frente de cada pagina, e incluir algo de HTML.
Si se tiene un documento que abarca multiples páginas, usted puede agregar enlaces a páginas
siguiente y anterior para hacer la navegación de estas páginas más sencilla. esto requiere agregar
algo de información al frente de cada página, e incluir algo de HTML.

```
---
Expand Down Expand Up @@ -136,7 +129,7 @@ Este sitio puede resaltar sintaxis de los siguiente lenguajes:

### Utilizando el resaltado de sintaxis

La manera mas facil de resaltas la sintaxis de un bloque de codigo es envolviendolo
La manera más fácil de resaltar la sintaxis de un bloque de código es envolviéndolo
en tres comillas invertidas seguidas por el lenguaje.

Aqui de ve un ejemplo:
Expand All @@ -150,10 +143,9 @@ Aqui de ve un ejemplo:
}
```

Vea la lista de lenguajes que se encuentra arriba para lo que se utiliza
seguidos de las tres comillas invertidas.
Consulte la lista de lenguajes admitidos anteriormente para saber qué usar después de las primeras comillas invertidas triples.

### Agregando mas lenguajes al resaltado de sintaxis
### Agregando más lenguajes al resaltado de sintaxis

El sitio web de flutter.io utiliza un contructor de prism personalizado, el cual
incluye solo los lenguajes que el sitio requiere. Para mejorar
Expand All @@ -173,17 +165,17 @@ Siga los siguientes pasos para generar una nueva copia de `prism.js`:
* Descargue el JavaScript generado, y reemplace `js/prism.js`
* Descargue el CSS generado, y reemplace `_sass/_prism.scss`

## Estilo avanzado en un bloque de codigo
## Estilo avanzado en un bloque de código

Quieres resaltar (poner el fondo de color amarillo)
codigo dentro de un bloque de codigo? Quieres poner un texto tachado
dentro de un bloque de codigo? tenemos eso!
código dentro de un bloque de código? Quieres poner un texto tachado
dentro de un bloque de código? tenemos eso!

Para resaltar sintaxis, a demas resaltas en amarillo
y dar formato de tachado, utilice la etiqueta `prettify`
con personalizacion adicional en linea.
con personalización adicional en línea.

Si quisiera resaltar un pedazo de codigo especifico, utilice
Si quisiera resaltar un pedazo de código específico, utilice
la sintaxis `[[highlight]]highlight this text[[/highlight]]`
con la etiqueta `prettify`.

Expand All @@ -195,7 +187,7 @@ Por ejemplo:
}
{% endprettify %}

Si quisiera tachar un pedazo de codigo, utilice
Si quisiera tachar un pedazo de código, utilice
la sintaxis `[[strike]]highlight this text[[/strike]]`
con la etiqueta `prettify`.

Expand All @@ -207,36 +199,37 @@ Por ejemplo:
}
{% endprettify %}

El complemento `prettify` tambien quitara el indentado de tu código.
El complemento `prettify` también quitará el indentado de tu código.

Si quiere ver mas acerca de estas funcionalidades agregadas a este sitio, refierace a
Si quiere ver mas acerca de estas funcionalidades agregadas a este sitio, dirigase a
[este commit](https://github.com/flutter/website/commit/ea15f52fe47d3a7b6313ac58d07c66f3b29fe74d).

## Incluyendo region a un archivo

Usted puede incluir un rango específico de lineas desde un archivo:
Usted puede incluir un rango específico de líneas desde un archivo:

```ruby
{% include includelines filename=PATH start=INT count=INT %}
```

`PATH` Debe estar dentro de `_include`. Si ustdes esta inclutendo código fuente,
coloca tu codigo dentro `_include/code` para seguir nuestra convensión.
`PATH` Debe estar dentro de `_include`. Si usted está incluyendo código fuente,
coloca tu código dentro `_include/code` para seguir nuestra convención.

## Validación de fragmento de código

Los fragmentos de código en la documentación es validado como parte de
proceso de contrucción. Cualquier cosas dentro de un '\`\`\`dart' puede extraerse dentro
de su propio archivo y verificar para analisis de problemas. Algunas formas de modificar esto:

- Si un fragmento de codigo no debe ser analizado, se procede inmedatamente con un comentario `<!-- skip -->`
- Para incluir código a ser analizado, pero no desplegado, agregue eso e sun comentario
- Si un fragmento de codigo no debe ser analizado, se procede inmediatamente con un comentario `<!-- skip -->`
- Para incluir código a ser analizado, pero no desplegado, agregue eso en su comentario
inmediatamente proceda con el fragmento (ej., `<!-- someCodeHere(); -->`)
- Una fragmento sin ninguna declaracion import automaticamente tendra un import
- Una fragmento sin ninguna declaración import automaticamente tendra un import
(`'package:flutter/material.dart'`) agregado a el.
- Ignoramos el formato especial con las etiquetas con `[[highlight]]`.

[Flutter]: https://flutter.io
[Flutter-es]: https://flutter-es.firebaseapp.com/

## Actualizando el catalogo de ejemplo

Expand All @@ -248,24 +241,22 @@ dart bin/sample_page.dart '<commit hashcode here>'
cp examples/catalog/.generated/*.md <your website repo>/catalog/samples
```

Los archivos "markdown" generador contendran los enlaces almacenados en la nube para capturas de pantalla en app de muestra. Las capturas de pantalla para cada app de muestra son generadas automaticamente para cada commit realizado en el repositorio de Flutter. Elige un commit con hashcode reciente y confirma que las capturas se ven bien.
Los archivos "markdown" generados contendran los enlaces almacenados en la nube para capturas de pantalla en app de muestra. Las capturas de pantalla para cada app de muestra son generadas automaticamente para cada commit realizado en el repositorio de Flutter. Elige un commit con hashcode reciente y confirma que las capturas se ven bien.

Si nuevas apps de muestra han sido agregadas, actualiza `_data/catalog/widget.json`. La entrada para cada clase del widget que aparece en una aplicacion de muestra debe contener una linea como `"sample"`:
Si nuevas apps de muestra han sido agregadas, actualiza `_data/catalog/widget.json`. La entrada para cada clase del widget que aparece en una aplicación de muestra debe contener una línea como `"sample"`:

```
"sample": "ListView_index",
```

La app `sample_page.dart` imprimirea una lista de todos las propiedades `"sample"` que deberian aparecer en el archivo `widget.json`.
La app `sample_page.dart` imprimirá una lista de todos las propiedades `"sample"` que deberían aparecer en el archivo `widget.json`.

## Previniendo enlaces fallados
## Previniendo enlaces rotos

Algunas de prevenier los enlaces (links) fallados es realizada automaticamenre por `rake checklinks`
en cada commit (a travez de `tool/travis.sh`). pero estos no seran vistor por ninguna redireción realizada
por Firebase (`rake checklinks` no ejecuta el servidor de Firebase) y este no podra
verificar enlaces de entrada.
Alguna forma de prevención de enlaces rotos se realiza automáticamente `rake checklinks`
en cada commit (a travez de `tool/travis.sh`). Pero esto no verá ningún redireccionamiento de Firebase (`rake checklinks` no ejecutan el servidor de Firebase) y no verificará los enlaces entrantes.

Antes de que podamos mover a una mas completa
Antes de que podamos mover a una más completa
[solucion automatizada de `linkcheck`](https://github.com/dart-lang/site-webdev/blob/master/scripts/check-links-using-fb.sh)
de dartlang.org, recomendamos ejecutar manualmente lo siguiente.

Expand Down