Skip to content

Commit 88f2aa1

Browse files
docs: remove unfortunate abbreviation from readme (#1299)
Fixes #1298
1 parent 900764f commit 88f2aa1

10 files changed

Lines changed: 50 additions & 50 deletions

File tree

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,8 +56,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
5656
// req.body will contain the text fields, if there were any
5757
})
5858

59-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
60-
app.post('/cool-profile', cpUpload, function (req, res, next) {
59+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
60+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
6161
// req.files is an object (String -> Array) where fieldname is the key, and the value is array of files
6262
//
6363
// e.g.
@@ -100,7 +100,7 @@ const multer = require('multer')
100100
const upload = multer({ dest: './public/data/uploads/' })
101101
app.post('/stats', upload.single('uploaded_file'), function (req, res) {
102102
// req.file is the name of your file in the form above, here 'uploaded_file'
103-
// req.body will hold the text fields, if there were any
103+
// req.body will hold the text fields, if there were any
104104
console.log(req.file, req.body)
105105
});
106106
```

doc/README-ar.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
**ملاحظة**: لن يقوم Multer بمعالجة أي شكل غير متعدد الأجزاء (`multipart/form-data`).
88

99

10-
## الترجمات
10+
## الترجمات
1111

1212
هذا الملف متاح أيضًا بلغات أخرى:
1313

@@ -63,8 +63,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
6363
// req.body will contain the text fields, if there were any
6464
})
6565

66-
var cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
67-
app.post('/cool-profile', cpUpload, function (req, res, next) {
66+
var uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
67+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
6868
// req.files is an object (String -> Array) where fieldname is the key, and the value is array of files
6969
//
7070
// e.g.
@@ -101,18 +101,18 @@ app.post('/profile', upload.none(), function (req, res, next) {
101101

102102
مفتاح | وصف | ملاحظة
103103
--- | --- | ---
104-
`fieldname` | اسم المُدخَل المحدد في الإستمارة |
105-
`originalname` | اسم الملف على كمبيوتر المستخدم |
106-
`encoding` | نوع تشفير الملف |
107-
`mimetype` | نوع ملف ملحقات بريد إنترنت متعددة الأغراض ( MIME ) |
108-
`size` | حجم الملف بالبايت |
104+
`fieldname` | اسم المُدخَل المحدد في الإستمارة |
105+
`originalname` | اسم الملف على كمبيوتر المستخدم |
106+
`encoding` | نوع تشفير الملف |
107+
`mimetype` | نوع ملف ملحقات بريد إنترنت متعددة الأغراض ( MIME ) |
108+
`size` | حجم الملف بالبايت |
109109
`destination` | المجلد الذي تم حفظ الملف إليه | `تخزين على الاسطوانة` (`DiskStorage`)
110110
`filename` | اسم الملف داخل "الوجهة" ( `destination` ) | `تخزين على الاسطوانة` (`DiskStorage`)
111111
`path` | المسار الكامل للملف الذي تم تحميله | `تخزين على الاسطوانة` (`DiskStorage`)
112112
`buffer` | "ذاكرة" (`Buffer`) للملف بأكمله | `تخزين على الذاكرة ` (`MemoryStorage`)
113113

114114

115-
### `multer(opts)`
115+
### `multer(opts)`
116116

117117
يقبل Multer كائن الخيارات ، وأهمها خاصية `dest`، والتي تحدد مكان تحميل الملفات. في حال حذفت كائن الخيارات ، سيتم الاحتفاظ بالملفات في الذاكرة ولن تتم كتابتها مطلقًا على القرص.
118118

@@ -122,10 +122,10 @@ app.post('/profile', upload.none(), function (req, res, next) {
122122

123123
مفتاح | وصف
124124
--- | ---
125-
`dest` أو `storage` | مكان لتخزين الملفات
125+
`dest` أو `storage` | مكان لتخزين الملفات
126126
`fileFilter` | دالة للسيطرة على الملفات التي يتم قبولها
127-
`limits` | حدود البيانات التي تم تحميلها
128-
`preservePath` | الاحتفظ بالمسار الكامل للملفات بدلاً من الاسم الأساسي
127+
`limits` | حدود البيانات التي تم تحميلها
128+
`preservePath` | الاحتفظ بالمسار الكامل للملفات بدلاً من الاسم الأساسي
129129

130130
في تطبيق ويب متوسط ​​، قد تكون هناك حاجة فقط إلى `dest`، وتكوينها كما هو موضح في
131131
المثال التالي :

doc/README-es.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
5151
// req.body contendrá los campos de texto, si los hubiera.
5252
})
5353

54-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
55-
app.post('/cool-profile', cpUpload, function (req, res, next) {
54+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
55+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
5656
// req.files es un objeto (String -> Array) donde el nombre del campo es la clave (key) y el valor es el arreglo (array) de archivos
5757
//
5858
// Ejemplo
@@ -84,7 +84,7 @@ Este es un ejemplo de cómo se utiliza multer en un formulario HTML. Presta espe
8484
<div class="form-group">
8585
<input type="file" class="form-control-file" name="uploaded_file">
8686
<input type="text" class="form-control" placeholder="Number of speakers" name="nspeakers">
87-
<input type="submit" value="Get me the stats!" class="btn btn-default">
87+
<input type="submit" value="Get me the stats!" class="btn btn-default">
8888
</div>
8989
</form>
9090
```

doc/README-fr.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 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)
22

3-
Multer est un middleware node.js pour la gestion des données `multipart/form-data` qui est principalement utilisé pour télécharger des fichiers.
3+
Multer est un middleware node.js pour la gestion des données `multipart/form-data` qui est principalement utilisé pour télécharger des fichiers.
44
Il est écrit au-dessus de [busboy](https://github.com/mscdex/busboy) pour une efficacité maximale.
55

66
**NOTE**: Multer ne traitera aucun formulaire qui ne soit pas un multipart (`multipart/form-data`).
@@ -55,8 +55,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
5555
// req.body contiendra les champs de texte, s'il y en avait
5656
})
5757

