translated command-line-interface :3

docs/.vitepress/config.ts

@@ -7,6 +7,7 @@ import replaceBrowserModules from '../../build-plugins/replace-browser-modules';
 import '../declarations.d';
 import { examplesPlugin } from './create-examples';
 import { renderMermaidGraphsPlugin } from './mermaid';
+import { replacePathPicomatch } from './replace-path-picomatch';
 import { transposeTables } from './transpose-tables';
 import { buildEnd, callback, transformPageData } from './verify-anchors';
 
@@ -84,7 +85,7 @@ export default defineConfig({
 		},
 		logo: '/rollup-logo.svg',
 		nav: [
-			{ link: '/introduction/', text: 'yolgöstərici' },
+			{ link: '/introduction/', text: 'bələdçi' },
 			{ link: '/repl/', text: 'repl' },
 			{ link: 'https://is.gd/rollup_chat', text: 'söhbət' },
 			{ link: 'https://opencollective.com/rollup', text: 'opencollective' }
@@ -184,7 +185,10 @@ export default defineConfig({
 	title: 'Rollup',
 	transformPageData,
 	vite: {
+		optimizeDeps: { exclude: ['@rollup/pluginutils'] },
 		plugins: [
+			replacePathPicomatch(),
+			replaceBrowserModules(),
 			renderMermaidGraphsPlugin(),
 			replaceBrowserModules(),
 			{

docs/index.md

@@ -36,7 +36,7 @@ features:
     linkText: Plagin yazmağı öyrənin
   - icon: 🛠️
     title: Xüsusi ehtiyaclarınıza uyğunlaşır
-    details: Rollup bir qəliblə məhdudlaşmayıb. Çoxsaylı konfiqurasiya seçimləri və zəngin plagin interfeysi Rollup-ı xüsusi iş axınları və yüksək səviyyəli tulinq üçün ideal bandler edir.
+    details: Rollup bir qəliblə məhdudlaşmayıb. Çoxsaylı konfiqurasiya seçimləri və zəngin plagin interfeysi Rollup-ı xüsusi iş axınları və təkmilləşmiş tulinq ("tooling") üçün ideal bandler edir.
     link: /configuration-options/
     linkText: Konfiqurasiya seçimlərinə baxın
   - icon:

docs/introduction/index.md

@@ -75,14 +75,14 @@ const query = 'Rollup';
 ajax(`https://api.example.com?search=${query}`).then(handleResponse);
 ```
 
-Rollup mümkün qədər minimal kod daxil etdiyi üçün daha yüngül, daha sürətli və daha az mürəkkəb kitabxanalar və tətbiqlər yaradır. Beləliklə, birbaşa `import` və `export` bəyanatlarından istifadə edildiyi üçün kompilyasiya edilmiş kodda istifadə edilməyən dəyişkənləri avtomatik kiçildici ilə aşkar etməkdən daha əlverişli bir üsul alınır.
+Rollup mümkün qədər minimal kod daxil etdiyi üçün daha yüngül, daha sürətli və daha az mürəkkəb kitabxanalar və tətbiqlər yaradır. Beləliklə, birbaşa `import` və `export` bəyanatlarından istifadə edildiyi üçün kompilyasiya edilmiş kodda istifadə edilməyən dəyişənləri avtomatik kiçildici ilə aşkar etməkdən daha əlverişli bir üsul alınır.
 
-## Uyğunluq {#compatibility}
+## Uyumluluq {#compatibility}
 
 ### CommonJS idxalatı {#importing-commonjs}
 
 Rollup [plagin vasitəsilə](https://github.com/rollup/plugins/tree/master/packages/commonjs) mövcud CommonJS modullarını idxal edə bilər.
 
-### ES modullarının yayımlanması {#publishing-es-modules}
+### ES modulları yayımlamaq {#publishing-es-modules}
 
 ES modullarınızın Node.js, yaxud webpack kimi CommonJS ilə işləyən alətlər tərəfindən istifadə edilə bilməsini təmin etmək üçün Rollup ilə UMD, yaxud CommonJS formatlarına kompilyasiya edib `package.json` faylındakı `main` parametrinə həmin kompilyasiya edilmiş faylı təyin edə bilərsiniz. Əgər `package.json` faylınızda `module` da təyin edilibsə, [webpack 2+](https://webpack.js.org/) və Rollup kimi ES modulunu tanıyan alətlər [birbaşa ES modulunu idxal edəcək](https://github.com/rollup/rollup/wiki/pkg.module).

docs/javascript-api/index.md

@@ -53,7 +53,10 @@ async function build() {
 	let bundle;
 	let buildFailed = false;
 	try {
-		// bandl yaradın
+		// Bandl yaradın. Əgər siz TypeScript, yaxud onu dəstəkləyən bir iş mühitdən istifadə edirsinizsə,
+    // əvəzində bunu yaza bilərsiniz, beləliklə bandlı aşağıda ayrıca bağlamağa ehtiyac qalmayacaq:
+		//
+		// await using bundle = await rollup(inputOptions);
 		bundle = await rollup(inputOptions);
 
 		// bandlın asılı olduğu fayl adlarından ibarət siyahı
@@ -96,7 +99,7 @@ async function generateOutputs(bundle) {
 				// {
 				//   code: string,                  // yaradılan JS kodu
 				//   dynamicImports: string[],      // blok tərəfindən dinamik idxal edilən xarici modullar
-				//   exports: string[],             // ixrac edilən dəyişkən adları
+				//   exports: string[],             // ixrac edilən dəyişən adları
 				//   facadeModuleId: string | null, // blokun uyğun gəldiyi müvafiq modulun identifikator nömrəsi
 				//   fileName: string,              // blokun fayl adı
 				//   implicitlyLoadedBefore: string[]; // yalnız bu blokdan sonra yüklənə biləcək daxiletmələr
@@ -108,8 +111,8 @@ async function generateOutputs(bundle) {
 				//   map: string | null,            // varsa, mənbə xəritəsi
 				//   modules: {                     // blokdakı modullar haqqında məlumat
 				//     [id: string]: {
-				//       renderedExports: string[]; // ixrac edilən dəyişkənlərdən saxlanılanların adları
-				//       removedExports: string[];  // ixrac edilən dəyişkənlərdən silinənlərin adları
+				//       renderedExports: string[]; // ixrac edilən dəyişənlərdən saxlanılanların adları
+				//       removedExports: string[];  // ixrac edilən dəyişənlərdən silinənlərin adları
 				//       renderedLength: number;    // moduldakı qalan kodun uzunluğu
 				//       originalLength: number;    // moduldakı əsl kodun uzunluğu
 				//       code: string | null;       // modulda qalan kod
@@ -142,7 +145,7 @@ const inputOptions = {
 	input, // şərti məcbur
 	plugins,
 
-	// yüksək səviyyəli giriş seçimləri
+	// təkmilləşmiş giriş seçimləri
 	cache,
 	logLevel,
 	makeAbsoluteExternalsRelative,
@@ -183,7 +186,7 @@ const outputOptions = {
 	name,
 	plugins,
 
-	// yüksək səviyyəli çıxış seçimləri
+	// təkmilləşmiş çıxış seçimləri
 	assetFileNames,
 	banner,
 	chunkFileNames,
@@ -208,6 +211,7 @@ const outputOptions = {
 	preserveModulesRoot,
 	sourcemap,
 	sourcemapBaseUrl,
+	sourcemapDebugIds,
 	sourcemapExcludeSources,
 	sourcemapFile,
 	sourcemapFileNames,
@@ -362,7 +366,7 @@ loadConfigFile(path.resolve(__dirname, 'rollup.config.js'), {
 });
 ```
 
-## Yüksək səviyyəli qeydiyyat filtrlərinin tətbiqi {#applying-advanced-log-filters}
+## Təkmilləşmiş qeydiyyat filtrlərinin tətbiqi {#applying-advanced-log-filters}
 
 Komanda sətri interfeysi [`--filterLogs`](../command-line-interface/index.md#filterlogs-filter) sayəsində qeydləri filtrləməyə şərait yaratsa da, bu xüsusiyyət JavaScript proqramlaşdırma interfeysində əlçatan deyil. Buna baxmayaraq, JavaScript proqramlaşdırma interfeysində komanda sətrindəki ilə eyni sintaksisdən istifadə edərək filtrləşdirmə əməliyyatı aparmağınız üçün Rollup `getLogFilter` köməkçisini sizə ixrac edir. Bu, öz fərdi `onLog` emalçınız olan zaman, yaxud üçüncü tərəf sistemlərdə Rollup-ın komanda sətri interfeysi ilə bənzər filtrləmə mexanizmi yaratmaq istəyəndə sizə kifayət qədər kömək edəcək. Funksiya mətn tipli verilənlərdən ibarət siyahı qəbul edir. Qeyd etmək lazımdır ki, bu köməkçi KSİ-dən fərqli olaraq, vergüllə ayrılan filtr siyahılarını bölüşdürmür.
 

docs/migration/index.md

@@ -22,7 +22,7 @@ Nisbətən böyük ölçülü konfiqurasiyalar üçün yaxşı olar ki, birinci
 
 Brauzer inşası isə (`@rollup/browser`) artıq ayrıca qeyd edilməli olan WASM artefaktına əsaslanır. Əgər siz Vite ilə birgə brauzer inşasından istifadə edirsinizsə, `optimizeDeps.exclude` siyahısına `"@rollup/browser"` asılılığını əlavə etməyiniz lazım gələcək, əks halda `npm run dev` komandası `.wasm` faylına gedən etibarsız yoldan ötürü uğursuz olacaq (həmçinin baxın: [vitejs #14609](https://github.com/vitejs/vite/issues/14609)). Bundan başqa, xüsusi bir müdaxiləyə ehtiyac duyulmadan hər şey öz qaydasında işləməlidir.
 
-Bunlara əlavə olaraq, Rollup ilə bağlı nəzərə çarpan digər bir dəyişiklik isə əvvəlki 16-lıq say sistemli çözənəklərin ("hash") yeni 64-lük say sistemindəki çözənəklərlə əvəz olunmasıdır. Beləliklə çözənəklər artıq daha təhlükəsizdir, ancaq texniki səbəblərdən ötürü maksimal çözənək uzunluğu 22 simvoldur.
+Bunlara əlavə olaraq, Rollup ilə bağlı nəzərə çarpan digər bir dəyişiklik isə əvvəlki 16-lıq say sistemli çözənəklərin ("hash") yeni 64-lük say sistemindəki çözənəklərlə əvəz olunmasıdır. Beləliklə çözənəklər artıq daha təhlükəsizdir, ancaq texniki səbəblərdən ötürü maksimal çözənək uzunluğu 21 simvoldur.
 
 KSİ tətbiqləri hazırlayarkən əgər çıxış [`format`](../configuration-options/index.md#output-format)-ı `es`, yaxud `cjs` olarsa, Rollup avtomatik olaraq `#!` şərhlərini qoruyacaq. Əvvəllər isə bu, şərhi plagin vasitəsilə əlavə etməklə mümkün olurdu.
 

docs/tutorial/index.md

@@ -88,7 +88,7 @@ node
 
 Təbrik edirik! Siz Rollup ilə ilk bandlınızı yaratdınız.
 
-## Konfiqurasiya fayllarından istifadə etmək {#using-config-files}
+## Konfiqurasiya fayllarından istifadə {#using-config-files}
 
 Hələ ki, yaxşı gedirik, ancaq bir neçə parametr daha əlavə eləsək, komandaları yazmaq bir qədər vaxt aparacaq.
 
@@ -178,7 +178,7 @@ Tövsiyə edilir ki, kitabxananı yükləyəndən sonra `package.json` faylına
 
 _Qeyd: Lokal şəkildə yüklənəndə həm NPM, həm də Yarn kitabxananın binar faylını emal edəcək və hansısa paket skriptindən çağrılanda Rollup-ı işə salacaq._
 
-## Plaginlərdən istifadə etmək {#using-plugins}
+## Plaginlərdən istifadə {#using-plugins}
 
 Hələ ki, biz bir giriş nöqtəsi və nisbi fayl mövqeyi vasitəsilə idxal edilən bir moduldan ibarət sadə bir bandl yaratmışıq. Sizə isə daha mürəkkəb bandllar yaratdıqca daha çox elastiklik lazım olacaq, məsələn: NPM ilə yüklənmiş modulları idxal etmək, Babel ilə kodu kompilyasiya etmək, JSON faylları ilə işləmək və s.
 
@@ -262,7 +262,7 @@ Gəlin bayaqkı nümunəni genişləndirək və bir kiçildilmiş, bir də kiçi
 npm install --save-dev @rollup/plugin-terser
 ```
 
-`rollup.config.mjs` faylını ikinci bir kiçildilmiş çıxış yaradılması üçün redaktə edin. Format kimi `iife` təyin edəcəyik, beləcə kod yığcamlaşdırılır və brauzerdə `script` teqi vasitəsilə digər kodla toqquşmadan istifadə edilə bilir. Bizim kodumuzda bir ədəd ixracat mövcuddur və savayı kodların bu ixracatdan istifadə edə bilməsi üçün bandl zamanı ona təyin edilmiş qlobal dəyişkən yaradılacaq, buna görə də biz həmin dəyişkən üçün ad təyin etməliyik.
+`rollup.config.mjs` faylını ikinci bir kiçildilmiş çıxış yaradılması üçün redaktə edin. Format kimi `iife` təyin edəcəyik, beləcə kod yığcamlaşdırılır və brauzerdə `script` teqi vasitəsilə digər kodla toqquşmadan istifadə edilə bilir. Bizim kodumuzda bir ədəd ixracat mövcuddur və savayı kodların bu ixracatdan istifadə edə bilməsi üçün bandl zamanı ona təyin edilmiş qlobal dəyişən yaradılacaq, buna görə də biz həmin dəyişən üçün ad təyin etməliyik.
 
 ```js twoslash
 // rollup.config.mjs