Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add spanish translation for advanced/files.md #982

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

JaviStamb
Copy link

Add Spanish translation for files.md in advance folder.

@JaviStamb JaviStamb requested a review from a team as a code owner June 3, 2024 03:01
Comment on lines +2 to +3


Copy link
Member

@alemohamad alemohamad Jun 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

Remove this line.


## Lectura

El método principal para leer un archivo envia fragmentos a un controlador de devolucion de llamadas a medida que se leen del disco. El archivo a leer se especifica por su ruta. Las rutas relativas buscarán en el directorio de trabajo actual del proceso.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
El método principal para leer un archivo envia fragmentos a un controlador de devolucion de llamadas a medida que se leen del disco. El archivo a leer se especifica por su ruta. Las rutas relativas buscarán en el directorio de trabajo actual del proceso.
El método principal para leer un archivo envía fragmentos a un controlador de devolución de llamadas a medida que se leen del disco. El archivo a leer se especifica por su ruta. Las rutas relativas buscarán en el directorio de trabajo actual del proceso.

}
// Lectura completada
```
Si utiliza `EventLoopFuture`, el futuro devuelto indicará cuando la lectura ha finalizado o si ha ocurrido un error. Si utiliza `async`/`await` entonces una vez que el `await` regrese, la lectura ha sido completada. Si un error ha ocurrido, arrojará una excepción.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Si utiliza `EventLoopFuture`, el futuro devuelto indicará cuando la lectura ha finalizado o si ha ocurrido un error. Si utiliza `async`/`await` entonces una vez que el `await` regrese, la lectura ha sido completada. Si un error ha ocurrido, arrojará una excepción.
Si utiliza `EventLoopFuture`, el futuro devuelto indicará cuando la lectura ha finalizado o si ha ocurrido un error. Si utiliza `async`/`await` entonces una vez que el `await` regrese, la lectura ha sido completada. Si un error ha ocurrido, arrojará una excepción.

Comment on lines +28 to +29

The `streamFile` method converts a streaming file to a `Response`. This method will set appropriate headers such as `ETag` and `Content-Type` automatically.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `streamFile` method converts a streaming file to a `Response`. This method will set appropriate headers such as `ETag` and `Content-Type` automatically.


### Flujo

El método `streamFile` convierte un archivo de transmisión en una respuesta. Este método establecerá automáticamente los encabezados apropiados, como `ETag` y `Content-Type`.
Copy link
Member

@alemohamad alemohamad Jun 7, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
El método `streamFile` convierte un archivo de transmisión en una respuesta. Este método establecerá automáticamente los encabezados apropiados, como `ETag` y `Content-Type`.
El método `streamFile` convierte un archivo de transmisión en una respuesta `Response`. Este método establecerá automáticamente los encabezados apropiados, como `ETag` y `Content-Type`.

```swift
// Transmite archivos de forma asincrónica como respuesta HTTP.
req.fileio.streamFile(at: "/path/to/file").map { res in
print(res) // Respuesta
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
print(res) // Respuesta
print(res) // Response

print(res)

```
El resultado puede ser devuelto directamente por su controlador de ruta.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
El resultado puede ser devuelto directamente por su controlador de ruta.
El resultado puede ser devuelto directamente por su controlador de ruta.

```

!!! Warning "Advertencia"
Este método requiere que el archivo entero este en la memoria a la vez. Utilice lectura fragmentada o en flujo para limitar el uso de memoria.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Este método requiere que el archivo entero este en la memoria a la vez. Utilice lectura fragmentada o en flujo para limitar el uso de memoria.
Este método requiere que el archivo entero esté en la memoria desde el comienzo. Utilice una lectura fragmentada (chunked) o lectura streaming para limitar el uso de memoria.

## Escritura

El método `writeFile` permite escribir un búfer en un archivo
The `writeFile` method supports writing a buffer to a file.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `writeFile` method supports writing a buffer to a file.


## Escritura

El método `writeFile` permite escribir un búfer en un archivo
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
El método `writeFile` permite escribir un búfer en un archivo
El método `writeFile` permite escribir un buffer a un archivo.

The `writeFile` method supports writing a buffer to a file.

```swift
// Escribe el búfer en el archivo.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
// Escribe el búfer en el archivo.
// Escribe el buffer en el archivo.

Comment on lines +74 to +75


Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

// Escribe el búfer en el archivo.
req.fileio.writeFile(ByteBuffer(string: "Hello, world"), at: "/path/to/file")
```
El futuro devuelto indicará cuando se haya completado la escritura o se haya producido un error.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
El futuro devuelto indicará cuando se haya completado la escritura o se haya producido un error.
El futuro devuelto indicará cuando se haya completado la escritura o se haya producido un error.


## Middleware

Para más información en cómo enviar archivos automáticamente desde la carpeta pública de su projecto, visite [Middleware → FileMiddleware](middleware.md#file-middleware).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Para más información en cómo enviar archivos automáticamente desde la carpeta pública de su projecto, visite [Middleware → FileMiddleware](middleware.md#file-middleware).
Para más información en cómo enviar archivos automáticamente desde la carpeta _Public_ de su proyecto, visite [Middleware → FileMiddleware](middleware.md#file-middleware).


## Avanzado

Para los casos que la API de vapor no es compatible, puede utilizar el tipo `NonBlockingFileIO` de NIO's directamente.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Para los casos que la API de vapor no es compatible, puede utilizar el tipo `NonBlockingFileIO` de NIO's directamente.
Para los casos que la API de Vapor no sea compatible, puede utilizar directamente el tipo `NonBlockingFileIO` de NIO's.

Comment on lines +98 to +100
Para más información, visite SwiftNIO's [API reference](https://swiftpackageindex.com/apple/swift-nio/main/documentation/nioposix/nonblockingfileio).


Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Para más información, visite SwiftNIO's [API reference](https://swiftpackageindex.com/apple/swift-nio/main/documentation/nioposix/nonblockingfileio).
Para más información, visite la [referencia de API](https://swiftpackageindex.com/apple/swift-nio/main/documentation/nioposix/nonblockingfileio) de SwiftNIO.

Copy link
Member

@alemohamad alemohamad left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pretty good job @JaviStamb! Review the suggested changes, and I will review them after. 👍

@alemohamad alemohamad added the translation-update This PR contains translations for the docs label Jun 7, 2024
@alemohamad alemohamad changed the title Add spanish translation for files.md Add spanish translation for advanced/files.md Jun 23, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
translation-update This PR contains translations for the docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants