Merge pull request #3046 from mariozaizar/better-translations

Missing translations for ES lang.

docs-translations/es/README.md

@@ -1,12 +1,13 @@
 ## Guías
 
-* [Distribución de aplicaciones](tutorial/application-distribution.md)
+* [Platfaformas Soportadas](tutorial/supported-platforms.md)
-* [Empaquetamiento de aplicaciones](tutorial/application-packaging.md)
+* [Distribución de la Aplicacion](tutorial/application-distribution.md)
-* [Utilizando módulos nativos](tutorial/using-native-node-modules.md)
+* [Empaquetamiento de la Aplicacion](tutorial/application-packaging.md)
-* [Depurando el proceso principal](tutorial/debugging-main-process.md)
+* [Utilizando Módulos Node Nativos](tutorial/using-native-node-modules.md)
+* [Depurando el Proceso Principal](tutorial/debugging-main-process.md)
 * [Utilizando Selenium y WebDriver](tutorial/using-selenium-and-webdriver.md)
 * [Extensión DevTools](tutorial/devtools-extension.md)
-* [Utilizando el plugin pepper flash](tutorial/using-pepper-flash-plugin.md)
+* [Utilizando el plugin Pepper Flash](tutorial/using-pepper-flash-plugin.md)
 
 ## Tutoriales
 
@@ -14,19 +15,19 @@
 * [Integración con el entorno de escritorio](tutorial/desktop-environment-integration.md)
 * [Detección del evento en línea/fuera de línea](tutorial/online-offline-events.md)
 
-## API
+## Referencias a la API
 
 * [Sinopsis](api/synopsis.md)
 * [Proceso](api/process.md)
 * [Parámetros CLI soportados (Chrome)](api/chrome-command-line-switches.md)
 
-Elementos DOM customizados:
+### Elementos DOM personalizados:
 
 * [Objeto `File`](../../docs/api/file-object.md)
 * [Etiqueta `<webview>`](../../docs/api/web-view-tag.md)
 * [Función `window.open`](../../docs/api/window-open.md)
 
-Módulos del proceso principal:
+### Módulos del Proceso Principal:
 
 * [app](../../docs/api/app.md)
 * [auto-updater](../../docs/api/auto-updater.md)
@@ -34,21 +35,23 @@ Módulos del proceso principal:
 * [content-tracing](../../docs/api/content-tracing.md)
 * [dialog](../../docs/api/dialog.md)
 * [global-shortcut](../../docs/api/global-shortcut.md)
-* [ipc (main process)](../../docs/api/ipc-main-process.md)
+* [ipc (proceso principal)](../../docs/api/ipc-main-process.md)
 * [menu](../../docs/api/menu.md)
 * [menu-item](../../docs/api/menu-item.md)
 * [power-monitor](../../docs/api/power-monitor.md)
 * [power-save-blocker](../../docs/api/power-save-blocker.md)
 * [protocol](../../docs/api/protocol.md)
+* [session](../../docs/api/session.md)
+* [web-contents](../../docs/api/web-contents.md)
 * [tray](../../docs/api/tray.md)
 
-Módulos del renderer (página web):
+### Módulos del proceso de renderizado (Página Web):
 
-* [ipc (renderer)](../../docs/api/ipc-renderer.md)
+* [ipc (renderizador)](../../docs/api/ipc-renderer.md)
 * [remote](../../docs/api/remote.md)
 * [web-frame](../../docs/api/web-frame.md)
 
-Módulos de ambos procesos:
+### Módulos de Ambos Procesos:
 
 * [clipboard](../../docs/api/clipboard.md)
 * [crash-reporter](../../docs/api/crash-reporter.md)
@@ -58,11 +61,11 @@ Módulos de ambos procesos:
 
 ## Desarrollo
 
