Skip to content

Commit 9d075db

Browse files
author
test
committed
docs: update translations
1 parent c8cbae8 commit 9d075db

24 files changed

Lines changed: 96 additions & 265 deletions

File tree

docs/src/content/docs/es/blog/migrating-from-aws-pdk.mdx

Lines changed: 3 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@ date: 2025-09-26
55
authors:
66
- jack
77
---
8-
9-
import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
8+
import { Steps } from '@astrojs/starlight/components';
109
import Snippet from '@components/snippet.astro';
1110
import CreateNxWorkspaceCommand from '@components/create-nx-workspace-command.astro';
1211
import RunGenerator from '@components/run-generator.astro';
@@ -37,7 +36,7 @@ Ten en cuenta también que algunas características de PDK no tienen equivalente
3736
:::
3837

3938
:::caution[Guía de un momento específico]
40-
Esta guía está escrita para un momento específico y probablemente no se actualizará conforme evolucione el Nx Plugin para AWS. Para compensar esto, la guía fija la versión de `@aws/nx-plugin` a `0.50.0`. Puedes intentar con la última versión si sigues los pasos, pero puede haber desviaciones respecto a la guía.
39+
Esta guía está escrita para un momento específico y probablemente no se actualizará conforme evolucione el Nx Plugin para AWS. Para compensar esto, la guía fija la versión de `@aws/nx-plugin` a `1.0.0-rc.33`. Puedes intentar con la última versión si sigues los pasos, pero puede haber desviaciones respecto a la guía.
4140
:::
4241

4342
## Ejemplo de Migración: Aplicación de Lista de Compras
@@ -55,28 +54,7 @@ La aplicación de lista de compras consiste en los siguientes tipos de proyecto
5554

5655
Para comenzar, crearemos un nuevo espacio de trabajo para nuestro proyecto nuevo. Aunque más extremo que una migración in situ, este enfoque nos da el resultado final más limpio. Crear un espacio de trabajo Nx es equivalente a usar el `MonorepoTsProject` de PDK:
5756

58-
<Tabs syncKey="cli-command">
59-
<TabItem label="pnpm" icon="pnpm">
60-
```bash
61-
npx create-nx-workspace@21.4.1 shopping-list --pm=pnpm --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
62-
```
63-
</TabItem>
64-
<TabItem label="yarn" icon="seti:yarn">
65-
```bash
66-
npx create-nx-workspace@21.4.1 shopping-list --pm=yarn --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
67-
```
68-
</TabItem>
69-
<TabItem label="npm" icon="seti:npm">
70-
```bash
71-
npx create-nx-workspace@21.4.1 shopping-list --pm=npm --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
72-
```
73-
</TabItem>
74-
<TabItem label="bun" icon="bun">
75-
```bash
76-
npx create-nx-workspace@21.4.1 shopping-list --pm=bun --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
77-
```
78-
</TabItem>
79-
</Tabs>
57+
<CreateNxWorkspaceCommand workspace="shopping-list" iac="cdk" tag="1.0.0-rc.33" />
8058

8159
Abre el directorio `shopping-list` que crea este comando en tu IDE favorito.
8260

docs/src/content/docs/es/snippets/pdk-migration/example/01-migrate-api.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Si usaste OpenAPI o TypeSpec como lenguaje de modelado, o tienes manejadores imp
2626

2727
Ejecuta el <Link path="/guides/ts-smithy-api">generador `ts#smithy-api`</Link> para configurar tu proyecto de API en `packages/api`:
2828

29-
<RunGenerator generator="ts#smithy-api" noInteractive requiredParameters={{ name: 'api', namespace: 'com.aws', auth: 'IAM' }} />
29+
<RunGenerator generator="ts#api" noInteractive requiredParameters={{ name: 'api', framework: 'smithy', namespace: 'com.aws', auth: 'iam' }} />
3030

3131
Notarás que esto genera un proyecto `model`, así como un proyecto `backend`. El proyecto `model` contiene tu modelo Smithy, y `backend` contiene la implementación del servidor.
3232

docs/src/content/docs/es/snippets/pdk-migration/example/02-migrate-website.mdx

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Como parte de la migración, también cambiaremos del React Router configurado p
2020

