Skip to content

Commit 6e6148b

Browse files
ricardochlSplaktar
authored andcommitted
translate: translations for Custom Build Pipeline guide
- Translate Custom Build Pipeline guide to Spanish - Update sub-navigation labels to Spanish Fixes #74
1 parent e701090 commit 6e6148b

File tree

3 files changed

+50
-17
lines changed

3 files changed

+50
-17
lines changed

adev-es/src/app/routing/sub-navigation-data.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1023,7 +1023,7 @@ const DOCS_SUB_NAVIGATION_DATA: NavigationItem[] = [
10231023
contentPath: 'ecosystem/web-workers',
10241024
},
10251025
{
1026-
label: 'Custom build pipeline',
1026+
label: 'Pipeline de compilación personalizada',
10271027
path: 'ecosystem/custom-build-pipeline',
10281028
contentPath: 'ecosystem/custom-build-pipeline',
10291029
},
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Custom build pipeline
2+
3+
When building an Angular app we strongly recommend you to use the Angular CLI to leverage its structure-dependent update functionality and build system abstraction. This way your projects benefit from the latest security, performance, and API improvements and transparent build improvements.
4+
5+
This page explores the **rare use cases** when you need a custom build pipeline that does not use the Angular CLI. All listed tools below are open source build plugins that are maintained by members of the Angular community. To learn more about their support model and maintenance status look at their documentation and GitHub repository URLs.
6+
7+
## When should you use a custom build pipeline?
8+
9+
There are some niche use cases when you may want to maintain a custom build pipeline. For example:
10+
11+
* You have an existing app using a different toolchain and you’d like to add Angular to it
12+
* You’re strongly coupled to [module federation](https://module-federation.io/) and unable to adopt bundler-agnostic [native federation](https://www.npmjs.com/package/@angular-architects/native-federation)
13+
* You’d like to create an short-lived experiment using your favorite build tool
14+
15+
## What are the options?
16+
17+
Currently, there are two well supported community tools that enable you to create a custom build pipeline with a [Vite plugin](https://www.npmjs.com/package/@analogjs/vite-plugin-angular) and [Rspack plugin](https://www.npmjs.com/package/@nx/angular-rspack). Both of them use underlying abstractions that power the Angular CLI. They allow you to create a flexible build pipeline and require manual maintenance and no automated update experience.
18+
19+
### Rspack
20+
21+
Rspack is a Rust-based bundler that aims to provide compatibility with the webpack plugin ecosystem.
22+
23+
If your project is tightly coupled to the webpack ecosystem, heavily relying on a custom webpack configuration you can leverage Rspack to improve your build times.
24+
25+
You can find more about Angular Rspack on the project’s [documentation website](https://nx.dev/recipes/angular/rspack/introduction).
26+
27+
### Vite
28+
29+
Vite is a frontend build tool that aims to provide a faster and leaner development experience for modern web projects. Vite is also extensible through its plugin system that allows ecosystems to build integrations with Vite, such as Vitest for unit and browser testing, Storybook for authoring components in isolation, and more. The Angular CLI also uses Vite as its development server.
30+
31+
The [AnalogJS Vite plugin for Angular](https://www.npmjs.com/package/@analogjs/vite-plugin-angular) enables the adoption of Angular with a project or framework that uses or is built on top of Vite. This can consist of developing and building an Angular project with Vite directly, or adding Angular to an existing project or pipeline. One example is integrating Angular UI components into a documentation website using [Astro and Starlight](https://analogjs.org/docs/packages/astro-angular/overview).
32+
33+
You can learn more about AnalogJS and how to use the plugin through its [documentation page](https://analogjs.org/docs/packages/vite-plugin-angular/overview).
Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
1-
# Custom build pipeline
1+
# Pipeline de compilación personalizada
22

3-
When building an Angular app we strongly recommend you to use the Angular CLI to leverage its structure-dependent update functionality and build system abstraction. This way your projects benefit from the latest security, performance, and API improvements and transparent build improvements.
3+
Al compilar una aplicación Angular, recomendamos enfáticamente usar Angular CLI para aprovechar su funcionalidad de actualizaciones dependientes de la estructura y la abstracción del sistema de compilación. De esta manera, tus proyectos se benefician de las mejoras más recientes en seguridad, rendimiento y APIs, además de obtener mejoras de compilación transparentes.
44

5-
This page explores the **rare use cases** when you need a custom build pipeline that does not use the Angular CLI. All listed tools below are open source build plugins that are maintained by members of the Angular community. To learn more about their support model and maintenance status look at their documentation and GitHub repository URLs.
5+
Esta página explora los **casos de uso poco comunes** en los que necesitas un pipeline de compilación personalizado que no utiliza Angular CLI. Todas las herramientas listadas a continuación son plugins de compilación de código abierto mantenidos por miembros de la comunidad de Angular. Para conocer más sobre su modelo de soporte y estado de mantenimiento, revisa su documentación y las URL de sus repositorios en GitHub.
66

7-
## When should you use a custom build pipeline?
7+
## ¿Cuándo deberías usar un pipeline de compilación personalizado?
88

9-
There are some niche use cases when you may want to maintain a custom build pipeline. For example:
9+
Existen algunos casos muy específicos en los que podrías querer mantener un pipeline de compilación personalizado. Por ejemplo:
1010

11-
* You have an existing app using a different toolchain and you’d like to add Angular to it
12-
* You’re strongly coupled to [module federation](https://module-federation.io/) and unable to adopt bundler-agnostic [native federation](https://www.npmjs.com/package/@angular-architects/native-federation)
13-
* You’d like to create an short-lived experiment using your favorite build tool
11+
* Tienes una aplicación existente que utiliza una herramienta diferente y quieres agregar Angular
12+
* Estás fuertemente acoplado a [module federation](https://module-federation.io/) y no puedes adoptar la [native federation](https://www.npmjs.com/package/@angular-architects/native-federation) independiente del empaquetador
13+
* Quieres crear un experimento de corta duración usando tu herramienta de compilación favorita
1414

15-
## What are the options?
15+
## ¿Cuáles son las opciones?
1616

17-
Currently, there are two well supported community tools that enable you to create a custom build pipeline with a [Vite plugin](https://www.npmjs.com/package/@analogjs/vite-plugin-angular) and [Rspack plugin](https://www.npmjs.com/package/@nx/angular-rspack). Both of them use underlying abstractions that power the Angular CLI. They allow you to create a flexible build pipeline and require manual maintenance and no automated update experience.
17+
Actualmente, existen dos herramientas comunitarias bien soportadas que te permiten crear un pipeline de compilación personalizado mediante un [plugin de Vite](https://www.npmjs.com/package/@analogjs/vite-plugin-angular) y un [plugin de Rspack](https://www.npmjs.com/package/@nx/angular-rspack). Ambos utilizan las abstracciones subyacentes que impulsan Angular CLI. Te permiten crear un pipeline de compilación flexible, pero requieren mantenimiento manual y no proporcionan una experiencia de actualización automática.
1818

1919
### Rspack
2020

21-
Rspack is a Rust-based bundler that aims to provide compatibility with the webpack plugin ecosystem.
21+
Rspack es un empaquetador basado en Rust que busca ofrecer compatibilidad con el ecosistema de plugins de webpack.
2222

23-
If your project is tightly coupled to the webpack ecosystem, heavily relying on a custom webpack configuration you can leverage Rspack to improve your build times.
23+
Si tu proyecto está fuertemente acoplado al ecosistema de webpack y depende en gran medida de una configuración personalizada de webpack, puedes aprovechar Rspack para mejorar los tiempos de compilación.
2424

25-
You can find more about Angular Rspack on the project’s [documentation website](https://nx.dev/recipes/angular/rspack/introduction).
25+
Puedes obtener más información sobre Angular Rspack en el [sitio de documentación](https://nx.dev/recipes/angular/rspack/introduction) del proyecto.
2626

2727
### Vite
2828

29-
Vite is a frontend build tool that aims to provide a faster and leaner development experience for modern web projects. Vite is also extensible through its plugin system that allows ecosystems to build integrations with Vite, such as Vitest for unit and browser testing, Storybook for authoring components in isolation, and more. The Angular CLI also uses Vite as its development server.
29+
Vite es una herramienta de compilación frontend que busca ofrecer una experiencia de desarrollo más rápida y liviana para proyectos web modernos. Además, Vite es extensible gracias a su sistema de plugins, que permite a distintos ecosistemas construir integraciones con Vite, como Vitest para pruebas unitarias y en el navegador, Storybook para crear componentes de forma aislada y más. Angular CLI también usa Vite como su servidor de desarrollo.
3030

31-
The [AnalogJS Vite plugin for Angular](https://www.npmjs.com/package/@analogjs/vite-plugin-angular) enables the adoption of Angular with a project or framework that uses or is built on top of Vite. This can consist of developing and building an Angular project with Vite directly, or adding Angular to an existing project or pipeline. One example is integrating Angular UI components into a documentation website using [Astro and Starlight](https://analogjs.org/docs/packages/astro-angular/overview).
31+
El [plugin de Vite para Angular de AnalogJS](https://www.npmjs.com/package/@analogjs/vite-plugin-angular) habilita la adopción de Angular en un proyecto o framework que usa Vite o se construye sobre Vite. Esto puede implicar desarrollar y compilar un proyecto Angular directamente con Vite, o agregar Angular a un proyecto o pipeline existente. Un ejemplo es integrar componentes de UI de Angular en un sitio de documentación usando [Astro y Starlight](https://analogjs.org/docs/packages/astro-angular/overview).
3232

33-
You can learn more about AnalogJS and how to use the plugin through its [documentation page](https://analogjs.org/docs/packages/vite-plugin-angular/overview).
33+
Puedes aprender más sobre AnalogJS y cómo usar el plugin en su [página de documentación](https://analogjs.org/docs/packages/vite-plugin-angular/overview).

0 commit comments

Comments
 (0)