-* [Guía de estilo](../../docs/development/coding-style.md)
+* [Guía de Estilo](development/coding-style.md)
-* [Estructura de directorio](../../docs/development/source-code-directory-structure.md)
+* [Estructura de los directorios del Código Fuente](../../development/source-code-directory-structure.md)
-* [Diferencias técnicas con NW.js (anteriormente conocido como node-webkit)](../../docs/development/atom-shell-vs-node-webkit.md)
+* [Diferencias Técnicas con NW.js (anteriormente conocido como node-webkit)](../../development/atom-shell-vs-node-webkit.md)
-* [Sistema de compilación](../../docs/development/build-system-overview.md)
+* [Repaso del Sistema de Compilación](../../development/build-system-overview.md)
-* [Instrucciones de compilación (Mac)](../../docs/development/build-instructions-osx.md)
+* [Instrucciones de Compilación (Mac)](../../development/build-instructions-osx.md)
-* [Instrucciones de compilación (Windows)](../../docs/development/build-instructions-windows.md)
+* [Instrucciones de Compilación (Windows)](../../development/build-instructions-windows.md)
-* [Instrucciones de compilación (Linux)](../../docs/development/build-instructions-linux.md)
+* [Instrucciones de Compilación (Linux)](../../development/build-instructions-linux.md)
-* [Configurando un servidor de símbolos en el depurador](../../docs/development/setting-up-symbol-server.md)
+* [Configurando un Servidor de Símbolos en el depurador](../../development/setting-up-symbol-server.md)

docs-translations/es/styleguide.md

