Skip to content

Commit c064555

Browse files
caesaycaesay
committed
update es ranslations
1 parent 4fe55f6 commit c064555

40 files changed

Lines changed: 1232 additions & 789 deletions

‎.github/workflows/translate.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,11 @@ jobs:
3636
# up by the script (see cleanupAfter in translate.config.json).
3737
- name: Scaffold UI translations
3838
run: npm run i18n:scaffold
39+
# The translate script shells out to the Claude CLI (`claude -p`); the runner doesn't
40+
# ship it. The CLI reads ANTHROPIC_API_KEY from the env automatically (set on the
41+
# Translate step below), so no `claude` login/config is needed in CI.
42+
- name: Install Claude CLI
43+
run: npm install -g @anthropic-ai/claude-code
3944
- name: Translate
4045
env:
4146
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

‎i18n/es/docusaurus-plugin-content-docs/current/contributing/compiling.mdx‎

Lines changed: 57 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,96 +1,106 @@
1-
# Construir el SDK de Velopack
1+
# Compilar el SDK de Velopack
22
<AppliesTo all />
3-
El SDK de Velopack es responsable de compilar las versiones y los instaladores.
3+
El SDK de Velopack es responsable de compilar versiones e instaladores.
44

5-
Está compuesto de:
6-
- Binarios de Rust que se redistribuyen con las aplicaciones instaladas,
7-
- Paquete NuGet de .NET (`Velopack`),
8-
- Herramienta de línea de comandos de .NET (`vpk`).
5+
Está compuesto por:
6+
- Binarios de Rust que se redistribuyen con las aplicaciones instaladas,
7+
- Paquete NuGet de .NET (`Velopack`),
8+
- Herramienta de línea de comandos de .NET (`vpk`).
99

10-
Para probar el proyecto, necesitas construir los binarios de Rust antes de compilar dotnet.
10+
Para probar el proyecto, es necesario compilar los binarios de Rust antes de compilar dotnet.
11+
12+
:::tip
13+
Para el desarrollo local, solo necesitas compilar los binarios para tu **sistema operativo actual** — no es necesario compilar todas las plataformas para ejecutar las pruebas. Una compilación de producción multiplataforma completa (que combina binarios de todos los sistemas operativos) es gestionada por CI y se describe en la sección de Lanzamiento / Compilación a continuación.
14+
:::
1115

