From 7ed18b7640eddf1fec501745a5f429a89f3f3d01 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Fri, 7 Jul 2023 22:45:07 -0500 Subject: [PATCH 1/5] feat: add link to maintained dependency list --- navigation.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/navigation.json b/navigation.json index abd30dceaf495..148fc3ce90030 100644 --- a/navigation.json +++ b/navigation.json @@ -77,7 +77,7 @@ "translationId": "components.navigation.docs.links.guides" }, "dependencies": { - "link": "/docs/meta/topics/dependencies", + "link": "https://github.com/nodejs/node/blob/main/doc/contributing/maintaining/maintaining-dependencies.md", "translationId": "components.navigation.docs.links.dependencies" } } From 1e977e32aa4b0532e3d40b29c2a5e8c656defce8 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Fri, 7 Jul 2023 22:45:41 -0500 Subject: [PATCH 2/5] chore: fix typo in TRANSLATION.md --- TRANSLATION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index a0a08e999ce06..657c489fc7ee0 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -48,7 +48,7 @@ If you're making a new Component and adding Translation Keys for your Component, - Only add the new translation keys on the `i18n/locales/en.json` file. Crowdin will handle on syncing the files and letting translators know there are new keys to be translated - The translation keys should have the prefix as the canonical path of your Component. If your Component is `components/Common/MyComponent` the prefix key should be `components.common.myComponent` - - The Translation Key suffix should be easy to undersand and semantic. For example, if the key is about "the text of a button that when interacted it copies content to the clipboard", the suffix should probably be `copyButton.title`. The final translation key would be `components.common.myComponent.copyButton.title` + - The Translation Key suffix should be easy to understand and semantic. For example, if the key is about "the text of a button that when interacted it copies content to the clipboard", the suffix should probably be `copyButton.title`. The final translation key would be `components.common.myComponent.copyButton.title` - Translation Keys should be in Camel Case only. - The values of each Translation Key should follow the [ICU Message Syntax](https://formatjs.io/docs/core-concepts/icu-syntax/) - All new Translation keys should be added at the bottom of the `i18n/locales/en.json` file. Since this makes it easier for Translators to notice that there are new Translation keys to be translated. From 17086fbf585248ee0f56190330f62a1c13508af2 Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Fri, 7 Jul 2023 22:46:14 -0500 Subject: [PATCH 3/5] chore: delete translated dependencies pages --- pages/ar/docs/meta/topics/dependencies.md | 78 ------- pages/en/docs/meta/topics/dependencies.md | 102 --------- pages/es/docs/meta/topics/dependencies.md | 79 ------- pages/fr/docs/meta/topics/dependencies.md | 78 ------- pages/id/docs/meta/topics/dependencies.md | 78 ------- pages/ja/docs/meta/topics/dependencies.md | 219 ------------------- pages/ko/docs/meta/topics/dependencies.md | 213 ------------------ pages/pt-br/docs/meta/topics/dependencies.md | 168 -------------- pages/ru/docs/meta/topics/dependencies.md | 98 --------- pages/uk/docs/meta/topics/dependencies.md | 94 -------- pages/zh-cn/docs/meta/topics/dependencies.md | 78 ------- 11 files changed, 1285 deletions(-) delete mode 100644 pages/ar/docs/meta/topics/dependencies.md delete mode 100644 pages/en/docs/meta/topics/dependencies.md delete mode 100644 pages/es/docs/meta/topics/dependencies.md delete mode 100644 pages/fr/docs/meta/topics/dependencies.md delete mode 100644 pages/id/docs/meta/topics/dependencies.md delete mode 100644 pages/ja/docs/meta/topics/dependencies.md delete mode 100644 pages/ko/docs/meta/topics/dependencies.md delete mode 100755 pages/pt-br/docs/meta/topics/dependencies.md delete mode 100644 pages/ru/docs/meta/topics/dependencies.md delete mode 100644 pages/uk/docs/meta/topics/dependencies.md delete mode 100644 pages/zh-cn/docs/meta/topics/dependencies.md diff --git a/pages/ar/docs/meta/topics/dependencies.md b/pages/ar/docs/meta/topics/dependencies.md deleted file mode 100644 index dcb213a0a0132..0000000000000 --- a/pages/ar/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: الإعتمادات -layout: docs.hbs ---- - -# الإعتمادات - -هناك العديد من الإعتمادات التي يعتمد عليها Node.js ليقوم بعمله على ما يرام. - -* [المكتبات](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [الأدوات](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## المكتبات - -### V8 - -تزود مكتبة V8 Node.js بمحرك جافاسكريبت ،الذي يتحكم به Node.js عبر واجهة برمجة التطبيقات V8 C++. يتم الإشراف على V8 بواسطة غوغل ، للاستخدام في متصفح كروم. - -* [التوثيق](https://v8.dev/docs/) - -### libuv - -إعتمادية مهمة الأخرى هي libuv ، وهي مكتبة C تُستخدم لتجريد عمليات الإدخال / الإخراج غير المحظورة إلى واجهة متناسقة عبر جميع الأنظمة الأساسية المدعومة. إنه يوفر آليات لمعالجة ملفات النظام ، DNS ، الشبكة ، العمليات الفرعية ، التصفية ، معالجة الإشارات ، الاقتراع والتدفق. يتضمن أيضًا تجمع مؤشرات ترابط لإلغاء تحميل العمل لبعض الأشياء التي لا يمكن القيام بها بشكل غير متزامن على مستوى نظام التشغيل. - -* [التوثيق](http://docs.libuv.org/) - -### llhttp - -تتم معالجة تحليلات بروتوكول الـ HTTP بواسطة مكتبة C خفيفة الوزن تسمى llhttp. تم تصميمه بحيث لا يقوم بإجراء أي نداءات نظام (syscalls) أو عمليات تخصيص ( allocations ) ، لذلك لا يأخذ الطلب سوى مساحة صغيرة جدا من الذاكرة. - -* [التوثيق](https://github.com/nodejs/llhttp) - -### c-ares - -بالنسبة لبعض طلبات الـ DNS الغير متزامنة ، يستخدم الـ Node.js مكتبة C تسمى c-ares. يتم كشفها من خلال وحدة DNS في جافا سكريبت كأنها عائلة من دوال الحلول ( `resolve()`) حيث تستخدم الدالة `lookup ()` ، وهي ما تستخدمه بقية النواة ، المكالمات المترابطة `getaddrinfo(3)` في libuv. والسبب في ذلك هو أن c-ares تدعم / etc / hosts ، و /etc/resolv.conf و /etc/svc.conf ، ولكن لا تفعل مع غيرها مثل mDNS. - -* [التوثيق](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -يستخدم OpenSSL على نطاق واسع في كل من الوحدات النمطية `tls` و `crypto`.توفر العديد من وظائف التشفير التي تم اختبارها واقعيا من أجل الأمان. - -* [التوثيق](https://www.openssl.org/docs/) - -### zlib - -من أجل الضغط السريع وإلغاء الضغط ، تعتمد Node.js على مكتبة zlib التي تمثل المعيار الذي يقاس عليه في هذه الناحية كما تعرف أيضًا باستخدامها في gzip و libpng. يستخدم الـNode.js مكتبة الـ zlib لإنشاء واجهات متزامنة وغير متزامنة إضافة إلى تمكين تدفق واجهات الضغط و فك الضغط. - -* [التوثيق](http://www.zlib.net/manual.html) - -## الأدوات - -### npm - -يعتبر كل ما يتعلق بالنمطية Node.js، ومع ذلك تأتي الحاجة إلى مدير حزمة ذو جودة ؛ لهذا الغرض ، تم إنشاء npm حيث يأتي مع مجموعة كبيرة من الحزم التي تم إنشاؤها من قبل المجتمع لأي نظام متكامل للبرمجة ، مما يجعل بناء تطبيقات Node.js سريعًا وسهلاً. - -* [التوثيق](https://docs.npmjs.com/) - -### gyp - -تتم معالجة نظام الإنشاء بواسطة gyp ، وهو منشئ مشروع يستند إلى بيثون تم نسخه من V8. يمكنه إنشاء ملفات مشاريع للاستخدام مع أنظمة الإنشاء عبر العديد من الأنظمة الأساسية. يتطلب Node.js نظام بناء لأن أجزاء كبيرة منه - وإعتماداته- مكتوبة بلغات تتطلب ترجمة. - -* [التوثيق](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -يمكن اختبار الكود الأصلي باستخدام gtest ، وهو مأخوذ من Chromium. لأنها تتيح اختبار C / C ++ دون الحاجة إلى نود موجودة قابلة للتنفيذ. - -* [التوثيق](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/en/docs/meta/topics/dependencies.md b/pages/en/docs/meta/topics/dependencies.md deleted file mode 100644 index 601cb3cea4df5..0000000000000 --- a/pages/en/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Dependencies -layout: docs.hbs ---- - -# Dependencies - -There are several dependencies that Node.js relies on to work the way it does. - -* [Libraries](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [Tools](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Libraries - -### V8 - -The V8 library provides Node.js with a JavaScript engine, which Node.js -controls via the V8 C++ API. V8 is maintained by Google, for use in Chrome. - -* [Documentation](https://v8.dev/docs) - -### libuv - -Another important dependency is libuv, a C library that is used to abstract -non-blocking I/O operations to a consistent interface across all supported -platforms. It provides mechanisms to handle file system, DNS, network, child -processes, pipes, signal handling, polling and streaming. It also includes a -thread pool for offloading work for some things that can't be done -asynchronously at the operating system level. - -* [Documentation](http://docs.libuv.org/) - -### llhttp - -HTTP parsing is handled by a lightweight TypeScript and C library called llhttp. -It is designed to not make any syscalls or allocations, so it has a very small -per-request memory footprint. - -* [Documentation](https://github.com/nodejs/llhttp) - -### c-ares - -For some asynchronous DNS requests, Node.js uses a C library called c-ares. -It is exposed through the DNS module in JavaScript as the `resolve()` family of -functions. The `lookup()` function, which is what the rest of core uses, makes -use of threaded `getaddrinfo(3)` calls in libuv. The reason for this is that -c-ares supports /etc/hosts, /etc/resolv.conf and /etc/svc.conf, but not things -like mDNS. - -* [Documentation](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL is used extensively in both the `tls` and `crypto` modules. It provides -battle-tested implementations of many cryptographic functions that the modern -web relies on for security. - -* [Documentation](https://www.openssl.org/docs/) - -### zlib - -For fast compression and decompression, Node.js relies on the industry-standard -zlib library, also known for its use in gzip and libpng. Node.js uses zlib to -create sync, async and streaming compression and decompression interfaces. - -* [Documentation](https://www.zlib.net/manual.html) - -## Tools - -### npm - -Node.js is all about modularity, and with that comes the need for a quality -package manager; for this purpose, npm was made. With npm comes the largest -selection of community-created packages of any programming ecosystem, -which makes building Node.js apps quick and easy. - -* [Documentation](https://docs.npmjs.com/) - -### gyp - -The build system is handled by gyp, a python-based project generator copied -from V8. It can generate project files for use with build systems across many -platforms. Node.js requires a build system because large parts of it — and its -dependencies — are written in languages that require compilation. - -* [Documentation](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -Native code can be tested using gtest, which is taken from Chromium. It allows -testing C/C++ without needing an existing node executable to bootstrap from. - -* [Documentation](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/es/docs/meta/topics/dependencies.md b/pages/es/docs/meta/topics/dependencies.md deleted file mode 100644 index 28ed781514f7e..0000000000000 --- a/pages/es/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Dependencias -layout: docs.hbs ---- - -# Dependencias - -Hay varias dependencias en las que se basa Node.js para funcionar como lo hace. - -* [Dependencias](#dependencias) - * [Librerías](#librerías) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) - * [Herramientas](#herramientas) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Librerías - -### V8 - -La librería V8 proporciona a Node.js un motor de JavaScript, que Node.js controla a través de la API V8 C++. V8 es mantenido por Google para su uso en Chrome. - -* [Documentación](https://v8.dev/docs) - -### libuv - -Otra dependencia importante es libuv, una librería en C que se utiliza para abstraer operaciones I/O sin bloqueo en una interfaz coherente en todas las plataformas compatibles. Proporciona mecanismos para manejar sistema de archivos, DNS, red, child processes, pipes, signal handling, polling y streaming. También incluye un thread pool para descargar el trabajo de algunas cosas que no se pueden hacer de forma asíncrona a nivel del sistema operativo. - -* [Documentación](http://docs.libuv.org/) - -### llhttp - -El análisis sintáctico de HTTP es manejado por una biblioteca ligera de TypeScript y C llamada llhttp. Está diseñada para no hacer ninguna llamada al sistema (syscalls) o asignación (allocations), por lo que tiene una cuota de memoria por solicitud muy pequeña. - -* [Documentación](https://github.com/nodejs/llhttp) - -### c-ares - -Para algunas peticiones DNS asíncronas, Node.js utiliza una librería en C llamada c-ares. Se expone a través del módulo DNS en JavaScript como la familia de funciones `resolve()`. La función `lookup()`, que es la que utiliza el resto del núcleo, hace uso de las llamadas `getaddrinfo(3)` en libuv. La razón de esto es que c-ares soporta /etc/hosts, /etc/resolv.conf y /etc/svc.conf pero no cosas como mDNS. - -* [Documentación](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL se utiliza ampliamente en los módulos `tls` y `crypto`. Proporciona implementaciones ampliamente probadas de muchas funciones criptográficas en las que la web moderna confía para su seguridad. - -* [Documentación](https://www.openssl.org/docs/) - -### zlib - -Para una rápida compresión y descompresión, Node.js se basa en la librería zlib, un estándar de la industria conocida también por su uso en gzip y libpng. Node.js utiliza zlib para crear interfaces de compresión y descompresión síncronas, asíncronas y de streaming. - -* [Documentación](https://www.zlib.net/manual.html) - -## Herramientas - -### npm - -Node.js se basa en la modularidad, y con ello viene la necesidad de un gestor de paquetes de calidad; para este propósito, se creó npm. Con npm viene la mayor selección de paquetes creados por la comunidad de cualquier ecosistema de programación, lo que hace que la construcción de aplicaciones Node.js sea rápida y fácil. - -* [Documentación](https://docs.npmjs.com/) - -### gyp - -El sistema de construcción (build system) es manejado por gyp, un generador de proyectos basado en python copiado de V8. Puede generar archivos de proyecto para utilizarlos con sistemas de compilación en muchas plataformas. Node.js requiere un sistema de compilación porque gran parte de él — y sus dependencias — están escritas en lenguajes que requieren compilación. - -* [Documentación](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -El código nativo puede ser probado usando gtest, que está tomado de Chromium. Permite probar C/C++ sin necesidad de un ejecutable de node existente desde el que arrancar. - -* [Documentación](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/fr/docs/meta/topics/dependencies.md b/pages/fr/docs/meta/topics/dependencies.md deleted file mode 100644 index bc364cd4cb9cd..0000000000000 --- a/pages/fr/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Dépendances -layout: docs.hbs ---- - -# Dépendances - -Il existe plusieurs dépendances sur lesquelles Node.js s'appuie pour fonctionner comme il le fait. - -* [Bibliothèques](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [Outils](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Bibliothèques - -### V8 - -The V8 library provides Node.js with a JavaScript engine, which Node.js controls via the V8 C++ API. V8 is maintained by Google, for use in Chrome. - -* [Documentation](https://v8.dev/docs) - -### libuv - -Another important dependency is libuv, a C library that is used to abstract non-blocking I/O operations to a consistent interface across all supported platforms. It provides mechanisms to handle file system, DNS, network, child processes, pipes, signal handling, polling and streaming. It also includes a thread pool for offloading work for some things that can't be done asynchronously at the operating system level. - -* [Documentation](http://docs.libuv.org/) - -### llhttp - -HTTP parsing is handled by a lightweight TypeScript and C library called llhttp. It is designed to not make any syscalls or allocations, so it has a very small per-request memory footprint. - -* [Documentation](https://github.com/nodejs/llhttp) - -### c-ares - -For some asynchronous DNS requests, Node.js uses a C library called c-ares. It is exposed through the DNS module in JavaScript as the `resolve()` family of functions. The `lookup()` function, which is what the rest of core uses, makes use of threaded `getaddrinfo(3)` calls in libuv. The reason for this is that c-ares supports /etc/hosts, /etc/resolv.conf and /etc/svc.conf, but not things like mDNS. - -* [Documentation](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL is used extensively in both the `tls` and `crypto` modules. It provides battle-tested implementations of many cryptographic functions that the modern web relies on for security. - -* [Documentation](https://www.openssl.org/docs/) - -### zlib - -Pour une compression et une décompression rapides, Node.js s'appuie sur la bibliothèque standard zlib, également connue pour son utilisation dans gzip et libpng. Node.js utilise zlib pour créer des interfaces de compression et de décompression sync, async et streaming. - -* [Documentation](https://www.zlib.net/manual.html) - -## Outils - -### npm - -Node.js est tout en modularité, et avec cela vient le besoin d'un gestionnaire de paquets de qualité. de qualité ; c'est dans ce but que npm a été créé. Avec npm vient la plus grande sélection de paquets créés par la communauté de tout écosystème de programmation, ce qui rend la construction d'applications Node.js rapide et facile. - -* [Documentation](https://docs.npmjs.com/) - -### gyp - -Le système de construction est géré par gyp, un générateur de projet basé sur python copié de V8. Il peut générer des fichiers de projet à utiliser avec des systèmes de compilation sur de nombreuses plateformes. Node.js nécessite un système de compilation parce que de grandes parties de celui-ci - et ses dépendances - sont écrites dans des langages qui nécessitent une compilation. - -* [Documentation](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -Le code natif peut être testé à l'aide de gtest, qui est tiré de Chromium. Il permet de tester C/C++ sans avoir besoin d'un exécutable de noeud existant à partir duquel démarrer. - -* [Documentation](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/id/docs/meta/topics/dependencies.md b/pages/id/docs/meta/topics/dependencies.md deleted file mode 100644 index 1da09539e0f75..0000000000000 --- a/pages/id/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Dependensi -layout: docs.hbs ---- - -# Dependencies / Dependensi - -Ada beberapa dependensi yang diandalkan Node.js untuk bekerja seperti itu. - -* [Perpustakaan atau Libraries](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [Peralatan](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Perpustakaan - -### V8 - -Pustaka V8 menyediakan Node.js dengan mesin JavaScript, yang Node.js kontrol melalui V8 C++ API. V8 dikelola oleh Google, untuk digunakan di Chrome. - -* [Dokumentasi](https://v8.dev/docs) - -### libuv - -Ketergantungan penting lainnya adalah libuv, pustaka C yang digunakan untuk abstrak operasi I/O non-pemblokiran ke antarmuka yang konsisten di semua yang didukung platform. Ini menyediakan mekanisme untuk menangani sistem file, DNS, jaringan, anak proses, pipe, penanganan sinyal, polling dan streaming. Ini juga termasuk kumpulan utas untuk pekerjaan pembongkaran untuk beberapa hal yang tidak dapat dilakukan secara asinkron di tingkat sistem operasi. - -* [Dokumentasi](http://docs.libuv.org/) - -### llhttp - -Penguraian HTTP ditangani oleh pustaka TypeScript dan C ringan yang disebut llhttp. Ini dirancang untuk tidak membuat panggilan atau alokasi apa pun, sehingga memiliki yang sangat kecil jejak memori per-permintaan. - -* [Dokumentasi](https://github.com/nodejs/llhttp) - -### c-ares - -Untuk beberapa permintaan DNS asinkron, Node.js menggunakan pustaka C yang disebut c-ares. Itu diekspos melalui modul DNS di JavaScript sebagai keluarga `resolve()` dari fungsi. Fungsi `lookup()`, yang digunakan oleh inti lainnya, membuat penggunaan panggilan `getaddrinfo(3)` berulir di libuv. Alasan untuk ini adalah c-ares mendukung /etc/hosts, /etc/resolv.conf dan /etc/svc.conf, tetapi tidak mendukung hal-hal seperti mDNS. - -* [Dokumentasi](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL digunakan secara luas di modul `tls` dan `crypto`. Ini menyediakan implementasi yang telah teruji pertempuran dari banyak fungsi kriptografi yang modern web bergantung pada keamanan. - -* [Dokumentasi](https://www.openssl.org/docs/) - -### zlib - -Untuk kompresi dan dekompresi yang cepat, Node.js mengandalkan standar industri zlib library, juga dikenal karena penggunaannya di gzip dan libpng. Node.js menggunakan zlib untuk buat sinkronisasi, asinkron, dan antarmuka kompresi dan dekompresi streaming. - -* [Dokumentasi](https://www.zlib.net/manual.html) - -## Peralatan - -### npm - -Node.js adalah tentang modularitas, dan dengan itu muncul kebutuhan akan kualitas manajer paket; untuk tujuan ini, npm dibuat. Dengan npm datang yang terbesar pemilihan paket buatan komunitas dari ekosistem pemrograman apa pun, yang membuat pembuatan aplikasi Node.js cepat dan mudah. - -* [Dokumentasi](https://docs.npmjs.com/) - -### gyp - -Sistem pembangunan ditangani oleh gyp, generator proyek berbasis python yang disalin dari V8. Itu dapat menghasilkan file proyek untuk digunakan dengan sistem build di banyak platform. Node.js membutuhkan sistem pembangunan karena sebagian besar — ​​dan itu dependensi — ditulis dalam bahasa yang memerlukan kompilasi. - -* [Dokumentasi](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -Kode asli dapat diuji menggunakan gtest, yang diambil dari Chromium. Ini memungkinkan menguji C/C++ tanpa memerlukan node yang ada yang dapat dieksekusi untuk bootstrap. - -* [Dokumentasi](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/ja/docs/meta/topics/dependencies.md b/pages/ja/docs/meta/topics/dependencies.md deleted file mode 100644 index 49ece1688dd26..0000000000000 --- a/pages/ja/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: 依存関係 -layout: docs.hbs ---- - - -# 依存関係 - -Node.js がそのように機能するために依存する依存関係がいくつかあります。 - -* [ライブラリ](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [ツール](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - - -## ライブラリ - -### V8 - -V8 ライブラリは、Node.js に JavaScript エンジンを提供します。これは、Node.js が V8 C++ API を介して制御するものです。 -V8 は Chrome で使用するために Google によってメンテナンスされています。 - -* [ドキュメント](https://v8.dev/docs/) - - -### libuv - -もう1つの重要な依存関係は libuv です。 -これは、サポートされているすべてのプラットフォームで、ノンブロッキング I/O 操作を一貫したインターフェースに抽象化するために使用される C ライブラリです。 -ファイルシステム、DNS、ネットワーク、子プロセス、パイプ、シグナル処理、ポーリング、ストリーミングを処理するメカニズムを提供します。 -また、オペレーティングシステムレベルで非同期的に実行することができないいくつかの作業のための -作業をオフロードするためのスレッドプールも含まれています。 - -* [ドキュメント](http://docs.libuv.org/) - - -### llhttp - -HTTP 解析は、llhttp という軽量の C ライブラリによって処理されます。 -システムコールや割り当てを行わないように設計されているため、 -リクエストごとのメモリ使用量は非常に小さくなっています。 - -* [ドキュメント](https://github.com/nodejs/llhttp) - - -### c-ares - -一部の非同期 DNS 要求では、Node.js は c-ares というCライブラリを使用します。 -JavaScript の DNS モジュールを通して `resolve()` 関数ファミリとして公開されています。 -`lookup()` 関数は、残りのコアが使用しているもので、 -libuv でスレッド付きの`getaddrinfo(3)` 呼び出しを利用します。 -これは、c-ares が /etc/hosts、/etc/resolv.conf、および /etc/svc.conf をサポートしているが、 -mDNS のようなものはサポートしていないためです。 - -* [ドキュメント](https://c-ares.haxx.se/docs.html) - - -### OpenSSL - -OpenSSL は、`tls` モジュールと`crypto` モジュールの両方で広く使用されています。 -それは現代の Web がセキュリティのために頼っている -多くの暗号機能の戦いでテストされた実装を提供します。 - -* [ドキュメント](https://www.openssl.org/docs/) - - -### zlib - -高速な圧縮と解凍のために、Node.js は gzip と libpng での使用でも知られている -業界標準の zlib ライブラリに依存しています。 -Node.js は zlib を使って同期、非同期、ストリーミングの圧縮と解凍のインターフェースを作成します。 - -* [ドキュメント](https://www.zlib.net/manual.html) - - -## ツール - -### npm - -Node.js はすべてモジュールであり、それに伴い高品質のパッケージマネージャが必要になります。 -この目的のために、npm が作られました。 -npm を使えば、あらゆるプログラミングエコシステムのコミュニティで作成されたパッケージの中で最大のものが選択でき、 -Node.js アプリケーションを素早く簡単に構築することができます。 - -* [ドキュメント](https://docs.npmjs.com/) - - -### gyp - -ビルドシステムは、V8 からコピーされた python ベースのプロジェクトジェネレータである gyp によって処理されます。 -それは多くのプラットフォームにわたるビルドシステムで使用するためのプロジェクトファイルを生成することができます。 -Node.js の大部分 (およびその依存関係) はコンパイルが必要な言語で書かれているため、 -Node.js にはビルドシステムが必要です。 - -* [ドキュメント](https://gyp.gsrc.io/docs/UserDocumentation.md) - - -### gtest - -ネイティブコードは、Chromium から入手した gtest を使用してテストできます。 -既存のノード実行可能ファイルをブートストラップする必要なしに C/C++ をテストすることができます。 - -* [ドキュメント](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/ko/docs/meta/topics/dependencies.md b/pages/ko/docs/meta/topics/dependencies.md deleted file mode 100644 index 6fb9ed72b3e23..0000000000000 --- a/pages/ko/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: 의존성 -layout: docs.hbs ---- - - - -# 의존성 - -Node.js가 의존하고 있는 여러 의존성 - -* [라이브러리](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [도구](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - - - -## 라이브러리 - -### V8 - -V8 라이브러리는 Node.js가 V8 C++ API로 제어하는 JavaScript 엔진을 제공합니다. -V8은 구글이 관리하고 크롬에서 사용 중인 엔진입니다. - -* [문서](https://v8.dev/docs/) - - - -### libuv - -또 하나의 중요한 의존성은 libuv입니다. libuv는 C 라이브러리로 논블로킹 I/O 작업을 지원하는 -모든 플랫폼에서 일관된 인터페이스로 추상화하는 데 사용됩니다. libuv는 파일 시스템, DNS, 네트워크, -자식 프로세스, 파이프, 신호 처리, 폴링, 스트리밍을 다루는 메커니즘을 제공하고 운영체제 수준에서 -비동기로 처리될 수 없는 작업을 위한 스레드 풀도 포함하고 있습니다. - -* [문서](http://docs.libuv.org/) - - - -### llhttp - -HTTP 파싱은 llhttp라는 경량 C 라이브러리가 처리합니다. 이는 시스템 호출이나 할당을 하려고 -만들어진 것이 아니므로 요청당 아주 작은 메모리 공간만 차지합니다. - -* [문서](https://github.com/nodejs/llhttp) - - - -### c-ares - -일부 비동기 DNS 요청을 위해서 Node.js는 c-ares라는 C 라이브러리를 사용합니다. c-ares는 -JavaScript DNS 모듈로 `resolve()` 류의 함수들을 노출합니다. 코어의 다른 부분에서 사용하는 -`lookup()` 함수는 libuv에서 스레드로 관리되는 `getaddrinfo(3)` 호출을 사용합니다. 이렇게 사용하는 -이유는 c-ares가 /etc/hosts, /etc/resolv.conf, /etc/svc.conf는 지원하지만 -mDNS 같은 것은 지원하지 않기 때문입니다. - -* [문서](https://c-ares.haxx.se/docs.html) - - - -### OpenSSL - -OpenSSL은 `tls`와 `crypto` 모듈에서 광범위하게 사용되고 있습니다. OpenSSL은 현대 웹이 -보안에서 사용하는 수많은 암호화 함수에 대한 검증된 구현체를 제공합니다. - -* [문서](https://www.openssl.org/docs/) - - - -### zlib - -빠른 압축과 압축 해제를 하기 위해 Node.js는 산업 표준인 zlib 라이브러리를 사용하고 zlib은 -gzip과 libpng를 사용한다고 알려져 있습니다. Node.js는 동기, 비동기, 스트리밍 압축과 -압축 해제 인터페이스에 zlib을 사용합니다. - -* [문서](https://www.zlib.net/manual.html) - - - -## 도구 - -### npm - -Node.js는 모든 것이 모듈화되어 있으므로 질 좋은 패키지 매니저가 필요해졌습니다. 이 목적 때문에 -npm이 만들어졌습니다. npm이 모든 프로그래밍 생태계에서 커뮤니티가 만든 커다란 패키지 선택권을 -제공해 주므로 Node.js를 빠르고 쉽게 만들 수 있습니다. - -* [문서](https://docs.npmjs.com/) - - - -### gyp - -V8에서 파생된 Python 기반의 프로젝트 제너레이터인 gyp가 빌드 시스템을 다룹니다. gyp는 다수의 -플랫폼에서 빌드 시스템을 사용하기 위한 프로젝트 파일을 생성할 수 있습니다. Node.js는 컴파일이 -필요한 언어로 작성된 부분이 많이 있으므로(혹은 의존성 라이브러리에서) 빌드 시스템이 필요합니다. - -* [문서](https://gyp.gsrc.io/docs/UserDocumentation.md) - - - -### gtest - -네이티브 코드는 Chromium의 gtest로 테스트할 수 있습니다. gtest로 C/C++를 시작하는 -기존의 node 실행 파일 없이 C/C++를 테스트할 수 있습니다. - -* [문서](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/pt-br/docs/meta/topics/dependencies.md b/pages/pt-br/docs/meta/topics/dependencies.md deleted file mode 100755 index 910deb102d80e..0000000000000 --- a/pages/pt-br/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,168 +0,0 @@ ---- -title: Dependências -layout: docs.hbs ---- - -# Dependências - -O Node.js precisa de diversas dependências para funcionar do jeito que funciona atualmente. - -* [Dependências](#dependências) - * [Bibliotecas](#bibliotecas) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) - * [Ferramentas](#ferramentas) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Bibliotecas - -### V8 - - - -A biblioteca do V8 provê um engine JavaScript para o Node.js, o qual -é controlado pela API C++ do próprio V8. O V8 é atualmente mantido -pelo Google, por conta de seu uso no navegador Chrome. - -* [Documentação](https://v8.dev/docs/) - -### libuv - - - -Uma outra dependência importante é a *libuv*. Uma biblioteca escrita em C que -é utilizada para abstrair todas as operações que não bloqueiam o I/O para uma -interface consistente por todas as plataformas suportadas. Ela provê mecanismos -para lidar com o sistema de arquivos, DNS, rede, processos filhos, pipes, -tratamento de sinais, polling e streaming. Ela também inclui uma pool de threads -para distribuir o trabalho que não pode ser feito assíncronamente a nível de SO. - -* [Documentação](http://docs.libuv.org/) - -### llhttp - - - -O parsing do protocolo HTTP é delegado a uma biblioteca leve, escrita em C, -chamada *llhttp*. Ela foi desenhada para não fazer nenhuma syscall ou -alocações, portanto acaba possuindo um baixo consumo de memória por requisição. - -* [Documentação](https://github.com/nodejs/llhttp) - -### c-ares - - -Para algumas requisições assíncronas de DNS, o Node.js utilizar uma biblioteca -escrita em C chamada *c-ares*. Ela é exposta através do módulo de DNS no JavaScript -na família `resolve()` de funções. A função `lookup()`, que é o que o resto do core -do Node.js usa, faz uso de uma chamada `getaddrinfo(3)` que é processada em threads -na libuv. A razão por trás disso é que o c-ares suporta caminhos como -/etc/hosts, /etc/resolv.conf e /etc/svc.conf, mas não outras coisas como o mDNS. - -* [Documentação](http://c-ares.haxx.se/docs.html) - -### OpenSSL - - - -O OpenSSL é extensivamente usado nos módulos `tls` e `crypto` do Node.js. Ele provê -uma implementação altamente testada de várias funções criptográficas que a web -moderna utiliza em grande escala a fim de manter a segurança. - -* [Documentação](https://www.openssl.org/docs/) - -### zlib - - - -Para compressões e descompressões rápidas, o Node.js utiliza na biblioteca zlib, -que é o padrão da indústria, também conhecida pelo seu uso nas bibliotecas gzip e libpng. -O Node.js utiliza o zlib para criar interfaces de descompressão e compressão que podem -ser síncronas, assíncronas ou através de streaming. - -* [Documentação](http://www.zlib.net/manual.html) - -## Ferramentas - -### npm - - - -Uma das grandes vantagens do Node.js é sua modularidade, e com isso vem a -necessidade de um gerenciador de pacotes de qualidade. O NPM foi justamente -criado para isto. Com ele, temos a maior seleção de pacotes criados pela -comunidade, maior do que em todos os outros ecossistemas existentes. Isto -faz com que construir uma aplicação Node.js seja fácil e rápida. - -* [Documentação](https://docs.npmjs.com/) - -### gyp - - - -Todo o sistema de build é gerenciado pelo gyp, um gerador de projetos baseado -em python que foi copiado do V8. Ele pode gerar arquivos de projeto para uso -em sistemas de build de diversas plataformas. O Node.js precisa disso porque -grande parte do próprio Node – e também de suas dependências – são escritas em -linguagens que requerem compilação, como C++. - -* [Documentação](https://gyp.gsrc.io/docs/UserDocumentação.md) - -### gtest - - - -O código nativo pode ser testado usando gtest, que foi tirado do Chromium. Ele -permite testes de C/C++ sem a necessidade de um executável node existente para -dar o bootstrap inicial. - -* [Documentação](https://code.google.com/p/googletest/wiki/V1_7_Documentação) diff --git a/pages/ru/docs/meta/topics/dependencies.md b/pages/ru/docs/meta/topics/dependencies.md deleted file mode 100644 index 8a7ce87c09044..0000000000000 --- a/pages/ru/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Зависимости -layout: docs.hbs ---- - -# Зависимости - -Есть несколько зависимостей, которые используются Node.js, чтобы работать так, как он работает. - -* [Библиотеки](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [Инструменты](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Библиотеки - -### V8 - -Библиотека V8 предоставляет для Node.js движок JavaScript, которым Node.js управляет -через API C++ V8. V8 поддерживается Google для использования в Chrome. - -* [Документация](https://v8.dev/docs/) - -### libuv - -Другой важной зависимостью является libuv, библиотека на C, которая используется для -абстрагирования неблокирующих операций ввода-вывода в согласованный интерфейс на всех -поддерживаемых платформах. Он предоставляет механизмы для обработки файловой системы, DNS, -сети, дочерних процессов, каналов, обработки сигналов, опроса и потоковой передачи. -Он также включает в себя пул потоков для разгрузки некоторых вещей, которые не могут быть -выполнены асинхронно на уровне операционной системы. - -* [Документация](http://docs.libuv.org/) - -### llhttp - -Синтаксический анализ HTTP выполняется легкой библиотекой C, которая называется llhttp. -Он спроектирован таким образом, чтобы не делать никаких системных вызовов или распределений, -поэтому занимает требует мало памяти на каждый запрос. - -* [Документация](https://github.com/nodejs/llhttp) - -### c-ares - -Для некоторых асинхронных DNS-запросов Node.js использует библиотеку C под названием c-ares. -Он представлен через модуль DNS в JavaScript как семейство функций `resolve()`. Функция `lookup()`, -которая используется остальной частью ядра, использует многопоточные вызовы `getaddrinfo(3)` в libuv. -Причина этого в том, что c-ares поддерживает /etc/hosts, /etc/resolv.conf и /etc/svc.conf, -но не такие вещи, как mDNS. - -* [Документация](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL широко используется в модулях `tls` и `crypto`. Он предоставляет проверенные на практике реализации -многих криптографических функций, которые современные сети используют для обеспечения безопасности. - -* [Документация](https://www.openssl.org/docs/) - -### zlib - -Для быстрого сжатия и распаковки Node.js использует стандартную библиотеку zlib, также известную своим -использованием в gzip и libpng. Node.js использует zlib для создания интерфейсов синхронизации, -асинхронного и потокового сжатия и распаковки. - -* [Документация](https://www.zlib.net/manual.html) - -## Инструменты - -### npm - -Node.js ― это модульность, и вместе с этим возникает необходимость в качественном менеджере пакетов и -для этого был создан npm. С npm поставляется самый большой выбор пакетов, созданных сообществом, -для любой экосистемы программирования, что делает создание приложений Node.js быстрым и простым. - -* [Документация](https://docs.npmjs.com/) - -### gyp - -Системой сборки управляет gyp, генератор проектов на основе Python, скопированный с V8. Он может -генерировать файлы проекта для использования на многих платформах. Node.js требует системы сборки, -потому что большая его часть и зависимостей написаны на языках, требующих компиляции. - -* [Документация](https://gyp.gsrc.io/docs/UserДокументация.md) - -### gtest - -Нативный код можно протестировать с помощью gtest, который взят из Chromium. Это позволяет -тестировать C/C++ без необходимости в существующем исполняемом файле node для начальной загрузки. - -* [Документация](https://code.google.com/p/googletest/wiki/V1_7_Документация) diff --git a/pages/uk/docs/meta/topics/dependencies.md b/pages/uk/docs/meta/topics/dependencies.md deleted file mode 100644 index c59fc593c067e..0000000000000 --- a/pages/uk/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: Залежності -layout: docs.hbs ---- - -# Залежності - -Node.js використовує кілька залежностей, на які використовуються для забезпечення його роботи. - -* [Бібліотеки](#libraries) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [Інструменти](#tools) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## Бібліотеки - -### V8 - -Бібліотека V8 надає Node.js JavaScript–рушій, який Node.js керується через V8 C++ API. V8 підтримується Google для використання у Chrome. - -* [Документація](https://v8.dev/docs/) - -### libuv - -Іншою важливою залежністю є libuv, C–бібліотека, що використовується для -абстрагування неблокуючих I/O–операцій у консистентний інтерфейс -для всіх платформ, що підтримуються. Вона надає механізм для маніпуляцій -файловою системою, DNS, мережею, дочірними процесами, пайпами, -сигналами, запитами та потоками. Вона також включає тред для розвантаження -роботи, що може бути виконана асинхронно на рівні операційної системи. - -* [Документація](http://docs.libuv.org/) - -### llhttp - -Парсинг HTTP відбувається з допомогою легкої С–бібліотеки, -яка називається llhttp. Вона спроектована так, щоб не робити жодних -системних викликів або алокацій, тому вона використовує дуже мало пам’яті -для обробки кожного запиту. - -* [Документація](https://github.com/nodejs/llhttp) - -### c-ares - -Для деяких асинхронних DNS–запитів Node.js використовує C–бібліотеку -під назвою c-ares. Вона використовується через DNS–модуль у JavaScript -в якості сім’ї функцій `resolve()`. Функція `lookup()`, -яку використовує решту ядра, використовується для `getaddrinfo(3)` -викликів у libuv. Причиною цього є те, що c-ares підтримує /etc/hosts, -/etc/resolv.conf та /etc/svc.conf, проте не речі, на зразок mDNS. - -* [Документація](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL широко використовується у модулях `tls` та `crypto`. Вона надає добре протестовані імплементації багатьох криптографічних функцій, які використовуються у сучасному вебі для безпеки. - -* [Документація](https://www.openssl.org/docs/) - -### zlib - -Для компресії та декомпресії Node.js використовує де–факто стандартну в -індустрії бібліотеку zlib, яка також використовується у gzip та libpng. -Node.js використовує zlib для створення синхронних, асинхронних -та потокових інтерфейсів компресії та декомпресії - -* [Документація](https://www.zlib.net/manual.html) - -## Інструменти - -### npm - -Node.js є модульним, а це вимагає наявності якісного пакетного менеджера і саме для цієї потреби був розроблений npm. Разом з npm надходить велика кількість пакетів для будь–якої програмної екосистеми, що робить побудову додатків на Node.js швидким та легким процесом. - -* [Документація](https://docs.npmjs.com/) - -### gyp - -Система збірки керується через gyp (генератор проектів взятий з V8, що написаний на Python). Вона може генерувати файли для проектів,щоб використовувати їх у системах збірки на багатьох платформах. Node.js потребує системи збірки, оскільки велика кількість його частин, його залежності, написані на мовах, що потребують компіляції. - -* [Документація](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -Нативний код можна тестувати через gtest, який взятий з Chromium. Він дозволяє тестувати C/C++ без потреби у існуючій збірці node. - -* [Документація](https://code.google.com/p/googletest/wiki/V1_7_Documentation) diff --git a/pages/zh-cn/docs/meta/topics/dependencies.md b/pages/zh-cn/docs/meta/topics/dependencies.md deleted file mode 100644 index ab39df0c3782f..0000000000000 --- a/pages/zh-cn/docs/meta/topics/dependencies.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: 所有依赖项 -layout: docs.hbs ---- - -# 所有依赖项 - -Node.js 依赖于以下一些依赖项，这样它才能正常工作。 - -* [类库](#类库) - * [V8](#v8) - * [libuv](#libuv) - * [llhttp](#llhttp) - * [c-ares](#c-ares) - * [OpenSSL](#openssl) - * [zlib](#zlib) -* [工具](#工具) - * [npm](#npm) - * [gyp](#gyp) - * [gtest](#gtest) - -## 类库 - -### V8 - -V8 类库为 Node.js 提供了 JavaScript 引擎，Node.js 通过 V8 C++ 的 API 函数接口进行操控， V8 由谷歌公司维护，用于谷歌浏览器中。 - -* [相关文档](https://v8.dev/docs) - -### libuv - -另外一个重要的依赖项是 libuv，它是一个 C 写成的类库，用于非阻塞型的 I/O 操作，同时在所有支持的操作系统上保持一致的接口。它提供了一些机制来处理诸如文件系统、DNS、网络、子进程、管道、信号量控制、轮询机制和数据流。它同样也提供了一个线程池，用于无法在操作系统层面进行异步操作的任务卸载。 - -* [相关文档](http://docs.libuv.org/) - -### llhttp - -HTTP 解析是通过一个由 C 语言编写、轻量级称作 llhttp 的类库进行的。由于它的设计不会引发系统调用和系统资源分配，因而它的预请求内存痕迹极小。 - -* [相关文档](https://github.com/nodejs/llhttp) - -### c-ares - -对于某些异步的 DNS 请求，Node.js 使用由 C 编写，称作 c-areas 的类库。它是通过 JavaScript 的 DNS 模块，以 `resolve()` 家族函数的形式发布。`lookup()` 函数，核心剩余部分使用它，借助在 libuv 中 `getaddrinfo(3)` 跨越函数的调用。那是因为 c-areas 支持 /etc/hosts，/etc/resolv.conf 以及 /etc/svc.conf。但不是像 mDNS 一样的东西。 - -* [相关文档](https://c-ares.haxx.se/docs.html) - -### OpenSSL - -OpenSSL 广泛地在 `tls` 和 `crypto` 模块中使用。它提供了战争环境下，许多现代网络为安全而依赖的密码函数。 - -* [相关文档](https://www.openssl.org/docs/) - -### zlib - -为了快速压缩解压，Node.js 依赖于工业标准的 zlib 类库。同名可知的还有 gzip 和 libpng。Node.js 使用 zlib 创建同步、异步和数据流压缩、解压缩接口。 - -* [相关文档](https://www.zlib.net/manual.html) - -## 工具 - -### npm - -Node.js 完全是基于模块化构建的，因此需要一个高质量的包管理器；有鉴于此 npm 产生了。随着 npm 的产生史上最大的社区创建的编程生态圈诞生，它们使得构建 Node.js 快而容易。 - -* [相关文档](https://docs.npmjs.com/) - -### gyp - -构建系统通过 gyp 来处理。这是一个从 V8 拷贝而来、基于 python 的项目生成工具。它可以生成项目文件用以跨不同平台中使用。Node.js 需要一个构建系统，因为它自身的大部分，以及它的依赖项，是用需要编译的语言写成的。 - -* [相关文档](https://gyp.gsrc.io/docs/UserDocumentation.md) - -### gtest - -本地代码可以通过 gtest 进行测试，它是从 Chromium 收录的。它不需要一个真实可启动的节点环境下，直接测试 C/C++ 程序。 - -* [相关文档](https://code.google.com/p/googletest/wiki/V1_7_Documentation) From 63b671f079bf90ee402c4c064bfff26adf6db88d Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 9 Jul 2023 14:33:43 -0500 Subject: [PATCH 4/5] chore: move es6 nav item to align with content --- navigation.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/navigation.json b/navigation.json index 148fc3ce90030..f50da11a8861f 100644 --- a/navigation.json +++ b/navigation.json @@ -60,10 +60,6 @@ "link": "/docs", "translationId": "components.header.links.docs", "items": { - "es6": { - "link": "/docs/es6", - "translationId": "components.navigation.docs.links.es6" - }, "apiLts": { "link": "https://nodejs.org/dist/latest-{ltsNodeVersion}/docs/api", "translationId": "components.navigation.docs.links.apiLts" @@ -72,6 +68,10 @@ "link": "https://nodejs.org/dist/latest-{currentNodeVersion}/docs/api", "translationId": "components.navigation.docs.links.apiCurrent" }, + "es6": { + "link": "/docs/es6", + "translationId": "components.navigation.docs.links.es6" + }, "guides": { "link": "/docs/guides", "translationId": "components.navigation.docs.links.guides" From 98634b465097376e692cdb26dd7116229912effb Mon Sep 17 00:00:00 2001 From: Brian Muenzenmeyer Date: Sun, 9 Jul 2023 14:34:19 -0500 Subject: [PATCH 5/5] chore: add description of dependencies content --- pages/en/docs/index.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/pages/en/docs/index.mdx b/pages/en/docs/index.mdx index 36959b8207645..ea0e81d72159a 100644 --- a/pages/en/docs/index.mdx +++ b/pages/en/docs/index.mdx @@ -12,6 +12,7 @@ There are several types of documentation available on this website: - API reference documentation - ES6 features - Guides +- Dependencies ## API reference documentation @@ -36,3 +37,7 @@ The [ES6 section](/en/docs/es6/) describes the three ES6 feature groups, and det ## Guides The [Guides section](/en/docs/guides/) has long-form, in-depth articles about Node.js technical features and capabilities. + +## Dependencies + +Node.js depends on additional components beyond the Node.js code itself. These [dependencies](https://github.com/nodejs/node/blob/main/doc/contributing/maintaining/maintaining-dependencies.md) provide both native and JavaScript code and are built together with the code under the `src` and `lib` directories to create the Node.js binaries.