@@ -0,0 +1,100 @@
+# Gúia de estilo de Electron
+
+Encuentra el apartado correcto para cada tarea: [leer la documentación de Electron](#reading-electron-documentation)
+o [escribir documentación para Electron](#writing-electron-documentation).
+
+## Escribir Documentación para Electron
+
+Estas son las maneras en las que construimos la documentación de Electron.
+
+- Máximo un título `h1` por página.
+- Utilizar `bash` en lugar de `cmd` en los bloques de código (por el resaltado
+  de sintaxis).
+- Los títulos `h1` en el documento deben corresponder al nombre del objeto
+  (ej. `browser-window` → `BrowserWindow`).
+  - Archivos separados por guiones, mas sin embargo, es correcto.
+- No subtítulos seguidos por otros subtítulos, añadir por lo menos un enunciado
+  de descripción.
+- Métodos de cabecera son delimitados con apóstrofes: `codigo`.
+- Cabeceras de Eventos son delimitados con 'comillas' simples.
+- No generar listas de mas de dos niveles (debido al renderizador de Markdown
+  desafortunadamente).
+- Agregar títulos de sección: Eventos, Métodos de Clases y Métodos de Instancia.
+- Utilizar 'deberá' en lugar de 'debería' al describir resultados.
+- Eventos y Métodos son cabeceras `h3`.
+- Argumentos opcionales escritos como `function (required[, optional])`.
+- Argumentos opcionales son denotados cuando se llaman en listas.
+- Delimitador de línea de 80-columnas.
+- Métodos específicos de Plataformas son denotados en italicas seguidas por la cabecera del método.
+  - ```### `method(foo, bar)` _OS X_```
+- Preferir 'en el ___ proceso' en lugar de 'sobre el'
+
+### Traducciones de la Documentación
+
+Traducciones de documentos de Electron se encuentran dentro del folder
+`docs-translations`.
+
+Para agregar otro set (o un set parcial):
+
+- Crear un subdirectorio nombrado igual a la abreviación del lenguaje.
+- Dentro de ese subdirectorio, duplicar el directorio de `docs`, manteniendo los
+  mismos nombres de directorios y archivos.
+- Traducir los archivos.
+- Actualizar el `README.md` dentro del subdirectorio del lenguaje apuntando a
+  los archivos que has traducido.
+- Agregar un enlace al folder de tu traducción en la sección principal Electron
+[README](https://github.com/atom/electron#documentation-translations).
+
+## Leyendo la Documentación de Electron
+
+Estos son algunos consejos para entender la syntaxis de la documentación de
+Electron.
+
+### Métodos
+
+Un ejemplo de la documentación del [método](https://developer.mozilla.org/en-US/docs/Glossary/Method):
+
+---
+
+`methodName(required[, optional]))`
+
+* `require` String, **required**
+* `optional` Integer
+
+---
+
+El nombre del método es seguido por los argumentos que recibe. Argumentos
+opcionales son denotados por corchetes rodeados por el argumento opcional y la
+coma requerida si el argumento opcional fuera seguido por otro argumento.
+
+Debajo del método se encuentra mas información detallada de cada uno de los
+argumentos. El tipo de argumento es denotado por los tipos comúnes:
+[`String`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String),
+[`Number`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number),
+[`Object`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object),
+[`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
+o un tipo personalizado como el [`webContent`](api/web-content.md) de Electron.
+
+### Eventos
+
+Un ejemplo de documentación del [evento](https://developer.mozilla.org/en-US/docs/Web/API/Event):
+
+---
+
+Event: 'wake-up'
+
+Returns:
+
+* `time` String
+
+---
+
+El evento es una cadena que es utilizada luego de un método observador `.on`. Si
+regresa un valor, el y su tipo son denotados abajo. Si se estaba a la escucha y
+respondió a este evento se debería ver así:
+
+```javascript
+Alarm.on('wake-up', function(time) {
+  console.log(time)
+})
+```

docs-translations/es/tutorial/application-distribution.md

@@ -1,8 +1,9 @@
-# Distribución de aplicaciones
+# Distribución de la Aplicación
 
-Para distribuir tu aplicación con Electron, debes nombrar al directorio de tu aplicación
+Para distribuir tu aplicación con Electron, el directorio que contiene la
-como `app`, y ponerlo bajo el directorio de recursos de Electron (en OSX es `Electron.app/Contents/Resources/`,
+aplicación deberá llamarse `app`, y ser colocado debajo del directorio de
-en Linux y Windows es `resources/`):
+recursos de Electron (en OSX es `Electron.app/Contents/Resources/`, en Linux y
+Windows es `resources/`), de esta forma:
 
 En OS X:
 
@@ -22,18 +23,19 @@ electron/resources/app
 └── index.html
 ```
 
-Posteriormente ejecutas `Electron.app` (o `electron` en Linux, `electron.exe` en Windows),
+Luego ejecutar `Electron.app` (o `electron` en Linux, `electron.exe` en Windows),
-y Electron iniciará la aplicación.  El directorio `electron` será la distribución que recibirán los usuarios finales.
+y Electron será iniciado como tu aplicación. El directorio `electron` será
+entonces tu distribución que recibirán los usuarios finales.
 
-## Empaquetando tu aplicación como un archivo
+## Empaquetando tu aplicación en un archivo
 
-Además de copiar todos tus archivos fuente para la distribución, también puedes
+Además de distribuir tu aplicación al copiar todos los archivos de código fuente,
-empaquetar tu aplicación como un archivo [asar](https://github.com/atom/asar)
+también puedes empaquetar tu aplicación como un archivo [asar](https://github.com/atom/asar)
-y de esta forma evitar la exposición del código fuente de tu aplicación a los usuarios.
+y de esta forma evitar exponer del código fuente de tu aplicación a los usuarios.
 
-Para usar un archivo `asar` en reemplazo de la carpeta `app`, debes renombrar
+Para utilizar un archivo `asar` en reemplazo del directorio `app`, debes de
-el archivo a `app.asar`, y ponerlo bajo el directorio de recursos de Electron (como arriba),
+renombrar el archivo a `app.asar`, y colocarlo por debajo el directorio de recursos
-Electron intentará leer el archivo y ejecutar la aplicación desde él.
+de Electron (ver en seguida), Electron intentará leer el archivo y arrancar desde el.
 
 En OS X:
 
@@ -49,30 +51,33 @@ electron/resources/
 └── app.asar
 ```
 
-Más detalles en [Empaquetamiento de aplicaciones](application-packaging-es.md).
+Más detalles en [Empaquetado de Aplicaciones](application-packaging.md).
 
-## Rebranding con binarios descargados
+## Redefinición con Binarios Descargados
 
-Luego de empaquetar tu aplicación con Electron, podría ser útil agregar tu marca
+Luego de empaquetar tu aplicación en Electron, querrás redefinir Electron antes
-antes de realizar la distribución.
+de distribuirlo a los usuarios.
 
 ### Windows
 
-Puedes renombrar `electron.exe` a cualquier nombre que desees, y editar su ícono y otras informaciones
+Puedes renombrar `electron.exe` a cualquier nombre que desees, y editar su ícono
-con herramientas como [rcedit](https://github.com/atom/rcedit) o [ResEdit](http://www.resedit.net).
+y otra información con herramientas como [rcedit](https://github.com/atom/rcedit)
+o [ResEdit](http://www.resedit.net).
 
 ### OSX
 
-Puedes renombrar `Electron.app` a cualquier nombre que desees. También debes modificar los campos 
+Puedes renombrar `Electron.app` a cualquier nombre que desees, y tendrás que
-`CFBundleDisplayName`, `CFBundleIdentifier` y `CFBundleName` en los siguientes archivos:
+renombrar los campos `CFBundleDisplayName`, `CFBundleIdentifier` y `CFBundleName`
+en los siguientes archivos:
 
 * `Electron.app/Contents/Info.plist`
 * `Electron.app/Contents/Frameworks/Electron Helper.app/Contents/Info.plist`
 
-También puedes renombrar el helper de la aplicación para evitar que aparezca como  `Electron Helper`
+También puedes renombrar el helper de la aplicación para evitar que aparezca
-en el Monitor de Actividades.
+como `Electron Helper` en el Monitor de Actividades. Pero asegurate de renombrar
+el nombre de archivo del ejecutable.
 
-La estructura de una aplicación renombrada sería así:
+La estructura de una aplicación renombrada será:
 
 ```
 MyApp.app/Contents
@@ -98,17 +103,19 @@ MyApp.app/Contents
 
 Puedes renombrar el ejectuable `electron` a cualquier nombre que desees.
 
-## Rebranding desde el código fuente de Electron
+## Redefinición mediante la recompilación de Electron desde el código fuente
 
-También es posible agregar tu marca a Electron mediante un build personalizado.
+También es posible redefinir Electron cambiando el nombre del producto y
-Para realizar esto debes modificar el archivo `atom.gyp`.
+compilandolo desde sus fuentes. Para realizar esto necesitas modificar el
+archivo `atom.gyp` y realizar una compilación desde cero.
 
 ### grunt-build-atom-shell
 
-La modificación del código de Electron para agregar tu marca puede resultar complicada, una tarea Grunt
+La modificación a mano del código de Electron y su compilación puede resultar
-se ha creado para manejar esto de forma automatizada:
+complicada, por lo cual se ha generado una tarea Grunt para manejar esto de
-
+forma automaticamente:
 [grunt-build-atom-shell](https://github.com/paulcbetts/grunt-build-atom-shell).
 
-Esta tarea se encargará de modificar el archivo `.gyp`, compilar el código
+Esta tarea se encargará de modificar el archivo `.gyp`, compilar el código desde
-y reconstruir los módulos nativos de la aplicación para que coincidan con el nuevo nombre.
+las fuentes, y luego reconstruir los módulos nativos de la aplicación para que
+coincidan con el nuevo nombre del ejecutable.

docs/styleguide.md

@@ -65,7 +65,11 @@ notated by brackets surrounding the optional argument as well as the comma
 required if this optional argument follows another argument.
 
 Below the method is more detailed information on each of the arguments. The type
-of argument is notated by either the common types: [`String`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String), [`Number`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number), [`Object`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object), [`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
+of argument is notated by either the common types:
+[`String`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String),
+[`Number`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number),
+[`Object`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object),
+[`Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)
 or a custom type like Electron's [`webContent`](api/web-content.md).
 
 ### Events