You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 20, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+89Lines changed: 89 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,20 +2,29 @@
2
2
[![Build Status][travis-badge]][travis-badge-url]
3
3
4
4
Angular.io es el sitio para la **documentación** de Angular 2.
5
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
5
6
Angular-es es la traducción oficial de Angular.io
7
+
=======
8
+
>>>>>>> Translate README
6
9
7
10
Este sitio incluye también enlaces a otros recursos útiles de angular incluyendo
8
11
Angular 2, Angular 1, Angular Material y AngularFire.
9
12
10
13
## Problemas
11
14
15
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
12
16
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
13
17
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
14
22
15
23
**Problemas con la API de Angular, correcciones del cheatsheet, peticiones de funcionalidad, informes de defectos, y preguntas técnicas** referentes a Angular en si,
16
24
pertenecen al repositorio de [**código fuente de angular**](https://github.com/angular/angular/issues) de github.
17
25
No podemos manejar esos tipos de temas aquí y le pedimos que vuelva a publicarlos en el repositorio de angular.
18
26
27
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
19
28
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)
20
29
21
30
## Cómo puedes ayudar
@@ -50,25 +59,72 @@ mientras se edita contenido para poder ver el efecto de los cambios *mientras se
50
59
La documentación se basa en estilos y mixins específicos.
51
60
Aprenda acerca de ellos en la [guía de estilo de documentación](https://angular.io/docs/ts/latest/styleguide.html).
52
61
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
53
96
Los archivos jade de documentación están en directorios específicos por lenguaje en la ruta `public/docs/`.
54
97
Por ejemplo, todos los documentos de TypeScript están en `public/docs/ts/latest`, ej.
### Servidor local sincronizado y recarga del navegador
105
+
=======
106
+
### Servidor local con observadores y recarga de navegador
107
+
>>>>>>> Translate README
61
108
1. cd dentro del directorio raiz `angular.io/`
62
109
1. ejecute `gulp serve-and-sync`
63
110
1. el navegador se lanzará en localhost:3000 y se mantendrá actualizado automáticamente.
64
111
65
112
<aid="serve-and-sync"></a>
113
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
66
114
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:
67
115
68
116
*`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
69
117
*`gulp serve-and-sync-api` : sincronice solo los archivos de ejemplo y de código fuente de la API
70
118
*`gulp serve-and-sync-devguide` : sincronice solo los archivos de la guía de desarrollo
71
119
*`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
72
128
73
129
## Desarrollo Del Código De Ejemplo
74
130
@@ -79,18 +135,28 @@ Los ejemplos del Inicio Rápido en Typescript están en `public/docs/_examples/q
79
135
80
136
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.
81
137
Esta consistencia es posible en parte, gracias a las herramientas impulsadas por gulp.
138
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
82
139
Para lanzar los ejemplos localmente y confirmar que trabajan apropiadamente,
83
140
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
84
145
85
146
1. cd a `public/docs/_examples`
86
147
87
148
1. instale los paquetes canónicos para todos los ejemplos ejecutando `npm install`
88
149
150
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
89
151
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
90
155
91
156
1. ejecute `gulp add-example-boilerplate` (elevar a administrador en Windows)
92
157
para copiar los archivos en los directorios de los ejemplos y crear symlinks ahí para node_modules y typings.
93
158
159
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
94
160
Ahora entra en cualquier ejemplo particular de un languaje (ej., `public/docs/_examples/quickstart/ts`) y pruebe:
95
161
-`npm start` para compilar y servir en el navegador de forma sincronizada
96
162
-`npm run tsc` para solo compilar
@@ -100,6 +166,18 @@ Mire los scripts en `package.json` para otras opciones.
100
166
También, puede abrir cualquier `plunkr.no-link.html` para ver la ejecución del código en plunker
101
167
(tal vez se debe ejecutar `gulp build-plunkers` primero para crear/actualizar).
102
168
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
103
181
Se debe verificar que los ejemplos estén libres de errores de estilo.
104
182
-`gulp lint`
105
183
@@ -119,11 +197,19 @@ Este proyecto genera muchos archivos, si deseas reiniciarlo a su estado original
119
197
120
198
-`git clean -xdf`
121
199
200
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
122
201
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:
123
202
124
203
-`./scripts/install.sh`
125
204
126
205
### 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
127
213
Se pueden cambiar los paquetes de `@angular` en `~/public/docs/_examples/node_modules` por los paquetes del build con
128
214
```
129
215
gulp install-example-angular --build
@@ -137,8 +223,11 @@ gulp install-example-angular
137
223
>El síntoma es típicamente un error al tratar de `rm -rf node_modules/@angular`.
138
224
>
139
225
>_Solución_: Para desbloquear un paquete. En VS Code, recargar la ventana (`cmd-P` luego ingresar `>relow`).
226
+
<<<<<<< 5ac6fe0211621d93ff4f61e0dbdefecf1ec9188c
140
227
141
228
NOTA: La versión build corresponde con la versión en master de Angular 2
0 commit comments