58-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
59-
app.post('/cool-profile', cpUpload, function (req, res, next) {
58+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
59+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
6060
// req.files est un objet (String -> Array) où fieldname est la clé et la valeur est un tableau de fichiers
6161
//
6262
// e.g.
@@ -87,7 +87,7 @@ Voici un exemple d'utilisation de multer dans un formulaire HTML. Faites particu
8787
<div class="form-group">
8888
<input type="file" class="form-control-file" name="uploaded_file">
8989
<input type="text" class="form-control" placeholder="Number of speakers" name="nspeakers">
90-
<input type="submit" value="Get me the stats!" class="btn btn-default">
90+
<input type="submit" value="Get me the stats!" class="btn btn-default">
9191
</div>
9292
</form>
9393
```
@@ -232,7 +232,7 @@ doit renvoyer un nom de fichier complet avec une extension de fichier.
232232
Chaque fonction reçoit à la fois la requête (`req`) et des informations sur
233233
le dossier (`file`) pour aider à la décision.
234234

235-
Notez que `req.body` n'a peut-être pas encore été entièrement rempli. Cela dépend de l'ordre
235+
Notez que `req.body` n'a peut-être pas encore été entièrement rempli. Cela dépend de l'ordre
236236
où le client transmet les champs et les fichiers au serveur.
237237

238238
Pour comprendre la convention d'appel utilisée dans le rappel (nécessité de passer

doc/README-ko.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,8 +44,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
4444
// 텍스트 필드가 있는 경우, req.body가 이를 포함할 것입니다.
4545
})
4646

47-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
48-
app.post('/cool-profile', cpUpload, function (req, res, next) {
47+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
48+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
4949
// req.files는 (String -> Array) 형태의 객체 입니다.
5050
// 필드명은 객체의 key에, 파일 정보는 배열로 value에 저장됩니다.
5151
//

doc/README-pt-br.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Multer é um middleware node.js para manipulação `multipart/form-data`, que é
44

55
**NOTA**: Multer não processará nenhum formulário que não seja multipart (`multipart/form-data`).
66

7-
## Traduções
7+
## Traduções
88

99
Este README também está disponível em outros idiomas:
1010

@@ -56,8 +56,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
5656
// req.body conterá os campos de texto, se houver
5757
})
5858

59-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
60-
app.post('/cool-profile', cpUpload, function (req, res, next) {
59+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
60+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
6161
// req.files é um objeto (String -> Array) onde fieldname é a chave e o valor é array de arquivos
6262
//
6363
// e.g.
@@ -251,7 +251,7 @@ A especificação dos limites pode ajudar a proteger seu site contra ataques de
251251

252252
### `fileFilter`
253253

254-
Defina isso para uma função para controlar quais arquivos devem ser enviados e quais devem ser ignorados.
254+
Defina isso para uma função para controlar quais arquivos devem ser enviados e quais devem ser ignorados.
255255

256256
A função deve ficar assim:
257257

doc/README-ru.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Multer — это middleware для фреймворка express для обра
44

55
**ВАЖНО**: Multer не обрабатывает никакой другой тип форм, кроме `multipart/form-data`.
66

7-
## Переводы
7+
## Переводы
88

99
Это README также доступно на других языках:
1010

@@ -52,8 +52,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
5252
// req.body сохранит текстовые поля, если они будут
5353
})
5454

55-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
56-
app.post('/cool-profile', cpUpload, function (req, res, next) {
55+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
56+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
5757
// req.files - объект (String -> Array), где fieldname - ключ, и значение - массив файлов
5858
//
5959
// например:
@@ -153,7 +153,7 @@ const upload = multer({ dest: 'uploads/' })
153153

154154
#### `DiskStorage`
155155

156-
Движок дискового пространства. Дает полный контроль над размещением файлов на диск.
156+
Движок дискового пространства. Дает полный контроль над размещением файлов на диск.
157157

158158
```javascript
159159
const storage = multer.diskStorage({
@@ -168,13 +168,13 @@ const storage = multer.diskStorage({
168168
const upload = multer({ storage: storage })
169169
```
170170

171-
Доступно две опции, расположение `destination` и имя файла `filename`. Обе эти функции определяют, где будет находиться файл после загрузки.
171+
Доступно две опции, расположение `destination` и имя файла `filename`. Обе эти функции определяют, где будет находиться файл после загрузки.
172172

173173
`destination` используется, чтобы задать каталог, в котором будут размещены файлы. Может быть задан строкой (например, `'/tmp/uploads'`). Если не задано расположение `destination`, операционная система воспользуется для сохранения каталогом для временных файлов.
174174

175-
**Важно:** Вы должны создать каталог, когда используете `destination`. При передачи в качестве аргумента строки, Multer проверяет, что каталог создан.
175+
**Важно:** Вы должны создать каталог, когда используете `destination`. При передачи в качестве аргумента строки, Multer проверяет, что каталог создан.
176176

177-
`filename` используется, чтобы определить, как будет назван файл внутри каталога. Если
177+
`filename` используется, чтобы определить, как будет назван файл внутри каталога. Если
178178
имя файла `filename` не задано, каждому файлу будет сконфигурировано случайное имя без расширения файла.
179179

180180
**Важно:** Multer не добавляет никакого файлового расширения, ваша функция должна возвращать имя файла с необходимым расширением.
@@ -191,13 +191,13 @@ const upload = multer({ storage: storage })
191191
const storage = multer.memoryStorage()
192192
const upload = multer({ storage: storage })
193193
```
194-
Когда вы используете этот тип передачи, информация о файле будет содержать поле `buffer`, которое содержит весь файл.
194+
Когда вы используете этот тип передачи, информация о файле будет содержать поле `buffer`, которое содержит весь файл.
195195

196196
**ПРЕДУПРЕЖДЕНИЕ**: Загрузка очень больших файлов, или относительно небольших файлов в большом количестве может вызвать переполнение памяти.
197197

198198
### `limits`
199199

200-
Объект, устанавливающий ограничения. Multer прокидывает этот объект напрямую в busboy, поэтому детали можно посмотреть
200+
Объект, устанавливающий ограничения. Multer прокидывает этот объект напрямую в busboy, поэтому детали можно посмотреть
201201
[на странице с методами busboy](https://github.com/mscdex/busboy#busboy-methods).
202202

203203
Доступны следующие целочисленные значения:
@@ -216,7 +216,7 @@ const upload = multer({ storage: storage })
216216

217217
### `fileFilter`
218218

219-
Задают функцию для того, чтобы решать, какие файлы будут загружены, а какие — нет. Функция может выглядеть так:
219+
Задают функцию для того, чтобы решать, какие файлы будут загружены, а какие — нет. Функция может выглядеть так:
220220

221221
```javascript
222222
function fileFilter (req, file, cb) {

doc/README-uz.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Multer - bu nodejs middleware bo'lib, asosan `multipart/form-data` shaklda yubor
44

55
**Muhim**: Multer `multipart` bo'lmagan har qanday formani qayta ishlamaydi.
66

7-
## Tarjimalar
7+
## Tarjimalar
88

99
Bu README boshqa tillarda ham mavjud:
1010

@@ -55,8 +55,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
5555
// req.body agar matnli maydonlar (fields) bo'lsa, ularni saqlanadi
5656
})
5757

58-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
59-
app.post('/cool-profile', cpUpload, function (req, res, next) {
58+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
59+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
6060
// req.files - bu ob'ekt (String -> Array), matn maydoni(fieldname) - bu key, va qiymat - fayllar massivi
6161
//
6262
// misol:
@@ -100,7 +100,7 @@ Kalit(key) | Ta'rif | Eslatma
100100

101101
### `multer(opts)`
102102

103-
Multer qo'shimcha ob'ekt qabul qiladi, ulardan eng asosiysi - `dest`,
103+
Multer qo'shimcha ob'ekt qabul qiladi, ulardan eng asosiysi - `dest`,
104104
Multerga fayllarni qayerga yuklash kerakligini aytadigan xususiyat. Agarda siz qo'shimcha(`options`) ob'ektni tashlab ketsangiz, fayllar xotirada saqlanadi va hech qachon diskka yozilmaydi.
105105

106106
Standart holatda - Multer nomlashda kelib chiqishi mumkin bo'lgan muammolarni oldini olish uchun fayllar nomini o'zgartiradi. O'z talablaringizga mos ravishda nomlash funksiyasini sozlay olashingiz mumkin.
@@ -156,7 +156,7 @@ Ushbu so'rov barcha fayllarni qabul qiladi, fayllar `req.files` ichida saqlanadi
156156

157157
#### `DiskStorage`
158158

159-
Diskka saqlash motori(engine) sizga fayllarni saqlashda to'liq nazorat qilish imkonini beradi.
159+
Diskka saqlash motori(engine) sizga fayllarni saqlashda to'liq nazorat qilish imkonini beradi.
160160

161161
```javascript
162162
const storage = multer.diskStorage({
@@ -202,7 +202,7 @@ Xotirada saqlash paytida, fayl ma'lumotlari `buffer` deb nomlanadigan maydonni o
202202

203203
### `limits`
204204

205-
Quyidagi xususiyatlar o'lchov(limit)larni aniqlaydigan obyekt. Multer ushbu obyektni to'g'ridan-to'g'ri busboy ga o'tkazadi va xususiyatlar tafsilotlari [busboy sahifasida](https://github.com/mscdex/busboy#busboy-methods)dan topishingiz mumkin.
205+
Quyidagi xususiyatlar o'lchov(limit)larni aniqlaydigan obyekt. Multer ushbu obyektni to'g'ridan-to'g'ri busboy ga o'tkazadi va xususiyatlar tafsilotlari [busboy sahifasida](https://github.com/mscdex/busboy#busboy-methods)dan topishingiz mumkin.
206206

207207
Quyidagi butun qiymatlar mavjud:
208208

@@ -225,7 +225,7 @@ Bu, qaysi fayllarni yuklashi, qaysilarini o'tkazib yuborish kerakligini boshqari
225225
```javascript
226226
function fileFilter (req, file, cb) {
227227

228-
// Bu funksiya, faylni qabul qilish kerakligini anglatish uchun `cb` ni
228+
// Bu funksiya, faylni qabul qilish kerakligini anglatish uchun `cb` ni
229229
// boolean qiymat bilan chaqirish kerak.
230230

231231
// Faylni qabul qilishni rad etish uchun false quyudagicha berilishi kerak:

doc/README-vi.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,11 +54,11 @@ app.post('/photos/upload', upload.array('photos', 12), function(
5454
// req.body sẽ giữ thông tin gắn kèm (vd: text fields), nếu có
5555
});
5656

57-
var cpUpload = upload.fields([
57+
var uploadMiddleware = upload.fields([
5858
{ name: 'avatar', maxCount: 1 },
5959
{ name: 'gallery', maxCount: 8 },
6060
]);
61-
app.post('/cool-profile', cpUpload, function(req, res, next) {
61+
app.post('/cool-profile', uploadMiddleware, function(req, res, next) {
6262
// req.files là một object kiểu (String -> Array) mà fieldname là key, và value là mảng các files
6363
//
6464
// vd:

doc/README-zh-cn.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,8 @@ app.post('/photos/upload', upload.array('photos', 12), function (req, res, next)
4747
// req.body 将具有文本域数据,如果存在的话
4848
})
4949

50-
const cpUpload = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
51-
app.post('/cool-profile', cpUpload, function (req, res, next) {
50+
const uploadMiddleware = upload.fields([{ name: 'avatar', maxCount: 1 }, { name: 'gallery', maxCount: 8 }])
51+
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
5252
// req.files 是一个对象 (String -> Array) 键是文件名,值是文件数组
5353
//
5454
// 例如:

0 commit comments

Comments
 (0)