Merge branch 'main' of https://github.com/RlxChap2/webpack.js.org

Author: RlxChap2

src/content/blog/2020-10-10-webpack-5-release.mdx

@@ -1,10 +1,11 @@
 ---
-title: Blog
+title: المدونة
 sort: -1
 contributors:
-  - sokra
+  - ameencfw
+  - RlxChap2
 ---
 
-Read here for announcements.
+اقرأ الإعلانات هنا.
 
-See recent blog posts in the side bar.
+شاهد أحدث مقالات المدونة في الشريط الجانبي.

src/content/blog/2020-12-08-roadmap-2021.mdx

@@ -1,35 +1,23 @@
 ---
-title: Configuration Languages
+title: لغات التخصيص
 sort: 2
 contributors:
-  - piouson
-  - sokra
-  - skipjack
-  - tarang9211
-  - simon04
-  - peterblazejewicz
-  - youta1119
-  - byzyk
-  - Nek-
-  - liyiming22
-  - daimalou
-  - ChocolateLoverRaj
-  - snitin315
+  - RlxChap2
 ---
 
-Webpack accepts configuration files written in multiple programming and data languages. The list of supported file extensions can be found in the [node-interpret](https://github.com/gulpjs/interpret) package. Using [node-interpret](https://github.com/gulpjs/interpret), webpack can handle many different types of configuration files.
+يقبل webpack ملفات تخصيص مكتوبة بعدّة لغات برمجة ولغات بيانات. تجد قائمة بامتدادات الملفات المدعومة في حزمة [node-interpret](https://github.com/gulpjs/interpret). فعبر [node-interpret](https://github.com/gulpjs/interpret)، يستطيع webpack التعامل مع أنواع كثيرة ومختلفة من ملفات التخصيص.
 
 ## TypeScript
 
-To write the webpack configuration in [TypeScript](http://www.typescriptlang.org/), you would first install the necessary dependencies, i.e., TypeScript and the relevant type definitions from the [DefinitelyTyped](https://definitelytyped.org/) project:
+لكتابة تخصيص webpack بلغة [TypeScript](http://www.typescriptlang.org/)، ثبّت أوّلاً الاعتماديات اللازمة، وهي TypeScript وتعريفات الأنواع ذات الصلة من مشروع [DefinitelyTyped](https://definitelytyped.org/):
 
 ```bash
 npm install --save-dev typescript ts-node @types/node
-# and, if using webpack-dev-server < v4.7.0
+# وإن كنت تستخدم webpack-dev-server بإصدار أقل من v4.7.0
 npm install --save-dev @types/webpack-dev-server
 ```
 
-and then proceed to write your configuration:
+ثم ابدأ بكتابة التخصيص:
 
 **webpack.config.ts**
 
@@ -38,7 +26,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 
 import webpack from "webpack";
-// in case you run into any typescript error when configuring `devServer`
+// في حال واجهتك أخطاء TypeScript عند تخصيص `devServer`
 import "webpack-dev-server";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -69,31 +57,31 @@ export default config;
     "resolveJsonModule": true,
     "isolatedModules": true,
 
-    // Allows you to write `import ... from './file.ts';`
+    // يتيح لك كتابة `import ... from './file.ts';`
     "rewriteRelativeImportExtensions": true
   }
 }
 ```
 
-The above sample assumes version >= 2.7 or newer of TypeScript is used with the new `esModuleInterop` and `allowSyntheticDefaultImports` compiler options in your `tsconfig.json` file.
+يفترض المثال السابق أنّك تستخدم إصدار TypeScript رقم 2.7 أو أحدث، مع تفعيل خياري `esModuleInterop` و `allowSyntheticDefaultImports` في ملف `tsconfig.json`.
 
-We support configuration in both `CommonJS` and `ESM` format.
+ندعم التخصيص بصيغة `CommonJS` و `ESM` معاً.
 
-Starting with v22.18.0 Node.js supports built-in [type stripping](https://nodejs.org/api/typescript.html#type-stripping), so the additional settings described below are only required for older versions.
+بدءاً من الإصدار v22.18.0، أصبح Node.js يدعم [إزالة الأنواع (type stripping)](https://nodejs.org/api/typescript.html#type-stripping) بشكل أصلي، ولذلك فإنّ الإعدادات الإضافية الموضّحة أدناه ليست مطلوبة إلا للإصدارات الأقدم.
 
-> To enable the transformation of non erasable TypeScript syntax, which requires JavaScript code generation, such as enum declarations, parameter properties use the flag [--experimental-transform-types](https://nodejs.org/api/cli.html#experimental-transform-types).
+> لتفعيل تحويل صياغات TypeScript غير القابلة للحذف، التي تحتاج إلى توليد شيفرة JavaScript مثل تصريحات `enum` وخصائص المُعاملات (parameter properties)، استخدم الراية [--experimental-transform-types](https://nodejs.org/api/cli.html#experimental-transform-types).
 
-If you are using an older version of Node.js that does not support the `typescript` format, or want to set `module` in `compilerOptions` in `tsconfig.json` to `commonjs` there are three solutions to this issue:
+إذا كنت تستخدم إصداراً أقدم من Node.js لا يدعم صيغة `typescript`، أو أردت ضبط `module` في `compilerOptions` ضمن `tsconfig.json` على `commonjs`، فأمامك ثلاثة حلول لهذه المشكلة:
 
-- Modify `tsconfig.json`.
-- Modify `tsconfig.json` and add settings for `ts-node`.
-- Install `tsconfig-paths`.
+- تعديل `tsconfig.json`.
+- تعديل `tsconfig.json` وإضافة إعدادات خاصة بـ `ts-node`.
+- تثبيت `tsconfig-paths`.
 
-The **first option** is to open your `tsconfig.json` file and look for `compilerOptions`. Set `target` to `"ES5"` and `module` to `"CommonJS"` (or completely remove the `module` option).
+**الحلّ الأول**: افتح ملف `tsconfig.json` وابحث عن `compilerOptions`، ثم اضبط `target` على `"ES5"` و `module` على `"CommonJS"` (أو احذف خيار `module` تماماً).
 
-The **second option** is to add settings for ts-node:
+**الحلّ الثاني**: أضِف إعدادات خاصة بـ ts-node.
 
-You can keep `"module": "ESNext"` for `tsc`, and if you use webpack, or another build tool, set an override for ts-node. [ts-node config](https://typestrong.org/ts-node/docs/imports/)
+يمكنك إبقاء `"module": "ESNext"` لـ `tsc`، وإن كنت تستعمل webpack أو أداة بناء أخرى، فاضبط قيمة بديلة لـ ts-node. [توثيق إعداد ts-node](https://typestrong.org/ts-node/docs/imports/)
 
 ```json
 {
@@ -108,13 +96,13 @@ You can keep `"module": "ESNext"` for `tsc`, and if you use webpack, or another
 }
 ```
 
-The **third option** is to install the `tsconfig-paths` package:
+**الحلّ الثالث**: ثبّت حزمة `tsconfig-paths`:
 
 ```bash
 npm install --save-dev tsconfig-paths
 ```
 
-And create a separate TypeScript configuration specifically for your webpack configs:
+ثم أنشئ تخصيصاً مستقلاً لـ TypeScript مخصّصاً لملفات تخصيص webpack:
 
 **tsconfig-for-webpack-config.json**
 
@@ -128,9 +116,9 @@ And create a separate TypeScript configuration specifically for your webpack con
 }
 ```
 
-T> `ts-node` can resolve a `tsconfig.json` file using the environment variable provided by `tsconfig-paths`.
+T> يستطيع `ts-node` تحديد ملف `tsconfig.json` المطلوب عبر متغيّر البيئة الذي توفّره `tsconfig-paths`.
 
-Then set the environment variable `process.env.TS_NODE_PROJECT` provided by `tsconfig-paths` like so:
+ثم اضبط متغيّر البيئة `process.env.TS_NODE_PROJECT` الذي توفّره `tsconfig-paths` على النحو التالي:
 
 **package.json**
 
@@ -142,17 +130,17 @@ Then set the environment variable `process.env.TS_NODE_PROJECT` provided by `tsc
 }
 ```
 
-W> We had been getting reports that `TS_NODE_PROJECT` might not work with `"TS_NODE_PROJECT" unrecognized command` error. Therefore running it with `cross-env` seems to fix the issue, for more info [see this issue](https://github.com/webpack/webpack.js.org/issues/2733).
+W> وردتنا بلاغات بأن `TS_NODE_PROJECT` قد لا يعمل أحياناً ويُظهر الخطأ `"TS_NODE_PROJECT" unrecognized command`. وقد ظهر أنّ تشغيله عبر `cross-env` يحلّ المشكلة. لمزيد من التفاصيل [راجع هذه القضية](https://github.com/webpack/webpack.js.org/issues/2733).
 
-## CoffeeScript
+## كوفي سكريبت
 
-Similarly, to use [CoffeeScript](https://coffeescript.org/), you would first install the necessary dependencies:
+بالطريقة نفسها، لاستخدام [CoffeeScript](https://coffeescript.org/)، ثبّت أوّلاً الاعتماديات اللازمة:
 
 ```bash
 npm install --save-dev coffeescript
 ```
 
-and then proceed to write your configuration:
+ثم اكتب التخصيص:
 
 **webpack.config.coffee**
 
@@ -185,13 +173,13 @@ config =
 export default config
 ```
 
-## Babel and JSX
+## Babel و JSX
 
-In the example below JSX (React JavaScript Markup) and Babel are used, to create a JSON configuration that webpack can understand.
+في المثال أدناه، يُستخدم JSX (صياغة JavaScript الخاصة بـ React) مع Babel لإنشاء تخصيص بصيغة JSON يستطيع webpack فهمه.
 
-> Courtesy of [Jason Miller](https://twitter.com/_developit)
+> بفضل من [Jason Miller](https://twitter.com/_developit)
 
-First, install the necessary dependencies:
+ثبّت أوّلاً الاعتماديات اللازمة:
 
 ```bash
 npm install --save-dev babel-register jsxobj babel-preset-es2015
@@ -212,7 +200,7 @@ npm install --save-dev babel-register jsxobj babel-preset-es2015
 ```jsx
 import jsxobj from "jsxobj";
 
-// example of an imported plugin
+// مثال على plugin مستورد
 const CustomPlugin = (config) => ({
   ...config,
   name: "custom-plugin",
@@ -236,4 +224,4 @@ export default (
 );
 ```
 
-W> If you are using Babel elsewhere and have `modules` set to `false`, you will have to either maintain two separate `.babelrc` files or use `const jsxobj = require('jsxobj');` and `module.exports` instead of the new `import` and `export` syntax. This is because while Node does support many new ES6 features, they don't yet support ES6 module syntax.
+W> إن كنت تستخدم Babel في أماكن أخرى وضبطت `modules` على `false`، فستضطر إمّا للاحتفاظ بملفَّي `.babelrc` منفصلين، أو استخدام `const jsxobj = require('jsxobj');` و `module.exports` بدلاً من صياغة `import` و `export` الجديدة. ذلك أنّ Node يدعم كثيراً من ميزات ES6 الجديدة، لكنه لا يدعم بعدُ صياغة وحدات ES6.

src/content/blog/2026-02-03-webpack-5-105.mdx

@@ -1,28 +1,18 @@
 ---
-title: Configuration Types
+title: أنواع التخصيص
 sort: 3
 contributors:
-  - sokra
-  - skipjack
-  - kbariotis
-  - simon04
-  - fadysamirsadek
-  - byzyk
-  - EugeneHlushko
-  - dhurlburtusa
-  - anshumanv
-  - thorn0
-  - tusharthakur04
+  - RlxChap2
 ---
 
-Besides exporting a single configuration object, there are a few more ways that cover other needs as well.
+إلى جانب تصدير كائن تخصيص واحد، هناك طرق أخرى تغطّي احتياجات مختلفة.
 
-## Exporting a Function
+## تصدير دالّة
 
-Eventually you will find the need to disambiguate in your `webpack.config.js` between [development](/guides/development) and [production builds](/guides/production). There are multiple ways to do that. One option is to export a function from your webpack configuration instead of exporting an object. The function will be invoked with two arguments:
+ستجد عاجلاً أم آجلاً حاجة إلى التمييز داخل `webpack.config.js` بين [بناء التطوير](/guides/development) و[بناء الإنتاج](/guides/production). وثمّة طرق متعددة لذلك. من بينها أن تُصدّر دالّة من ملف تخصيص webpack بدلاً من تصدير كائن. سيتمّ استدعاء هذه الدالّة بمعاملين:
 
-- An environment as the first parameter. See the [environment options CLI documentation](/api/cli/#environment-options) for syntax examples.
-- An options map (`argv`) as the second parameter. This describes the options passed to webpack, with keys such as [`output-path`](/api/cli/#flags) and [`mode`](/api/cli/#flags).
+- بيئة (environment) بوصفها المعامل الأول. راجع [توثيق خيارات البيئة في الـ CLI](/api/cli/#environment-options) لأمثلة على الصياغة.
+- خريطة خيارات (`argv`) بوصفها المعامل الثاني. تصف هذه الخريطة الخيارات الممرَّرة إلى webpack، بمفاتيح مثل [`output-path`](/api/cli/#flags) و[`mode`](/api/cli/#flags).
 
 ```diff
 -export default {
@@ -33,19 +23,19 @@ Eventually you will find the need to disambiguate in your `webpack.config.js` be
      plugins: [
        new MinimizerPlugin({
          minimizerOptions: {
-+          compress: argv.mode === 'production' // only if `--mode production` was passed
++          compress: argv.mode === 'production' // فقط في حال تمرير `--mode production`
          }
        })
      ]
 +  };
 };
 ```
 
-## Exporting a Promise
+## تصدير Promise
 
-Webpack will run the function exported by the configuration file and wait for a Promise to be returned. Handy when you need to asynchronously load configuration variables.
+سيُشغّل webpack الدالّة المُصدَّرة من ملف التخصيص، وينتظر منها إرجاع Promise. وهذا مفيد حين تحتاج إلى تحميل متغيّرات التخصيص بشكل غير متزامن.
 
-T> It is possible to export multiple promises by wrapping them into `Promise.all([/* Your promises */]).`
+T> يمكنك تصدير عدّة Promises عبر تغليفها داخل `Promise.all([/* Promises الخاصة بك */])`.
 
 ```js
 export default () =>
@@ -59,11 +49,11 @@ export default () =>
   });
 ```
 
-W> Returning a `Promise` only works when using webpack via CLI. [`webpack()`](/api/node/#webpack) expects an object.
+W> إرجاع `Promise` يعمل فقط حين تستخدم webpack عبر الـ CLI. أمّا [`webpack()`](/api/node/#webpack) فيتوقّع كائناً.
 
-## Exporting multiple configurations
+## تصدير تخصيصات متعددة
 
-Instead of exporting a single configuration object/function, you may export multiple configurations (multiple functions are supported since webpack 3.1.0). When running webpack, all configurations are built. For instance, this is useful for [bundling a library](/guides/author-libraries) for multiple [targets](/configuration/output/#outputlibrarytarget) such as AMD and CommonJS:
+عوضاً عن تصدير كائن أو دالّة تخصيص واحدة، يمكنك تصدير عدّة تخصيصات (وقد دُعمت الدوال المتعددة منذ webpack 3.1.0). وعند تشغيل webpack، تُبنى كل التخصيصات معاً. وهذا مفيد مثلاً عند [حزم مكتبة](/guides/author-libraries) لعدّة [أهداف (targets)](/configuration/output/#outputlibrarytarget) كـ AMD و CommonJS:
 
 ```js
 export default [
@@ -88,11 +78,11 @@ export default [
 ];
 ```
 
-T> If you pass a name to [`--config-name`](/api/cli/#config-name) flag, webpack will only build that specific configuration.
+T> لو مرّرت اسماً إلى الراية [`--config-name`](/api/cli/#config-name)، فلن يبني webpack إلا التخصيص المطابق لذلك الاسم فقط.
 
 ### dependencies
 
-In case you have a configuration that depends on the output of another configuration, you can specify a list of dependencies using the [`dependencies`](/configuration/other-options/#dependencies) array.
+إن كان لديك تخصيص يعتمد على ناتج تخصيص آخر، فيمكنك تحديد قائمة بالاعتماديات عبر مصفوفة [`dependencies`](/configuration/other-options/#dependencies).
 
 **webpack.config.js**
 
@@ -111,26 +101,24 @@ export default [
 ];
 ```
 
-### parallelism
+### التوازي
 
-In case you export multiple configurations, you can use the `parallelism` option on the configuration array to specify the maximum number of compilers that will compile in parallel.
+عند تصدير تخصيصات متعددة، يمكنك استخدام الخيار `parallelism` على مصفوفة التخصيصات لتحديد الحدّ الأقصى لعدد الـ compilers التي ستعمل بالتوازي.
 
-- Type: `number`
-- Available: 5.22.0+
+- النوع: `number`
+- متاح: 5.22.0+
 
 **webpack.config.js**
 
 ```js
 const config = [
   {
-    // config-1
+    // التخصيص-1
   },
   {
-    // config-2
+    // التخصيص-2
   },
 ];
-
 config.parallelism = 1;
-
 export default config;
 ```