2121
Ejecuta el <Link path="/guides/react-website">generador `ts#website`</Link> con `framework` establecido en `react` para configurar tu proyecto de sitio web en `packages/website`:
2222

23-
<RunGenerator generator="ts#website" noInteractive requiredParameters={{ name: 'website', framework: 'react' }} />
23+
<RunGenerator generator="ts#website" noInteractive requiredParameters={{ name: 'website', framework: 'react', ux: 'cloudscape' }} />
2424

2525
#### Añadir autenticación Cognito
2626

@@ -67,7 +67,7 @@ El `CloudscapeReactTsWebsiteProject` incluía automáticamente una dependencia d
6767
```diff lang="ts"
6868
// packages/website/vite.config.mts
6969
build: {
70-
outDir: '../../dist/packages/website',
70+
outDir: '../../dist/packages/website/bundle',
7171
emptyOutDir: true,
7272
reportCompressedSize: true,
7373
commonjsOptions: {
@@ -99,16 +99,12 @@ Notarás algunos errores de compilación en tu IDE, necesitaremos hacer algunos
9999

100100
Al usar [enrutamiento basado en archivos](https://tanstack.com/router/latest/docs/framework/react/routing/file-based-routing), podemos usar el servidor de desarrollo local del sitio web para gestionar la generación automática de la configuración de rutas.
101101

102-
El servidor local de la API Smithy se ejecuta con [`tsx`](https://github.com/privatenumber/tsx), así que añadámoslo como dependencia de desarrollo antes de iniciar los servidores locales:
102+
Iniciemos el servidor local del sitio web:
103103

104-
<InstallCommand dev pkg="tsx" />
105-
106-
Ahora iniciemos el servidor local del sitio web:
107-
108-
<NxCommands commands={["serve-local website"]} />
104+
<NxCommands commands={["dev website"]} />
109105

110106
:::tip
111-
Usamos el objetivo `serve-local` que también inicia servidores locales para APIs conectadas con `connection`, y recarga en caliente si cambian el sitio web, modelo o backend. ¡Esto nos permite probar la API y el sitio web localmente antes de escribir código CDK!
107+
Usamos el objetivo `dev` aquí, que también inicia servidores locales para APIs conectadas con `connection`, y recarga en caliente si cambian el sitio web, modelo o backend. ¡Esto nos permite probar la API y el sitio web localmente antes de escribir código CDK!
112108
:::
113109

114110
Verás algunos errores, pero el servidor local debería iniciarse en el puerto `4200`, junto con el servidor Smithy local en el puerto `3001`.

docs/src/content/docs/fr/blog/migrating-from-aws-pdk.mdx

Lines changed: 3 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ authors:
66
- jack
77
---
88

9-
import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
9+
import { Steps } from '@astrojs/starlight/components';
1010
import Snippet from '@components/snippet.astro';
1111
import CreateNxWorkspaceCommand from '@components/create-nx-workspace-command.astro';
1212
import RunGenerator from '@components/run-generator.astro';
@@ -37,7 +37,7 @@ Notez aussi que certaines fonctionnalités de PDK n'ont pas d'équivalents exact
3737
:::
3838

3939
:::caution[Guide à un instant donné]
40-
Ce guide représente un instantané et ne sera probablement pas mis à jour avec l'évolution du Nx Plugin pour AWS. Pour compenser, le guide utilise la version `0.50.0` de `@aws/nx-plugin`. Vous pouvez essayer avec la dernière version, mais il pourrait y avoir des écarts par rapport au guide.
40+
Ce guide représente un instantané et ne sera probablement pas mis à jour avec l'évolution du Nx Plugin pour AWS. Pour compenser, le guide utilise la version `1.0.0-rc.33` de `@aws/nx-plugin`. Vous pouvez essayer avec la dernière version, mais il pourrait y avoir des écarts par rapport au guide.
4141
:::
4242

4343
## Exemple de migration : Application de liste de courses
@@ -55,28 +55,7 @@ L'application de liste de courses contient les types de projets PDK suivants :
5555

5656
Pour commencer, nous allons créer un nouvel espace de travail pour notre projet. Bien que plus radical qu'une migration in situ, cette approche donne le résultat le plus propre. Créer un espace Nx équivaut à utiliser le `MonorepoTsProject` de PDK :
5757

58-
<Tabs syncKey="cli-command">
59-
<TabItem label="pnpm" icon="pnpm">
60-
```bash
61-
npx create-nx-workspace@21.4.1 shopping-list --pm=pnpm --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
62-
```
63-
</TabItem>
64-
<TabItem label="yarn" icon="seti:yarn">
65-
```bash
66-
npx create-nx-workspace@21.4.1 shopping-list --pm=yarn --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
67-
```
68-
</TabItem>
69-
<TabItem label="npm" icon="seti:npm">
70-
```bash
71-
npx create-nx-workspace@21.4.1 shopping-list --pm=npm --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
72-
```
73-
</TabItem>
74-
<TabItem label="bun" icon="bun">
75-
```bash
76-
npx create-nx-workspace@21.4.1 shopping-list --pm=bun --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
77-
```
78-
</TabItem>
79-
</Tabs>
58+
<CreateNxWorkspaceCommand workspace="shopping-list" iac="cdk" tag="1.0.0-rc.33" />
8059

8160
Ouvrez le répertoire `shopping-list` créé par cette commande dans votre IDE préféré.
8261

docs/src/content/docs/fr/snippets/pdk-migration/example/01-migrate-api.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Si vous avez utilisé OpenAPI ou TypeSpec comme langage de modélisation, ou des
2626

2727
Exécutez le <Link path="/guides/ts-smithy-api">générateur `ts#smithy-api`</Link> pour configurer votre projet d'API dans `packages/api` :
2828

