diff --git a/doc/README-pt-br.md b/doc/README-pt-br.md index 5fa2e7ee..996049b5 100644 --- a/doc/README-pt-br.md +++ b/doc/README-pt-br.md @@ -1,6 +1,6 @@ # Multer [![Build Status](https://travis-ci.org/expressjs/multer.svg?branch=master)](https://travis-ci.org/expressjs/multer) [![NPM version](https://badge.fury.io/js/multer.svg)](https://badge.fury.io/js/multer) [![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://github.com/feross/standard) -Multer é um middleware node.js para manipulação `multipart/form-data`, que é usado principalmente para fazer upload de arquivos. Está escrito em cima do [busboy](https://github.com/mscdex/busboy) para máxima eficiência. +Multer é um middleware node.js para manipulação `multipart/form-data`, que é usado principalmente para fazer upload de arquivos. Foi escrito em cima do [busboy](https://github.com/mscdex/busboy) para máxima eficiência. **NOTA**: Multer não processará nenhum formulário que não seja multipart (`multipart/form-data`). @@ -36,30 +36,30 @@ Não esqueça o `enctype="multipart/form-data"` em seu formulário. ```javascript const express = require('express') -const multer = require('multer') +const multer = require('multer') const upload = multer({ dest: 'uploads/' }) const app = express() app.post('/profile', upload.single('avatar'), function (req, res, next) { - // req.file is the `avatar` file - // req.body will hold the text fields, if there were any + // req.file é um arquivo `avatar` + // req.body conterá os campos de texto, se houver }) app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) { - // req.files is array of `photos` files - // req.body will contain the text fields, if there were any + // req.files é um array de arquivos `photos` + // req.body conterá os campos de texto, se houver }) const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }]) app.post('/cool-profile', cpUpload, function (req, res, next) { - // req.files is an object (String -> Array) where fieldname is the key, and the value is array of files + // req.files é um objeto (String -> Array) onde fieldname é a chave e o valor é array de arquivos // // e.g. // req.files['avatar'][0] -> File // req.files['gallery'] -> Array // - // req.body will contain the text fields, if there were any + // req.body conterá os campos de texto, se houver }) ``` @@ -72,7 +72,7 @@ const multer = require('multer') const upload = multer() app.post('/profile', upload.none(), function (req, res, next) { - // req.body contains the text fields + // req.body contém os campos de texto }) ``` @@ -100,7 +100,7 @@ Multer aceita um objeto de opções, a propriedade mais básica é o `dest`, que Por padrão, Multer irá renomear os arquivos para evitar conflitos de nomes. A função de renomeação pode ser personalizada de acordo com suas necessidades. -A seguir estão as opções que podem ser passadas para Multer. +A seguir estão as opções que podem ser passadas para o Multer. Key | Descrição --- | --- @@ -123,7 +123,7 @@ Aceite um único arquivo com o nome `fieldname`. O arquivo único será armazena #### `.array(fieldname[, maxCount])` -Aceite múltiplos arquivos, todos com o nome `fieldname`. Opcional, gera um erro se mais de `maxCount` forem enviados. O array de arquivos serão armazenados em +Aceite múltiplos arquivos, todos com o nome `fieldname`. Opcional, gera um errose forem enviados mais de `maxCount`. O array de arquivos serão armazenados em `req.files`. #### `.fields(fields)` @@ -147,7 +147,7 @@ Aceite apenas campo de texto. Se algum upload de arquivo for feito, um erro com #### `.any()` -Aceita todos os arquivos que são enviaos. Uma matriz de arquivos será armazenada em +Aceita todos os arquivos que são enviados. Uma matriz de arquivos será armazenada em `req.files`. **AVISO:** Certifique-se de sempre manipular os arquivos que um usuário envia. @@ -226,7 +226,7 @@ A função deve ficar assim: function fileFilter (req, file, cb) { // A função deve chamar `cb` com um booleano - // to indicate if the file should be accepted + // para indicar se o arquivo deve ser aceito // Para rejeitar este arquivo passe `false`, assim: cb(null, false) @@ -253,12 +253,12 @@ const upload = multer().single('avatar') app.post('/profile', function (req, res) { upload(req, res, function (err) { if (err instanceof multer.MulterError) { - // A Multer error occurred when uploading. + // Ocorreu um erro durante o upload. } else if (err) { - // An unknown error occurred when uploading. + // Ocorreu um erro durante o upload. } - // Everything went fine. + // Tudo correu bem. }) }) ```