Skip to content

Commit

Permalink
[automated]: crowdin sync (nodejs#5958)
Browse files Browse the repository at this point in the history
* New translations current.md (Romanian)
chore: synced translations from crowdin

* New translations index.md (Romanian)
chore: synced translations from crowdin

* New translations abi-stability.md (French)
chore: synced translations from crowdin

* New translations current.md (French)
chore: synced translations from crowdin

* New translations index.md (French)
chore: synced translations from crowdin

* New translations releases.md (French)
chore: synced translations from crowdin

* New translations current.md (Spanish)
chore: synced translations from crowdin

* New translations index.md (Spanish)
chore: synced translations from crowdin

* New translations index.md (Spanish)
chore: synced translations from crowdin

* New translations index.md (Arabic)
chore: synced translations from crowdin

* New translations current.md (Arabic)
chore: synced translations from crowdin

* New translations event-loop-timers-and-nexttick.md (Belarusian)
chore: synced translations from crowdin

* New translations current.md (Belarusian)
chore: synced translations from crowdin

* New translations index.md (Belarusian)
chore: synced translations from crowdin

* New translations index.md (Catalan)
chore: synced translations from crowdin

* New translations current.md (Catalan)
chore: synced translations from crowdin

* New translations index.md (Catalan)
chore: synced translations from crowdin

* New translations current.md (German)
chore: synced translations from crowdin

* New translations index.md (German)
chore: synced translations from crowdin

* New translations index.md (Italian)
chore: synced translations from crowdin

* New translations collab-summit.md (Italian)
chore: synced translations from crowdin

* New translations es6.md (Japanese)
chore: synced translations from crowdin

* New translations current.md (Japanese)
chore: synced translations from crowdin

* New translations index.md (Japanese)
chore: synced translations from crowdin

* New translations releases.md (Japanese)
chore: synced translations from crowdin

* New translations governance.md (Georgian)
chore: synced translations from crowdin

* New translations index.md (Georgian)
chore: synced translations from crowdin

* New translations debugging-getting-started.md (Georgian)
chore: synced translations from crowdin

* New translations getting-started-guide.md (Georgian)
chore: synced translations from crowdin

* New translations index.md (Georgian)
chore: synced translations from crowdin

* New translations index.md (Georgian)
chore: synced translations from crowdin

* New translations current.md (Korean)
chore: synced translations from crowdin

* New translations index.md (Korean)
chore: synced translations from crowdin

* New translations governance.md (Dutch)
chore: synced translations from crowdin

* New translations index.md (Dutch)
chore: synced translations from crowdin

* New translations current.md (Dutch)
chore: synced translations from crowdin

* New translations index.md (Dutch)
chore: synced translations from crowdin

* New translations package-manager.md (Dutch)
chore: synced translations from crowdin

* New translations releases.md (Dutch)
chore: synced translations from crowdin

* New translations index.md (Russian)
chore: synced translations from crowdin

* New translations blocking-vs-non-blocking.md (Russian)
chore: synced translations from crowdin

* New translations diagnostics-flamegraph.md (Russian)
chore: synced translations from crowdin

* New translations current.md (Russian)
chore: synced translations from crowdin

* New translations index.md (Russian)
chore: synced translations from crowdin

* New translations collab-summit.md (Russian)
chore: synced translations from crowdin

* New translations contribute.md (Russian)
chore: synced translations from crowdin

* New translations index.md (Turkish)
chore: synced translations from crowdin

* New translations current.md (Turkish)
chore: synced translations from crowdin

* New translations index.md (Turkish)
chore: synced translations from crowdin

* New translations governance.md (Ukrainian)
chore: synced translations from crowdin

* New translations current.md (Ukrainian)
chore: synced translations from crowdin

* New translations index.md (Ukrainian)
chore: synced translations from crowdin

* New translations index.mdx (Ukrainian)
chore: synced translations from crowdin

* New translations backpressuring-in-streams.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations buffer-constructor-deprecation.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations debugging-getting-started.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations using-gc-traces.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations nodejs-docker-webapp.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations timers-in-node.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations current.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations index.md (Chinese Simplified)
chore: synced translations from crowdin

* New translations index.mdx (Chinese Simplified)
chore: synced translations from crowdin

* New translations index.md (Chinese Traditional)
chore: synced translations from crowdin

* New translations current.md (Chinese Traditional)
chore: synced translations from crowdin

* New translations index.md (Chinese Traditional)
chore: synced translations from crowdin

* New translations collab-summit.md (Chinese Traditional)
chore: synced translations from crowdin

* New translations index.md (Chinese Traditional)
chore: synced translations from crowdin

* New translations current.md (Portuguese, Brazilian)
chore: synced translations from crowdin

* New translations index.md (Portuguese, Brazilian)
chore: synced translations from crowdin

* New translations collab-summit.md (Portuguese, Brazilian)
chore: synced translations from crowdin

* New translations backpressuring-in-streams.md (Indonesian)
chore: synced translations from crowdin

* New translations buffer-constructor-deprecation.md (Indonesian)
chore: synced translations from crowdin

* New translations current.md (Indonesian)
chore: synced translations from crowdin

* New translations index.md (Indonesian)
chore: synced translations from crowdin

* New translations index.mdx (Indonesian)
chore: synced translations from crowdin

* New translations index.md (Persian)
chore: synced translations from crowdin

* chore: automated format of translated files

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: ovflowd <[email protected]>
  • Loading branch information
ovflowd and ovflowd authored Oct 3, 2023
1 parent 26c0976 commit 8b4f698
Show file tree
Hide file tree
Showing 44 changed files with 391 additions and 878 deletions.
19 changes: 2 additions & 17 deletions pages/ar/about/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,32 +26,17 @@ server.listen(port, hostname, () => {

هذا على النقيض من نموذج التزامن الأكثر شيوعا اليوم أين يتم استخدام الخيوط الخاصة بالنظام

إن شبكة مبنية على الخيوط تعتبر غير فعالة نسبيا، و صعبة الاستخدام. و إضافة إلى ذلك
فإن مستخدمي Node.js لن يكون لديهم قلق حول اغلاق العملية بما أنه ليس هنالك اقفال.
تقريبا، ليس هنالك من دالة في Node.js تعمل مباشرة على مستوى الادخال و الاخراج لذلك
لا تتوقف اي عملية، لذلك فإن بناء انظمة قابلة للتطوير بNode.js يعد امرا محببا و منطقيا.
اذا كانت الفقرة السابقة تحتوي على مصطلحات مبهمة بالنسبة إليك
تفضل بقراءة هذا المقال للتعمق (باللغة الانجليزية) [Blocking vs Non-Blocking][].
إن شبكة مبنية على الخيوط تعتبر غير فعالة نسبيا، و صعبة الاستخدام. و إضافة إلى ذلك فإن مستخدمي Node.js لن يكون لديهم قلق حول اغلاق العملية بما أنه ليس هنالك اقفال. تقريبا، ليس هنالك من دالة في Node.js تعمل مباشرة على مستوى الادخال و الاخراج لذلك لا تتوقف اي عملية، لذلك فإن بناء انظمة قابلة للتطوير بNode.js يعد امرا محببا و منطقيا. اذا كانت الفقرة السابقة تحتوي على مصطلحات مبهمة بالنسبة إليك تفضل بقراءة هذا المقال للتعمق (باللغة الانجليزية) [Blocking vs Non-Blocking][].

---

تعتبر النود جي اس شبيهة في تصميمها بمكتبات و أنظمة مثل [Event Machine][] الخاصة بالروبي و [Twisted][] الخاصة بالبايثون.

تأخذ Node.js نموذج الاحداث (event model) ابعد قليلا فتمثل الحلقة التكرارية الخاصة بالاحداث ([event loop][]) كمكون اساسي في وقت التشغيل (runtime construct) وليس كمكتبة في انظمة أخرى، حيث ان هنالك دائما استدعاء متزامن (blocking call)
للبدء في حلقة الاحداث.
مبدئيا، يتم تحديد السلوك عبر دالة مستدعاة في بداية السكريبت في نهايتها
تقوم بتشغيل خادم (server) عبر استدعاءٍ غير متزامن (blocking call) مثل <span dir="ltr">`EventMachine::run()`</span>، ولكن في Node.js لا يوجد شيء من هذا القبيل.
تقوم Node.js بكل بساطة بدخول حلقة الاحداث بعد تنفيذها لسكريبت الادخال و تخرج من الحلقة السالفة الذكر عندما لا يكون هنالك اي دوال مستدعاة اخرى تستوجب التنفيذ.
هذا النمط يشبه JavaScript الخاصة بالمتصفح اين يتم اخفاء حلقة الاحداث عن المستخدم.
تأخذ Node.js نموذج الاحداث (event model) ابعد قليلا فتمثل الحلقة التكرارية الخاصة بالاحداث ([event loop][]) كمكون اساسي في وقت التشغيل (runtime construct) وليس كمكتبة في انظمة أخرى، حيث ان هنالك دائما استدعاء متزامن (blocking call) للبدء في حلقة الاحداث. مبدئيا، يتم تحديد السلوك عبر دالة مستدعاة في بداية السكريبت في نهايتها تقوم بتشغيل خادم (server) عبر استدعاءٍ غير متزامن (blocking call) مثل <span dir="ltr">`EventMachine::run()`</span>، ولكن في Node.js لا يوجد شيء من هذا القبيل. تقوم Node.js بكل بساطة بدخول حلقة الاحداث بعد تنفيذها لسكريبت الادخال و تخرج من الحلقة السالفة الذكر عندما لا يكون هنالك اي دوال مستدعاة اخرى تستوجب التنفيذ. هذا النمط يشبه JavaScript الخاصة بالمتصفح اين يتم اخفاء حلقة الاحداث عن المستخدم.

يعتبر بروتوكول الـHTTP مهما في Node.js. حيث انه تم أخذ اعتبار بث و تقليل وقت التأخير و هذا ما يجعل النود ممتازة لبناء مكتبات و إطارات عمل خاصة بالويب.

يجب عليك ان تدرك ان تصميم Node.js بدون خيوط (threads) لا يعني انك لا تستطيع تحقيق الاستفادة الكاملة من الانوية المتعددة في البيئة التي تعمل عليها، فيمكن توليد المعالجات الفرعية عبر واجهة برمجة التطبيقات <span dir="ltr">[`child_process.fork()`][]</span> الخاصة بنا حيث انها مصممة لتكون سهلة التعامل.
هناك ايضا نموذج [`cluster`][] المبني على نفس الواجهة والذي يسمح لك بمشاركة المآخذ (sockets) بين العمليات لموازنة الحمل على الانوية الخاصة بك.

[Blocking vs Non-Blocking]: /en/docs/guides/blocking-vs-non-blocking/
[`child_process.fork()`]: https://nodejs.org/api/child_process.html#child_process_child_process_fork_modulepath_args_options
[`cluster`]: https://nodejs.org/api/cluster.html
[event loop]: /en/docs/guides/event-loop-timers-and-nexttick/
[Event Machine]: https://github.com/eventmachine/eventmachine
[Twisted]: https://twistedmatrix.com/trac/
66 changes: 36 additions & 30 deletions pages/be/docs/guides/event-loop-timers-and-nexttick.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,24 +17,26 @@ layout: docs.hbs

На дыяграме ніжэй паказаны спрошчаны агляд паслядоўнасці аперацый цыкла падзей.

┌───────────────────────────┐
┌─>│ timers │
│ └─────────────┬─────────────┘
│ ┌─────────────┴─────────────┐
│ │ pending callbacks │
│ └─────────────┬─────────────┘
│ ┌─────────────┴─────────────┐
│ │ idle, prepare │
│ └─────────────┬─────────────┘ ┌───────────────┐
│ ┌─────────────┴─────────────┐ │ incoming: │
│ │ poll │<─────┤ connections, │
│ └─────────────┬─────────────┘ │ data, etc. │
│ ┌─────────────┴─────────────┐ └───────────────┘
│ │ check │
│ └─────────────┬─────────────┘
│ ┌─────────────┴─────────────┐
└──┤ close callbacks │
└───────────────────────────┘
```
┌───────────────────────────┐
┌─>│ timers │
│ └─────────────┬─────────────┘
│ ┌─────────────┴─────────────┐
│ │ pending callbacks │
│ └─────────────┬─────────────┘
│ ┌─────────────┴─────────────┐
│ │ idle, prepare │
│ └─────────────┬─────────────┘ ┌───────────────┐
│ ┌─────────────┴─────────────┐ │ incoming: │
│ │ poll │<─────┤ connections, │
│ └─────────────┬─────────────┘ │ data, etc. │
│ ┌─────────────┴─────────────┐ └───────────────┘
│ │ check │
│ └─────────────┬─────────────┘
│ ┌─────────────┴─────────────┐
└──┤ close callbacks │
└───────────────────────────┘
```

> Кожны блок дыяграмы далей будзе называецца "фазай" цыкла падзей.
Expand Down Expand Up @@ -153,13 +155,15 @@ setImmediate(() => {
});
```

$ node timeout_vs_immediate.js
timeout
immediate
```
$ node timeout_vs_immediate.js
timeout
immediate
$ node timeout_vs_immediate.js
immediate
timeout
$ node timeout_vs_immediate.js
immediate
timeout
```

Аднак, калі вы перамесціце два выклікі ў цыкл уводу-вываду, неадкладная (immediate) callback-функцыя заўсёды будзе выконвацца першай:

Expand All @@ -177,13 +181,15 @@ fs.readFile(__filename, () => {
});
```

$ node timeout_vs_immediate.js
immediate
timeout
```
$ node timeout_vs_immediate.js
immediate
timeout
$ node timeout_vs_immediate.js
immediate
timeout
$ node timeout_vs_immediate.js
immediate
timeout
```

Асноўная перавага выкарыстання функцыі `setImmediate()` над функцыяй `setTimeout()` заключаецца ў тым, што функцыя `setImmediate()` заўсёды будзе выконвацца перад таймерамі, калі яна запланавана ўнутры цыкла ўводу-вывыду, незалежна ад колькасці таймераў.

Expand Down
35 changes: 6 additions & 29 deletions pages/ca/about/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,7 @@ trademark: Trademark

# Sobre Node.js®

Nascut com a un entorn d'execució de JavaScript orientat a esdeveniments asíncrons, Node.js està
dissenyat per a crear aplicacions en xarxa de manera escalable. En la següent aplicació d'exemple
"hola món", es pot manegar moltes connexions concurrents. Per a cada connexió el callback serà
executat, no obstant si no hi hagués tasques pendents per a fer, Node.js romandrà adormit.
Nascut com a un entorn d'execució de JavaScript orientat a esdeveniments asíncrons, Node.js està dissenyat per a crear aplicacions en xarxa de manera escalable. En la següent aplicació d'exemple "hola món", es pot manegar moltes connexions concurrents. Per a cada connexió el callback serà executat, no obstant si no hi hagués tasques pendents per a fer, Node.js romandrà adormit.

```javascript
const http = require('http');
Expand All @@ -28,37 +25,17 @@ server.listen(port, hostname, () => {
});
```

Això contrasta amb el model de concurrència més comú d'avui dia, o es fan servir els
fils del Sistema Operatiu. Les operacions en xarxes basades en fils són relativament
ineficients i són molt més complicades de fer servir. A més a més, els usuaris de
Node.js no han d'estar preocupats quant als bloquejos dels processos ja que són
inexistents. Gairebé cap funció en Node.js realitza I/O directament, d'aquesta manera
el procés mai és bloquejat. A raó de què no hi ha bloquejos, és més raonable desenvolupar
sistemes escalables en Node.js.
Això contrasta amb el model de concurrència més comú d'avui dia, o es fan servir els fils del Sistema Operatiu. Les operacions en xarxes basades en fils són relativament ineficients i són molt més complicades de fer servir. A més a més, els usuaris de Node.js no han d'estar preocupats quant als bloquejos dels processos ja que són inexistents. Gairebé cap funció en Node.js realitza I/O directament, d'aquesta manera el procés mai és bloquejat. A raó de què no hi ha bloquejos, és més raonable desenvolupar sistemes escalables en Node.js.

Si cap d'aquests termes no li és familiar, hi ha un article complet en
[Blocking vs Non-Blocking][].
Si cap d'aquests termes no li és familiar, hi ha un article complet en [Blocking vs Non-Blocking][].

---

Node té un disseny similar i està influenciat per sistemes com [Event Machine][]
de Ruby o [Twisted][] de Python. Node porta el model d'esdeveniments una mica
més enllà, aquest presenta un [bucle d'esdeveniments][] com un entorn en comptes d'una llibreria.
En altres sistemes sempre existeix una trucada que bloqueja per iniciar el bucle d'esdeveniments.
El comportament és típicament definit a través de _callbacks_ a l'inici del script i al final
s'inicia el servidor mitjançant una trucada de bloqueig com `EventMachine::run()`. En Node no
existeix aquesta trucada. Node simplement ingressa el bucle d'esdeveniments després d'executar
el script d'entrada. Node surt del bucle d'esdeveniments quan no hi ha més _callbacks_ que executar.
s comporta d'una forma similar a JavaScript al navegador - el bucle d'esdeveniments està ocult a l'usuari.
Node té un disseny similar i està influenciat per sistemes com [Event Machine][] de Ruby o [Twisted][] de Python. Node porta el model d'esdeveniments una mica més enllà, aquest presenta un [bucle d'esdeveniments][] com un entorn en comptes d'una llibreria. En altres sistemes sempre existeix una trucada que bloqueja per iniciar el bucle d'esdeveniments. El comportament és típicament definit a través de _callbacks_ a l'inici del script i al final s'inicia el servidor mitjançant una trucada de bloqueig com `EventMachine::run()`. En Node no existeix aquesta trucada. Node simplement ingressa el bucle d'esdeveniments després d'executar el script d'entrada. Node surt del bucle d'esdeveniments quan no hi ha més _callbacks_ que executar. s comporta d'una forma similar a JavaScript al navegador - el bucle d'esdeveniments està ocult a l'usuari.

HTTP es ciutadà de primera classe en Node, disenyat amb operacions de streaming y baixa latència
en ment. Això no fa a Node candidat per ser la base d'una llibrería o un framework web.
HTTP es ciutadà de primera classe en Node, disenyat amb operacions de streaming y baixa latència en ment. Això no fa a Node candidat per ser la base d'una llibrería o un framework web.

Solament perquè Node està dissenyat sense fils, no significa que vostè no pot aprofitar els
múltiples cores del seu sistema. Processos fills poden ser llençats usant la nostra API
[`child_process.fork()`][], la qual està dissenyada per comunicar-se fàcilment amb el procés
principal. Construïda sobre la mateixa interfície està el mòdul [`cluster`][], el qual permet
compartir sockets entre processos per activar el balanceig de càrregues en els seus múltiples cores.
Solament perquè Node està dissenyat sense fils, no significa que vostè no pot aprofitar els múltiples cores del seu sistema. Processos fills poden ser llençats usant la nostra API [`child_process.fork()`][], la qual està dissenyada per comunicar-se fàcilment amb el procés principal. Construïda sobre la mateixa interfície està el mòdul [`cluster`][], el qual permet compartir sockets entre processos per activar el balanceig de càrregues en els seus múltiples cores.

[Blocking vs Non-Blocking]: https://nodejs.org/ca/docs/guides/blocking-vs-non-blocking/
[`child_process.fork()`]: https://nodejs.org/api/child_process.html#child_process_child_process_fork_modulepath_args_options
Expand Down
4 changes: 1 addition & 3 deletions pages/de/download/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,7 @@ downloads:
additional:
headline: Weitere Plattformen
intro: >
Mitglieder der Node.js Community pflegen inoffizielle, gebaute Versionen von Node.js für weitere Plattformen. Beachte, dass
solche Versionen nicht vom Node.js-Kernteam unterstützt werden und daher eventuell noch nicht auf dem selben Level wie die
aktuelle Node.js-Version sind.
Mitglieder der Node.js Community pflegen inoffizielle, gebaute Versionen von Node.js für weitere Plattformen. Beachte, dass solche Versionen nicht vom Node.js-Kernteam unterstützt werden und daher eventuell noch nicht auf dem selben Level wie die aktuelle Node.js-Version sind.
platform: Plattform
provider: Anbieter
SmartOSBinaries: SmartOS Binaries
Expand Down
3 changes: 1 addition & 2 deletions pages/es/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,5 +15,4 @@ labels:
version-schedule-prompt-link-text: Programa de soporte a largo plazo (LTS)
---

Node.js® es un entorno de ejecución para JavaScript construido con [V8, motor
de JavaScript de Chrome](https://v8.dev/).
Node.js® es un entorno de ejecución para JavaScript construido con [V8, motor de JavaScript de Chrome](https://v8.dev/).
Loading

0 comments on commit 8b4f698

Please sign in to comment.