29-
<RunGenerator generator="ts#smithy-api" noInteractive requiredParameters={{ name: 'api', namespace: 'com.aws', auth: 'IAM' }} />
29+
<RunGenerator generator="ts#api" noInteractive requiredParameters={{ name: 'api', framework: 'smithy', namespace: 'com.aws', auth: 'iam' }} />
3030

3131
Vous remarquerez que cela génère un projet `model` ainsi qu'un projet `backend`. Le projet `model` contient votre modèle Smithy, et `backend` contient l'implémentation serveur.
3232

docs/src/content/docs/fr/snippets/pdk-migration/example/02-migrate-website.mdx

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ Dans le cadre de la migration, nous passerons également du React Router configu
1818

1919
#### Générer un site React
2020

21-
Exécutez le <Link path="/guides/react-website">générateur `ts#website`</Link> avec `framework` défini sur `react` pour configurer votre projet de site dans `packages/website` :
21+
Exécutez le <Link path="/guides/react-website">générateur `ts#website`</Link> avec `framework` défini sur `react` pour configurer votre projet de site dans `packages/website`. Comme l'application de liste de courses est construite avec des composants CloudScape, nous définissons également `ux` sur `cloudscape` (la valeur par défaut est `shadcn`) :
2222

23-
<RunGenerator generator="ts#website" noInteractive requiredParameters={{ name: 'website', framework: 'react' }} />
23+
<RunGenerator generator="ts#website" noInteractive requiredParameters={{ name: 'website', framework: 'react', ux: 'cloudscape' }} />
2424

2525
#### Ajouter l'authentification Cognito
2626

