Skip to content

Commit 67b4316

Browse files
nicobytesSplaktar
authored andcommitted
docs: translate libraries.md
1 parent 604bd6e commit 67b4316

File tree

2 files changed

+62
-24
lines changed

2 files changed

+62
-24
lines changed

aio/content/guide/libraries.en.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Overview of Angular libraries
2+
3+
Many applications need to solve the same general problems, such as presenting a unified user interface, presenting data, and allowing data entry.
4+
Developers can create general solutions for particular domains that can be adapted for re-use in different apps.
5+
Such a solution can be built as Angular *libraries* and these libraries can be published and shared as *npm packages*.
6+
7+
An Angular library is an Angular [project](guide/glossary#project) that differs from an app in that it cannot run on its own.
8+
A library must be imported and used in an app.
9+
10+
Libraries extend Angular's base functionality. For example, to add [reactive forms](guide/reactive-forms) to an app, add the library package using `ng add @angular/forms`, then import the `ReactiveFormsModule` from the `@angular/forms` library in your application code.
11+
Similarly, adding the [service worker](guide/service-worker-intro) library to an Angular application is one of the steps for turning an application into a [Progressive Web App](https://developers.google.com/web/progressive-web-apps/) (PWA).
12+
[Angular Material](https://material.angular.io/) is an example of a large, general-purpose library that provides sophisticated, reusable, and adaptable UI components.
13+
14+
Any app developer can use these and other libraries that have been published as npm packages by the Angular team or by third parties. See [Using Published Libraries](guide/using-libraries).
15+
16+
## Creating libraries
17+
18+
If you have developed functionality that is suitable for reuse, you can create your own libraries.
19+
These libraries can be used locally in your workspace, or you can publish them as [npm packages](guide/npm-packages) to share with other projects or other Angular developers.
20+
These packages can be published to the npm registry, a private npm Enterprise registry, or a private package management system that supports npm packages.
21+
See [Creating Libraries](guide/creating-libraries).
22+
23+
Whether you decide to package functionality as a library is an architectural decision, similar to deciding whether a piece of functionality is a component or a service, or deciding on the scope of a component.
24+
25+
Packaging functionality as a library forces the artifacts in the library to be decoupled from the application's business logic.
26+
This can help to avoid various bad practices or architecture mistakes that can make it difficult to decouple and reuse code in the future.
27+
28+
Putting code into a separate library is more complex than simply putting everything in one app.
29+
It requires more of an investment in time and thought for managing, maintaining, and updating the library.
30+
This complexity can pay off, however, when the library is being used in multiple apps.
31+
32+
<div class="alert is-helpful">
33+
34+
Note that libraries are intended to be used by Angular apps.
35+
To add Angular functionality to non-Angular web apps, you can use [Angular custom elements](guide/elements).
36+
37+
</div>

aio/content/guide/libraries.md

Lines changed: 25 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,38 @@
1-
# Overview of Angular libraries
1+
# Vista general de librerías para Angular
22

3-
Many applications need to solve the same general problems, such as presenting a unified user interface, presenting data, and allowing data entry.
4-
Developers can create general solutions for particular domains that can be adapted for re-use in different apps.
5-
Such a solution can be built as Angular *libraries* and these libraries can be published and shared as *npm packages*.
3+
Muchas aplicaciones necesitan resolver los mismos problemas en general, como presentar una interfaz de usuario unificada, mostrar datos, permitir entrada de datos etc.
4+
Los desarrolladores puede crear soluciones generales para dominios particulares que pueden ser adoptados para re usarse en diferentes aplicaciones.
5+
Tal solución se puede construir como *librerías* para Angular y estas librerías pueden ser publicadas y compartidas como *paquetes de npm*.
66

7-
An Angular library is an Angular [project](guide/glossary#project) that differs from an app in that it cannot run on its own.
8-
A library must be imported and used in an app.
7+
Una librería de Angular es como un [proyecto](guide/glossary#project) lo que la diferencia de una app es que no puede correr por si sola.
8+
Una librería debe ser importada y usada en una app.
99

10-
Libraries extend Angular's base functionality. For example, to add [reactive forms](guide/reactive-forms) to an app, add the library package using `ng add @angular/forms`, then import the `ReactiveFormsModule` from the `@angular/forms` library in your application code.
11-
Similarly, adding the [service worker](guide/service-worker-intro) library to an Angular application is one of the steps for turning an application into a [Progressive Web App](https://developers.google.com/web/progressive-web-apps/) (PWA).
12-
[Angular Material](https://material.angular.io/) is an example of a large, general-purpose library that provides sophisticated, reusable, and adaptable UI components.
10+
Las librerías extienden la funcionalidad base de Angular. Por ejemplo, para agregar [formularios reactivos](guide/reactive-forms) en una app, agregamos la librería usando `ng add @angular/forms`, entonces importamos el `ReactiveFormsModule` desde la librería `@angular/forms` el código de la aplicación.
11+
De igual manera, agregar la librería [service worker](guide/service-worker-intro) dentro de una aplicación Angular es el primer paso para convertir una aplicación a una [Progressive Web App](https://developers.google.com/web/progressive-web-apps/) (PWA).
12+
[Angular Material](https://material.angular.io/) es un ejemplo de una gran librería de propósito general que ofrece componentes de UI sofisticados, reutilizables y adaptables.
1313

14-
Any app developer can use these and other libraries that have been published as npm packages by the Angular team or by third parties. See [Using Published Libraries](guide/using-libraries).
14+
Cualquier desarrollador de apps puede usar estas y otras librerías que han sido publicadas como paquetes de npm por el equipo de Angular o por terceros. Mirá [Usando librerías publicadas](guide/using-libraries).
1515

16-
## Creating libraries
16+
## Creando librerías
1717

18-
If you have developed functionality that is suitable for reuse, you can create your own libraries.
19-
These libraries can be used locally in your workspace, or you can publish them as [npm packages](guide/npm-packages) to share with other projects or other Angular developers.
20-
These packages can be published to the npm registry, a private npm Enterprise registry, or a private package management system that supports npm packages.
21-
See [Creating Libraries](guide/creating-libraries).
18+
Si tu tienes funcionalidades desarrolladas que puede ser adecuadas para re usarse tu puedes crear tus propias librerías.
19+
Estas librerías puede ser usadas localmente en tu espacio de trabajo, o puede ser publicadas como [paquetes de npm](guide/npm-packages) para compartir con otros proyectos o otros desarrolladores Angular.
20+
Estos paquetes pueden ser publicados en el registro de npm, en un registro empresarial privado de npm, o en un sistema de gestión de paquetes privado que soporte paquetes de npm.
21+
Mirá [Creando librerías](guide/creating-libraries).
2222

23-
Whether you decide to package functionality as a library is an architectural decision, similar to deciding whether a piece of functionality is a component or a service, or deciding on the scope of a component.
23+
Si tu decides empaquetar una funcionalidad como una librería es una decisión de arquitectura, similar a decidir entre si una pieza de funcionalidad es un componente o un servicio, o decidir el alcance de un componente.
2424

25-
Packaging functionality as a library forces the artifacts in the library to be decoupled from the application's business logic.
26-
This can help to avoid various bad practices or architecture mistakes that can make it difficult to decouple and reuse code in the future.
25+
Empaquetar funcionalidad como una librería fuerza a
26+
que los artefactos en la librería puedan ser desacoplados de la lógica de negocio de la aplicación.
27+
Esto puede ayudar a evitar varias malas practicas o errores de arquitectura que puede hacer difícil desacoplar y re usar código en el futuro.
2728

28-
Putting code into a separate library is more complex than simply putting everything in one app.
29-
It requires more of an investment in time and thought for managing, maintaining, and updating the library.
30-
This complexity can pay off, however, when the library is being used in multiple apps.
29+
Poniendo el código dentro de una librería separada es más complejo que simplemente poner todo en una sola aplicación.
30+
Esto requiere una inversión mayor de tiempo y pensar para administrar, mantener y actualizar la librería.
31+
Sin embargo esta complejidad puede valer la pena cuando la librería esta siendo usada en múltiples aplicaciones.
3132

3233
<div class="alert is-helpful">
3334

34-
Note that libraries are intended to be used by Angular apps.
35-
To add Angular functionality to non-Angular web apps, you can use [Angular custom elements](guide/elements).
35+
Note que las librerías están destinadas para ser usadas por aplicaciones Angular.
36+
Para agregar funcionalidad de Angular hacia una aplicación web que no es Angular, puedes usar [Angular custom elements](guide/elements).
3637

37-
</div>
38+
</div>

0 commit comments

Comments
 (0)