Skip to content
This repository was archived by the owner on Mar 20, 2024. It is now read-only.

Commit 4d87b9a

Browse files
GuzmanPIFoxandxss
authored andcommitted
Translate README
1 parent 5ac6fe0 commit 4d87b9a

1 file changed

Lines changed: 89 additions & 0 deletions

File tree

README.md

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,29 @@
22
[![Build Status][travis-badge]][travis-badge-url]
33

44
Angular.io es el sitio para la **documentación** de Angular 2.
5+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
56
Angular-es es la traducción oficial de Angular.io
7+
=======
8+
>>>>>>> Translate README
69
710
Este sitio incluye también enlaces a otros recursos útiles de angular incluyendo
811
Angular 2, Angular 1, Angular Material y AngularFire.
912

1013
## Problemas
1114

15+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
1216
Por favor crea **issues en Guithub _sólo_ referentes a la Guía del Desarrollador, a las Recetas y/o de ejemplos de código** en el
1317
repositorio [Angular.io](https://github.com/angular/angular.io/issues) de github.
18+
=======
19+
Por favor crea **issues en Guithub _sólo_ referentes a la Guía del Desarrollador, a las Recetas y/o de ejemplos de código** al
20+
repositorio [Angular.io](https://github.com/angular/angular.io/issues) de github. Este repositorio es para los errores generales de la doc.
21+
>>>>>>> Translate README
1422
1523
**Problemas con la API de Angular, correcciones del cheatsheet, peticiones de funcionalidad, informes de defectos, y preguntas técnicas** referentes a Angular en si,
1624
pertenecen al repositorio de [**código fuente de angular**](https://github.com/angular/angular/issues) de github.
1725
No podemos manejar esos tipos de temas aquí y le pedimos que vuelva a publicarlos en el repositorio de angular.
1826

27+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
1928
Por último, para problemas con la localización al Español de esta documentación, por favor abra un issue en el repositorio de [angular-es](https://github.com/angular/angular-es)
2029

2130
## Cómo puedes ayudar
@@ -50,25 +59,72 @@ mientras se edita contenido para poder ver el efecto de los cambios *mientras se
5059
La documentación se basa en estilos y mixins específicos.
5160
Aprenda acerca de ellos en la [guía de estilo de documentación](https://angular.io/docs/ts/latest/styleguide.html).
5261

62+
=======
63+
## Cómo puedes ayudar
64+
65+
Crear issues de Github acerca de problemas es útil pero **pull requests** que mejoren la documentación son aun mejores!
66+
67+
Aprende como [contribuir a Angular.io](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md).
68+
69+
## Configuración para desarrollo
70+
Este sitio depende en gran medida de node y npm.
71+
72+
1. Asegúrese de estar usando la versión más reciente de node y npm;
73+
si no, instala [nvm](https://github.com/creationix/nvm) para conseguir node en tu máquina.
74+
75+
2. Instale *globalmente* estos paquetes npm: `npm install -g harp gulp`
76+
77+
3. Clone este repositorio y el [repositorio de código fuente de angular](https://github.com/angular/angular) en el mismo directorio.
78+
79+
4. cd dentro del directorio raiz `angular.io/`
80+
81+
5. Instale los paquetes locales del sitio ejecutando el comando `npm install`
82+
> Si está ejecutando node v.5+, probablemente deba reconstruir `node-sass` en un paso a parte: `npm rebuild node-sass`
83+
84+
6. Vea [abajo](#desarrollo-de-código-muestra) para la preparación del desarrollo de código de muestra.
85+
86+
## Desarrollo de Contenido
87+
Todo el contenido de documentación está escrito en Jade, el cual tiene [su propia sintaxis](http://jade-lang.com/reference/).
88+
Hay que tener en cuenta las estrictas exigencias de formato de texto impuestas por Jade.
89+
Recomendamos encarecidamente ejecutar uno de los comandos `serve-and-sync` de gulp [descritos debajo](#serve-and-sync),
90+
mientras se edita contenido para poder ver el efecto de los cambios *mientras se teclea*.
91+
92+
La documentación se basa en estilos y mixins específicos.
93+
Aprenda acerca de ellos en la [guía de estilo de documentación](https://angular.io/docs/ts/latest/styleguide.html).
94+
95+
>>>>>>> Translate README
5396
Los archivos jade de documentación están en directorios específicos por lenguaje en la ruta `public/docs/`.
5497
Por ejemplo, todos los documentos de TypeScript están en `public/docs/ts/latest`, ej.
5598
- `public/docs/ts/latest/quickstart.jade`
5699
- `public/docs/ts/latest/guide/architecture.jade`
57100
- `public/docs/ts/latest/cookbook/component-communication.jade`
58101
- `public/docs/ts/latest/tutorial/toh-pt5.jade`
59102

103+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
60104
### Servidor local sincronizado y recarga del navegador
105+
=======
106+
### Servidor local con observadores y recarga de navegador
107+
>>>>>>> Translate README
61108
1. cd dentro del directorio raiz `angular.io/`
62109
1. ejecute `gulp serve-and-sync`
63110
1. el navegador se lanzará en localhost:3000 y se mantendrá actualizado automáticamente.
64111

65112
<a id="serve-and-sync"></a>
113+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
66114
Si va a trabajar en una parte especifica de la documentación, tal como la guía de desarrollo, se puede utilizar una de las tareas más especificas de gulp para sincronizar solo esos archivos del sistema:
67115

68116
* `gulp serve-and-sync` : sincronice todos los archivos Jade/Sass locales, los ejempos y recursos de la API y los archivos de la guía de desarrollo
69117
* `gulp serve-and-sync-api` : sincronice solo los archivos de ejemplo y de código fuente de la API
70118
* `gulp serve-and-sync-devguide` : sincronice solo los archivos de la guía de desarrollo
71119
* `gulp build-and-serve` : sincronice solo los archivos Jade/Sass locales
120+
=======
121+
Si va a trabajar en una parte especifica de los documentos, tal como la guía de desarrollo, se puede utilizar una de las tareas más especificas de gulp para ver solo esas partes de los archivos del sistema:
122+
123+
* `gulp serve-and-sync` : ver todos los archivos Jade/Sass locales, los ejempos y recursos de la API y los archivos de la guía de desarrollo
124+
* `gulp serve-and-sync-api` : ver solo los archivos de ejemplo y de código fuente de la API
125+
* `gulp serve-and-sync-devguide` : ver solo los archivos de la guía de desarrollo
126+
* `gulp build-and-serve` : ver solo los archivos Jade/Sass locales
127+
>>>>>>> Translate README
72128
73129
## Desarrollo Del Código De Ejemplo
74130

@@ -79,18 +135,28 @@ Los ejemplos del Inicio Rápido en Typescript están en `public/docs/_examples/q
79135

80136
Todos los ejemplos están en una estructura consistente de directorios usando los mismos estilos y los mismos paquetes npm, incluyendo la última versión de Angular 2.
81137
Esta consistencia es posible en parte, gracias a las herramientas impulsadas por gulp.
138+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
82139
Para lanzar los ejemplos localmente y confirmar que trabajan apropiadamente,
83140
ejecute los siguientes pasos extra para preparar el entorno:
141+
=======
142+
Para correr los ejemplos localmente y confirmar que trabajan apropiadamente,
143+
tomar los siguientes pasos extra para preparar el ambiente:
144+
>>>>>>> Translate README
84145
85146
1. cd a `public/docs/_examples`
86147

87148
1. instale los paquetes canónicos para todos los ejemplos ejecutando `npm install`
88149

150+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
89151
1. cd de vuelta a la raiz `angular.io`: `cd ../../..`
152+
=======
153+
1. cd de regreso a la raiz `angular.io`: `cd ../../..`
154+
>>>>>>> Translate README
90155
91156
1. ejecute `gulp add-example-boilerplate` (elevar a administrador en Windows)
92157
para copiar los archivos en los directorios de los ejemplos y crear symlinks ahí para node_modules y typings.
93158

159+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
94160
Ahora entra en cualquier ejemplo particular de un languaje (ej., `public/docs/_examples/quickstart/ts`) y pruebe:
95161
- `npm start` para compilar y servir en el navegador de forma sincronizada
96162
- `npm run tsc` para solo compilar
@@ -100,6 +166,18 @@ Mire los scripts en `package.json` para otras opciones.
100166
También, puede abrir cualquier `plunkr.no-link.html` para ver la ejecución del código en plunker
101167
(tal vez se debe ejecutar `gulp build-plunkers` primero para crear/actualizar).
102168

169+
=======
170+
171+
Ahora entra en cualquier ejemplo particular a un languaje (ej., `public/docs/_examples/quickstart/ts`) y probar:
172+
- `npm start` para compilar-observar y servir-y-observar en el navegador simultaneamente
173+
- `npm run tsc` para solo compilar
174+
- `npm run lite` para servir-y-observar en el navegador
175+
176+
Mire los scripts en `package.json` para otras opciones.
177+
También, se puede abrir cualquier `plunkr.no-link.html` para ver la ejecución de código en plunker
178+
(tal vez se debe ejecutar `gulp build-plunkers` primero para crear/actualizar).
179+
180+
>>>>>>> Translate README
103181
Se debe verificar que los ejemplos estén libres de errores de estilo.
104182
- `gulp lint`
105183

@@ -119,11 +197,19 @@ Este proyecto genera muchos archivos, si deseas reiniciarlo a su estado original
119197

120198
- `git clean -xdf`
121199

200+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
122201
También, hay un script disponible para los usuarios de Linux, OSX y Windows Gitbash que configurará el proyecto usando los pasos mostrados en esta sección:
123202

124203
- `./scripts/install.sh`
125204

126205
### Trabajar con la versión build de Angular en vez de la última versión publicada
206+
=======
207+
También, hay un script disponible para los usuarios de Linux, OSX Windows Gitbash que configurará el proyecto usando los pasos mostrados en esta sección:
208+
209+
- `./scripts/install.sh`
210+
211+
### Trabajar con el build actual en lugar de los paquetes de la versión actual
212+
>>>>>>> Translate README
127213
Se pueden cambiar los paquetes de `@angular` en `~/public/docs/_examples/node_modules` por los paquetes del build con
128214
```
129215
gulp install-example-angular --build
@@ -137,8 +223,11 @@ gulp install-example-angular
137223
>El síntoma es típicamente un error al tratar de `rm -rf node_modules/@angular`.
138224
>
139225
>_Solución_: Para desbloquear un paquete. En VS Code, recargar la ventana (`cmd-P` luego ingresar `>relow`).
226+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
140227

141228
NOTA: La versión build corresponde con la versión en master de Angular 2
229+
=======
230+
>>>>>>> Translate README
142231
143232

144233
## Technología Usada

0 commit comments

Comments
 (0)