@@ -67,7 +67,7 @@ Le `CloudscapeReactTsWebsiteProject` incluait automatiquement une dépendance su
6767
```diff lang="ts"
6868
// packages/website/vite.config.mts
6969
build: {
70-
outDir: '../../dist/packages/website',
70+
outDir: '../../dist/packages/website/bundle',
7171
emptyOutDir: true,
7272
reportCompressedSize: true,
7373
commonjsOptions: {
@@ -99,16 +99,12 @@ Vous aurez maintenant des erreurs de build dans votre IDE, nous devrons apporter
9999

100100
Comme nous utilisons le [routage basé sur les fichiers](https://tanstack.com/router/latest/docs/framework/react/routing/file-based-routing), nous pouvons utiliser le serveur de développement local pour générer automatiquement la configuration des routes.
101101

102-
Le serveur local de l'API Smithy s'exécute avec [`tsx`](https://github.com/privatenumber/tsx), ajoutons-le donc comme dépendance de développement avant de démarrer les serveurs locaux :
102+
Démarrons le serveur local du site :
103103

104-
<InstallCommand dev pkg="tsx" />
105-
106-
Démarrons maintenant le serveur local du site :
107-
108-
<NxCommands commands={["serve-local website"]} />
104+
<NxCommands commands={["dev website"]} />
109105

110106
:::tip
111-
Nous utilisons la cible `serve-local` ici, qui démarre aussi les serveurs locaux pour les APIs connectées via `connection`, avec rechargement à chaud si le site, le modèle ou le backend changent ! Cela nous permet de tester notre API et notre site localement avant même d'écrire du code CDK.
107+
Nous utilisons la cible `dev` ici, qui démarre aussi les serveurs locaux pour les APIs connectées via `connection`, avec rechargement à chaud si le site, le modèle ou le backend changent ! Cela nous permet de tester notre API et notre site localement avant même d'écrire du code CDK.
112108
:::
113109

114110
Des erreurs peuvent apparaître, mais le serveur local devrait démarrer sur le port `4200`, ainsi que le serveur Smithy local sur le port `3001`.

docs/src/content/docs/it/blog/migrating-from-aws-pdk.mdx

Lines changed: 3 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ authors:
66
- jack
77
---
88

9-
import { Steps, Tabs, TabItem } from '@astrojs/starlight/components';
9+
import { Steps } from '@astrojs/starlight/components';
1010
import Snippet from '@components/snippet.astro';
1111
import CreateNxWorkspaceCommand from '@components/create-nx-workspace-command.astro';
1212
import RunGenerator from '@components/run-generator.astro';
@@ -37,7 +37,7 @@ Nota inoltre che alcune funzionalità di PDK non hanno equivalenti esatti. Fai r
3737
:::
3838

3939
:::caution[Guida ad un momento specifico]
40-
Questa guida è scritta come riferimento temporale e molto probabilmente non verrà aggiornata con l'evoluzione del Plugin Nx per AWS. Per compensare, la guida fissa la versione di `@aws/nx-plugin` a `0.50.0`. Puoi provare con l'ultima versione se segui la guida, ma potrebbero esserci alcune differenze.
40+
Questa guida è scritta come riferimento temporale e molto probabilmente non verrà aggiornata con l'evoluzione del Plugin Nx per AWS. Per compensare, la guida fissa la versione di `@aws/nx-plugin` a `1.0.0-rc.33`. Puoi provare con l'ultima versione se segui la guida, ma potrebbero esserci alcune differenze.
4141
:::
4242

4343
## Migrazione di esempio: Applicazione Lista della Spesa
@@ -55,28 +55,7 @@ L'applicazione lista della spesa consiste nei seguenti tipi di progetto PDK:
5555

5656
Per iniziare, creeremo un nuovo workspace per il nostro nuovo progetto. Sebbene più drastico di una migrazione in-place, questo approccio garantisce il risultato finale più pulito. Creare un workspace Nx è equivalente all'uso di `MonorepoTsProject` di PDK:
5757

58-
<Tabs syncKey="cli-command">
59-
<TabItem label="pnpm" icon="pnpm">
60-
```bash
61-
npx create-nx-workspace@21.4.1 shopping-list --pm=pnpm --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
62-
```
63-
</TabItem>
64-
<TabItem label="yarn" icon="seti:yarn">
65-
```bash
66-
npx create-nx-workspace@21.4.1 shopping-list --pm=yarn --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
67-
```
68-
</TabItem>
69-
<TabItem label="npm" icon="seti:npm">
70-
```bash
71-
npx create-nx-workspace@21.4.1 shopping-list --pm=npm --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
72-
```
73-
</TabItem>
74-
<TabItem label="bun" icon="bun">
75-
```bash
76-
npx create-nx-workspace@21.4.1 shopping-list --pm=bun --preset=@aws/nx-plugin@0.50.0 --iacProvider=CDK --ci=skip --analytics=false
77-
```
78-
</TabItem>
79-
</Tabs>
58+
<CreateNxWorkspaceCommand workspace="shopping-list" iac="cdk" tag="1.0.0-rc.33" />
8059

8160
Apri la directory `shopping-list` creata da questo comando nel tuo IDE preferito.
8261

docs/src/content/docs/it/snippets/pdk-migration/example/01-migrate-api.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Se hai utilizzato OpenAPI o TypeSpec come linguaggio di modellazione, o hai hand
2626

2727
Esegui il <Link path="/guides/ts-smithy-api">generatore `ts#smithy-api`</Link> per configurare il tuo progetto API in `packages/api`:
2828