1216
### Requisitos previos
13-
- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
14-
- [Rust / Cargo](https://www.rust-lang.org/tools/install)
15-
- `dotnet tool install -g dotnet-coverage`
16-
- `dotnet tool install -g nbgv`
17+
- [SDK de .NET 10](https://dotnet.microsoft.com/download/dotnet/10.0) — la solución tiene como objetivo múltiple `net8.0`, `net9.0` y `net10.0`, por lo que se requiere el SDK más alto (10) para compilar todo. CI instala los SDKs `8.0.x`, `9.0.x` y `10.0.x` de forma paralela.
18+
- [Rust / Cargo](https://www.rust-lang.org/tools/install) — la versión mínima de Rust compatible es `1.75` (edición 2021).
19+
- `dotnet tool update -g nbgv`
20+
- `dotnet tool install -g dotnet-coverage` (solo necesario para recopilar cobertura de código)
1721

18-
### Depuración / Prueba
19-
En Windows, necesitas construir los binarios de Rust usando la característica `windows` antes de ejecutar las pruebas. En OSX o Linux, deberías ejecutar `cargo build` sin el indicador de característica en su lugar.
22+
### Depuración / Pruebas
23+
En Windows, debes compilar los binarios de Rust usando la función `windows` antes de ejecutar las pruebas (algunos binarios lo requieren). En OSX o Linux, debes ejecutar `cargo build` sin el indicador de función.
2024

2125
En Windows:
2226
```shell
2327
git clone https://github.com/velopack/velopack.git
24-
cd velopack/src/bins
25-
cargo build --features windows
26-
cd ../../
28+
cd velopack
29+
cargo build -p velopack_bins --features windows
2730
dotnet build
2831
dotnet test --no-build
2932
```
3033

3134
En OSX / Linux:
3235
```shell
3336
git clone https://github.com/velopack/velopack.git
34-
cd velopack/src/bins
35-
cargo build
36-
cd ../../
37+
cd velopack
38+
cargo build -p velopack_bins
3739
dotnet build
3840
dotnet test --no-build
3941
```
4042

41-
### Publicación / Compilación
42-
Crear una versión de producción completa es complejo porque Velopack debe incluir binarios nativos para Windows, Linux y macOS. Necesitas construir los binarios de Rust por separado en cada plataforma, luego combinarlos en la máquina de compilación final usando `/p:PackRustAssets=true`.
43+
:::tip
44+
El ejecutor de pruebas está configurado mediante `global.json` para usar [`Microsoft.Testing.Platform`](https://learn.microsoft.com/dotnet/core/testing/microsoft-testing-platform-intro). `dotnet test --no-build` sigue funcionando; también puedes apuntar a un proyecto individual, por ejemplo `dotnet test --project test/Velopack.Tests/Velopack.Tests.csproj --no-build`.
45+
:::
46+
47+
### Lanzamiento / Compilación
48+
Crear un lanzamiento de producción completo es complejo porque Velopack debe incluir binarios nativos para Windows, Linux y macOS. Debes compilar los binarios de Rust por separado en cada plataforma y luego combinarlos en la máquina de compilación final usando `/p:PackRustAssets=true`.
4349

44-
Para el **desarrollo local**, normalmente solo necesitas binarios para tu sistema operativo actual. El enfoque más simple es:
50+
Para el **desarrollo local**, generalmente solo necesitas binarios para tu sistema operativo actual. El enfoque más simple es:
4551

4652
En Windows:
4753
```shell
4854
git clone https://github.com/velopack/velopack.git
49-
cd velopack/src/bins
50-
cargo build --release --features windows
51-
cd ../../
55+
cd velopack
56+
cargo build --release -p velopack_bins --features windows
5257
dotnet build -c Release
5358
```
5459

5560
En OSX:
5661
```shell
5762
git clone https://github.com/velopack/velopack.git
58-
cd velopack/src/bins
59-
cargo build --release
60-
cd ../../
63+
cd velopack
64+
cargo build --release -p velopack_bins
6165
dotnet build -c Release
6266
```
6367

6468
En Linux:
6569
```shell
6670
git clone https://github.com/velopack/velopack.git
67-
cd velopack/src/bins
68-
cargo build --release
69-
cd ../../
71+
cd velopack
72+
cargo build --release -p velopack_bins
7073
dotnet build -c Release
7174
```
7275

7376
:::tip
74-
Para un ejemplo de trabajo completo de cómo construir una versión usando código local de Velopack, consulta los [dev-scripts en el ejemplo de Avalonia](https://github.com/velopack/velopack/tree/master/samples/CSharpAvalonia/dev-scripts).
77+
Para ver un ejemplo completo y funcional de cómo compilar un lanzamiento usando código local de Velopack, consulta los [scripts de desarrollo en la muestra de Avalonia](https://github.com/velopack/velopack/tree/master/samples/CSharpAvalonia/dev-scripts).
7578
:::
7679

7780
:::note
78-
Una **compilación de producción multiplataforma** completa (que combina binarios de todos los sistemas operativos en un solo paquete) requiere construir Rust en cada plataforma primero, y luego ejecutar `dotnet build -c Release /p:PackRustAssets=true` con todos los binarios de la plataforma presentes. Este flujo de trabajo lo gestiona la CI y no es práctico replicarlo localmente. Consulta los [flujos de trabajo de CI](https://github.com/velopack/velopack/tree/master/.github/workflows) para más detalles.
81+
Una **compilación de producción multiplataforma** completa (que combina binarios de todos los sistemas operativos en un solo paquete) requiere compilar Rust en cada plataforma primero, luego recopilar todos los artefactos en `target/release` y ejecutar `dotnet build -c Release /p:PackRustAssets=true /p:ContinuousIntegrationBuild=true`. Este flujo de trabajo es gestionado por CI y no es práctico replicarlo localmente. Consulta los [flujos de trabajo de CI](https://github.com/velopack/velopack/tree/master/.github/workflows) para más detalles.
7982
:::
8083

81-
### Preparar Linux
82-
Si estás en Linux (probado en Ubuntu), hay requisitos previos de paquetes adicionales:
84+
### Preparación de Linux
85+
Si estás en Linux (probado en Ubuntu), hay requisitos previos de paquetes adicionales. Ejecutar las pruebas (que construyen AppImages) requiere FUSE:
8386
```shell
84-
sudo apt install libssl-dev pkg-config build-essential
87+
sudo add-apt-repository universe
88+
sudo apt update
89+
sudo apt install libfuse2
8590
```
8691

87-
Instalar dotnet y configurar las rutas es una molestia, recomiendo usar el script [dotnet-install.sh](https://learn.microsoft.com/dotnet/core/tools/dotnet-install-script).
92+
Si también estás compilando las bibliotecas/binarios nativos de Rust, se requieren los siguientes paquetes de desarrollo:
93+
```shell
94+
sudo apt-get install -y libgtk-3-dev libx11-dev libxext-dev libxft-dev libxinerama-dev libxcursor-dev libxrender-dev libxfixes-dev libpango1.0-dev libgl1-mesa-dev libglu1-mesa-dev libpipewire-0.3-dev libclang-dev libgbm-dev libegl-dev libwayland-dev
95+
```
96+
97+
Instalar dotnet y configurar las rutas puede ser complicado; recomiendo usar el script [dotnet-install.sh](https://learn.microsoft.com/dotnet/core/tools/dotnet-install-script).
8898

8999
```shell
90-
./dotnet-install.sh -c 8.0
100+
./dotnet-install.sh -c 10.0
91101
```
92102

93-
Y luego añadir lo siguiente al final de tu `.bashrc` o `.profile`:
103+
Y luego agregar lo siguiente al final de tu `.bashrc` o `.profile`:
94104

95105
```shell
96106
export DOTNET_ROOT="$HOME/.dotnet"
@@ -99,22 +109,21 @@ export PATH="$PATH:$HOME/.dotnet"
99109
export PATH="$PATH:$HOME/.dotnet/tools"
100110
```
101111

102-
A continuación, instala las herramientas de dotnet que faltan:
112+
A continuación, instala las herramientas de dotnet faltantes:
103113

104114
```shell
115+
dotnet tool update -g nbgv
105116
dotnet tool install -g dotnet-coverage
106-
dotnet tool install -g nbgv
107117
```
108118

109-
Necesitas verificar que `nbgv` funciona en la línea de comandos (por ejemplo, `nbgv -h`) antes de continuar.
110-
Si no funciona, comprueba que tus herramientas se instalaron en `~/.dotnet/tools`. Si no usaste el script `dotnet-install.sh`,
111-
dotnet podría estar en una ubicación diferente (por ejemplo, `/usr/share/dotnet`) y las rutas anteriores tendrán que actualizarse.
119+
Debes verificar que `nbgv` funcione en la línea de comandos (p. ej., `nbgv -h`) antes de continuar.
120+
Si no funciona, verifica que tus herramientas se instalaron en `~/.dotnet/tools`. Si no usaste el script `dotnet-install.sh`,
121+
dotnet podría estar en una ubicación diferente (p. ej., `/usr/share/dotnet`) y las rutas anteriores deberán actualizarse.
112122

113-
Una vez que dotnet esté configurado, puedes instalar Rust, lo que normalmente se hace con el [script de rustup disponible aquí](https://www.rust-lang.org/tools/install)
123+
Una vez que dotnet esté configurado, puedes instalar Rust, lo cual se hace habitualmente con el [script rustup disponible aquí](https://www.rust-lang.org/tools/install)
114124

115-
Para verificar que Rust está instalado y funcionando correctamente, deberías compilar los binarios de Rust en `src/bins`:
125+
Para verificar que Rust está instalado y funcionando correctamente, debes compilar los binarios de Rust:
116126

117127
```shell
118-
cargo build --target x86_64-unknown-linux-gnu --release
128+
cargo build --release -p velopack_bins
119129
```
120-

‎i18n/es/docusaurus-plugin-content-docs/current/distributing/Flow/authentication.mdx‎

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,30 @@
11
# Autenticación
2-
<FlowLink /> admite OAuth, autenticación por formularios y claves de API para la autenticación. Puedes usar cualquiera de estos métodos para autenticarte con el servicio Flow. El método recomendado es usar OAuth, ya que proporciona el mecanismo de autenticación más seguro y flexible.
2+
<FlowLink /> admite OAuth, autenticación mediante formularios y claves de API. Puede utilizar cualquiera de estos métodos para autenticarse con el servicio Flow. El método recomendado es OAuth, ya que proporciona el mecanismo de autenticación más seguro y flexible.
33

4-
Para realizar un inicio de sesión interactivo, usa el comando `vpk login`. Esto guardará tu autenticación localmente dentro de `~/.vpk`. Para ejecutar comandos sin interacción, como en una canalización de CI/CD, puedes especificar la opción `--api-key` en los comandos `vpk` que interactúan con Flow.
4+
## Inicio de sesión interactivo
55

6+
Para realizar un inicio de sesión interactivo, utilice el comando `vpk login`. Esto abre un navegador para autenticarse mediante OAuth y almacena sus credenciales localmente, de modo que los comandos posteriores no necesiten iniciar sesión de nuevo. Puede borrarlas con `vpk logout`.
7+
8+
```bash
9+
vpk login
10+
```
11+
12+
Las credenciales se almacenan en `~/.vpk` (el archivo `creds.bin`), respaldadas por el almacén de secretos del sistema operativo cuando está disponible (el llavero en macOS y el keyring en Linux). Este es el mismo directorio utilizado para su perfil de Flow.
13+
14+
## Inicio de sesión no interactivo (CI/CD)
15+
16+
Para ejecutar comandos sin interacción, como en un pipeline de CI/CD, cree una clave de API y pásela mediante la opción `--api-key`. Las claves de API se gestionan desde el panel de control de Flow en **Configuración de la cuenta** (consulte [Administración de cuentas](account.mdx)).
17+
18+
```bash
19+
vpk publish --api-key {yourApiKey} --outputDir <OutputDir> --channel <Channel>
20+
```
21+
22+
Al igual que con todas las opciones de `vpk`, puede proporcionar la clave de API como la variable de entorno `VPK_API_KEY` en lugar de incluirla en la línea de comandos, lo que resulta más seguro en los registros de CI.
23+
24+
## Comandos de Flow
25+
26+
Los comandos de `vpk` que interactúan con Flow aceptan todos `--api-key`:
27+
28+
- `vpk login` / `vpk logout` — inicia o cierra una sesión OAuth interactiva.
29+
- `vpk publish` — sube una versión a Flow (utilizado en la guía de [Velopack Flow](../flow.mdx)).
30+
- `vpk flow api` — realiza llamadas REST directas a la API de Flow (consulte [API](api.mdx)).

‎i18n/es/docusaurus-plugin-content-docs/current/distributing/deploy-cli.mdx‎

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,42 @@
11
# CLI de Despliegue
22
<AppliesTo all />
3-
El proceso general para desplegar una versión de Velopack (`download -> pack -> upload`) puede simplificarse enormemente usando los comandos `download` y `upload` que están integrados en la herramienta de línea de comandos `vpk`.
3+
El proceso general para desplegar una versión de Velopack (`download -> pack -> upload`) puede simplificarse considerablemente utilizando los comandos `download` y `upload` integrados en la herramienta de línea de comandos `vpk`.
44

5-
## Empaquetar tu nueva versión con deltas
5+
## Empaquetando tu nueva versión con deltas
66

7-
Para que se generen deltas durante el comando `pack`, primero necesitas descargar la última versión actual. Esto debe hacerse con el comando download:
7+
Para que se generen los deltas durante el comando `pack`, primero debes descargar la versión más reciente actual. Esto debe hacerse con el comando de descarga:
88

99
```cmd
1010
vpk download http --url https://the.place/you-host/updates
1111
vpk pack -u YourAppId -v 1.0.1 -p {buildOutput}
1212
```
1313

14-
Hay proveedores para diversas fuentes, como GitHub, S3, HTTP, etc.
14+
:::note
15+
Los flags cortos `-u`, `-v` y `-p` son alias de `--packId`, `--packVersion` y `--packDir` respectivamente (consulta la [descripción general del empaquetado](../packaging/overview.mdx)). Son intercambiables.
16+
:::
17+
18+
Existen proveedores para diversas fuentes, como GitHub, S3, HTTP, etc.
1519

16-
## Desplegar versiones
17-
En el ejemplo anterior, usamos la fuente `http`; aunque es muy genérica, no proporciona ninguna información sobre cómo subir las versiones, así que en el siguiente ejemplo de despliegue usaremos [AWS S3](https://aws.amazon.com/s3/).
20+
## Desplegando versiones
21+
En el ejemplo anterior usamos la fuente `http`; aunque es muy genérica, no proporciona información sobre cómo cargar las versiones, por lo que en el siguiente ejemplo de despliegue usaremos [AWS S3](https://aws.amazon.com/s3/).
1822

1923
:::tip
20-
La mayoría de los proveedores de almacenamiento en la nube de hoy en día tienen una API compatible con S3 ([GCP](https://cloud.google.com/storage/docs/interoperability), [BackBlaze B2](https://www.backblaze.com/docs/cloud-storage-s3-compatible-api), [DigitalOcean](https://docs.digitalocean.com/products/spaces/how-to/use-aws-sdks/), [Linode](https://www.linode.com/docs/products/storage/object-storage/), [IBM Cloud](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-compatibility-api), etc.) y se puede usar con este comando; no está limitado a AWS.
24+
La mayoría de los proveedores de almacenamiento en la nube hoy en día tienen una API compatible con S3 ([GCP](https://cloud.google.com/storage/docs/interoperability), [BackBlaze B2](https://www.backblaze.com/docs/cloud-storage-s3-compatible-api), [DigitalOcean](https://docs.digitalocean.com/products/spaces/how-to/use-aws-sdks/), [Linode](https://www.linode.com/docs/products/storage/object-storage/), [IBM Cloud](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-compatibility-api), etc.) y pueden usarse con este comando; no está limitado a AWS.
2125
:::
2226

23-
Con AWS, puedes [autenticarte usando la herramienta de línea de comandos `aws`](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/creds-idc.html) o puedes proporcionar claves de acceso como se muestra a continuación.
27+
Con AWS, puedes [autenticarte usando la herramienta de línea de comandos `aws`](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/creds-idc.html) o proporcionar claves de acceso como se muestra a continuación.
2428

25-
Si estás usando AWS SSO, deberías consultar la documentación de [AWS CLI SSO](https://aws.amazon.com/blogs/security/aws-single-sign-on-now-enables-command-line-interface-access-for-aws-accounts-using-corporate-credentials/) y la [autenticación de sesión de AWS](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html).
29+
Si estás usando AWS SSO, debes consultar la documentación de [AWS CLI SSO](https://aws.amazon.com/blogs/security/aws-single-sign-on-now-enables-command-line-interface-access-for-aws-accounts-using-corporate-credentials/) y la [autenticación de sesión de AWS](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html).
2630

2731
```cmd
2832
vpk download s3 --bucket MyApp --region us-west-1 --keyId {accessKeyId} --secret {accessKeySecret}
2933
vpk pack -u YourAppId -v 1.0.1 -p {buildOutput}
3034
vpk upload s3 --bucket MyApp --region us-west-1 --keyId {accessKeyId} --secret {accessKeySecret}
3135
```
3236

33-
Ten en cuenta que también puedes especificar la mayoría de estos argumentos como variables de entorno. Puedes revisar las [variables de entorno del SDK de AWS aquí](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) y cada opción de `vpk` también se puede proporcionar como una variable de entorno; para listarlas en el texto de ayuda usa `vpk -H` en lugar de `vpk -h`.
37+
Ten en cuenta que también puedes especificar la mayoría de estos argumentos como variables de entorno. Puedes revisar las [variables de entorno del SDK de AWS aquí](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) y cada opción de `vpk` también puede proporcionarse como variable de entorno; para listarlas en el texto de ayuda usa `vpk -H` en lugar de `vpk -h`.
3438

35-
Cuando uses una API compatible con S3 que no sea de AWS (por ejemplo, BackBlaze B2), necesitas especificar un endpoint en lugar de una región:
39+
Al usar una API compatible con S3 que no sea de AWS (p. ej., BackBlaze B2), debes especificar un endpoint en lugar de una región:
3640

3741
```cmd
3842
vpk download s3 --bucket MyApp --endpoint https://s3.eu-central-003.backblazeb2.com --keyId {accessKeyId} --secret {accessKeySecret}

0 commit comments

Comments
 (0)