29-
<RunGenerator generator="ts#smithy-api" noInteractive requiredParameters={{ name: 'api', namespace: 'com.aws', auth: 'IAM' }} />
29+
<RunGenerator generator="ts#api" noInteractive requiredParameters={{ name: 'api', framework: 'smithy', namespace: 'com.aws', auth: 'iam' }} />
3030

3131
Noterai che vengono generati un progetto `model` e un progetto `backend`. Il progetto `model` contiene il modello Smithy, mentre `backend` contiene l'implementazione del server.
3232

docs/src/content/docs/it/snippets/pdk-migration/example/02-migrate-website.mdx

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,13 @@ Come parte della migrazione, passeremo anche dal React Router configurato da PDK
2020

2121
Esegui il <Link path="/guides/react-website">generatore `ts#react-website`</Link> per configurare il progetto del sito web in `packages/website`:
2222

23-
<RunGenerator generator="ts#react-website" noInteractive requiredParameters={{ name: 'website' }} />
23+
<RunGenerator generator="ts#website" noInteractive requiredParameters={{ name: 'website', framework: 'react', ux: 'cloudscape' }} />
2424

2525
#### Aggiungi Autenticazione Cognito
2626

2727
Il generatore per siti web React sopra citato non include l'autenticazione Cognito di default come `CloudscapeReactTsWebsiteProject`, ma può essere aggiunta esplicitamente tramite il <Link path="/guides/react-website-auth">generatore `ts#react-website#auth`</Link>.
2828

29-
<RunGenerator generator="ts#react-website#auth" noInteractive requiredParameters={{ project: 'website', cognitoDomain: 'shopping-list' }} />
29+
<RunGenerator generator="ts#website#auth" noInteractive requiredParameters={{ project: 'website', cognitoDomain: 'shopping-list' }} />
3030

3131
Questo aggiunge componenti React che gestiscono i redirect necessari per garantire il login degli utenti tramite l'UI ospitata da Cognito. Viene inoltre aggiunto un costrutto CDK per distribuire le risorse Cognito in `packages/common/constructs`, chiamato `UserIdentity`.
3232

@@ -67,7 +67,7 @@ Il `CloudscapeReactTsWebsiteProject` includeva automaticamente una dipendenza da
6767
```diff lang="ts"
6868
// packages/website/vite.config.mts
6969
build: {
70-
outDir: '../../dist/packages/website',
70+
outDir: '../../dist/packages/website/bundle',
7171
emptyOutDir: true,
7272
reportCompressedSize: true,
7373
commonjsOptions: {
@@ -97,12 +97,14 @@ Noterai alcuni errori di compilazione nell'IDE: apporteremo ulteriori modifiche
9797

9898
#### Migra da React Router a TanStack Router
9999

100-
Utilizzando il [routing basato su file](https://tanstack.com/router/latest/docs/framework/react/routing/file-based-routing), possiamo usare il server di sviluppo locale per generare automaticamente la configurazione delle rotte. Avviamo il server locale del sito web:
100+
Utilizzando il [routing basato su file](https://tanstack.com/router/latest/docs/framework/react/routing/file-based-routing), possiamo usare il server di sviluppo locale per generare automaticamente la configurazione delle rotte.
101101

102-
<NxCommands commands={["serve-local website"]} />
102+
Avviamo il server locale del sito web:
103+
104+
<NxCommands commands={["dev website"]} />
103105

104106
:::tip
105-
Utilizziamo il target `serve-local` che avvia anche server locali per le API connesse tramite `connection`, con hot-reload in caso di modifiche! Questo ci permette di testare API e sito web localmente prima ancora di scrivere codice CDK.
107+
Utilizziamo il target `dev` che avvia anche server locali per le API connesse tramite `connection`, con hot-reload in caso di modifiche al sito web, al modello o al backend! Questo ci permette di testare API e sito web localmente prima ancora di scrivere codice CDK.
106108
:::
107109

108110
Potresti vedere alcuni errori, ma il server locale del sito web dovrebbe avviarsi sulla porta `4200`, e il server Smithy API locale sulla porta `3001`.

0 commit comments

Comments
 (0)