diff --git a/i18n/locales/fr.json b/i18n/locales/fr.json new file mode 100644 index 0000000000000..8160a9b407efb --- /dev/null +++ b/i18n/locales/fr.json @@ -0,0 +1,300 @@ +{ + "components": { + "containers": { + "footer": { + "links": { + "trademarkPolicy": "Politique de Marque", + "privacyPolicy": "Politique de confidentialité", + "codeOfConduct": "Code de conduite", + "security": "Politique de sécurité", + "openJS": "OpenJS Foundation" + } + }, + "navBar": { + "links": { + "about": "À propos", + "download": "Téléchargement", + "docs": "Docs", + "guides": "Guides", + "learn": "Apprendre", + "security": "Sécurité", + "certification": "Certification", + "blog": "Blog" + } + } + }, + "navigation": { + "learn": { + "gettingStarted": { + "links": { + "gettingStarted": "Bien démarrer", + "introductionToNodejs": "Introduction à Node.js", + "howToInstallNodejs": "Comment installer Node.js", + "howMuchJavascriptDoYouNeedToKnowToUseNodejs": "À quel point avez-vous besoin de connaître JavaScript pour savoir utiliser Node.js ?", + "differencesBetweenNodejsAndTheBrowser": "Différences entre Node.js et le navigateur", + "theV8JavascriptEngine": "Le moteur JavaScript V8", + "anIntroductionToTheNpmPackageManager": "Une introduction au gestionnaire de paquets npm", + "ecmascript2015Es6AndBeyond": "ECMAScript 2015 (ES6) et au-delà", + "nodejsTheDifferenceBetweenDevelopmentAndProduction": "Node.js, la différence entre le développement et la production", + "nodejsWithTypescript": "Node.js avec TypeScript", + "nodejsWithWebassembly": "Node.js avec WebAssembly", + "debugging": "Débogage de Node.js", + "profiling": "Profilage des applications Node.js", + "securityBestPractices": "Meilleures pratiques de sécurité" + } + }, + "asynchronousWork": { + "links": { + "asynchronousWork": "Travail asynchrone", + "asynchronousFlowControl": "Contrôle de l'exécution asynchrone", + "overviewOfBlockingVsNonBlocking": "Vue d'ensemble des opérations bloquantes vs non bloquantes", + "javascriptAsynchronousProgrammingAndCallbacks": "Programmation asynchrone en JavaScript et Callbacks", + "discoverJavascriptTimers": "Découvrez les minuteurs JavaScript", + "eventLoopTimersAndNexttick": "La boucle d'évènement Node.js", + "theNodejsEventEmitter": "L'émetteur d'événement Node.js", + "understandingProcessnexttick": "Comprendre process.nextTick()", + "understandingSetimmediate": "Comprendre setImmediate()", + "dontBlockTheEventLoop": "Ne bloquez pas la boucle d'événement" + } + }, + "manipulatingFiles": { + "links": { + "manipulatingFiles": "Manipuler des fichiers", + "nodejsFileStats": "Attributs de fichier Node.js", + "nodejsFilePaths": "Chemins d'accès aux fichiers avec Node.js", + "workingWithFileDescriptorsInNodejs": "Travailler avec des descripteurs de fichiers dans Node.js", + "readingFilesWithNodejs": "Lire des fichiers avec Node.js", + "writingFilesWithNodejs": "Écrire des fichiers avec Node.js", + "workingWithFoldersInNodejs": "Travailler avec des dossiers dans Node.js", + "workingWithDifferentFilesystems": "Comment travailler avec différents systèmes de fichiers" + } + }, + "commandLine": { + "links": { + "commandLine": "Ligne de commande", + "runNodejsScriptsFromTheCommandLine": "Exécuter les scripts Node.js en ligne de commande", + "howToReadEnvironmentVariablesFromNodejs": "Comment lire les variables d'environnement de Node.js", + "howToUseTheNodejsRepl": "Comment utiliser le REPL Node.js", + "outputToTheCommandLineUsingNodejs": "Sortie vers la ligne de commande avec Node.js", + "acceptInputFromTheCommandLineInNodejs": "Accepter des données provenant de la ligne de commande dans Node.js" + } + }, + "modules": { + "links": { + "modules": "Modules", + "publishingNodeApiModules": "Comment publier le paquet N-API", + "anatomyOfAnHttpTransaction": "Anatomie d'une transaction HTTP", + "abiStability": "Stabilité de l'ABI", + "backpressuringInStreams": "La contre-pression dans Streams" + } + }, + "diagnostics": { + "links": { + "diagnostics": "Diagnostique", + "userJourney": "Parcours de l'utilisateur", + "memory": "Mémoire", + "liveDebugging": "Débogage en direct", + "poorPerformance": "Live debugging", + "flameGraphs": "Flame Graphs" + } + }, + "testRunner": { + "links": { + "testRunner": "Exécuteur de test", + "introduction": "Découverte de l'exécuteur de tests de Node.js", + "usingTestRunner": "Utilisation de l'exécuteur de tests de Node.js" + } + } + }, + "about": { + "links": { + "about": "À propos de Node.js", + "aboutSide": "À propos de Node.js®", + "branding": "L'image de marque de Node.js", + "governance": "Gouvernance du Projet", + "releases": "Versions de Node.js", + "security": "Rapport de sécurité" + } + }, + "getInvolved": { + "links": { + "getInvolved": "S’impliquer", + "collabSummit": "Sommet des Collaborateurs", + "upcomingEvents": "Événements à venir", + "contribute": "Contribuer à Node.js", + "codeOfConduct": "Code de conduite" + } + } + }, + "downloadList": { + "links": { + "previousReleases": "Versions de Node.js", + "packageManager": "Installer Node.js via le gestionnaire de paquets", + "shaSums": { + "title": "SHASUMS signés pour les fichiers des versions", + "howToVerify": " (Comment vérifier)" + }, + "allDownloads": "Toutes les options de téléchargement", + "nightlyReleases": "Versions quotidiennes", + "unofficialBuilds": "Constructions non officielles", + "buildingFromSource": "Compiler Node.js à partir du code source sur les systèmes d'exploitation maintenus", + "installingOnLinux": "Installation de Node.js via une archive binaire", + "installingOnWsl": "Installation sur le sous-système Windows pour Linux (WSL)" + } + }, + "downloadReleasesTable": { + "changelog": "Journal de modifications", + "releases": "Sorties", + "docs": "Docs" + }, + "pagination": { + "next": "Suivant", + "previous": "Précédent" + }, + "common": { + "breadcrumbs": { + "navigateToHome": "Naviguer à l'accueil" + }, + "crossLink": { + "previous": "Préc.", + "next": "Suiv." + }, + "codebox": { + "copy": "Copier dans le Presse-papier", + "copied": "Copié dans le presse-papiers!" + }, + "pagination": { + "prev": "Précédent", + "prevAriaLabel": "Page précédente", + "next": "Suivant", + "nextAriaLabel": "Page suivante", + "defaultLabel": "Pagination", + "pageLabel": "Aller à la page {pageNumber}" + }, + "sidebar": { + "title": "Changer de page" + }, + "languageDropdown": { + "label": "Choisir la langue" + }, + "themeToggle": { + "label": "Basculer en mode sombre" + } + }, + "mdx": { + "upcomingEvents": { + "defaultTitle": "Aucun événement à venir" + } + }, + "metabar": { + "lastUpdated": "Dernière Mise à jour", + "readingTime": "Temps de Lecture", + "addedIn": "Ajouté dans", + "author": "Auteur", + "authors": "Auteurs", + "contribute": "Contribuer", + "contributeText": "Éditer cette page", + "viewAs": "Afficher en tant que", + "tableOfContents": "Table des matières" + }, + "downloads": { + "changelogModal": { + "startContributing": "Commencer à contribuer" + } + }, + "search": { + "searchBox": { + "placeholder": "Commencer à écrire..." + }, + "seeAll": { + "text": "Voir les {count} résultats" + }, + "searchError": { + "text": "Une erreur est survenue lors de la recherche. Veuillez réessayer plus tard." + }, + "poweredBy": { + "text": "Propulsé par" + }, + "noResults": { + "text": "Aucun résultat trouvé pour \"{query}\"." + }, + "emptyState": { + "text": "Chercher quelque chose..." + }, + "searchPage": { + "title": "Vous recherchez : {query}" + } + }, + "blog": { + "blogHeader": { + "subtitle": "Les dernières nouvelles de Node.js, des études de cas, des tutoriels et des ressources.", + "rssLink": "Flux RSS" + } + } + }, + "layouts": { + "blogPost": { + "author": { + "byLine": "{author, select, null {} other {Par {author}, }}" + } + }, + "blogIndex": { + "categoryName": "{category, select, all {Blog} other {{category} Blog posts}}" + }, + "blog": { + "title": "Blog", + "selectCategory": "Catégories", + "categories": { + "all": "Toutes les catégories", + "announcements": "Annonces", + "release": "Sorties", + "vulnerability": "Vulnérabilités", + "advisory-board": "Conseil consultatif", + "community": "Communauté", + "feature": "Fonctionalité", + "module": "Module", + "npm": "npm", + "uncategorized": "Sans catégorie", + "video": "Vidéo", + "weekly": "Mises à jour hebdomadaire", + "wg": "Groupes de travail", + "events": "Événements" + } + }, + "error": { + "notFound": { + "title": "Nous n'avons pas trouvé cette page.", + "description": "Désolé, nous n'avons pas trouvé la page que vous cherchez ! Essayez de recommencer à partir de la page d'accueil." + }, + "internalServerError": { + "title": "Erreur interne du serveur", + "description": "Cette page a généré une erreur irrécupérable." + }, + "backToHome": "Retourner à l'accueil" + }, + "download": { + "selectCategory": "Catégories", + "categories": { + "prebuilt-installer": "Installateur préconstruit", + "prebuilt-binaries": "Binaires préconstruits", + "package-manager": "Gestionnaire de paquets", + "source-code": "Code source" + }, + "buttons": { + "prebuilt": "Télécharger Node.js {version}", + "source": "Télécharger les sources de Node.js {version}" + }, + "dropdown": { + "bitness": "Bitness", + "os": "Système d'exploitation", + "version": "Version", + "platform": "Plateforme" + }, + "codeBox": { + "systemManagerWarning": "n'est pas un gestionnaire de paquets Node.js. Veuillez vous assurer que {packageManager} est déjà installé.", + "communityWarning": "Les gestionnaires de paquets et leurs scripts d'installation ne sont pas maintenus par le projet Node.js.", + "communityWarningReport": "Si vous rencontrez des problèmes, veuillez contacter les responsables du gestionnaire de paquets." + } + } + } +} diff --git a/package-lock.json b/package-lock.json index ea7808c13237f..6cd0e34e10c85 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,9 +1,10 @@ { - "name": "nodejs.org", + "name": "@nodejs/website", "lockfileVersion": 3, "requires": true, "packages": { "": { + "name": "@nodejs/website", "license": "MIT", "dependencies": { "@heroicons/react": "~2.1.1", diff --git a/pages/fa/about/branding.mdx b/pages/fa/about/branding.mdx new file mode 100644 index 0000000000000..f32e9d8e175f0 --- /dev/null +++ b/pages/fa/about/branding.mdx @@ -0,0 +1,72 @@ +--- +title: برندسازی Node.js +layout: about +--- + +برندسازی Node.js + +لطفاً [سیاست علامت تجاری](https://trademark-policy.openjsf.org/) را بررسی کنید برای اطلاعات درباره استفاده مجاز از لوگوها و نشان‌های Node.js®‎. + +## Node.js® Mascot + +Node.js mascot + +## لوگو Node.js®‎ + +### لوگوی افقی Node.js®‎ + + + + + + + +
+ Node.js Dark Horizontal Logo + + Node.js Light Horizontal Logo +
+ +### لوگو تراکم‌یافته Node.js®‎ + + + + + + + + + + + + + +
+ لوگو تراکم‌یافته تاریک Node.js + + لوگو تراکم‌یافته روشن Node.js +
+ لوگو تراکم‌یافته تاریک Node.js + + لوگو تراکم‌یافته سفید Node.js +
+ +### نمادهای JS + + + + + + + +
+ نمادهای JS سبز + + آیکون‌های JS سفید +
diff --git a/pages/fa/about/get-involved/collab-summit.md b/pages/fa/about/get-involved/collab-summit.md new file mode 100644 index 0000000000000..9e9613c9814a9 --- /dev/null +++ b/pages/fa/about/get-involved/collab-summit.md @@ -0,0 +1,16 @@ +--- +title: نشست مشارکت کنندگان (Collab Summit) +layout: about +--- + +# نشست مشارکت کنندگان (Collab Summit) + +نشست مشارکت کنندگان Node.js یک کنفرانس غیررسمی برای گردهم آوردن مشارکت کنندگان فعلی و جدید برای بحث در مورد Node.js همراه با همکاری بصورت زنده، آموزش و اشتراک دانش است. تیم‌ها، گروه‌های کاری و مشارکت‌کنندگان از جامعه دو بار در سال برای بحث‌هایی که در تصمیم‌گیری کمک می‌کنند گرد هم می‌آیند و در عین حال بر روی تلاش‌های هیجان‌انگیزی که می‌خواهند به صورت حضوری پیش ببرند، کار می‌کنند. + +## چه کسانی شرکت می‌کنند؟ + +در کنفرانس همکاری عمدتاً مشارکت‌کنندگان و اعضای جامعه فعلی حضور دارند، اما همچنین از کسانی که هنوز مشارکت‌کننده نیستند و می‌خواهند به تیم بپیوندند نیز استقبال می‌شود. اگر در مشارکت در Node.js تازه وارد هستید، کنفرانس همکاری می‌تواند فرصت خوبی باشد تا به شما کمک کند که بتوانید بفهمید چه اتفاقی در جامعه رخ می‌دهد و با مهارت‌هایی که دارید و دوست دارید بهبود بخشید، مشارکت کنید. + +قبل از برگزاری این نشست، همکاران و اعضای جامعه پیشنهادها جلسه را برای ایجاد یک برنامه زمانی ارسال می کنند. شرکت کنندگان می‌توانند قبل از رسیدن به محل برگزاری، با جلسه آشنا شوند و پس از بحث‌های کلی همکاران، وارد جلسات شوند. همچنین فرصت‌های زیادی برای دنباله‌های محیطی و ایده‌پردازی‌ها وجود خواهد داشت. + +برای اطلاعات درباره نشست‌های آینده و گذشته همکاری، به [Summit repo](https://github.com/openjs-foundation/summit) مراجعه کنید. به [issue های ثبت شده](https://github.com/nodejs/summit/issues) که نشان می‌دهد چه موضوعاتی توسط همکاران و اعضای جامعه برای بحث حضوری پیشنهاد شده‌اند، نگاهی بیندازید. diff --git a/pages/fa/about/get-involved/contribute.md b/pages/fa/about/get-involved/contribute.md new file mode 100644 index 0000000000000..74caf97e3fa43 --- /dev/null +++ b/pages/fa/about/get-involved/contribute.md @@ -0,0 +1,47 @@ +--- +title: مشارکت +layout: about +--- + +# مشارکت + +از علاقه شما برای مشارکت در Node.js متشکریم! راه ها و مکان های مختلفی برای مشارکت وجود دارد و ما اینجا هستیم تا در این زمینه کمک کنیم. + +## درخواست کمک عمومی + +به دلیل سطح بالای فعالیت در مخزن `nodejs/node`، سوالات یا درخواست های کمک عمومی برای استفاده از Node.js باید به [مخزن راهنمای Node.js](https://github.com/nodejs/help/issues) ارسال شود. + +## گزارش مشکل + +اگر فکر می کنید مشکلی در Node.js وجود دارد، لطفاً از ایجاد یک issue در GitHub خودداری نکنید. هنگام ثبت مشکل، مطمئن شوید که می توانید آن را با یک مورد آزمایش قابل تکرار بیان کنید و این مورد آزمایش نباید شامل هیچ وابستگی خارجی باشد. یعنی مورد آزمایش باید بدون هیچ چیز بیشتر از خود Node.js قابل اجرا باشد. + +هنگام گزارش مشکل، ما همچنین به اطلاعات بیشتری در مورد محیط شما نیاز داریم. ما هرگز نمی‌دانیم چه اطلاعاتی برای محدود کردن مشکل نیاز خواهد بود. برای همین لطفاً حداقل اطلاعات زیر را ارائه دهید: + +- نسخه Node.js +- پلتفرمی که روی آن اجرا می‌شود (macOS ، SmartOS ، Linux ، Windows) +- معماری که روی آن اجرا می‌شود (32 بیتی یا 64 بیتی و x86 یا ARM) + +پروژه Node.js در حال حاضر در چندین مخزن جداگانه GitHub مدیریت می شود که هر کدام دارای پایگاه داده مسائل جداگانه خود هستند. در صورت امکان، لطفاً هر مشکلی را که گزارش می‌دهید به مخزن مناسب هدایت کنید، اما نگران نباشید اگر موارد در جای اشتباه قرار گرفتند، جامعه مشارکت‌کنندگان از کمک به شما برای راهنمایی در جهت درست خوشحال خواهند شد. + +- برای گزارش مشکلات مربوط به Node.js، لطفاً از [nodejs/node](https://github.com/nodejs/node) استفاده کنید +- برای گزارش مشکلات مربوط به این وب سایت، لطفاً از [nodejs/nodejs.org](https://github.com/nodejs/nodejs.org/issues) استفاده کنید + +## مشارکت در کد + +اگر می خواهید اشکالات را برطرف کنید یا ویژگی جدیدی به Node.js اضافه کنید، لطفاً مطمئن شوید که [راهنمای مشارکت Node.js](https://github.com/nodejs/node/blob/main/CONTRIBUTING.md/#pull-requests) را مطالعه کرده اید. روند بازبینی برای تمام مشارکت ها به پروژه توسط همکاران موجود در آنجا توضیح داده شده است. + +اگر می خواهید بدانید چگونه شروع کنید، می توانید [Node Todo](https://www.nodetodo.org/) را بررسی کنید که ممکن است شما را به سمت اولین مشارکت خود راهنمایی کند. + +## تبدیل شدن به یک همکار (مشارکت کننده) + +با تبدیل شدن به همکار، مشارکت کنندگان می توانند تأثیر بیشتری بر روی پروژه داشته باشند. آنها می توانند با بازبینی مشارکت های دیگران، رده بندی مشکلات و ایفای نقش بزرگتری در شکل دادن به آینده پروژه، به سایر مشارکت کنندگان کمک کنند. افرادی که توسط TSC به عنوان ارائه دهندگان مشارکت های قابل توجه و ارزشمند در هر مخزن Node.js شناسایی می شوند، ممکن است به عنوان همکار انتخاب شده و دسترسی commit به پروژه به آنها داده شود. فعالیت هایی که در نظر گرفته می شوند شامل (اما نه محدود به) کیفیت موارد زیر است: + +- commits بر روی code و ارسال pull request +- commit بر روی مستندات و ارسال pull request ها +- کامنت بر روی issue ها و pull request ها +- مشارکت در وب سایت Node.js +- کمک ارائه شده به کاربران نهایی و مشارکت کنندگان تازه‌کار +- مشارکت در گروه های کاری +- سایر مشارکت‌ها در جامعه گسترده‌تر Node.js + +اگر افرادی که مشارکت های ارزشمندی دارند، احساس می کنند برای دسترسی commit در نظر گرفته نشده اند، می توانند [یک issue ایجاد کنند](https://github.com/nodejs/TSC/issues) یا مستقیماً با [یک عضو TSC تماس بگیرند](https://github.com/nodejs/node#tsc-technical-steering-committee). diff --git a/pages/fa/about/get-involved/events.mdx b/pages/fa/about/get-involved/events.mdx new file mode 100644 index 0000000000000..3271e2078b335 --- /dev/null +++ b/pages/fa/about/get-involved/events.mdx @@ -0,0 +1,16 @@ +--- +title: رویدادهای آینده +layout: about +--- + +## رویدادهای آینده + +رویدادهای Node.js برای عموم باز و در دسترس هستند. هر کسی می‌تواند در آنها شرکت کند و مشارکت داشته باشد. + +### جلسات آینده Node.js®‎ + +پروژه Node.js طی سال جلسات متعددی را برای بحث و برنامه‌ریزی جنبه‌های مختلف پروژه برگزار می‌کند. + +جلسات زیر در 7 روز آینده برگزار می‌شوند. + + diff --git a/pages/fa/about/get-involved/index.md b/pages/fa/about/get-involved/index.md new file mode 100644 index 0000000000000..c7d1ef3eb8a72 --- /dev/null +++ b/pages/fa/about/get-involved/index.md @@ -0,0 +1,26 @@ +--- +title: مشارکت کنید +layout: about +--- + +# مشارکت کنید + +## گفتگوی جامعه + +- [لیست issue ها در گیت‌هاب](https://github.com/nodejs/node/issues) محل بحث در مورد ویژگی‌های اصلی Node.js است. +- برای گفتگوی لحظه‌ای در مورد توسعه Node.js از یکی از پلتفرم‌های زیر استفاده کنید + - برای IRC، به `irc.libera.chat` در کانال `‎#node.js` با یک [کلاینت IRC](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) بروید یا در مرورگر وب خود به کانال با استفاده از یک [کلاینت تحت وب](https://kiwiirc.com/nextclient/) متصل شوید. + - برای Slack، دو راه وجود دارد: + - [OpenJSF Slack](https://slack-invite.openjsf.org/) یک Slack است که توسط بنیاد اجرا می‌شود با چندین کانال Node.js (کانال‌های با پیشوند `‎#nodejs-‎` مربوط به پروژه هستند). + - [Node Slackers](https://www.nodeslackers.com/) یک جامعه Slack متمرکز بر Node.js است. +- حساب رسمی Node.js در توییتر [nodejs](https://twitter.com/nodejs) است. +- [تقویم پروژه Node.js](https://nodejs.org/calendar) با تمام جلسات عمومی تیم. + +## یادگیری + +- [بخش یادگیری رسمی](https://nodejs.org/en/learn/) وبسایت Node.js. +- [مستندات رسمی API reference](https://nodejs.org/api/). +- [NodeSchool.io](https://nodeschool.io/) مفاهیم Node.js را از طریق بازی‌های تعاملی خط فرمان به شما می‌آموزد. +- [تگ Node.js در Stack Overflow](https://stackoverflow.com/questions/tagged/node.js) هر روز اطلاعات جدیدی را جمع می‌کند. +- [تگ Node.js در جامعه DEV](https://dev.to/t/node) محلی برای اشتراک‌گذاری پروژه‌ها، مقالات و آموزش‌های Node.js و نیز شروع بحث‌ها و درخواست بازخورد در مورد موضوعات مرتبط با Node.js است. توسعه‌دهندگان در تمام سطوح مهارت می‌توانند شرکت کنند. +- [Nodeiflux](https://discordapp.com/invite/vUsrbjd) یک جامعه دوستانه از توسعه‌دهندگان بک‌اند Node.js است که در Discord از یکدیگر پشتیبانی می‌کنند. diff --git a/pages/fa/about/governance.md b/pages/fa/about/governance.md new file mode 100644 index 0000000000000..8b0a5e42793e7 --- /dev/null +++ b/pages/fa/about/governance.md @@ -0,0 +1,31 @@ +--- +title: حاکمیت پروژه +layout: about +--- + +# حاکمیت پروژه + +## توافق جمعی (Consensus Seeking Process) + +پروژه Node.js از مدل تصمیم‌گیری [Consensus Seeking][] پیروی می‌کند. + +## همکاران + +مخزن اصلی گیت‌هاب [nodejs/node][] توسط همکارانی که به صورت مداوم توسط دیگر همکاران موجود نامزد می‌شوند، نگهداری می‌شود. + +افرادی که مشارکت های مهم و ارزشمندی دارند، به عنوان همکار انتخاب می شوند و به آنها دسترسی ارسال (commit) به پروژه داده می شود. این افراد توسط سایر همکاران شناسایی می شوند و پیشنهاد نامزدی آنها با همکاران فعلی در میان گذاشته و مورد بحث قرار می گیرد. + +برای لیست فعلی همکاران، به [README.md][] پروژه مراجعه کنید. + +راهنمای همکاران در [collaborator-guide.md][] نگهداری می شود. + +## کمیته هدایت فنی + +پروژه توسط کمیته هدایت فنی یا همان [Technical Steering Committee (TSC)][] اداره می شود که مسئول هدایت کلان پروژه است. TSC یک زیرمجموعه از همکاران فعال است که توسط سایر اعضای TSC موجود نامزد می‌شوند. + +[consensus seeking]: https://en.wikipedia.org/wiki/Consensus-seeking_decision-making +[readme.md]: https://github.com/nodejs/node/blob/main/README.md#current-project-team-members +[tsc]: https://github.com/nodejs/TSC +[technical steering committee (tsc)]: https://github.com/nodejs/TSC/blob/main/TSC-Charter.md +[collaborator-guide.md]: https://github.com/nodejs/node/blob/main/doc/contributing/collaborator-guide.md +[nodejs/node]: https://github.com/nodejs/node diff --git a/pages/fa/about/index.mdx b/pages/fa/about/index.mdx new file mode 100644 index 0000000000000..1bc8bbe99714b --- /dev/null +++ b/pages/fa/about/index.mdx @@ -0,0 +1,61 @@ +--- +title: Node.js درباره +layout: about +--- + +درباره ®Node.js + +به عنوان یک رانتایم جاوااسکریپتِ غیرهمگام و رویداد محور، Node.js برای ساخت برنامه‌های تحت شبکه مقیاس‌پذیر طراحی شده است. در مثال "سلام دنیا" زیر، کانکشن متعددی می‌توانند به صورت همزمان پردازش شوند. با هر کانکشن، callback فراخوانی می‌شود، اما اگر کاری برای انجام وجود نداشته باشد، Node.js به حالت خواب می‌رود. + +```cjs +const { createServer } = require('node:http'); + +const hostname = '127.0.0.1'; +const port = 3000; + +const server = createServer((req, res) => { + res.statusCode = 200; + res.setHeader('Content-Type', 'text/plain'); + res.end('Hello World'); +}); + +server.listen(port, hostname, () => { + console.log(`Server running at http://${hostname}:${port}/`); +}); +``` + +```mjs +import { createServer } from 'node:http'; + +const hostname = '127.0.0.1'; +const port = 3000; + +const server = createServer((req, res) => { + res.statusCode = 200; + res.setHeader('Content-Type', 'text/plain'); + res.end('Hello World'); +}); + +server.listen(port, hostname, () => { + console.log(`Server running at http://${hostname}:${port}/`); +}); +``` + +این برخلاف مدل رایج‌تر همزمانی امروزی است، که در آن از Theradهای سیستم‌عامل استفاده می‌شود. شبکه مبتنی بر Therad نسبتاً ناکارآمد و بسیار دشوار برای استفاده است. علاوه بر این، کاربران Node.js نگران قفل شدن فرایند نیستند، زیرا قفلی وجود ندارد. تقریباً هیچ فانکشنی در Node.js مستقیماً I/O را انجام نمی‌دهد، بنابراین فرایند هرگز بلوکه نمی‌شود مگر زمانی که I/O با استفاده از روش‌های همگام از کتابخانه استاندارد Node.js انجام شود. از آنجایی که چیزی بلوکه نمی‌شود، پیاده سازی سیستم‌های مقیاس‌پذیر در Node.js بسیار منطقی است. + +اگر برخی از این اصطلاحات برایتان جدید است، می‌توانید مقاله کاملی را در مورد [Blocking vs. Non-Blocking][] مطالعه کنید. + +--- + +Node.js در طراحی خود شبیه به سیستم‌هایی مانند [Event Machine][] در Ruby و [Twisted][] در Python است و از آنها الهام گرفته است. Node.js مدل رویداد را یک گام جلوتر می‌برد. حلقه رویداد را به عنوان یک ساختار زمان اجرا و نه یک کتابخانه ارائه می‌دهد. در سایر سیستم‌ها، همیشه یک blocking call برای شروع حلقه رویداد وجود دارد. +معمولاً رفتار از طریق callback‌ها در ابتدای اسکریپت تعریف می‌شود، و در انتها یک سرور از طریق یک blocking call مانند `EventMachine::run()‎` راه‌اندازی می‌شود. در Node.js چنین تماسی برای شروع حلقه رویداد وجود ندارد. Node.js پس از اجرای اسکریپت ورودی، به طور ساده وارد حلقه رویداد می‌شود. Node.js زمانی از حلقه رویداد خارج می‌شود که دیگر callback‌یی برای اجرا وجود نداشته باشد. این رفتار شبیه جاوااسکریپت مرورگر است - حلقه رویداد از کاربر پنهان است. + +HTTP در Node.js از جایگاه ویژه‌ای برخوردار است و با در نظر گرفتن استریمینگ و کاهش تاخیر طراحی شده است. این ویژگی باعث می‌شود Node.js برای پایه‌گذاری یک کتابخانه یا فریمورک وب مناسب باشد. + +اگرچه Node.js بدون استفاده از threadها طراحی شده است، اما این به این معنی نیست که نمی‌توانید از چندهسته‌ای بودن محیط خود بهره ببرید. می‌توانید فرایندهای فرزند را با استفاده از API مربوط به خود یعنی [`child_process.fork()‎`][] ایجاد کنید و به گونه ای طراحی شده اند که برقراری ارتباط با آنها آسان باشد. بر پایه همان رابط، ماژول [`cluster`][] نیز بنا شده که به شما امکان می‌دهد سوکت‌ها را بین فرایندها به اشتراک بگذارید تا بتوانید بار را بر روی هسته‌های خود متعادل کنید. + +[blocking vs. non-blocking]: /learn/asynchronous-work/overview-of-blocking-vs-non-blocking +[`child_process.fork()‎`]: https://nodejs.org/api/child_process.html +[`cluster`]: https://nodejs.org/api/cluster.html +[event machine]: https://github.com/eventmachine/eventmachine +[twisted]: https://twisted.org/ diff --git a/pages/fa/about/previous-releases.mdx b/pages/fa/about/previous-releases.mdx new file mode 100644 index 0000000000000..90e1f48e38c8a --- /dev/null +++ b/pages/fa/about/previous-releases.mdx @@ -0,0 +1,21 @@ +--- +title: انتشارهای Node.js +layout: about +--- + +انتشارهای Node.js + +نسخه‌های اصلی Node.js برای شش ماه وضعیت انتشار _Current_ را پیدا می‌کنند که به نویسندگان کتابخانه ها زمان می‌دهد تا پشتیبانی از آنها را اضافه کنند. +پس از شش ماه، انتشارهای با شماره فرد (11، 9 و غیره) پشتیبانی نمی‌شوند و انتشارهای با شماره زوج (12، 10 و غیره) به وضعیت _Active LTS_ منتقل می‌شوند و برای استفاده عمومی آماده هستند. +وضعیت انتشار LTS به معنای "پشتیبانی طولانی مدت" است که معمولاً تضمین می‌کند باگ‌های بحرانی در مجموع برای 30 ماه برطرف خواهند شد. +برنامه‌های پروداکشن تنها باید از انتشارهای _Active LTS_ یا _Maintenance LTS_ استفاده کنند. + +## برنامه زمانبندی انتشار + +![Releases](https://raw.githubusercontent.com/nodejs/Release/main/schedule.svg?sanitize=true) + +جزئیات کامل در مورد زمانبندی انتشار Node.js در [گیت‌هاب](https://github.com/nodejs/release#release-schedule) موجود است. + +## به دنبال آخرین انتشار از یک برنچ نسخه هستید؟ + + diff --git a/pages/fa/about/security-reporting.mdx b/pages/fa/about/security-reporting.mdx new file mode 100644 index 0000000000000..ab8dafdc590ec --- /dev/null +++ b/pages/fa/about/security-reporting.mdx @@ -0,0 +1,64 @@ +--- +title: گزارش امنیتی +layout: about +--- + +گزارش امنیتی + +برای جزئیات بیشتر در مورد سیاست‌های امنیتی فعال، [این صفحه](https://github.com/nodejs/node/security/policy) را بررسی کنید. + +## گزارش باگ در Node.js + +برای گزارش باگ‌های امنیتی در Node.js از [HackerOne](https://hackerone.com/nodejs) استفاده کنید. + +گزارش شما طی ۵ روز تایید خواهد شد و شما ظرف ۱۰ روز پاسخی با جزئیات بیشتر حاوی مراحل بعدی در بررسی گزارش‌تان را دریافت خواهید کرد. + +پس از پاسخ اولیه به گزارش شما، تیم امنیتی تلاش خواهد کرد تا شما را از پیشرفت‌های صورت گرفته در جهت رفع مشکل و اعلام نهایی آگاه کند، و ممکن است درخواست اطلاعات یا راهنمایی بیشتری در مورد مشکل گزارش شده داشته باشد. + +### برنامه پاداشِ کشف باگ در Node.js + +پروژه Node.js در یک برنامه رسمی پاداش کشف باگ برای محققان امنیتی و افشای مسئولانه در فضای عمومی مشارکت دارد. این برنامه از طریق پلتفرم HackerOne مدیریت می‌شود. برای اطلاعات بیشتر به [https://hackerone.com/nodejs](https://hackerone.com/nodejs) مراجعه کنید. + +## گزارش باگ در ماژول شخص‌ثالث + +باگ‌های امنیتی در ماژول‌های شخص ثالث باید به نگهدارندگان مربوطه گزارش شوند. + +## سیاست افشاگری + +سیاست افشاگری امنیتی برای Node.js : + +گزارش امنیتی دریافت و یک کنترل کننده اصلی به آن اختصاص داده می‌شود. این شخص فرایند رفع مشکل و انتشار را هماهنگ می‌کند. مشکل تایید و لیستی از تمام نسخه‌های تاثیرپذیر تعیین می‌شود. کد برای یافتن هرگونه مشکل مشابه بالقوه دیگر بررسی می‌شود. رفع‌ها برای تمام نسخه‌هایی که هنوز تحت پشتیبانی هستند آماده می‌شوند. این رفع‌ها به مخزن عمومی ارسال نمی‌شوند بلکه به صورت محلی نگهداری می‌شوند تا زمان اعلام فرا برسد. + +یک تاریخ محرمانگی پیشنهادی برای این آسیب‌پذیری انتخاب می‌شود و یک CVE (آسیب‌پذیری‌ها و مواجهه‌های رایج مشترک) برای آسیب‌پذیری درخواست می‌شود. + +در تاریخ محرمانگی، کپی اطلاعیه به لیست ایمیل امنیتی Node.js ارسال می‌شود. تغییرات به مخزن عمومی ارسال و نسخه‌های جدید در nodejs.org منتشر می‌شوند. در عرض 6 ساعت از اطلاع‌رسانی به لیست ایمیل، کپی‌ای از اطلاعیه در بلاگ Node.js منتشر خواهد شد. + +معمولاً تاریخ محرمانگی 72 ساعت پس از صدور CVE تنظیم می‌شود. با این حال، ممکن است بر اساس شدت باگ یا دشواری در اعمال رفع تغییر کند. + +این فرایند ممکن است زمانبر باشد، به ویژه زمانی که هماهنگی با نگهدارندگان پروژه‌های دیگر نیز مورد نیاز باشد. تلاش خواهد شد تا باگ در سریع‌ترین زمان ممکن برطرف شود؛ با این حال، مهم است که ما از فرایند انتشار بالا پیروی کنیم تا اطمینان حاصل شود که افشاگری به شیوه‌ای یکپارچه انجام می‌شود. + +## دریافت به‌روزرسانی‌های امنیتی + +اطلاعیه‌های امنیتی از طریق روش‌های زیر توزیع خواهند شد: + +[گروه گوگل](https://groups.google.com/group/nodejs-sec) +[بلاگ Node.js](/blog) + +## نظرات درباره این سیاست + +اگر پیشنهادی برای بهبود این فرایند دارید، لطفاً یک [pull request](https://github.com/nodejs/nodejs.org) ارسال کنید یا یک [issue جدید](https://github.com/nodejs/security-wg/issues/new) ایجاد نمایید تا آن را بررسی کنیم. + +## رویه‌های بهینه OpenSSF + + + نشان OpenSSF + + +[نشان بهترین شیوه ها](https://github.com/coreinfrastructure/best-practices-badge) بنیاد امنیت متن باز (OpenSSF) راهی است برای پروژه‌های نرم‌افزار آزاد/رایگان و متن باز (FLOSS) تا نشان دهند که از رویه‌های بهینه پیروی می‌کنند. پروژه‌ها می‌توانند به صورت داوطلبانه خود تأیید کنند که چگونه از هر رویه بهینه پیروی می‌کنند. مصرف‌کنندگان این نشان می‌توانند به سرعت ارزیابی کنند که کدام پروژه‌های FLOSS از رویه‌های بهینه پیروی می‌کنند و در نتیجه احتمال بیشتری دارد که نرم‌افزارهای امن با کیفیت بالاتر تولید کنند. diff --git a/pages/fa/download/package-manager/all.md b/pages/fa/download/package-manager/all.md new file mode 100644 index 0000000000000..5192b8847d665 --- /dev/null +++ b/pages/fa/download/package-manager/all.md @@ -0,0 +1,422 @@ +--- +layout: download +title: از طریق پکیج منیجر Node.js نصب +--- + +# نصب Node.js از طریق پکیج منیجر + +> پکیج‌های این صفحه توسط پکیج منیجر های مربوطه نگهداری و پشتیبانی می‌شوند، **نه** توسط تیم هسته Node.js. لطفاً اگر به هرگونه مشکلی برخوردید آن را به نگه دارنده پکیج گزارش دهید. اگر مشکل شما یک باگ در خود Node.js باشد، نگه دارنده آن را به مرجع اصلی گزارش خواهد داد. + +--- + +- [Alpine Linux](#alpine-linux) +- [Android](#android) +- [Arch Linux](#arch-linux) +- [CentOS, Fedora and Red Hat Enterprise Linux](#centos-fedora-and-red-hat-enterprise-linux) +- [Debian and Ubuntu based Linux distributions](#debian-and-ubuntu-based-linux-distributions) +- [Exherbo Linux](#exherbo-linux) +- [fnm](#fnm) +- [FreeBSD](#freebsd) +- [Gentoo](#gentoo) +- [IBM i](#ibm-i) +- [macOS](#macos) +- [n](#n) +- [NetBSD](#netbsd) +- [Nodenv](#nodenv) +- [nvm](#nvm) +- [nvs](#nvs) +- [OpenBSD](#openbsd) +- [openSUSE and SLE](#opensuse-and-sle) +- [SmartOS and illumos](#smartos-and-illumos) +- [Snap](#snap) +- [Solus](#solus) +- [vfox](#vfox) +- [Void Linux](#void-linux) +- [Windows](#windows-1) +- [z/OS](#zos) + +--- + +## Alpine Linux + +بسته‌های Node.js LTS و npm در مخزن اصلی موجود هستند. + +```bash +apk add nodejs npm +``` + +Node.js Current نیز می‌تواند از مخزن کامیونیتی نصب شود. + +```bash +apk add nodejs-current +``` + +## Android + +پشتیبانی از اندروید در Node.js هنوز در مرحله آزمایشی است، بنابراین باینری‌های از پیش کامپایل شده هنوز توسط توسعه دهندگان Node.js ارائه نشده‌اند. + +با این حال، برخی راه حل‌های شخص ثالث وجود دارند. به عنوان مثال، کامیونیتی [Termux](https://termux.com/) یک شبیه‌ساز ترمینال و محیط لینوکس برای اندروید، به همراه پکیج منیجر مخصوص و [مجموعه گسترده‌ای](https://github.com/termux/termux-packages) از بسیاری از برنامه‌های از پیش کامپایل شده را ارائه می‌دهد. این دستور در برنامه Termux، آخرین نسخه موجود از Node.js را نصب خواهد کرد: + +```bash +pkg install nodejs +``` + +در حال حاضر، باینری‌های Node.js در Termux به `system-icu` لینک شده‌اند (وابسته به بسته `libicu`). + +## Arch Linux + +بسته‌های Node.js و npm در مخزن کامیونیتی موجود هستند. + +```bash +pacman -S nodejs npm +``` + +## CentOS - Fedora - Red Hat Enterprise Linux + +Node.js در CentOS/RHEL 8 و Fedora به عنوان یک ماژول با نام `nodejs` موجود است. + +```bash +dnf module install nodejs: +``` + +که در آن `` مربوط به نسخه اصلی Node.js است. +برای مشاهده لیست استریم‌های موجود: + +```bash +dnf module list nodejs +``` + +به عنوان مثال، برای نصب Node.js 18: + +```bash +dnf module install nodejs:18/common +``` + +### جایگزین + +این منابع بسته‌هایی را ارائه می‌کنند که با CentOS ، Fedora و RHEL سازگار هستند. + +- [Node.js snaps](#snap) که در https://github.com/nodejs/snap نگهداری و پشتیبانی می‌شوند. +- [توزیع‌های باینری Node.js](#debian-and-ubuntu-based-linux-distributions) که توسط [NodeSource](https://github.com/nodesource/distributions) نگهداری و پشتیبانی می‌شوند. + +## توزیع‌های لینوکس مبتنی بر Debian و Ubuntu + +[توزیع‌های باینری Node.js](https://github.com/nodesource/distributions) از NodeSource در دسترس هستند. + +### جایگزین + +بسته‌هایی که با توزیع‌های لینوکس مبتنی بر دبیان و اوبونتو سازگار هستند، از طریق [Node.js snaps](#snap) در دسترس می‌باشند. + +## Exherbo Linux + +بسته های Node.js و npm در [مخزن arbor](https://gitlab.exherbo.org/exherbo/arbor/-/tree/master/packages/dev-lang/node) در دسترس است. + +```bash +cave resolve -x node +``` + +## fnm + +مدیر نسخه سریع و ساده Node.js که با Rust ساخته شده است و برای مدیریت نسخه‌های مختلف منتشر شده Node.js استفاده می‌شود. به شما امکان می‌دهد عملیاتی مانند نصب، حذف، تغییر نسخه‌های Node را براساس پوشه فعلی به صورت خودکار انجام دهید و غیره. +برای نصب fnm از این [اسکریپت نصب](https://github.com/Schniz/fnm#using-a-script-macoslinux) استفاده کنید. + +fnm پشتیبانی از پلتفرم‌های متعدد (macOS ، Windows ، Linux) و تمام شل‌های محبوب (Bash ، Zsh ، Fish ، PowerShell ، Windows Command Line Prompt) را دارد. +fnm با تمرکز بر سرعت و پشتیبانی از سازگاری برای فایل‌های `‎.node-version` و `‎.nvmrc` ساخته شده است. + +## FreeBSD + +آخرین نسخه منتشر شده Node.js از طریق [پورت www/node](https://www.freshports.org/www/node) در دسترس است. + +بسته باینری را از طریق [pkg](https://www.freebsd.org/cgi/man.cgi?pkg) نصب کنید: + +```bash +pkg install node +``` + +یا آن را با استفاده از [ports](https://www.freebsd.org/cgi/man.cgi?ports) کامپایل کنید: + +```bash +cd /usr/ports/www/node && make install +``` + +## Gentoo + +Node.js در portage tree موجود است. + +```bash +emerge nodejs +``` + +## IBM i + +نسخه‌های LTS از Node.js در دسترس هستند و از طریق [پکیج منیجر 'yum'](https://ibm.biz/ibmi-rpms) قابل دسترسی می‌باشند. نام بسته `nodejs` به دنبال شماره نسخه اصلی است (به عنوان مثال: `nodejs18` ، `nodejs20` و غیره) + +برای نصب Node.js 20.x از خط فرمان، دستور زیر را به عنوان کاربر با مجوز ویژه ‎\*ALLOBJ اجرا کنید: + +```bash +yum install nodejs20 +``` + +Node.js همچنین می‌تواند با محصول IBM i Access Client Solutions نصب شود. برای جزئیات بیشتر به [این سند پشتیبانی](http://www-01.ibm.com/support/docview.wss?uid=nas8N1022619) مراجعه کنید. + +## macOS + +دانلود مستقیم [نصب‌کننده macOS](/#home-downloadhead) از وب‌سایت [nodejs.org](https://nodejs.org/) + +_اگر می‌خواهید بسته را با bash دانلود کنید:_ + +```bash +curl "https://nodejs.org/dist/latest/$(curl -s https://nodejs.org/dist/latest/ | grep "pkg" | cut -d'"' -f 2)" -o "$HOME/Downloads/node-latest.pkg" && sudo installer -store -pkg "$HOME/Downloads/node-latest.pkg" -target "/" +``` + +### جایگزین + +با استفاده از **[Homebrew](https://brew.sh/)**: + +```bash +brew install node +``` + +با استفاده از **[MacPorts](https://www.macports.org/)**: + +```bash +port install nodejs + +# Example +port install nodejs7 +``` + +با استفاده از **[pkgsrc](https://pkgsrc.joyent.com/install-on-macos/)**: + +نصب بسته باینری: + +```bash +pkgin -y install nodejs +``` + +یا ساخت دستی از pkgsrc: + +```bash +cd pkgsrc/lang/nodejs && bmake install +``` + +## n + +`n` یک مدیر نسخه ساده برای استفاده Node.js برای Mac و Linux است. نسخه مورد نظر برای نصب را مشخص کنید، یا از میان منوی نسخه‌های قبلاً دانلود شده انتخاب نمایید. نسخه‌ها در سطح سیستم یا در سطح کاربر نصب می‌شوند و برای استفاده هدفمندتر می‌توانید نسخه‌ای را مستقیماً از دانلودهای ذخیره شده اجرا کنید. + +برای روش‌های نصب (bootstrap, npm, Homebrew, third-party) و تمام جزئیات استفاده، به [صفحه اصلی](https://github.com/tj/n) مراجعه کنید. + +اگر قبلاً `npm` را داشته باشید، نصب `n` و سپس نسخه LTS جدیدترین `node` به این سادگی است: + +``` +npm install -g n +n lts +``` + +## NetBSD + +Node.js در pkgsrc tree موجود است: + +```bash +cd /usr/pkgsrc/lang/nodejs && make install +``` + +یا یک بسته باینری را نصب کنید (در صورت موجود بودن برای پلتفرم شما) با استفاده از pkgin: + +```bash +pkgin -y install nodejs +``` + +## Nodenv + +`nodenv` یک مدیر نسخه سبک Node، مشابه `nvm` است. ساده و قابل پیش‌بینی است. یک اکوسیستم پلاگین غنی به شما امکان می‌دهد آن را برای تطابق با نیازهایتان سفارشی کنید. از `nodenv` برای انتخاب نسخه Node برای برنامه خود استفاده کنید و اطمینان حاصل کنید که محیط توسعه شما با محیط تولید مطابقت دارد. + +دستورالعمل‌های نصب Nodenv در [صفحه گیت‌هاب آن](https://github.com/nodenv/nodenv#installation) نگهداری می‌شوند. لطفاً به آن صفحه مراجعه کنید تا از آخرین نسخه مراحل نصب پیروی کنید. + +## nvm + +Node Version Manager یک اسکریپت bash است که برای مدیریت نسخه‌های مختلف منتشر شده Node.js استفاده می‌شود. به شما امکان می‌دهد عملیاتی مانند نصب، حذف، تغییر نسخه و غیره را انجام دهید. +برای نصب nvm، از این [اسکریپت نصب](https://github.com/nvm-sh/nvm#install--update-script) استفاده کنید. + +در سیستم‌های Unix / OS X، می‌توانیم Node.js ساخته شده از سورس کد را با استفاده از [nvm](https://github.com/creationix/nvm) در مکانی که nvm انتظار دارد، نصب کنیم: + +```bash +env VERSION=`python tools/getnodeversion.py` make install DESTDIR=`nvm_version_path v$VERSION` PREFIX="" +``` + +پس از این می‌توانید از `nvm` برای سوئیچ بین نسخه‌های منتشر شده و نسخه‌های ساخته شده از سورس کد استفاده کنید. +به عنوان مثال، اگر نسخه Node.js برابر با v8.0.0-pre باشد: + +```bash +nvm use 8 +``` + +هنگامی که نسخه رسمی منتشر شد، باید نسخه ساخته شده از سوررس کد را حذف کنید: + +```bash +nvm uninstall 8 +``` + +## nvs + +#### Windows + +مدیر نسخه `nvs` چندسکویی است و می‌تواند در ویندوز، macOS و سیستم‌های شبیه یونیکس استفاده شود. + +برای نصب `nvs` در ویندوز به [صفحه انتشار](https://github.com/jasongin/nvs/releases) بروید و فایل نصب‌کننده MSI از آخرین نسخه را دانلود کنید. + +همچنین می‌توانید از `chocolatey` برای نصب آن استفاده کنید: + +```bash +choco install nvs +``` + +#### macOS، UnixLike + +می‌توانید مستندات مربوط به مراحل نصب `nvs` در سیستم‌های macOS/Unix-like را [اینجا](https://github.com/jasongin/nvs/blob/master/doc/SETUP.md#mac-linux) پیدا کنید. + +#### استفاده + +پس از این می‌توانید از `nvs` برای تغییر بین نسخه‌های مختلف node استفاده کنید. + +برای اضافه کردن آخرین نسخه از node: + +```bash +nvs add latest +``` + +یا برای اضافه کردن آخرین نسخه LTS از node: + +```bash +nvs add lts +``` + +سپس دستور `nvs use` را اجرا کنید تا یک نسخه از node را به `PATH` برای شل فعلی اضافه کنید: + +```bash +$ nvs use lts +PATH -= %LOCALAPPDATA%\nvs\default +PATH += %LOCALAPPDATA%\nvs\node\14.17.0\x64 +``` + +برای اضافه کردن آن به `PATH` به صورت دائمی، از `nvs link` استفاده کنید: + +```bash +nvs link lts +``` + +## OpenBSD + +Node.js از طریق سیستم پورت‌ها در دسترس است. + +```bash +/usr/ports/lang/node +``` + +با استفاده از [pkg_add](https://man.openbsd.org/OpenBSD-current/man1/pkg_add.1) در OpenBSD: + +```bash +pkg_add node +``` + +## openSUSE و SLE + +Node.js در مخازن اصلی تحت بسته‌های زیر موجود است: + +- `nodejs10` ، `nodejs12` ، `nodejs14` :**openSUSE Leap 15.2** +- - `nodejs20` :**openSUSE Tumbleweed** +- **SUSE Linux Enterprise Server (SLES) 12**: `nodejs10`, `nodejs12`, and `nodejs14` + (باید [ماژول "Web and Scripting"](https://www.suse.com/releasenotes/x86_64/SUSE-SLES/12-SP5/#intro-modulesExtensionsRelated) فعال شود.) +- `nodejs10`، `nodejs12` ، `nodejs14` :**SUSE Linux Enterprise Server (SLES) 15 SP2** + (باید [ماژول "Web and Scripting"](https://www.suse.com/releasenotes/x86_64/SUSE-SLES/15/#Intro.Module) فعال شود.) + +به عنوان مثال، برای نصب Node.js 14.x در openSUSE Leap 15.2، با دسترسی root دستور زیر را اجرا کنید: + +```bash +zypper install nodejs14 +``` + +نسخه‌های مختلف اصلی Node می‌توانند همزمان نصب و استفاده شوند. + +## SmartOS و illumos + +image های SmartOS با pkgsrc از پیش نصب شده ارائه می‌شوند. در توزیع‌های دیگر illumos، ابتدا **[pkgsrc](https://pkgsrc.joyent.com/install-on-illumos/)** را نصب کنید، سپس می‌توانید بسته باینری را به صورت عادی نصب کنید: + +```bash +pkgin -y install nodejs +``` + +یا به صورت دستی از pkgsrc بسازید: + +```bash +cd pkgsrc/lang/nodejs && bmake install +``` + +## Snap + +[اسنپ ​​های Node.js](https://github.com/nodejs/snap) تحت عنوان [`node`](https://snapcraft.io/node) در فروشگاه Snap در دسترس هستند. + +## Solus + +Solus، بسته Node.js را در مخزن اصلی خود ارائه می‌دهد. + +```bash +sudo eopkg install nodejs +``` + +## vfox + +یک مدیر نسخه چندسکویی (ویندوز، macOS، لینوکس) و قابل **گسترش**. + +به شما اجازه می‌دهد که **نسخه‌های مختلف برای پروژه‌های مختلف**، **نسخه‌های مختلف برای شل‌های مختلف**، و تغییر خودکار نسخه Node بر اساس دایرکتوری فعلی، و غیره را انجام دهید. + +این نرم‌افزار تمام پوسته‌های محبوب را پشتیبانی می‌کند (Bash, Zsh, Fish, PowerShell, Clink, Cmder). + +به [شروع سریع](https://vfox.lhan.me/guides/quick-start.html) برای استفاده سریع از vfox و تمام جزئیات استفاده مراجعه کنید. + +## Void Linux + +Void Linux نسخه پایدار Node.js را در مخزن اصلی خود ارائه می‌کند. + +```bash +xbps-install -Sy nodejs +``` + +## Windows + +مستقیماً [نصب‌کننده ویندوز](/#home-downloadhead) را از وب‌سایت [nodejs.org](https://nodejs.org/) دانلود کنید. + +### جایگزین + +با استفاده از **[Winget](https://aka.ms/winget-cli)**: + +```bash +winget install OpenJS.NodeJS +# or for LTS +winget install OpenJS.NodeJS.LTS +``` + +پس از اجرای یکی از دو دستور بالا، ممکن است لازم باشد ترمینال را دوباره راه‌اندازی کنید تا دستور `node` در CLI در دسترس قرار بگیرد. + +با استفاده از **[Chocolatey](https://chocolatey.org/)**: + +```bash +cinst nodejs +# or for full install with npm +cinst nodejs.install +``` + +با استفاده از **[Scoop](https://scoop.sh/)**: + +```bash +scoop install nodejs +# or for LTS +scoop install nodejs-lts +``` + +## z/OS + +IBM® SDK برای Node.js - z/OS® در دو قالب نصب، SMP/E و PAX در دسترس است. قالب نصب مربوط به خود را انتخاب کنید: + +- [نصب و پیکربندی نسخه SMP/E از Node.js در z/OS](https://www.ibm.com/docs/en/sdk-nodejs-zos/14.0?topic=configuring-installing-smpe-edition) +- [نصب و پیکربندی نسخه PAX از Node.js در z/OS](https://www.ibm.com/docs/en/sdk-nodejs-zos/14.0?topic=configuring-installing-pax-edition) diff --git a/pages/fa/download/package-manager/current.mdx b/pages/fa/download/package-manager/current.mdx new file mode 100644 index 0000000000000..2fac9d78fe9a3 --- /dev/null +++ b/pages/fa/download/package-manager/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+نصب Node.js روی با استفاده از + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +دیگر پکیج منیجر ها که توسط جامعه پشتیبانی می‌شوند را ببینید + +
diff --git a/pages/fa/download/package-manager/index.mdx b/pages/fa/download/package-manager/index.mdx new file mode 100644 index 0000000000000..8ad4424230a8d --- /dev/null +++ b/pages/fa/download/package-manager/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+نصب Node.js روی با استفاده از + + +
+ +
+Node.js شامل است. + +پست بلاگ مربوط به این نسخه را بخوانید. + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +دیگر پکیج منیجر ها که توسط جامعه پشتیبانی می‌شوند را ببینید + +
diff --git a/pages/fa/download/prebuilt-binaries/current.mdx b/pages/fa/download/prebuilt-binaries/current.mdx new file mode 100644 index 0000000000000..85514a07dd72c --- /dev/null +++ b/pages/fa/download/prebuilt-binaries/current.mdx @@ -0,0 +1,23 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+من نسخه از Node.js را برای در حال اجرا می‌خواهم + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +نسخه‌های پیش‌ساخته شبانه یا ساخت‌های غیررسمی را برای دیگر پلتفرم‌ها بررسی کنید +
diff --git a/pages/fa/download/prebuilt-binaries/index.mdx b/pages/fa/download/prebuilt-binaries/index.mdx new file mode 100644 index 0000000000000..85514a07dd72c --- /dev/null +++ b/pages/fa/download/prebuilt-binaries/index.mdx @@ -0,0 +1,23 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+من نسخه از Node.js را برای در حال اجرا می‌خواهم + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +نسخه‌های پیش‌ساخته شبانه یا ساخت‌های غیررسمی را برای دیگر پلتفرم‌ها بررسی کنید +
diff --git a/pages/fa/download/prebuilt-installer/current.mdx b/pages/fa/download/prebuilt-installer/current.mdx new file mode 100644 index 0000000000000..5fb580d31fa6f --- /dev/null +++ b/pages/fa/download/prebuilt-installer/current.mdx @@ -0,0 +1,26 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+من نسخه از Node.js را برای در حال اجرا می‌خواهم + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +تمام آپشن‌های دانلود Node.js را ببینید + +درباره Node.js مطالعه کنید + +
diff --git a/pages/fa/download/prebuilt-installer/index.mdx b/pages/fa/download/prebuilt-installer/index.mdx new file mode 100644 index 0000000000000..a74e2634d9e89 --- /dev/null +++ b/pages/fa/download/prebuilt-installer/index.mdx @@ -0,0 +1,26 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+من نسخه از Node.js را برای در حال اجرا می‌خواهم + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تأیید کنید + +تمام آپشن‌های دانلود Node.js را ببینید + +درباره Node.js مطالعه کنید + +
diff --git a/pages/fa/download/source-code/current.mdx b/pages/fa/download/source-code/current.mdx new file mode 100644 index 0000000000000..25599aa1b2b0e --- /dev/null +++ b/pages/fa/download/source-code/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+من نسخه از سورس کد Node.js را می‌خواهم. + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +نحوه ساخت Node.js از سورس کد را ببینید. + +
diff --git a/pages/fa/download/source-code/index.mdx b/pages/fa/download/source-code/index.mdx new file mode 100644 index 0000000000000..25599aa1b2b0e --- /dev/null +++ b/pages/fa/download/source-code/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: دانلود Node.js +subtitle: Node.js را به شیوه‌ای که می‌خواهید دانلود کنید. +--- + +
+من نسخه از سورس کد Node.js را می‌خواهم. + + +
+ +
+Node.js شامل است. + +گزارش تغییرات این نسخه را بخوانید + +پست بلاگ مربوط به این نسخه را بخوانید + +یاد بگیرید که چگونه امضاهای SHASUMS را تایید کنید + +نحوه ساخت Node.js از سورس کد را ببینید. + +
diff --git a/pages/fa/index.mdx b/pages/fa/index.mdx new file mode 100644 index 0000000000000..57634d9833d1b --- /dev/null +++ b/pages/fa/index.mdx @@ -0,0 +1,139 @@ +--- +title: اجرا جاوااسکریپت در همه جا +layout: home +--- + +
+ + +
+

اجرا جاوااسکریپت در همه جا

+ +Node.js یک محیط اجرای جاوااسکریپت متن‌باز، رایگان و چندسکویی است +که به توسعه دهندگان اجازه می‌دهد تا سرورها، وب اپلیکیشن‌ها +ابزارهای خط فرمان و اسکریپت‌ها را ایجاد کنند. + +
+ +
+ + {({ release }) => ( + <> + دانلود Node.js (نسخه پایدار) + + دانلود Node.js {release.versionWithPrefix} + 1 با پشتیبانی بلندمدت. + Node.js همچنین از طریق package managers نیز قابل نصب است. + + + )} + + + + {({ release }) => ( + + می‌خواهید زودتر از ویژگی‌های جدید برخوردار شوید؟ + به‌جای آن Node.js {release.versionWithPrefix} + 1 را دریافت کنید. + + )} + +
+
+ +
+
+ ```js displayName="Create an HTTP Server" + // server.mjs + import { createServer } from 'node:http'; + +const server = createServer((req, res) => { +res.writeHead(200, { 'Content-Type': 'text/plain' }); +res.end('Hello World!\n'); +}); + +// starts a simple http server locally on port 3000 +server.listen(3000, '127.0.0.1', () => { +console.log('Listening on 127.0.0.1:3000'); +}); + +// run with `node server.mjs` + +```` + +```js displayName="Write Tests" +// tests.mjs +import assert from 'node:assert'; +import test from 'node:test'; + +test('that 1 is equal 1', () => { + assert.strictEqual(1, 1); +}); + +test('that throws as 1 is not equal 2', () => { + // throws an exception because 1 != 2 + assert.strictEqual(1, 2); +}); + +// run with `node tests.mjs` +```` + +```js displayName="Read and Hash a File" +// crypto.mjs +import { createHash } from 'node:crypto'; +import { readFile } from 'node:fs/promises'; + +const hasher = createHash('sha1'); + +hasher.setEncoding('hex'); +// ensure you have a `package.json` file for this test! +hasher.write(await readFile('package.json')); +hasher.end(); + +const fileHash = hasher.read(); + +// run with `node crypto.mjs` +``` + +```js displayName="Streams Pipeline" +// streams.mjs +import { pipeline } from 'node:stream/promises'; +import { createReadStream, createWriteStream } from 'node:fs'; +import { createGzip } from 'node:zlib'; + +// ensure you have a `package.json` file for this test! +await pipeline( + createReadStream('package.json'), + createGzip(), + createWriteStream('package.json.gz') +); + +// run with `node streams.mjs` +``` + +```js displayName="Work with Threads" +// threads.mjs +import { + Worker, + isMainThread, + workerData, + parentPort, +} from 'node:worker_threads'; + +if (isMainThread) { + const data = 'some data'; + const worker = new Worker(import.meta.filename, { workerData: data }); + worker.on('message', msg => console.log('Reply from Thread:', msg)); +} else { + const source = workerData; + parentPort.postMessage(btoa(source.toUpperCase())); +} + +// run with `node threads.mjs` +``` + +
+ +با [مطالب آموزشی](/learn) ما، بیشتر در مورد اینکه Node.js چه امکاناتی را ارائه می دهد بیاموزید. + +
diff --git a/pages/fa/search.mdx b/pages/fa/search.mdx new file mode 100644 index 0000000000000..789c12514cdfa --- /dev/null +++ b/pages/fa/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: نتایج جستجو +--- + + diff --git a/pages/fr/about/branding.mdx b/pages/fr/about/branding.mdx new file mode 100644 index 0000000000000..8f96b99a5e5ca --- /dev/null +++ b/pages/fr/about/branding.mdx @@ -0,0 +1,72 @@ +--- +title: L'image de marque de Node.js +layout: about +--- + +L'image de marque de Node.js + +Veuillez consulter la [politique en matière de marques](https://trademark-policy.openjsf.org/) pour obtenir des informations sur l'utilisation autorisée des logos et marques de Node.js®. + +## Mascotte de Node.js® + +Mascotte de Node.js + +## Logo Node.js® + +### Node.js® Logo horizontal + + + + + + + +
+ Node.js Logo horizontal + + Node.js Light Horizontal Logo +
+ +### Logo Node.js® empilé + + + + + + + + + + + + + +
+ Node.js Dark Stacked Logo + + Node.js Light Stacked Logo +
+ Node.js Black Stacked Logo + + Node.js White Stacked Logo +
+ +### Icons JS + + + + + + + +
+ Icons JS Vert + + Icons JS Blanc +
diff --git a/pages/fr/about/get-involved/collab-summit.md b/pages/fr/about/get-involved/collab-summit.md new file mode 100644 index 0000000000000..4bbe40fb05fc0 --- /dev/null +++ b/pages/fr/about/get-involved/collab-summit.md @@ -0,0 +1,16 @@ +--- +title: Sommet des Collaborateurs +layout: about +--- + +# Sommet des Collaborateurs + +Le Collaboration Summit de Node.js est une non-conférence qui rassemble les contributeurs actuels et potentiels pour discuter de Node.js dans un esprit de collaboration, d'éducation et de partage des connaissances. Les équipes, les groupes de travail et les contributeurs de la communauté se réunissent deux fois par an pour avoir des discussions qui aident à la prise de décision tout en travaillant sur des efforts passionnants qu'ils veulent faire avancer en personne. + +## Qui y assiste ? + +Le Collaboration Summit de Node.js est une non-conférence qui rassemble les contributeurs actuels et potentiels pour discuter de Node.js dans un esprit de collaboration, d'éducation et de partage des connaissances. Les équipes, les groupes de travail et les contributeurs de la communauté se réunissent deux fois par an pour avoir des discussions qui aident à la prise de décision tout en travaillant sur des efforts passionnants qu'ils veulent faire avancer en personne. + +Avant le sommet, les contributeurs et les membres de la communauté envoient des propositions de sessions afin de créer un programme. Les participants peuvent se familiariser avec la session avant de se rendre sur place, de participer aux discussions générales des collaborateurs, puis de se plonger dans les sessions. Il y aura également de nombreuses occasions de suivre des pistes dans les couloirs et de participer à des séances de réflexion. + +Pour obtenir des informations sur les sommets de la collaboration à venir et passés, consultez le [Summit repo](https://github.com/openjs-foundation/summit). Jetez un coup d'œil aux [issues filed](https://github.com/nodejs/summit/issues) qui présentent ce que les contributeurs et les membres de la communauté proposent de discuter en personne. diff --git a/pages/fr/about/get-involved/contribute.md b/pages/fr/about/get-involved/contribute.md new file mode 100644 index 0000000000000..ebe77d2973041 --- /dev/null +++ b/pages/fr/about/get-involved/contribute.md @@ -0,0 +1,47 @@ +--- +title: Contribuer +layout: about +--- + +# Contribuer + +Merci de votre intérêt à contribuer à Node.js ! Vous pouvez contribuer de plusieurs façons et à plusieurs endroits, nous sommes là pour vous aider à faciliter cela. + +## Demander de l'aide générale + +Le niveau d'activité du dépôt `nodejs/node` étant très élevé, les questions ou les demandes d'aide générale concernant l'utilisation de Node.js doivent être adressées au [Node.js help repository] (https://github.com/nodejs/help/issues).Node.js + +## Signaler un problème + +Si vous avez trouvé ce que vous pensez être un problème avec Node.js, n'hésitez pas à déposer un problème sur le projet GitHub. Lorsque vous déposez votre problème, assurez-vous que vous pouvez exprimer le problème avec un cas de test reproductible, et ce cas de test ne doit pas inclure de dépendances externes. En d'autres termes, le cas de test peut être exécuté sans rien d'autre que Node.js lui-même. + +Lorsque vous signalez un problème, nous avons également besoin d'un maximum d'informations sur votre environnement. Nous ne savons jamais quelles informations seront pertinentes pour tenter de circonscrire le problème. Veuillez inclure au moins les informations suivantes : + +- Version de Node.js +- Plateforme sur laquelle vous l'utilisez (macOS, SmartOS, Linux, Windows) +- Architecture sur laquelle vous l'utilisez (32bit ou 64bit et x86 ou ARM) + +Le projet Node.js est actuellement géré par un certain nombre de dépôts GitHub distincts, chacun ayant sa propre base de données de problèmes. Dans la mesure du possible, veuillez diriger les problèmes que vous signalez vers le dépôt approprié, mais ne vous inquiétez pas si les choses se retrouvent au mauvais endroit, la communauté des contributeurs sera plus qu'heureuse de vous aider à vous orienter dans la bonne direction. + +- Pour signaler des problèmes spécifiques à Node.js, veuillez utiliser [nodejs/node](https://github.com/nodejs/node) +- Pour signaler des problèmes spécifiques à ce site web, veuillez utiliser [nodejs/nodejs.org](https://github.com/nodejs/nodejs.org/issues) + +## Contributions au code + +Si vous souhaitez corriger des bogues ou ajouter une nouvelle fonctionnalité à Node.js, veuillez consulter les [Directives de contribution à Node.js] (https://github.com/nodejs/node/blob/main/CONTRIBUTING.md/#pull-requests). Le processus de révision par les collaborateurs existants pour toutes les contributions au projet y est également expliqué. + +Si vous vous demandez comment commencer, vous pouvez consulter [Node Todo](https://www.nodetodo.org/) qui vous guidera peut-être vers votre première contribution. + +## Devenir un collaborateur + +En devenant collaborateur, les contributeurs peuvent avoir encore plus d'impact sur le projet. Ils peuvent aider d'autres contributeurs en examinant leurs contributions, trier les problèmes et prendre une part encore plus importante dans l'élaboration de l'avenir du projet. Les personnes identifiées par le TSC comme apportant des contributions significatives et précieuses dans n'importe quel dépôt Node.js peuvent être nommées collaborateurs et se voir accorder un accès au projet. Les activités prises en compte incluent (mais ne sont pas limitées à) la qualité de : + +- les modifications de code et les demandes d'autorisation d'accès (pull requests) +- la documentation des commits et des pull requests +- commentaires sur les issues et pull requests +- contributions au site Node.js +- l'assistance fournie aux utilisateurs finaux et aux contributeurs novices +- participation à des groupes de travail +- autre participation à la communauté Node.js plus large + +Si des personnes apportant des contributions précieuses estiment qu'elles n'ont pas été prises en compte pour l'accès à l'engagement, elles peuvent [enregistrer un problème] (https://github.com/nodejs/TSC/issues) ou [contacter un membre du TSC] (https://github.com/nodejs/node#tsc-technical-steering-committee) directement. diff --git a/pages/fr/about/get-involved/events.mdx b/pages/fr/about/get-involved/events.mdx new file mode 100644 index 0000000000000..9e42e932ca042 --- /dev/null +++ b/pages/fr/about/get-involved/events.mdx @@ -0,0 +1,16 @@ +--- +title: Événements à venir +layout: about +--- + +## Événements à venir + +Les événements Node.js sont ouverts et disponibles au public. Tout le monde est invité à s'y joindre et à y participer. + +### Réunions Node.js® à venir + +Le projet Node.js organise de nombreuses réunions tout au long de l'année pour discuter et planifier certains aspects du projet. + +Les réunions suivantes auront lieu dans les 7 prochains jours. + + diff --git a/pages/fr/about/get-involved/index.md b/pages/fr/about/get-involved/index.md new file mode 100644 index 0000000000000..eaf1911daa61a --- /dev/null +++ b/pages/fr/about/get-involved/index.md @@ -0,0 +1,26 @@ +--- +title: Impliquez-vous +layout: about +--- + +# Impliquez-vous + +## Discussions de la communauté + +- La [GitHub issues list](https://github.com/nodejs/node/issues) est le lieu de discussion des fonctionnalités de base de Node.js. +- Pour discuter en temps réel du développement de Node.js, utilisez l'une des plateformes suivantes + - Pour IRC, allez sur `irc.libera.chat` dans le canal `#node.js` avec un [client IRC](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) ou connectez-vous dans votre navigateur web au canal en utilisant [un client web] (https://kiwiirc.com/nextclient/). + - Pour Slack, il y a deux options : + - Le [OpenJSF Slack](https://slack-invite.openjsf.org/) est un Slack géré par la Fondation avec plusieurs canaux Node.js (les canaux préfixés par `#nodejs-` sont liés au projet). + - [Node Slackers](https://www.nodeslackers.com/) est une communauté Slack axée sur Node.js. +- Le compte Twitter officiel de Node.js est [nodejs](https://twitter.com/nodejs). +- Le [calendrier du projet Node.js](https://nodejs.org/calendar) avec toutes les réunions publiques de l'équipe. + +## Apprentissage + +- [Section officielle d'apprentissage](https://nodejs.org/en/learn/) du site web de Node.js. +- [Official API reference documentation](https://nodejs.org/api/). +- [NodeSchool.io](https://nodeschool.io/) vous enseignera les concepts de Node.js par le biais de jeux interactifs en ligne de commande. +- Le site [Stack Overflow Node.js tag](https://stackoverflow.com/questions/tagged/node.js) recueille de nouvelles informations chaque jour. +- [Le tag Node.js de la communauté DEV](https://dev.to/t/node) est un endroit pour partager des projets, des articles et des tutoriels Node.js, ainsi que pour lancer des discussions et demander des commentaires sur des sujets liés à Node.js. Les développeurs de tous niveaux sont les bienvenus. +- [Nodeiflux](https://discordapp.com/invite/vUsrbjd) est une communauté amicale de développeurs backend Node.js qui s'entraident sur Discord. diff --git a/pages/fr/about/governance.md b/pages/fr/about/governance.md new file mode 100644 index 0000000000000..9cf0b1c050669 --- /dev/null +++ b/pages/fr/about/governance.md @@ -0,0 +1,36 @@ +--- +title: Gouvernance du Projet +layout: about +--- + +# Gouvernance du Projet + +## Processus de recherche de consensus + +Le projet Node.js suit un modèle de prise de décision [Consensus Seeking][]. + +## Collaborateurs + +Le dépôt GitHub [nodejs/node][] core est maintenu par les Collaborateurs +qui sont nommés par d'autres collaborateurs existants sur une base continue. + +Les personnes qui apportent des contributions significatives et précieuses sont nommées collaborateurs +et se voient attribuer un accès au projet. Ces personnes sont identifiées par d'autres. +Ces personnes sont identifiées par d'autres collaborateurs et leur nomination est discutée avec les collaborateurs existants. + +Pour la liste actuelle des collaborateurs, voir le [README.md][] du projet. + +Un guide pour les collaborateurs est disponible à l'adresse suivante : [collaborator-guide.md][]. + +## Comité de pilotage technique + +Le projet est régi par le \[Comité de pilotage technique (TSC)]\[] +qui est responsable de l'orientation de haut niveau du projet. Le TSC est un +un sous-ensemble de collaborateurs actifs qui sont nommés par d'autres membres existants du TSC. + +[consensus seeking]: https://en.wikipedia.org/wiki/Consensus-seeking_decision-making +[readme.md]: https://github.com/nodejs/node/blob/main/README.md#current-project-team-members +[tsc]: https://github.com/nodejs/TSC +[technical steering committee (tsc)]: https://github.com/nodejs/TSC/blob/main/TSC-Charter.md +[collaborator-guide.md]: https://github.com/nodejs/node/blob/main/doc/contributing/collaborator-guide.md +[nodejs/node]: https://github.com/nodejs/node diff --git a/pages/fr/about/index.mdx b/pages/fr/about/index.mdx new file mode 100644 index 0000000000000..c08e7bff80aa4 --- /dev/null +++ b/pages/fr/about/index.mdx @@ -0,0 +1,85 @@ +--- +title: À propos de Node.js® +layout: about +--- + +À propos de Node.js® + +En tant que moteur d'exécution JavaScript asynchrone piloté par les événements, Node.js est conçu pour construire des applications réseau évolutives. +des applications réseau évolutives. Dans l'exemple suivant, "hello world", de nombreuses +peuvent être gérées simultanément. À chaque connexion, le rappel est +mais s'il n'y a pas de travail à faire, Node.js se met en veille. + +```cjs +const { createServer } = require('node:http'); + +const hostname = '127.0.0.1'; +const port = 3000; + +const server = createServer((req, res) => { + res.statusCode = 200; + res.setHeader('Content-Type', 'text/plain'); + res.end('Hello World'); +}); + +server.listen(port, hostname, () => { + console.log(`Server running at http://${hostname}:${port}/`); +}); +``` + +```mjs +import { createServer } from 'node:http'; + +const hostname = '127.0.0.1'; +const port = 3000; + +const server = createServer((req, res) => { + res.statusCode = 200; + res.setHeader('Content-Type', 'text/plain'); + res.end('Hello World'); +}); + +server.listen(port, hostname, () => { + console.log(`Server running at http://${hostname}:${port}/`); +}); +``` + +Cela contraste avec le modèle de concurrence le plus courant aujourd'hui, dans lequel les threads du système d'exploitation sont utilisés. +sont utilisés. Les réseaux basés sur les threads sont relativement inefficaces et très +difficile à utiliser. En outre, les utilisateurs de Node.js n'ont pas à s'inquiéter d'un blocage du processus, puisqu'il n'y a pas de verrous. +de bloquer le processus, puisqu'il n'y a pas de verrous. Presque aucune fonction de +Node.js n'exécute directement des E/S, de sorte que le processus ne se bloque jamais, sauf lorsque les E/S sont exécutées à l'aide des méthodes synchrones de Node.js. +méthodes synchrones de la bibliothèque standard de Node.js. Comme rien ne se bloque, il est très raisonnable de développer des systèmes évolutifs en Node.js. +raisonnables à développer en Node.js. + +Si ce langage ne vous est pas familier, vous trouverez un article complet sur le site suivant +[Blocage et non-blocage][]. + +--- + +La conception de Node.js est similaire et influencée par des systèmes tels que Ruby [Event Machine][] et Python [Twisted][]. +[Event Machine][] de Ruby et [Twisted][] de Python. Node.js pousse le modèle d'événement un peu plus loin. +un peu plus loin. Il présente une boucle d'événements comme une construction d'exécution plutôt que comme une bibliothèque. Dans d'autres systèmes, +il y a toujours un appel bloquant pour démarrer la boucle d'événements. +Généralement, le comportement est défini par des rappels au début d'un script et, à la fin, un serveur est démarré par le biais d'un appel bloquant. +la fin, un serveur est démarré par un appel bloquant comme `EventMachine::run()`. +Dans Node.js, il n'y a pas de tel appel start-the-event-loop. Node.js entre simplement dans la boucle d'événements après avoir exécuté le script d'entrée. Node.js +quitte la boucle d'événements lorsqu'il n'y a plus de rappels à effectuer. Ce comportement +est similaire à celui d'un navigateur JavaScript - la boucle d'événements est cachée à l'utilisateur. + +HTTP est un citoyen de première classe dans Node.js, conçu pour la diffusion en continu et la faible latence. +latence. Node.js est donc bien adapté à la création d'une bibliothèque ou d'un cadre web. +web ou d'un framework. + +Le fait que Node.js soit conçu sans threads ne signifie pas que vous ne pouvez pas tirer +profiter de plusieurs cœurs dans votre environnement. Les processus enfants peuvent être créés en utilisant notre API [`child_process.fork()`][]. +en utilisant notre API [`child_process.fork()`][], et sont conçus pour être faciles à communiquer. +communiquer avec. Le module [`cluster`][] est construit sur cette même interface, +qui vous permet de partager des sockets entre les processus afin d'équilibrer la charge +sur vos cœurs. + +[bloquant ou non bloquant]: /learn/asynchronous-work/overview-of-blocking-vs-non-blocking +[`child_process.fork()`]: https://nodejs.org/api/child_process.html +[`cluster`]: https://nodejs.org/api/cluster.html +[événements machine]: https://github.com/eventmachine/eventmachine +[tordu]: https://twisted.org/ diff --git a/pages/fr/about/previous-releases.mdx b/pages/fr/about/previous-releases.mdx new file mode 100644 index 0000000000000..617c6b9088f29 --- /dev/null +++ b/pages/fr/about/previous-releases.mdx @@ -0,0 +1,21 @@ +--- +title: Versions de Node.js +layout: about +--- + +Versions de Node.js + +Les versions majeures de Node.js passent au statut de version _Current_ pendant six mois, ce qui donne aux auteurs de bibliothèques le temps de les prendre en charge. +Après six mois, les versions impaires (9, 11, etc.) ne sont plus supportées, et les versions paires (10, 12, etc.) passent au statut _Active LTS_ et sont prêtes pour une utilisation générale. +Le statut de la version _LTS_ correspond à un "support à long terme", qui garantit généralement que les bogues critiques seront corrigés pendant une durée totale de 30 mois. +Les applications de production ne doivent utiliser que les versions _Active LTS_ ou _Maintenance LTS_. + +## Calendrier de sortie + +![Releases](https://raw.githubusercontent.com/nodejs/Release/main/schedule.svg?sanitize=true) + +Tous les détails concernant le calendrier des versions de Node.js sont disponibles [sur GitHub] (https://github.com/nodejs/release#release-schedule). + +## Vous recherchez la dernière version d'une branche de version ? + + diff --git a/pages/fr/about/security-reporting.mdx b/pages/fr/about/security-reporting.mdx new file mode 100644 index 0000000000000..4209d3c628ecf --- /dev/null +++ b/pages/fr/about/security-reporting.mdx @@ -0,0 +1,88 @@ +--- +title: Rapport de sécurité +layout: about +--- + +Rapport de sécurité + +Pour plus de détails sur les politiques de sécurité active, consultez [cette page] (https://github.com/nodejs/node/security/policy). + +## Signaler une faille dans Node.js + +Signalez les bogues de sécurité dans Node.js via [HackerOne] (https://hackerone.com/nodejs). + +Vous recevrez un accusé de réception de votre rapport dans les 5 jours, et vous recevrez une réponse plus détaillée dans les 10 jours, indiquant les prochaines étapes. +une réponse plus détaillée à votre rapport dans les 10 jours, indiquant les prochaines étapes du traitement de votre demande. +traitement de votre demande. + +Après la réponse initiale à votre rapport, l'équipe de sécurité s'efforcera de vous tenir informé des progrès réalisés en vue d'un correctif et d'une annonce complète. +vous tenir informé des progrès réalisés en vue d'une correction et d'une annonce complète, +et pourra vous demander des informations supplémentaires ou des conseils sur le problème signalé. +problème signalé. + +### Programme de primes aux bugs Node.js + +Le projet Node.js s'engage dans un programme officiel de primes aux bogues pour les chercheurs en sécurité et les divulgations publiques responsables. +et les divulgations publiques responsables. Le programme est géré par la plateforme +la plateforme HackerOne. Voir [https://hackerone.com/nodejs](https://hackerone.com/nodejs) pour plus de détails. + +## Signaler un bogue dans un module tiers + +Les bogues de sécurité dans les modules tiers doivent être signalés à leurs mainteneurs respectifs. + +## Politique de divulgation + +Voici la politique de divulgation de la sécurité pour Node.js + +Le rapport de sécurité est reçu et un gestionnaire principal lui est attribué. Cette personne +Cette personne coordonnera le processus de correction et de libération. Le problème est confirmé +et une liste de toutes les versions affectées est établie. Le code est audité pour trouver +tout problème similaire potentiel. Des correctifs sont préparés pour toutes les versions qui sont +toujours en cours de maintenance. Ces correctifs ne sont pas déposés dans le +mais sont plutôt conservés localement dans l'attente de l'annonce. + +Une date d'embargo est proposée pour cette vulnérabilité et un CVE (Common Vulnerabilities and Exposures (CVE®)) est demandé pour cette vulnérabilité. +Vulnérabilités et expositions communes (CVE®) est demandé pour la vulnérabilité. + +À la date d'embargo, la liste de diffusion sur la sécurité de Node.js reçoit une copie de l'annonce. +annonce. Les changements sont poussés vers le dépôt public et de nouvelles versions +sont déployées sur nodejs.org. Dans les 6 heures suivant la notification de la liste de diffusion +une copie de l'avis sera publiée sur le blog de Node.js. + +En règle générale, la date d'embargo est fixée à 72 heures à compter de l'émission du CVE. +est publié. Toutefois, cela peut varier en fonction de la gravité du bogue ou de la +de la difficulté à appliquer un correctif. + +Ce processus peut prendre un certain temps, en particulier lorsqu'une coordination est nécessaire avec les responsables d'autres projets. +avec les responsables d'autres projets. Tous les efforts seront faits pour traiter le +bogue le plus rapidement possible ; cependant, il est important que nous suivions la +processus de publication ci-dessus pour s'assurer que la divulgation est traitée de manière +de manière cohérente. + +## Recevoir les alertes de sécurité + +Les notifications de sécurité seront diffusées par les méthodes suivantes. + +[Google Group](https://groups.google.com/group/nodejs-sec) +[Node.js Blog](/blog) + +## Commentaires sur cette politique + +Si vous avez des suggestions sur la façon dont ce processus pourrait être amélioré, veuillez soumettre une +[pull request](https://github.com/nodejs/nodejs.org) ou +[file an issue](https://github.com/nodejs/security-wg/issues/new) pour en discuter. + +## OpenSSF Best Practices + + + Badge OpenSSF + + +Le [badge des meilleures pratiques] de l'Open Source Security Foundation (OpenSSF) (https://github.com/coreinfrastructure/best-practices-badge) est un moyen pour les projets de logiciels libres et open source (FLOSS) de montrer qu'ils suivent les meilleures pratiques. Les projets peuvent volontairement auto-certifier la manière dont ils suivent chaque meilleure pratique. Les utilisateurs du badge peuvent rapidement déterminer quels sont les projets FLOSS qui suivent les meilleures pratiques et qui sont donc plus susceptibles de produire des logiciels sécurisés de meilleure qualité. diff --git a/pages/fr/download/package-manager/all.md b/pages/fr/download/package-manager/all.md new file mode 100644 index 0000000000000..838d5a30b6f6a --- /dev/null +++ b/pages/fr/download/package-manager/all.md @@ -0,0 +1,430 @@ +--- +layout: download +title: Installer Node.js via le gestionnaire de paquets +--- + +# Installer Node.js via le gestionnaire de paquets + +> Les paquets sur cette page sont maintenus et supportés par leurs auteurs respectifs, **pas** par l'équipe de base de Node.js. Veuillez rapporter tout problème que vous rencontrez au mainteneur du paquet. S'il s'avère que votre problème est un bogue dans Node.js lui-même, le mainteneur rapportera le problème en amont. + +--- + +- [Alpine Linux](#alpine-linux) +- [Android](#android) +- [Arch Linux](#arch-linux) +- [CentOS, Fedora et Red Hat Enterprise Linux](#centos-fedora-and-red-hat-enterprise-linux) +- [Debian et Distributions Linux basées sur Ubuntu](#debian-and-ubuntu-based-linux-distributions) +- [Exherbo Linux](#exherbo-linux) +- [fnm](#fnm) +- [FreeBSD](#freebsd) +- [Gentoo](#gentoo) +- [IBM i](#ibm-i) +- [macOS](#macos) +- [n](#n) +- [NetBSD](#netbsd) +- [Nodenv](#nodenv) +- [nvm](#nvm) +- [nvs](#nvs) +- [OpenBSD](#openbsd) +- [openSUSE et SLE](#opensuse-and-sle) +- [SmartOS et illumos](#smartos-and-illumos) +- [Snap](#snap) +- [Solus](#solus) +- [vfox](#vfox) +- [Void Linux](#void-linux) +- [Windows](#windows-1) +- [z/OS](#zos) + +--- + +## Alpine Linux + +Les paquets Node.js LTS et npm sont disponibles dans le dépôt principal. + +```bash +apk add nodejs npm +``` + +Node.js actuel peut être installé à partir du Repository de la Communauté. + +```bash +apk add nodejs-current +``` + +## Android + +Le support d'Android est encore expérimental dans Node.js, donc les binaires précompilés ne sont pas encore fournis par les développeurs de Node.js. + +Toutefois, il existe des solutions tierces. Par exemple, la communauté [Termux](https://termux.com/) fournit un émulateur de terminal et un environnement Linux pour Android, ainsi que son propre gestionnaire de paquets et une [vaste collection](https://github.com/termux/termux-packages) de nombreuses applications précompilées. Cette commande dans l'application Termux installera la dernière version disponible de Node.js : + +```bash +pkg install nodejs +``` + +Actuellement, les binaires de Termux Node.js sont liés à `system-icu` (dépendant du paquet `libicu`). + +## Arch Linux + +Les paquets Node.js et npm sont disponibles dans le Dépôt de la communauté. + +```bash +pacman -S nodejs npm +``` + +## CentOS, Fedora et Red Hat Enterprise Linux + +Node.js est disponible en tant que module appelé `nodejs` dans CentOS/RHEL 8 et Fedora. + +```bash +dnf module install nodejs: +``` + +où `` correspond à la version majeure de Node.js. +Pour voir la liste des flux disponibles : + +```bash +dnf module list nodejs +``` + +Par exemple, pour installer Node.js 18 : + +```bash +dnf module install nodejs:18/common +``` + +### Alternatives + +Ces ressources fournissent des paquets compatibles avec CentOS, Fedora et RHEL. + +- [Node.js snaps](#snap) maintenu et supporté à https://github.com/nodejs/snap +- [Distributions binaires Node.js](#debian-and-ubuntu-based-linux-distributions) maintenues et supportées par [NodeSource](https://github.com/nodesource/distributions) + +## Distributions basées sur Debian et Ubuntu + +Des [distributions binaires de Node.js](https://github.com/nodesource/distributions) sont disponibles auprès de NodeSource. + +### Alternatives + +Les paquets compatibles avec les distributions Linux basées sur Debian et Ubuntu sont disponibles via [Node.js snaps](#snap). + +## Exherbo Linux + +Les paquets Node.js et npm sont disponibles dans le [dépôt d'arborescence](https://gitlab.exherbo.org/exherbo/arbor/-/tree/master/packages/dev-lang/node). + +```bash +cave resolve -x node +``` + +## fnm + +Gestionnaire de versions Node.js simple et rapide, construit en Rust, utilisé pour gérer plusieurs versions de Node.js. Il vous permet d'effectuer des opérations telles que l'installation, la désinstallation, le changement automatique de version de Node en fonction du répertoire courant, etc. +Pour installer fnm, utilisez ce [script d'installation](https://github.com/Schniz/fnm#using-a-script-macoslinux). + +fnm est multiplateforme (macOS, Windows, Linux) et supporte tous les shells populaires (Bash, Zsh, Fish, PowerShell, Windows Command Line Prompt). +fnm est construit avec la vitesse à l'esprit et le support de compatibilité pour les fichiers `.node-version` et `.nvmrc`. + +## FreeBSD + +La version la plus récente de Node.js est disponible via le port [www/node](https://www.freshports.org/www/node). + +Installer un paquetage binaire via [pkg](https://www.freebsd.org/cgi/man.cgi?pkg) : + +```bash +pkg install node +``` + +Vous pouvez également le compiler vous-même en utilisant [ports](https://www.freebsd.org/cgi/man.cgi?ports) : + +```bash +cd /usr/ports/www/node && make install +``` + +## Gentoo + +Node.js est disponible dans l'arbre de portage. + +```bash +emerge nodejs +``` + +## IBM i + +Les versions LTS de Node.js sont disponibles auprès d'IBM, et sont disponibles via [le gestionnaire de paquets 'yum'](https://ibm.biz/ibmi-rpms). Le nom du paquet est `nodejs` suivi du numéro de la version majeure (par exemple, `nodejs18`, `nodejs20`, etc) + +Pour installer Node.js 14.x à partir de la ligne de commande, exécutez la commande suivante en tant qu'utilisateur disposant de l'autorisation spéciale \*ALLOBJ : + +```bash +yum install nodejs20 +``` + +Node.js peut également être installé avec le produit IBM i Access Client Solutions. Voir [ce document d'assistance](http://www-01.ibm.com/support/docview.wss?uid=nas8N1022619) pour plus de détails + +## macOS + +Téléchargez l'[installateur macOS](/#home-downloadhead) directement depuis le site web [nodejs.org](https://nodejs.org/). + +Si vous voulez télécharger le paquet avec bash + +```bash +curl "https://nodejs.org/dist/latest/$(curl -s https://nodejs.org/dist/latest/ | grep "pkg" | cut -d'"' -f 2)" -o "$HOME/Downloads/node-latest.pkg" && sudo installer -store -pkg "$HOME/Downloads/node-latest.pkg" -target "/" +``` + +### Alternatives + +Utilisation de **[Homebrew](https://brew.sh/)** : + +```bash +brew install node +``` + +Utilisation de **[MacPorts](https://www.macports.org/)** : + +```bash +port install nodejs + +# Example +port install nodejs7 +``` + +Utilisation de **[pkgsrc](https://pkgsrc.joyent.com/install-on-macos/)** : + +Installer le paquet binaire : + +```bash +pkgin -y install nodejs +``` + +Ou compiler manuellement à partir de pkgsrc : + +```bash +cd pkgsrc/lang/nodejs && bmake install +``` + +## n + +`n` est un gestionnaire de version Node.js simple à utiliser pour Mac et Linux. Spécifiez la version cible à installer en utilisant une syntaxe riche, +ou choisissez parmi un menu de versions précédemment téléchargées. Les versions sont installées à l'échelle du système ou de l'utilisateur, et pour une utilisation plus ciblée, vous pouvez exécuter une version directement à partir de votre ordinateur. +Pour une utilisation plus ciblée, vous pouvez exécuter une version directement à partir des téléchargements mis en cache. + +Voir la [page d'accueil](https://github.com/tj/n) pour les méthodes d'installation (bootstrap, npm, Homebrew, tierce partie), et tous les détails d'utilisation. + +Si vous avez déjà `npm`, l'installation de `n` et de la dernière version LTS de `node` est aussi simple que cela : + +``` +npm install -g n +n lts +``` + +## NetBSD + +Node.js est disponible dans l'arborescence pkgsrc : + +```bash +cd /usr/pkgsrc/lang/nodejs && make install +``` + +Ou installez un paquetage binaire (si disponible pour votre plateforme) en utilisant pkgin : + +```bash +pkgin -y install nodejs +``` + +## Nodenv + +`nodenv` est un gestionnaire de version léger pour les nœuds, similaire à `nvm`. Il est simple et prévisible. Un riche écosystème de plugins vous permet de l'adapter à vos besoins. Utilisez `nodenv` pour choisir une version de Node pour votre application et garantissez que votre environnement de développement correspond à la production. + +Les instructions d'installation de Nodenv sont maintenues [sur sa page Github](https://github.com/nodenv/nodenv#installation). Veuillez consulter cette page pour vous assurer que vous suivez la dernière version des étapes d'installation. + +## nvm + +Node Version Manager est un script bash utilisé pour gérer plusieurs versions de Node.js. Il permet +d'effectuer des opérations telles que l'installation, la désinstallation, le changement de version, etc. +Pour installer nvm, utilisez ce [script d'installation](https://github.com/nvm-sh/nvm#install--update-script). + +Sur les systèmes Unix / OS X, Node.js construit à partir des sources peut être installé à l'aide de +[nvm](https://github.com/creationix/nvm) en l'installant à l'emplacement attendu par nvm : + +```bash +env VERSION=`python tools/getnodeversion.py` make install DESTDIR=`nvm_version_path v$VERSION` PREFIX="" +``` + +Après cela, vous pouvez utiliser `nvm` pour basculer entre les versions publiées et les versions +compilées à partir des sources. +Par exemple, si la version de Node.js est v8.0.0-pre : + +```bash +nvm use 8 +``` + +Une fois que la version officielle sera disponible, vous voudrez désinstaller la version construite +à partir des sources : + +```bash +nvm uninstall 8 +``` + +## nvs + +#### Windows + +Le gestionnaire de versions `nvs` est multiplateforme et peut être utilisé sur Windows, macOS et les systèmes de type Unix + +Pour installer `nvs` sur Windows, allez sur la [page de publication](https://github.com/jasongin/nvs/releases) ici et téléchargez le fichier d'installation MSI de la dernière version. + +Vous pouvez également utiliser `chocolatey` pour l'installer : + +```bash +choco install nvs +``` + +#### macOS et tous les systèmes de type Unix + +Vous pouvez trouver la documentation concernant les étapes d'installation de `nvs` dans les systèmes macOS/Unix-like [ici](https://github.com/jasongin/nvs/blob/master/doc/SETUP.md#mac-linux) + +#### Usage + +Après cela, vous pouvez utiliser `nvs` pour passer d'une version à l'autre de node. + +Pour ajouter la dernière version du node : + +```bash +nvs add latest +``` + +Ou d'ajouter la dernière version LTS de node : + +```bash +nvs add lts +``` + +Ensuite, lancez la commande `nvs use` pour ajouter une version de node à votre `PATH` pour l'interpréteur de commandes actuel : + +```bash +$ nvs use lts +PATH -= %LOCALAPPDATA%\nvs\default +PATH += %LOCALAPPDATA%\nvs\node\14.17.0\x64 +``` + +Pour l'ajouter à `PATH` de façon permanente, utilisez `nvs link` : + +```bash +nvs link lts +``` + +## OpenBSD + +Node.js est disponible via le système des ports. + +```bash +/usr/ports/lang/node +``` + +Utilisation de [pkg_add](https://man.openbsd.org/OpenBSD-current/man1/pkg_add.1) sur OpenBSD : + +```bash +pkg_add node +``` + +## openSUSE et SLE + +Node.js est disponible dans les dépôts principaux sous les paquets suivants : + +- **openSUSE Leap 15.2**: `nodejs10`, `nodejs12`, `nodejs14` +- **openSUSE Tumbleweed**: `nodejs20` +- **SUSE Linux Enterprise Server (SLES) 12** : `nodejs10`, `nodejs12`, et `nodejs14` + (Le "Web et Scripting Module" doit être [activé](https://www.suse.com/releasenotes/x86_64/SUSE-SLES/12-SP5/#intro-modulesExtensionsRelated).) +- **SUSE Linux Enterprise Server (SLES) 15 SP2** : `nodejs10`, `nodejs12`, et `nodejs14` + (Le "Web etScripting Module" doit être [activés](https://www.suse.com/releasenotes/x86_64/SUSE-SLES/15/#Intro.Module).) + +Par exemple, pour installer Node.js 14.x sur openSUSE Leap 15.2, exécutez ce qui suit en tant que root : + +```bash +zypper install nodejs14 +``` + +Différentes versions majeures de Node peuvent être installées et utilisées simultanément. + +## SmartOS et illumos + +Les images de SmartOS sont livrées avec pkgsrc pré-installé. Sur les autres distributions illumos, installez d'abord **[pkgsrc](https://pkgsrc.joyent.com/install-on-illumos/)**, puis vous pouvez installer le paquetage binaire normalement : + +```bash +pkgin -y install nodejs +``` + +Ou compiler manuellement à partir de pkgsrc : + +```bash +cd pkgsrc/lang/nodejs && bmake install +``` + +## Snap + +Les [snaps Node.js](https://github.com/nodejs/snap) sont disponibles en tant que [`node`](https://snapcraft.io/node) sur le magasin Snap. + +## Solus + +Solus fournit Node.js dans son dépôt principal. + +```bash +sudo eopkg install nodejs +``` + +## vfox + +Un gestionnaire de versions multiplateforme (Windows, macOS, Linux) et **extensible**. + +Il vous permet de **différentes versions pour différents projets**, **différentes versions pour différents shells**, et de changer de version de Node automatiquement en fonction du répertoire courant, etc. + +Il supporte tous les shells populaires (Bash, Zsh, Fish, PowerShell, Clink, Cmder). + +Voir le [Démarrage rapide](https://vfox.lhan.me/guides/quick-start.html) pour une utilisation rapide de vfox, et tous les détails d'utilisation. + +## Void Linux + +Void Linux fournit Node.js stable dans le dépôt principal. + +```bash +xbps-install -Sy nodejs +``` + +## Windows + +Téléchargez l'[Installateur Windowsr](/#home-downloadhead) directement depuis le site web [nodejs.org](https://nodejs.org/). + +### Alternatives + +Utilisation **[Winget](https://aka.ms/winget-cli)**: + +```bash +winget install OpenJS.NodeJS +# or for LTS +winget install OpenJS.NodeJS.LTS +``` + +Après avoir exécuté l'une des deux commandes ci-dessus, il peut être nécessaire de redémarrer l'émulateur de terminal avant que la commande CLI `node` ne soit disponible. +l'émulateur de terminal avant que la commande CLI `node` ne soit disponible. + +Utilisation **[Chocolatey](https://chocolatey.org/)**: + +```bash +cinst nodejs +# or for full install with npm +cinst nodejs.install +``` + +Utilisation **[Scoop](https://scoop.sh/)**: + +```bash +scoop install nodejs +# or for LTS +scoop install nodejs-lts +``` + +## z/OS + +IBM® SDK pour Node.js - z/OS® est disponible en deux formats d'installation, +SMP/E et PAX. Sélectionnez le format d'installation qui vous convient : + +- [Installation et configuration de l'édition SMP/E de Node.js sur z/OS](https://www.ibm.com/docs/en/sdk-nodejs-zos/14.0?topic=configuring-installing-smpe-edition) +- [Installation et configuration de l'édition PAX de Node.js sur z/OS](https://www.ibm.com/docs/en/sdk-nodejs-zos/14.0?topic=configuring-installing-pax-edition) diff --git a/pages/fr/download/package-manager/current.mdx b/pages/fr/download/package-manager/current.mdx new file mode 100644 index 0000000000000..69f1c75348f95 --- /dev/null +++ b/pages/fr/download/package-manager/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Installer Node.js sur en utilisant + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Consultez d'autres gestionnaires de paquets soutenus par la communauté + +
diff --git a/pages/fr/download/package-manager/index.mdx b/pages/fr/download/package-manager/index.mdx new file mode 100644 index 0000000000000..69f1c75348f95 --- /dev/null +++ b/pages/fr/download/package-manager/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Installer Node.js sur en utilisant + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Consultez d'autres gestionnaires de paquets soutenus par la communauté + +
diff --git a/pages/fr/download/prebuilt-binaries/current.mdx b/pages/fr/download/prebuilt-binaries/current.mdx new file mode 100644 index 0000000000000..8bb21316ba7a3 --- /dev/null +++ b/pages/fr/download/prebuilt-binaries/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Je veux la version de Node.js pour exécutant + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Consultez les binaires préconstruits Nightly ou les Unofficial Builds pour d'autres plateformes. + +
diff --git a/pages/fr/download/prebuilt-binaries/index.mdx b/pages/fr/download/prebuilt-binaries/index.mdx new file mode 100644 index 0000000000000..8bb21316ba7a3 --- /dev/null +++ b/pages/fr/download/prebuilt-binaries/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Je veux la version de Node.js pour exécutant + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Consultez les binaires préconstruits Nightly ou les Unofficial Builds pour d'autres plateformes. + +
diff --git a/pages/fr/download/prebuilt-installer/current.mdx b/pages/fr/download/prebuilt-installer/current.mdx new file mode 100644 index 0000000000000..451440f6adc96 --- /dev/null +++ b/pages/fr/download/prebuilt-installer/current.mdx @@ -0,0 +1,26 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Je veux la version de Node.js pour fonctionner + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Consultez toutes les options de téléchargement de Node.js. + +En savoir plus sur les Versions Node.js + +
diff --git a/pages/fr/download/prebuilt-installer/index.mdx b/pages/fr/download/prebuilt-installer/index.mdx new file mode 100644 index 0000000000000..451440f6adc96 --- /dev/null +++ b/pages/fr/download/prebuilt-installer/index.mdx @@ -0,0 +1,26 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Je veux la version de Node.js pour fonctionner + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Consultez toutes les options de téléchargement de Node.js. + +En savoir plus sur les Versions Node.js + +
diff --git a/pages/fr/download/source-code/current.mdx b/pages/fr/download/source-code/current.mdx new file mode 100644 index 0000000000000..f7a2f1af75833 --- /dev/null +++ b/pages/fr/download/source-code/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Je veux la version du code source de Node.js. + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Découvrez comment compiler Node.js à partir des sources. + +
diff --git a/pages/fr/download/source-code/index.mdx b/pages/fr/download/source-code/index.mdx new file mode 100644 index 0000000000000..f7a2f1af75833 --- /dev/null +++ b/pages/fr/download/source-code/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Télécharger Node.js® +subtitle: Téléchargez Node.js comme vous le souhaitez. +--- + +
+Je veux la version du code source de Node.js. + + +
+ +
+Node.js inclut . + +Lire le journal des modifications pour cette version + +Lire l'article de blog pour cette version + +Apprenez à vérifier les SHASUMS signés + +Découvrez comment compiler Node.js à partir des sources. + +
diff --git a/pages/fr/index.mdx b/pages/fr/index.mdx new file mode 100644 index 0000000000000..54262c84798a6 --- /dev/null +++ b/pages/fr/index.mdx @@ -0,0 +1,138 @@ +--- +title: Exécuter du JavaScript partout +layout: home +--- + +
+ + +
+

Exécuter du JavaScript partout

+ +Node.js® est un environnement d'exécution JavaScript gratuit, open-source et multiplateforme qui permet aux développeurs de créer des serveurs, des applications web et des applications de gestion de contenu. +qui permet aux développeurs de créer des serveurs, des applications web, des outils en ligne de commande et des scripts. + +
+ +
+ + {({ release }) => ( + <> + Télécharger Node.js (LTS) + + Télécharger Node.js {release.versionWithPrefix} + 1 avec un support à long terme. + Node.js peut également être installé via gestionnaires de paquets. + + + )} + + + + {({ release }) => ( + + Vous voulez de nouvelles fonctionnalités plus tôt ? + Obtenez Node.js {release.versionWithPrefix} + 1 à la place. + + )} + +
+
+ +
+
+ ```js displayName="Create an HTTP Server" + // server.mjs + import { createServer } from 'node:http'; + +const server = createServer((req, res) => { +res.writeHead(200, { 'Content-Type': 'text/plain' }); +res.end('Hello World!\n'); +}); + +// starts a simple http server locally on port 3000 +server.listen(3000, '127.0.0.1', () => { +console.log('Listening on 127.0.0.1:3000'); +}); + +// run with `node server.mjs` + +```` + +```js displayName="Write Tests" +// tests.mjs +import assert from 'node:assert'; +import test from 'node:test'; + +test('that 1 is equal 1', () => { + assert.strictEqual(1, 1); +}); + +test('that throws as 1 is not equal 2', () => { + // throws an exception because 1 != 2 + assert.strictEqual(1, 2); +}); + +// run with `node tests.mjs` +```` + +```js displayName="Read and Hash a File" +// crypto.mjs +import { createHash } from 'node:crypto'; +import { readFile } from 'node:fs/promises'; + +const hasher = createHash('sha1'); + +hasher.setEncoding('hex'); +// ensure you have a `package.json` file for this test! +hasher.write(await readFile('package.json')); +hasher.end(); + +const fileHash = hasher.read(); + +// run with `node crypto.mjs` +``` + +```js displayName="Streams Pipeline" +// streams.mjs +import { pipeline } from 'node:stream/promises'; +import { createReadStream, createWriteStream } from 'node:fs'; +import { createGzip } from 'node:zlib'; + +// ensure you have a `package.json` file for this test! +await pipeline( + createReadStream('package.json'), + createGzip(), + createWriteStream('package.json.gz') +); + +// run with `node streams.mjs` +``` + +```js displayName="Work with Threads" +// threads.mjs +import { + Worker, + isMainThread, + workerData, + parentPort, +} from 'node:worker_threads'; + +if (isMainThread) { + const data = 'some data'; + const worker = new Worker(import.meta.filename, { workerData: data }); + worker.on('message', msg => console.log('Reply from Thread:', msg)); +} else { + const source = workerData; + parentPort.postMessage(btoa(source.toUpperCase())); +} + +// run with `node threads.mjs` +``` + +
+ +Apprenez-en plus sur ce que Node.js est capable d'offrir avec notre [Matériel d'apprentissage](/learn). + +
diff --git a/pages/fr/search.mdx b/pages/fr/search.mdx new file mode 100644 index 0000000000000..e1e31021bab81 --- /dev/null +++ b/pages/fr/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: Résultats de la recherche +--- + + diff --git a/pages/id/search.mdx b/pages/id/search.mdx new file mode 100644 index 0000000000000..7b4a2ae44d4c4 --- /dev/null +++ b/pages/id/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: Hasil Pencarian +--- + + diff --git a/pages/ja/about/branding.mdx b/pages/ja/about/branding.mdx new file mode 100644 index 0000000000000..70bfbb817e3a0 --- /dev/null +++ b/pages/ja/about/branding.mdx @@ -0,0 +1,72 @@ +--- +title: Node.jsのブランド +layout: about +--- + +Node.jsのブランド + +Node.jsのロゴやシンボルマークの許可されている利用方法については[トレードマークポリシー](https://trademark-policy.openjsf.org/)を確認してください。 + +## Node.js®マスコット + +Node.jsマスコット + +## Node.js®ロゴ + +### Node.js®横型ロゴ + + + + + + + +
+ Node.jsダーク横型ロゴ + + Node.jsライト横型ロゴ +
+ +### Node.js®スタック型ロゴ + + + + + + + + + + + + + +
+ Node.jsダークスタック型ロゴ + + Node.jsライトスタック型ロゴ +
+ Node.jsブラックスタック型ロゴ + + Node.jsホワイトスタック型ロゴ +
+ +### JSアイコン + + + + + + + +
+ JSアイコングリーン + + JSアイコンホワイト +
diff --git a/pages/ja/about/get-involved/events.mdx b/pages/ja/about/get-involved/events.mdx new file mode 100644 index 0000000000000..357e93438240c --- /dev/null +++ b/pages/ja/about/get-involved/events.mdx @@ -0,0 +1,16 @@ +--- +title: 今後のイベント +layout: about +--- + +## 今後のイベント + +Node.jsのイベントは公開されており、どんな方の参加も歓迎されています。 + +### 今後のNode.js®会議 + +Node.jsプロジェクトでは年間を通じて多くの会議を開催し、プロジェクトのさまざまな側面について議論し計画を立てています。 + +次の7日間ではこれらの会議が予定されています。 + + diff --git a/pages/ja/about/get-involved/index.md b/pages/ja/about/get-involved/index.md new file mode 100644 index 0000000000000..bdb21e9846047 --- /dev/null +++ b/pages/ja/about/get-involved/index.md @@ -0,0 +1,26 @@ +--- +title: 参加しよう +layout: about +--- + +# 参加しよう + +## コミュニティーでの議論 + +- [GitHub issues](https://github.com/nodejs/node/issues)がNode.jsのコア機能に関する議論の場となっています。 +- Node.jsの開発に関するリアルタイムのチャットには次のプラットフォームを利用してください。 + - IRCの場合は[IRCクライアント](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients)または[ウェブクライアント](https://kiwiirc.com/nextclient/)を利用して`irc.libera.chat`の`#node.js`チャンネルに参加してください。 + - Slackの場合は2つの選択肢があります: + - [OpenJSFのSlack](https://slack-invite.openjsf.org/)にはいくつかのNode.jsに関するチャンネルがあります(接頭辞として`#nodejs-`がつくチャンネル)。 + - [Node Slackers](https://www.nodeslackers.com/)はNode.jsに特化したSlackコミュニティーです。 +- Node.jsの公式Twitterアカウントは[nodejs](https://twitter.com/nodejs)です。 +- [Node.jsプロジェクトカレンダー](https://nodejs.org/calendar)では公開されている全ての会議を確認できます。 + +## 学ぶ + +- Node.jsのウェブサイトに[公式の学習セクション](https://nodejs.org/en/learn/)があります。 +- [公式のAPIリファレンス](https://nodejs.org/api/) +- [NodeSchool.io](https://nodeschool.io/)ではインタラクティブなコマンドラインゲームを通してNode.jsのコンセプトを学べます。 +- [Stack OverflowのNode.jsタグ](https://stackoverflow.com/questions/tagged/node.js)には毎日新しい情報が集まっています。 +- [DEVコミュニティーのNode.jsタグ](https://dev.to/t/node)はNode.jsのプロジェクト、記事、チュートリアルを共有したり、Node.js関連のトピックについてディスカッションしたり、フィードバックを求めたりする場になっています。どんなスキルレベルの方でも参加できます。 +- [Nodeiflux](https://discordapp.com/invite/vUsrbjd)はNode.jsのバックエンド開発者がDiscord上でお互いをサポートするフレンドリーなコミュニティーです。 diff --git a/pages/ja/download/package-manager/current.mdx b/pages/ja/download/package-manager/current.mdx new file mode 100644 index 0000000000000..81bc85396d4f4 --- /dev/null +++ b/pages/ja/download/package-manager/current.mdx @@ -0,0 +1,29 @@ +--- +layout: download +title: Node.js®をダウンロードする +subtitle: 好きな方法でNode.jsをダウンロードできます。 +--- + +
+を利用してにNode.js をインストールする。 + + +
+ +
+Node.jsはを同梱しています。 + +このバージョン +に関する変更点を確認する。 + +このバージョン +に関するブログ記事を確認する。 + + + 署名済みSHASUMSの検証方法 + +を確認する。 + +コミュニティーによってサポートされているその他のパッケージマネージャーを確認する。 + +
diff --git a/pages/ja/download/package-manager/index.mdx b/pages/ja/download/package-manager/index.mdx new file mode 100644 index 0000000000000..9235e0c26895a --- /dev/null +++ b/pages/ja/download/package-manager/index.mdx @@ -0,0 +1,29 @@ +--- +layout: download +title: Node.js®をダウンロードする +subtitle: 好きな方法でNode.jsをダウンロードできます。 +--- + +
+を利用して用のNode.js をインストールする。 + + +
+ +
+Node.jsはを同梱しています。 + +このバージョン +に関する変更点を確認する。 + +このバージョン +に関するブログ記事を確認する。 + + + 署名済みSHASUMSの検証方法 + +を確認する。 + +コミュニティーによってサポートされているその他のパッケージマネージャーを確認する。 + +
diff --git a/pages/ja/download/prebuilt-binaries/current.mdx b/pages/ja/download/prebuilt-binaries/current.mdx new file mode 100644 index 0000000000000..5219eba628248 --- /dev/null +++ b/pages/ja/download/prebuilt-binaries/current.mdx @@ -0,0 +1,28 @@ +--- +layout: download +title: Node.js®をダウンロードする +subtitle: 好きな方法でNode.jsをダウンロードできます。 +--- + +
+で動作している用のNode.jsをダウンロードする。 + + +
+ +
+Node.jsはを同梱しています。 + +このバージョン +の変更点を確認する。 + +このバージョン +に関するブログ記事を確認する。 + + + 署名済みSHASUMSの検証方法 + +を確認する。 + +ナイトリービルドや他のプラットフォーム用の非公式のビルドがあります。 +
diff --git a/pages/ja/download/prebuilt-binaries/index.mdx b/pages/ja/download/prebuilt-binaries/index.mdx new file mode 100644 index 0000000000000..5219eba628248 --- /dev/null +++ b/pages/ja/download/prebuilt-binaries/index.mdx @@ -0,0 +1,28 @@ +--- +layout: download +title: Node.js®をダウンロードする +subtitle: 好きな方法でNode.jsをダウンロードできます。 +--- + +
+で動作している用のNode.jsをダウンロードする。 + + +
+ +
+Node.jsはを同梱しています。 + +このバージョン +の変更点を確認する。 + +このバージョン +に関するブログ記事を確認する。 + + + 署名済みSHASUMSの検証方法 + +を確認する。 + +ナイトリービルドや他のプラットフォーム用の非公式のビルドがあります。 +
diff --git a/pages/ja/download/source-code/current.mdx b/pages/ja/download/source-code/current.mdx new file mode 100644 index 0000000000000..2d5e3c07bd222 --- /dev/null +++ b/pages/ja/download/source-code/current.mdx @@ -0,0 +1,29 @@ +--- +layout: download +title: Node.js®をダウンロードする +subtitle: 好きな方法でNode.jsをダウンロードできます。 +--- + +
+Node.js のソースコードをダウンロードする。 + + +
+ +
+Node.jsはを同梱しています。 + +このバージョン +の変更点を確認する。 + +このバージョン +に関するブログ記事を確認する。 + + + 署名済みSHASUMSの検証方法 + +を確認する。 + +ソースコードからNode.jsをビルドする方法を確認する。 + +
diff --git a/pages/ja/download/source-code/index.mdx b/pages/ja/download/source-code/index.mdx new file mode 100644 index 0000000000000..2d5e3c07bd222 --- /dev/null +++ b/pages/ja/download/source-code/index.mdx @@ -0,0 +1,29 @@ +--- +layout: download +title: Node.js®をダウンロードする +subtitle: 好きな方法でNode.jsをダウンロードできます。 +--- + +
+Node.js のソースコードをダウンロードする。 + + +
+ +
+Node.jsはを同梱しています。 + +このバージョン +の変更点を確認する。 + +このバージョン +に関するブログ記事を確認する。 + + + 署名済みSHASUMSの検証方法 + +を確認する。 + +ソースコードからNode.jsをビルドする方法を確認する。 + +
diff --git a/pages/ja/index.mdx b/pages/ja/index.mdx new file mode 100644 index 0000000000000..ba34b86b0c6c4 --- /dev/null +++ b/pages/ja/index.mdx @@ -0,0 +1,137 @@ +--- +title: Run JavaScript Everywhere +layout: home +--- + +
+ + +
+

Run JavaScript Everywhere

+ +Node.js®は自由かつオープンソースでクロスプラットフォームに対応したJavaScript実行環境です。開発者にサーバー、ウェブアプリ、コマンドラインツール、スクリプトの開発環境を提供します。 + +
+ +
+ + {({ release }) => ( + <> + Node.js (LTS)をダウンロードする + + 長期サポート版Node.js {release.versionWithPrefix} + 1をダウンロードする。 + パッケージマネージャーを利用したインストール方法もあります。 + + + )} + + + + {({ release }) => ( + + 最新の機能をすぐに試したい場合は + Node.js {release.versionWithPrefix} + 1をインストールできます。 + + )} + +
+
+ +
+
+ ```js displayName="Create an HTTP Server" + // server.mjs + import { createServer } from 'node:http'; + +const server = createServer((req, res) => { +res.writeHead(200, { 'Content-Type': 'text/plain' }); +res.end('Hello World!\n'); +}); + +// starts a simple http server locally on port 3000 +server.listen(3000, '127.0.0.1', () => { +console.log('Listening on 127.0.0.1:3000'); +}); + +// run with `node server.mjs` + +```` + +```js displayName="Write Tests" +// tests.mjs +import assert from 'node:assert'; +import test from 'node:test'; + +test('that 1 is equal 1', () => { + assert.strictEqual(1, 1); +}); + +test('that throws as 1 is not equal 2', () => { + // throws an exception because 1 != 2 + assert.strictEqual(1, 2); +}); + +// run with `node tests.mjs` +```` + +```js displayName="Read and Hash a File" +// crypto.mjs +import { createHash } from 'node:crypto'; +import { readFile } from 'node:fs/promises'; + +const hasher = createHash('sha1'); + +hasher.setEncoding('hex'); +// ensure you have a `package.json` file for this test! +hasher.write(await readFile('package.json')); +hasher.end(); + +const fileHash = hasher.read(); + +// run with `node crypto.mjs` +``` + +```js displayName="Streams Pipeline" +// streams.mjs +import { pipeline } from 'node:stream/promises'; +import { createReadStream, createWriteStream } from 'node:fs'; +import { createGzip } from 'node:zlib'; + +// ensure you have a `package.json` file for this test! +await pipeline( + createReadStream('package.json'), + createGzip(), + createWriteStream('package.json.gz') +); + +// run with `node streams.mjs` +``` + +```js displayName="Work with Threads" +// threads.mjs +import { + Worker, + isMainThread, + workerData, + parentPort, +} from 'node:worker_threads'; + +if (isMainThread) { + const data = 'some data'; + const worker = new Worker(import.meta.filename, { workerData: data }); + worker.on('message', msg => console.log('Reply from Thread:', msg)); +} else { + const source = workerData; + parentPort.postMessage(btoa(source.toUpperCase())); +} + +// run with `node threads.mjs` +``` + +
+ +私たちの[学習教材](/learn)でNode.jsでできることをさらに学んでみましょう。 + +
diff --git a/pages/ja/search.mdx b/pages/ja/search.mdx new file mode 100644 index 0000000000000..ad7e918069f96 --- /dev/null +++ b/pages/ja/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: 検索結果 +--- + + diff --git a/pages/pt/about/branding.mdx b/pages/pt/about/branding.mdx new file mode 100644 index 0000000000000..9e20fdf437a4d --- /dev/null +++ b/pages/pt/about/branding.mdx @@ -0,0 +1,72 @@ +--- +title: Marca da Node.js +layout: about +--- + +Marca da Node.js + +Consultar a [política de marcas registadas](https://trademark-policy.openjsf.org/) por informação sobre a utilização permitida dos logótipos e marcas da Node.js®. + +## Mascote da Node.js® + +Mascote da Node.js + +## Logótipo da Node.js® + +### Logótipo Horizontal da Node.js® + + + + + + + +
+ Logótipo Escuro Horizontal da Node.js + + Logótipo Claro Horizontal da Node.js +
+ +### Logótipo Empilhado da Node.js® + + + + + + + + + + + + + +
+ Logótipo Escuro Empilhado da Node.js + + Logótipo Claro Empilhado da Node.js +
+ Logótipo Empilhado Preto da Node.js + + Logótipo Empilhado Branco da Node.js +
+ +### Ícones da JS + + + + + + + +
+ Ícones da JS Verde + + Ícones da JS Branco +
diff --git a/pages/pt/about/get-involved/collab-summit.md b/pages/pt/about/get-involved/collab-summit.md new file mode 100644 index 0000000000000..c862a0c886777 --- /dev/null +++ b/pages/pt/about/get-involved/collab-summit.md @@ -0,0 +1,16 @@ +--- +title: Cimeira de Colaboração +layout: about +--- + +# Cimeira de Colaboração + +A Cimeira da Colaboração do Node.js é uma conferência para reunir atuais e potenciais colaboradores para discutir o Node.js com colaboração ativa, educação e partilha de conhecimento. Equipas, grupos de trabalho e colaboradores da comunidade reúnem-se duas vezes por ano para realizar discussões que ajudam na tomada de decisões, ao mesmo tempo em que trabalham pessoalmente em alguns esforços interessantes que desejam levar adiante. + +## Quem participa? + +A Cimeira de Colaboração conta principalmente com a participação de contribuidores existentes e membros da comunidade, mas também dá as boas-vindas àqueles que ainda não são contribuidores e desejam participar. Se você é novo na contribuição para o Node.js, a Cimeira da Colaboração pode ser uma boa oportunidade para ajudá-lo a aprender o que está a acontecer na comunidade e contribuir com as habilidades que você possui e gostaria de aprimorar. + +Antes da cimeira, colaboradores e membros da comunidade enviam propostas de sessões para criar um cronograma. Os participantes podem se familiarizar com a sessão antes de chegar ao local, ter discussões gerais com os colaboradores e depois assistir às sessões. Haverá também muitas oportunidades para socializar e debater ideias. + +Para mais informações sobre as próximas e anteriores Cimeiras da Colaboração, veja o [repositório das Cimeiras](https://github.com/openjs-foundation/summit). Veja também os [problemas arquivados](https://github.com/nodejs/summit/issues) que partilham o que os colaboradores e membros da comunidade estão a propor discutir pessoalmente. diff --git a/pages/pt/about/get-involved/contribute.md b/pages/pt/about/get-involved/contribute.md new file mode 100644 index 0000000000000..54f66f7b64bde --- /dev/null +++ b/pages/pt/about/get-involved/contribute.md @@ -0,0 +1,47 @@ +--- +title: Contribuir +layout: about +--- + +# Contribuir + +Obrigado pelo teu interesse em contribuir para o Node.js! Existem várias maneiras e lugares onde podes contribuir e estamos aqui para ajudar a facilitar isso. + +## Pedir Ajuda Geral + +Como o nível de atividade no repositório `nodejs/node` é muito alto, perguntas ou solicitações de ajuda gerais usando o Node.js devem ser direcionadas ao [repositório de ajuda do Node.js](https://github.com/nodejs/ajuda/problemas). + +## Reportar um Problema + +Se encontrarmos o que acreditarmos ser um problema com a Node.js, não deveríamos hesitar em registar um problema no projeto da GitHub. Quando registarmos o problema, devemos certificar-nos de incluir um caso de teste reproduzível e que este caso de teste não inclua nenhuma dependência externa. Ou seja, o caso de teste possa ser executado sem nada além do próprio Node.js. + +Quando relatarmos um problema, também precisamos do máximo de informações que pudermos incluir sobre o ambiente de desenvolvimento. Nunca sabemos quais informações serão pertinentes ao tentar restringir o problema. Então, devemos incluir pelo menos as seguintes informações: + +- Versão do Node.js +- Plataforma que está a usar (macOS, SmartOS, Linux, Windows) +- Arquitetura que executamos (32bits ou 64bits e x86 ou ARM) + +O projeto Node.js é atualmente administrado em vários repositórios GitHub separados, cada um com seu próprio banco de dados de problemas separados. Se possível, direcione quaisquer problemas que encontre para o repositório apropriado, mas não se preocupe se colocar no repositório errado, a comunidade de colaboradores ficará mais do que feliz em ajudá-lo a apontar na direção correta. + +- Para relatar problemas específicos do Node.js, usa [nodejs/node](https://github.com/nodejs/node) +- Para relatar problemas específicos deste site, usa [nodejs/nodejs.org](https://github.com/nodejs/nodejs.org/issues) + +## Contribuições de código + +Se você quiser corrigir bugs ou adicionar uma nova funcionalidade ao Node.js, consulte as [Diretrizes de contribuição do Node.js](https://github.com/nodejs/node/blob/main/CONTRIBUTING.md/#pull-solicitações). O processo de revisão por parte dos colaboradores existentes para todas as contribuições para o projeto também é explicado lá. + +Se estivermos em dúvida sobre como começar, podemos consultar a [NodeTodo](https://www.nodetodo.org/) que pode guiar-nos rumo a nossa primeira contribuição. + +## Torne-se um colaborador + +Ao seres um colaborador, os contribuidores podem ter ainda mais impacto no projeto. Eles podem ajudar outros colaboradores revendo as suas contribuições, selecionando problemas e ter um papel ainda maior no rumo do futuro do projeto. Indivíduos identificados pelo TSC como fazendo contribuições significativas e valiosas em qualquer repositório Node.js podem ser nomeados Colaboradores e ter acesso de commit ao projeto. As atividades levadas em consideração incluem (mas não estão limitadas a) a qualidade de: + +- commits de código e pull requests +- documentação de commits e pull requests +- comentários em problemas e pull requests +- contribuições para o site Node.js +- assistência fornecida a utilizadores finais e colaboradores novos +- participação em grupos de trabalhos +- outra participação na grande comunidade do Node.js + +Se indivíduos que fizeram contribuições valiosas não acreditarem que foram considerados para acesso de commit, eles poderão [registrar um problema](https://github.com/nodejs/TSC/issues) ou [entrar em contato com um membro do TSC](https:// github.com/nodejs/node#tsc-technical-steering-committee) diretamente. diff --git a/pages/pt/about/get-involved/events.mdx b/pages/pt/about/get-involved/events.mdx new file mode 100644 index 0000000000000..fbb2b8f05a4e1 --- /dev/null +++ b/pages/pt/about/get-involved/events.mdx @@ -0,0 +1,16 @@ +--- +title: Próximos Eventos +layout: about +--- + +## Próximos Eventos + +Os eventos do Node.js são abertos e disponíveis ao público. Qualquer pessoa é bem-vinda para entrar e participar. + +### Próximas reuniões do Node.js® + +projeto Node.js realiza várias reuniões ao longo do ano para discutir e planear aspetos do projeto. + +As próximas reuniões que vão ocorrer nos próximos 7 dias. + + diff --git a/pages/pt/about/get-involved/index.md b/pages/pt/about/get-involved/index.md new file mode 100644 index 0000000000000..03833b4a02692 --- /dev/null +++ b/pages/pt/about/get-involved/index.md @@ -0,0 +1,26 @@ +--- +title: Participe +layout: about +--- + +# Participe + +## Discussão de Comunidade + +- A [Lista de Problemas no Github](https://github.com/nodejs/node/issues) é o local para discussões sobre as funcionalidades principais do Node.js. +- Para comunicação em tempo real sobre o desenvolvimento do Node.js, use uma das plataformas abaixo + - Para IRC, acesse `irc.libera.chat` no canal `#node.js` utilizando um [cliente IRC](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) ou junte-se ao canal com o seu navegador usando um [cliente web](https://kiwiirc.com/nextclient/) + - Para o Slack, existe duas opções: + - O [OpenJSF Slack](https://slack-invite.openjsf.org/) é um Slack administrado pela Fundação com vários canais Node.js (canais com o prefixo `#nodejs-` estão relacionados ao projeto). + - [Node Slackers](https://www.nodeslackers.com/) é uma comunidade do Slack focada em Node.js. +- A conta oficial do Node.js no Twitter é [nodejs](https://twitter.com/nodejs). +- O [calendário do projeto Node.js](https://nodejs.org/calendar) com todas as reuniões públicas da equipa. + +## Estudos + +- [Secção oficial de aprendizagem](https://nodejs.org/en/learn/) do sítio da Node.js. +- [Documentação oficial de referência da API](https://nodejs.org/api/). +- [NodeSchool.io](https://nodeschool.io/) ensina conceitos de Node.js por jogos interativos da linha de comandos. +- [A tag Stack Overflow Node.js](https://stackoverflow.com/questions/tagged/node.js) coleta novas informações todos os dias. +- [A tag Node.js da comunidade DEV](https://dev.to/t/node) é um lugar para partilhar projetos, artigos e tutoriais do Node.js, bem como iniciar discussões e pedir feedback sobre assuntos relacionados ao Node.js. Desenvolvedores de todos os níveis de habilidade podem participar. +- [Nodeiflux](https://discordapp.com/invite/vUsrbjd) é uma comunidade amigável de desenvolvedores de backend Node.js que se apoiam uns aos outros no Discord. diff --git a/pages/pt/about/governance.md b/pages/pt/about/governance.md new file mode 100644 index 0000000000000..7fed8c9af7bd0 --- /dev/null +++ b/pages/pt/about/governance.md @@ -0,0 +1,31 @@ +--- +title: Gestão do Projeto +layout: about +--- + +# Gestão do Projeto + +## Processo de Procura de Consenso + +O projeto Node.js segue um modelo de tomada de decisão de [Procura de Consenso][Consensus Seeking]. + +## Colaboradores + +O repositório central da GitHub [nodejs/node][] é mantido pelos colaboradores nomeados por outros colaboradores existentes numa base contínua. + +Os indivíduos que fazem contribuições significativas e valiosas são nomeados colaboradores e têm acesso ao projeto. Estes indivíduos são identificados por outros colaboradores e a sua nomeação é discutida com os colaboradores existentes. + +Para a lista atual de colaboradores, consultar o [README.md][] do projeto. + +Um guia para colaboradores é mantido no [collaborator-guide.md][]. + +## Comité de Direção Técnica + +O projeto é gerido pelo [Comité de Direção Técnica][Technical Steering Committee (TSC)] responsável pela orientação de alto nível do projeto. O TSC é um subconjunto de colaboradores ativos nomeados por outros membros existentes do TSC. + +[consensus seeking]: https://en.wikipedia.org/wiki/Consensus-seeking_decision-making +[readme.md]: https://github.com/nodejs/node/blob/main/README.md#current-project-team-members +[tsc]: https://github.com/nodejs/TSC +[technical steering committee (tsc)]: https://github.com/nodejs/TSC/blob/main/TSC-Charter.md +[collaborator-guide.md]: https://github.com/nodejs/node/blob/main/doc/contributing/collaborator-guide.md +[nodejs/node]: https://github.com/nodejs/node diff --git a/pages/pt/about/index.mdx b/pages/pt/about/index.mdx new file mode 100644 index 0000000000000..5a9795a95a8a3 --- /dev/null +++ b/pages/pt/about/index.mdx @@ -0,0 +1,60 @@ +--- +title: Sobre a Node.js® +layout: about +--- + +Sobre a Node.js® + +Como uma execução de JavaScript assíncrona orientada a eventos, a Node.js foi desenhada para construir aplicações de rede escaláveis. No seguinte exemplo de "hello world", muitas conexões podem ser manipuladas simultaneamente. Em cada conexão, a função de retorno de chamada é disparada, mas se não existir trabalho a ser feito, a Node.js dormirá. + +```cjs +const { createServer } = require('node:http'); + +const hostname = '127.0.0.1'; +const port = 3000; + +const server = createServer((req, res) => { + res.statusCode = 200; + res.setHeader('Content-Type', 'text/plain'); + res.end('Hello World'); +}); + +server.listen(port, hostname, () => { + console.log(`Server running at http://${hostname}:${port}/`); +}); +``` + +```mjs +import { createServer } from 'node:http'; + +const hostname = '127.0.0.1'; +const port = 3000; + +const server = createServer((req, res) => { + res.statusCode = 200; + res.setHeader('Content-Type', 'text/plain'); + res.end('Hello World'); +}); + +server.listen(port, hostname, () => { + console.log(`Server running at http://${hostname}:${port}/`); +}); +``` + +Isto contrasta com o modelo de concorrência mais comum atualmente, em que são utilizadas as linhas de processamento do sistema operativo. A conexão de rede baseada em linhas de processamento é relativamente ineficiente e muito difícil de usar. Além disto, os utilizadores da Node.js estão livres de preocupações com o bloqueio do processo, uma vez que não existem bloqueios. Quase nenhuma função na Node.js executa diretamente E/S, pelo que o processo nunca bloqueia, exceto quando as E/S são executadas usando métodos síncronos da biblioteca padrão da Node.js. Uma vez que nada bloqueia, os sistemas escaláveis são muito razoáveis de desenvolver na Node.js. + +Se alguma desta linguagem não for familiar, existe um artigo completo sobre [Bloqueio vs Não Bloqueio][Blocking vs. Non-Blocking]. + +--- + +Node.js é semelhante em desenho a, e influenciada por, sistemas como a [Máquina de Evento][Event Machine] da Ruby e o [Twisted][Twisted] da Python. A Node.js leva o modelo de evento um pouco mais longe. Esta apresenta um ciclo de eventos como uma construção de execução e não como uma biblioteca. Noutros sistemas, existe sempre uma chamada bloqueante para começar o ciclo de eventos. Tipicamente, o comportamento é definido através das funções de retorno de chamada no início de um programa, e no final um servidor é iniciado através duma chamada bloqueante como `EventMachine::run()`. Na Node.js, não existe essa chama que começa o ciclo de evento. A Node.js simplesmente entra no ciclo de eventos após executar o programa de entrada. A Node.js sai do ciclo de eventos quando não existir mais funções de retorno de chamada para executar. Este comportamento é semelhante a JavaScript do navegador — o ciclo de eventos está oculto para o utilizador. + +protocolo de transferência de hipertexto é um cidadão de primeira classe na Node.js, desenhado com fluxo contínuo e baixa latência em mente. Isto torna a Node.js adequada para a fundação duma biblioteca ou abstração da Web. + +fato da Node.js ter sido desenhada sem linhas de processamento não significa que não possamos tirar partido de vários núcleos no nosso ambiente. Os processos filhos podem ser gerados com o uso da nossa interface de programação de aplicação [`child_process.fork()`][], e estão desenhadas para serem fáceis de se comunicar. Construída sobre esta mesma interface está o módulo [`cluster`][], que permite-nos partilhar tomadas entre processos para permitir o balanceio de carga entre os nossos núcleos. + +[bloqueio vs não bloqueio]: /learn/asynchronous-work/overview-of-blocking-vs-non-blocking +[`child_process.fork()`]: https://nodejs.org/api/child_process.html +[`cluster`]: https://nodejs.org/api/cluster.html +[máquina de evento]: https://github.com/eventmachine/eventmachine +[torcido]: https://twisted.org/ diff --git a/pages/pt/about/previous-releases.mdx b/pages/pt/about/previous-releases.mdx new file mode 100644 index 0000000000000..1d98dae5c5f35 --- /dev/null +++ b/pages/pt/about/previous-releases.mdx @@ -0,0 +1,18 @@ +--- +title: Lançamentos da Node.js +layout: about +--- + +Lançamentos da Node.js + +As principais versões da Node.js entram no estado de lançamento _Atual (Current)_ por seis meses, o que dá aos autores de bibliotecas tempo para adicionar suporte a estas. Depois de seis meses, as versões de número ímpares (9, 11, etc.) deixam de ser suportadas e as versões de números pares (10, 12, etc) passam para o estado _SLP Ativo (Active LTS)_ e estão prontas para uso geral. O estado de lançamento _SLP (LTS)_ é “suporte de longo prazo”, o que normalmente garante que os erros de programação críticos serão corrigidos durante um total de 30 meses. As aplicações de produção apenas devem usar os lançamentos _SLP Ativo (Active LTS)_ ou _SLP de Manutenção (Maintenance LTS)_. + +## Calendário de Lançamento + +![Lançamentos](https://raw.githubusercontent.com/nodejs/Release/main/schedule.svg?sanitize=true) + +Todos os detalhes sobre o calendário de lançamento da Node.js estão disponíveis [na GitHub](https://github.com/nodejs/release#release-schedule). + +## Procura o lançamento mais recente de um ramo de versão? + + diff --git a/pages/pt/about/security-reporting.mdx b/pages/pt/about/security-reporting.mdx new file mode 100644 index 0000000000000..184f4b990d644 --- /dev/null +++ b/pages/pt/about/security-reporting.mdx @@ -0,0 +1,64 @@ +--- +title: Relatórios de Segurança +layout: about +--- + +Relatórios de Segurança + +Para obter mais informações sobre as Políticas de Segurança ativas, consultar [esta página](https://github.com/nodejs/node/security/policy). + +## Reportar um erro na Node.js + +Reportar erros de segurança na Node.js através da [HackerOne](https://hackerone.com/nodejs). + +nosso relatório será confirmado dentro de 5 dias e receberemos uma resposta mais detalhada ao nosso relatório dentro de 10 dias, indicando os próximos passos no tratamento da nossa submissão. + +Após a resposta inicial ao nosso relatório, a equipa de segurança esforçar-se-á por manter-nos informados sobre os progressos realizados no sentido duma correção e de um anúncio completo, podendo solicitar informações ou orientações adicionais sobre o problema reportado. + +### Programa de recompensa por erros da Node.js + +projeto Node.js tem um programa oficial de recompensa por erros para investigadores de segurança e divulgações públicas responsáveis. O programa é gerido através da plataforma HackerOne. Consultar [https://hackerone.com/nodejs](https://hackerone.com/nodejs) por mais detalhes. + +## Reportar um erro num módulo de terceiro + +Os erros de segurança em módulos de terceiros devem ser reportados aos seus respetivos responsáveis. + +## Política de Divulgação + +Eis a política de divulgação de segurança da Node.js + +O relatório de segurança é recebido e é-lhe atribuído um responsável principal. Esta pessoa coordenará o processo de correção e lançamento. O problema é confirmado e determinada uma lista de todas as versões afetadas. O código é auditado para detetar quaisquer problemas semelhantes. São preparadas correções para todas as versões que ainda se encontram em manutenção. Estas correções não são colocadas no repositório público, mas sim mantidas localmente enquanto se aguarda o anúncio. + +É selecionada uma data de embargo para esta vulnerabilidade e requisitada um CVE (Common Vulnerabilities and Exposures (CVE®)) para a vulnerabilidade. + +Na data do embargo, a lista de discussão de segurança da Node.js recebe uma cópia do anúncio. As alterações são enviadas ao repositório público e novas compilações são implantadas na nodejs.org. Dentro de 6 horas após a notificação da lista de correio eletrónico, será publicada uma cópia do aviso no blogue da Node.js. + +Normalmente, a data de embargo será definida 72 horas a partir do momento em que o CVE é emitido. No entanto, isto pode variar consoante a gravidade do erro ou a dificuldade em aplicar uma correção. + +Este processo pode demorar algum tempo, especialmente quando é necessária coordenação com os responsáveis de outros projetos. Todos os esforços serão feitos para tratar o erro da maneira mais atempada possível; no entanto, é importante que sigamos o processo de divulgação acima referido para garantir que a divulgação é tratada de maneira consistente. + +## Receber atualizações de segurança + +As notificações de segurança serão distribuídas através dos seguintes métodos. + +[Grupo da Google](https://groups.google.com/group/nodejs-sec) +[Blogue da Node.js](/blog) + +## Comentários sobre esta política + +Se tivermos sugestões sobre como este processo poderia ser melhorado, podemos submeter um [pedido de atualização](https://github.com/nodejs/nodejs.org) ou [registar um problema](https://github.com/nodejs/security-wg/issues/new) a discutir-se. + +## Boas Práticas da OpenSSF + + + Distintivo da OpenSSF + + +distintivo de boas práticas da “Open Source Security Foundation (OpenSSF)” é uma maneira de os projetos de Software Livre e de Código Aberto (FLOSS) mostrarem que seguem as boas práticas. Os projetos podem certificar-se voluntariamente como seguem cada uma das boas práticas. Os consumidores do distintivo podem avaliar rapidamente quais os projetos FLOSS que seguem as boas práticas e, consequentemente, têm maior probabilidade de produzir software seguro de superior qualidade. diff --git a/pages/pt/download/package-manager/all.md b/pages/pt/download/package-manager/all.md new file mode 100644 index 0000000000000..7a9b32cab0f5e --- /dev/null +++ b/pages/pt/download/package-manager/all.md @@ -0,0 +1,417 @@ +--- +layout: download +title: Instalação da Node.js através do Gestor de Pacote +--- + +# Instalação da Node.js através dos Gestores de Pacote + +> Os pacotes nesta página são mantidos e suportados por seus respetivos empacotadores, **não** pela equipa principal da Node.js. Precisamos reportar quaisquer problemas que encontrarmos ao responsável do pacote. Se o nosso problema for um erro de programação na própria Node.js, o responsável reportará o problema. + +--- + +- [Alpine Linux](#alpine-linux) +- [Android](#android) +- [Arch Linux](#arch-linux) +- [CentOS, Fedora e Red Hat Enterprise Linux](#centos-fedora-e-red-hat-enterprise-linux) +- [Distribuições de Linux baseadas em Debian e Ubuntu](#distribuicoes-de-linux-baseadas-em-debian-e-ubuntu) +- [Exherbo Linux](#exherbo-linux) +- [fnm](#fnm) +- [FreeBSD](#freebsd) +- [Gentoo](#gentoo) +- [IBM i](#ibm-i) +- [macOS](#macos) +- [n](#n) +- [NetBSD](#netbsd) +- [Nodenv](#nodenv) +- [nvm](#nvm) +- [nvs](#nvs) +- [OpenBSD](#openbsd) +- [openSUSE e SLE](#opensuse-e-sle) +- [SmartOS e illumos](#smartos-e-illumos) +- [Snap](#snap) +- [Solus](#solus) +- [vfox](#vfox) +- [Void Linux](#void-linux) +- [Windows](#windows-1) +- [z/OS](#zos) + +--- + +## Linux Alpino + +Os pacotes da Node.js com suporte de longo prazo e npm estão disponíveis no repositório principal. + +```bash +apk add nodejs npm +``` + +A versão atual da Node.js pode ser instalada a partir do repositório da comunidade. + +```bash +apk add nodejs-current +``` + +## Android + +O suporte de Android ainda é experimental na Node.js, pelo que os binários pré-compilados ainda não são fornecidos pelos programadores da Node.js. + +No entanto, existem algumas soluções de terceiros. Por exemplo, a comunidade da [Termux](https://termux.com/) fornece um emulador de terminal e um ambiente de Linux para Android, bem como um gestor de pacote e uma [vasta coleção](https://github.com/termux/termux-packages) de muitas aplicações pré-compiladas. Este comando na aplicação Termux instalará a última versão disponível da Node.js: + +```bash +pkg install nodejs +``` + +Atualmente, os binários da Node.js da Termux estão ligados ao `system-icu` (dependendo do pacote `libicu`). + +## Linux Arch + +Os pacotes da Node.js e npm estão disponíveis no repositório da comunidade. + +```bash +pacman -S nodejs npm +``` + +## CentOS, Fedora e Red Hat Enterprise Linux + +A Node.js está disponível como um módulo chamado `nodejs` no CentOS/RHEL 8 e Fedora. + +```bash +dnf module install nodejs: +``` + +onde `` corresponde à versão principal da Node.js. Para ver uma lista de fluxos disponíveis: + +```bash +dnf module list nodejs +``` + +Por exemplo, para instalar a Node.js 18: + +```bash +dnf module install nodejs:18/common +``` + +### Alternativas + +Estes recursos fornecem pacotes compatíveis com CentOS, Fedora, e RHEL. + +- [Os snaps da Node.js](#snap) mantidos e suportados na https://github.com/nodejs/snap +- [Distribuições binárias da Node.js](#distribuicoes-de-linux-baseadas-em-debian-e-ubuntu) mantidas e suportadas pela [NodeSource](https://github.com/nodesource/distributions) + +## Distribuições de Linux baseadas em Debian e Ubuntu + +As [distribuições binárias da Node.js](https://github.com/nodesource/distributions) estão disponíveis a partir da NodeSource. + +### Alternativas + +Os pacotes compatíveis com as distribuições de Linux baseadas em Debian e Ubuntu estão disponíveis através dos [snaps da Node.js](#snap). + +## Exherbo Linux + +Os pacotes da Node.js e npm estão disponíveis no [repositório da arbor](https://gitlab.exherbo.org/exherbo/arbor/-/tree/master/packages/dev-lang/node). + +```bash +cave resolve -x node +``` + +## fnm + +Rápido e simples gestor de versão da Node.js, construído em Rust, usado para gerir várias versões lançadas da Node.js. Permite-nos realizar operações como instalar, desinstalar, mudar automaticamente as versões da Node com base no diretório atual, etc. +Para instalar o `fnm`, usamos este [programa de instalação](https://github.com/Schniz/fnm#using-a-script-macoslinux). + +O `fnm` suporta várias plataformas (macOS, Windows, Linux) & todas as conchas populares (Bash, Zsh, Fish, PowerShell, Windows Command Line Prompt). +O `fnm` foi construído com a velocidade em mente e suporte de compatibilidade para ficheiros `.node-version` e `.nvmrc`. + +## FreeBSD + +O lançamento mais recente da Node.js está disponível através da porta [www/node](https://www.freshports.org/www/node). + +Instalamos um pacote binário através do [pkg](https://www.freebsd.org/cgi/man.cgi?pkg): + +```bash +pkg install node +``` + +Ou o compilamos nós mesmos usando as [portas](https://www.freebsd.org/cgi/man.cgi?ports): + +```bash +cd /usr/ports/www/node && make install +``` + +## Gentoo + +A Node.js está disponível na árvore de transporte. + +```bash +emerge nodejs +``` + +## IBM i + +As versões de suporte de longo prazo da Node.js estão disponíveis a partir da IBM, e estão disponíveis através do [gestor de pacote `yum`](https://ibm.biz/ibmi-rpms). O nome do pacote é `nodejs` seguido pelo número da versão principal (por exemplo, `nodejs18`, `nodejs20`, etc). + +Para instalar a Node.js 20.x a partir da linha de comando, executamos o seguinte como um utilizador com autorização especial \*ALLOBJ: + +```bash +yum install nodejs20 +``` + +A Node.js também pode ser instalada com o produto de soluções de cliente de acesso IBM i. Consultar [este documento de suporte](http://www-01.ibm.com/support/docview.wss?uid=nas8N1022619) por mais detalhes. + +## macOS + +Descarregamos o [instalador do macOS](/#home-downloadhead) diretamente a partir do sítio da Web [nodejs.org](https://nodejs.org/). + +_Se quisermos descarregar o pacote com o bash:_ + +```bash +curl "https://nodejs.org/dist/latest/$(curl -s https://nodejs.org/dist/latest/ | grep "pkg" | cut -d'"' -f 2)" -o "$HOME/Downloads/node-latest.pkg" && sudo installer -store -pkg "$HOME/Downloads/node-latest.pkg" -target "/" +``` + +### Alternativas + +Com o uso do **[Homebrew](https://brew.sh/)**: + +```bash +brew install node +``` + +Com o uso do **[MacPorts](https://www.macports.org/)**: + +```bash +port install nodejs + +# Example +port install nodejs7 +``` + +Com o uso do **[pkgsrc](https://pkgsrc.joyent.com/install-on-macos/)**: + +Instalar o pacote binário: + +```bash +pkgin -y install nodejs +``` + +Ou construir manualmente a partir do `pkgsrc`: + +```bash +cd pkgsrc/lang/nodejs && bmake install +``` + +## n + +`n` é um gestor de versão da Node.js simples de usar para Mac e Linux. Especificamos a versão de destino a instalar usando uma sintaxe rica, ou selecionamos a partir de um menu de versões previamente descarregadas. As versões são instaladas em todo o sistema ou em todo o utilizador, e para um uso mais específico, podemos executar uma versão diretamente a partir das transferências provisionadas. + +Consultar a [página principal](https://github.com/tj/n) por métodos de instalação (inicialização, npm, Homebrew, terceiros) e todos os detalhes de uso. + +Se já tivermos o `npm`, então instalar o `n` e depois a versão mais recente da `node` com suporte de longo prazo é tão simples quanto: + +``` +npm install -g n +n lts +``` + +## NetBSD + +A Node.js está disponível na árvore do `pkgsrc`: + +```bash +cd /usr/pkgsrc/lang/nodejs && make install +``` + +Ou instalamos um pacote binário (se estiver disponível para nossa plataforma) usando `pkgin`: + +```bash +pkgin -y install nodejs +``` + +## Nodenv + +`nodeenv` é um gestor de versão de Node leve, semelhante ao `nvm`. É simples e previsível. Um rico ecossistema de extensão permite-nos adaptá-lo às nossas necessidades. Usamos `nodenv` para escolher uma versão de Node para a nossa aplicação e garantir que o nosso ambiente de desenvolvimento seja igual ao de produção. + +As instruções de instalação da Nodeenv são mantidos [na sua página da GitHub](https://github.com/nodenv/nodenv#installation). Precisamos visitar esta página para assegurar que seguimos versão mais recente dos passos de instalação. + +## nvm + +O gestor de versão da Node é um programa de bash usado para gerir várias versões lançadas da Node.js. Permite-nos realizar operações como instalar, desinstalar, alternar versão, etc. Para instalar a `nvm`, usamos este [programa de instalação](https://github.com/nvm-sh/nvm#install--update-script). + +Nos sistemas Unix ou OS X, a Node.js construída a partir do código-fonte pode ser instalada usando [nvm](https://github.com/creationix/nvm) ao instalar numa localização esperada pelo `nvm`: + +```bash +env VERSION=`python tools/getnodeversion.py` make install DESTDIR=`nvm_version_path v$VERSION` PREFIX="" +``` + +Depois disto, podemos usar o `nvm` para alternar entre versões lançadas e versões construídas a partir do código-fonte. Por exemplo, se a versão da Node.js for v8.0.0-pre: + +```bash +nvm use 8 +``` + +Quando a versão oficial for lançada, desejaremos desinstalar a versão construída a partir do código-fonte: + +```bash +nvm uninstall 8 +``` + +## nvs + +#### Windows + +O gestor de versão `nvs` suporta várias plataformas e pode ser usado no Windows, macOS, e sistemas parecidos com Unix. + +Para instalar `nvs` no Windows seguimos para [página de lançamento](https://github.com/jasongin/nvs/releases) e descarregamos o ficheiro instalador MSI do lançamento mais recente. + +Nós também podemos usar `chocolatey` para instalá-lo: + +```bash +choco install nvs +``` + +#### macOS,UnixLike + +Podemos encontrar documentação sobre os passos de instalação do `nvs` nos sistemas macOS ou parecidos com Unix [nesta hiperligação](https://github.com/jasongin/nvs/blob/master/doc/SETUP.md#mac-linux). + +#### Uso + +Depois disto podemos usar `nvs` para alternar entre diferentes versões da Node. + +Para adicionar a versão mais recente da Node: + +```bash +nvs add latest +``` + +Ou adicionar a versão mais recente com suporte de longo prazo da Node: + +```bash +nvs add lts +``` + +Depois executamos o comando `nvs use` para adicionar uma versão de Node ao `PATH` para concha atual: + +```bash +$ nvs use lts +PATH -= %LOCALAPPDATA%\nvs\default +PATH += %LOCALAPPDATA%\nvs\node\14.17.0\x64 +``` + +Para adicioná-lo ao `PATH` permanentemente, usamos `nvs link`: + +```bash +nvs link lts +``` + +## OpenBSD + +A Node.js está disponível através do sistema de portas. + +```bash +/usr/ports/lang/node +``` + +Com o uso do [pkg_add](https://man.openbsd.org/OpenBSD-current/man1/pkg_add.1) no OpenBSD: + +```bash +pkg_add node +``` + +## openSUSE e SLE + +A Node.js está disponível nos repositórios principais sob os seguintes pacotes: + +- **openSUSE Leap 15.2**: `nodejs10`, `nodejs12`, `nodejs14` +- **openSUSE Tumbleweed**: `nodejs20` +- **SUSE Linux Enterprise Server (SLES) 12**: `nodejs10`, `nodejs12`, e `nodejs14` (O "Web and Scripting Module" deve estar [ativado](https://www.suse.com/releasenotes/x86_64/SUSE-SLES/12-SP5/#intro-modulesExtensionsRelated).) +- **SUSE Linux Enterprise Server (SLES) 15 SP2**: `nodejs10`, `nodejs12`, e `nodejs14` (O "Web and Scripting Module" deve estar [ativado](https://www.suse.com/releasenotes/x86_64/SUSE-SLES/15/#Intro.Module).) + +Por exemplo, para instalar a Node.js 14.x no openSUSE Leap 15.2, executamos o seguinte como administrador (root ou raiz): + +```bash +zypper install nodejs14 +``` + +Diferentes versões principais da Node podem ser instaladas e usadas simultaneamente. + +## SmartOS e illumos + +As imagens do SmartOS vêm com `pkgsrc` pré-instalado. Em outras distribuições de illumos, primeiro instalamos **[pkgsrc](https://pkgsrc.joyent.com/install-on-illumos/)**, depois podemos instalar o pacote binário conforme o habitual: + +```bash +pkgin -y install nodejs +``` + +Ou compilar manualmente a partir do `pkgsrc`: + +```bash +cd pkgsrc/lang/nodejs && bmake install +``` + +## Snap + +Os [snaps da Node.js](https://github.com/nodejs/snap) estão disponíveis como [`node`](https://snapcraft.io/node) na loja da Snap. + +## Solus + +O Solus fornece a Node.js no seu repositório principal. + +```bash +sudo eopkg install nodejs +``` + +## vfox + +Um gestor de versão que suporta várias plataformas (Windows, macOS, Linux) e **extensível**. + +Permite-nos **diferenciar versões para diferentes projetos**, **diferenciar versões para diferentes conchas**, e alternar versões da Node automaticamente com base no diretório atual, etc. + +Suporta todas as conchas populares (Bash, Zsh, Fish, PowerShell, Clink, Cmder). + +Consultar a [Introdução Rápida](https://vfox.lhan.me/guides/quick-start.html) para rapidamente usar o `vfox`, e todos os detalhes de uso. + +## Void Linux + +O Void Linux entrega a Node.js estável no repositório principal. + +```bash +xbps-install -Sy nodejs +``` + +## Windows + +Descarregamos o [instalador da Node.js](/#home-downloadhead) diretamente a partir do sítio da Web [nodejs.org](https://nodejs.org/). + +### Alternativas + +Com o uso do **[Winget](https://aka.ms/winget-cli)**: + +```bash +winget install OpenJS.NodeJS +# or for LTS +winget install OpenJS.NodeJS.LTS +``` + +Após executarmos um dos dois comandos acima, pode ser necessário reiniciar o emulador de terminal antes do comando `node` da interface da linha de comando torne-se disponível. + +Com o uso do **[Chocolatey](https://chocolatey.org/)**: + +```bash +cinst nodejs +# or for full install with npm +cinst nodejs.install +``` + +Com o uso do **[Scoop](https://scoop.sh/)**: + +```bash +scoop install nodejs +# or for LTS +scoop install nodejs-lts +``` + +## z/OS + +IBM® SDK para Node.js — z/OS® está disponível em dois formatos de instalação, SMP/E e PAX. Selecionamos o formato de instalação que se aplica a nós: + +- [Instalar e configurar a edição SMP/E da Node.js no z/OS](https://www.ibm.com/docs/en/sdk-nodejs-zos/14.0?topic=configuring-installing-smpe-edition) +- [Instalar e configurar a edição PAX da Node.js no z/OS](https://www.ibm.com/docs/en/sdk-nodejs-zos/14.0?topic=configuring-installing-pax-edition) diff --git a/pages/pt/download/package-manager/current.mdx b/pages/pt/download/package-manager/current.mdx new file mode 100644 index 0000000000000..5da09b77522cc --- /dev/null +++ b/pages/pt/download/package-manager/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Instalar a Node.js no usando o + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar outros gestores de pacote suportados da comunidade + +
diff --git a/pages/pt/download/package-manager/index.mdx b/pages/pt/download/package-manager/index.mdx new file mode 100644 index 0000000000000..6772ace86659f --- /dev/null +++ b/pages/pt/download/package-manager/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Instalar a Node.js no usando o + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar outros gestores de pacote suportados da comunidade + +
diff --git a/pages/pt/download/prebuilt-binaries/current.mdx b/pages/pt/download/prebuilt-binaries/current.mdx new file mode 100644 index 0000000000000..7d8805c02a7c2 --- /dev/null +++ b/pages/pt/download/prebuilt-binaries/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Quero a versão da Node.js para executando sobre + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar os binários pré-compilados Noturnos ou Compilações Não Oficiais para outras plataformas + +
diff --git a/pages/pt/download/prebuilt-binaries/index.mdx b/pages/pt/download/prebuilt-binaries/index.mdx new file mode 100644 index 0000000000000..7d8805c02a7c2 --- /dev/null +++ b/pages/pt/download/prebuilt-binaries/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Quero a versão da Node.js para executando sobre + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar os binários pré-compilados Noturnos ou Compilações Não Oficiais para outras plataformas + +
diff --git a/pages/pt/download/prebuilt-installer/current.mdx b/pages/pt/download/prebuilt-installer/current.mdx new file mode 100644 index 0000000000000..4f5ddee39b502 --- /dev/null +++ b/pages/pt/download/prebuilt-installer/current.mdx @@ -0,0 +1,26 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Quero a versão da Node.js para executando sobre + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar todas as opções de descarga disponíveis da Node.js + +Saber mais sobre os Lançamentos da Node.js + +
diff --git a/pages/pt/download/prebuilt-installer/index.mdx b/pages/pt/download/prebuilt-installer/index.mdx new file mode 100644 index 0000000000000..22ef2c0d72f25 --- /dev/null +++ b/pages/pt/download/prebuilt-installer/index.mdx @@ -0,0 +1,26 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Quero a versão da Node.js para executando sobre + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar todas as opções de descarga disponíveis da Node.js + +Saber mais sobre os Lançamentos da Node.js + +
diff --git a/pages/pt/download/source-code/current.mdx b/pages/pt/download/source-code/current.mdx new file mode 100644 index 0000000000000..c65b0284f74c1 --- /dev/null +++ b/pages/pt/download/source-code/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Quero o código-fonte da versão da Node.js. + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar como compilar a Node.js a partir do código-fonte. + +
diff --git a/pages/pt/download/source-code/index.mdx b/pages/pt/download/source-code/index.mdx new file mode 100644 index 0000000000000..c65b0284f74c1 --- /dev/null +++ b/pages/pt/download/source-code/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Descarregar a Node.js® +subtitle: Podemos descarregar a Node.js como quisermos. +--- + +
+Quero o código-fonte da versão da Node.js. + + +
+ +
+A Node.js inclui o . + +Ler o registo de alterações desta versão + +Ler a publicação do blogue desta versão + +Saber como verificar o SHASUMS assinado + +Consultar como compilar a Node.js a partir do código-fonte. + +
diff --git a/pages/pt/index.mdx b/pages/pt/index.mdx new file mode 100644 index 0000000000000..d7c2c5d1dea25 --- /dev/null +++ b/pages/pt/index.mdx @@ -0,0 +1,137 @@ +--- +title: Executar a JavaScript em Toda Parte +layout: home +--- + +
+ + +
+

Executar a JavaScript em Toda Parte

+ +Node.js® é uma ambiente de execução de JavaScript disponível para várias plataformas, de código aberto e gratuita, que permite os programadores criar servidores, aplicações da Web, ferramentas de linha de comando e programas de automação de tarefas. + +
+ +
+ + {({ release }) => ( + <> + Descarregar a Node.js (LTS) + + Descarrega a Node.js {release.versionWithPrefix} + 1 com o suporte de longo prazo. + A Node.js também pode ser instalada através dos gestores de pacotes. + + + )} + + + + {({ release }) => ( + + Queremos novas funcionalidades mais cedo? + Podemos obter a Node.js {release.versionWithPrefix} + 1. + + )} + +
+
+ +
+
+ ```js displayName="Create an HTTP Server" + // server.mjs + import { createServer } from 'node:http'; + +const server = createServer((req, res) => { +res.writeHead(200, { 'Content-Type': 'text/plain' }); +res.end('Hello World!\n'); +}); + +// starts a simple http server locally on port 3000 +server.listen(3000, '127.0.0.1', () => { +console.log('Listening on 127.0.0.1:3000'); +}); + +// run with `node server.mjs` + +```` + +```js displayName="Write Tests" +// tests.mjs +import assert from 'node:assert'; +import test from 'node:test'; + +test('that 1 is equal 1', () => { + assert.strictEqual(1, 1); +}); + +test('that throws as 1 is not equal 2', () => { + // throws an exception because 1 != 2 + assert.strictEqual(1, 2); +}); + +// run with `node tests.mjs` +```` + +```js displayName="Read and Hash a File" +// crypto.mjs +import { createHash } from 'node:crypto'; +import { readFile } from 'node:fs/promises'; + +const hasher = createHash('sha1'); + +hasher.setEncoding('hex'); +// ensure you have a `package.json` file for this test! +hasher.write(await readFile('package.json')); +hasher.end(); + +const fileHash = hasher.read(); + +// run with `node crypto.mjs` +``` + +```js displayName="Streams Pipeline" +// streams.mjs +import { pipeline } from 'node:stream/promises'; +import { createReadStream, createWriteStream } from 'node:fs'; +import { createGzip } from 'node:zlib'; + +// ensure you have a `package.json` file for this test! +await pipeline( + createReadStream('package.json'), + createGzip(), + createWriteStream('package.json.gz') +); + +// run with `node streams.mjs` +``` + +```js displayName="Work with Threads" +// threads.mjs +import { + Worker, + isMainThread, + workerData, + parentPort, +} from 'node:worker_threads'; + +if (isMainThread) { + const data = 'some data'; + const worker = new Worker(import.meta.filename, { workerData: data }); + worker.on('message', msg => console.log('Reply from Thread:', msg)); +} else { + const source = workerData; + parentPort.postMessage(btoa(source.toUpperCase())); +} + +// run with `node threads.mjs` +``` + +
+ +Podemos saber mais do que a Node.js é capaz de oferecer com os nossos [materiais de aprendizado](/learn). + +
diff --git a/pages/pt/search.mdx b/pages/pt/search.mdx new file mode 100644 index 0000000000000..8760cc8d396e3 --- /dev/null +++ b/pages/pt/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: Resultados da Pesquisa +--- + + diff --git a/pages/tr/about/get-involved/contribute.md b/pages/tr/about/get-involved/contribute.md new file mode 100644 index 0000000000000..0c812116db400 --- /dev/null +++ b/pages/tr/about/get-involved/contribute.md @@ -0,0 +1,47 @@ +--- +title: Katkıda bulunma +layout: about +--- + +# Katkıda bulunma + +Node.js'e katkıda bulunmaya ilginiz için teşekkür ederiz! Katkıda bulunabileceğiniz birçok yol ve yer bulunmaktadır ve biz de bunu kolaylaştırmak için buradayız. + +## Genel Yardım Talebi + +Nodejs/node\\` deposundaki etkinlik düzeyi çok yüksek olduğundan, Node.js kullanımıyla ilgili genel yardım soruları veya talepleri [Node.js yardım deposu] (https\://github.com/nodejs/help/issues) adresine yönlendirilmelidir. + +## Sorun Bildirme + +Eğer Node.js ile ilgili bir sorun bulduysanız, lütfen GitHub projesinde bir sorun (issue) bildirmekten çekinmeyin. Sorununuzu bildirirken, sorunun tekrarlanabilir bir test örneği ile ifade edilebildiğinden emin olun, ve bu test örneği dış bağımlılıklar içermemelidir. Yani, test örneği sadece Node.js'in kendisi ile çalıştırılabilir olmalıdır. + +Bir sorun bildirirken, mümkün olduğunca çevrenizle ilgili bilgi de dahil etmeniz gerekmektedir. Sorunu daraltmaya çalışırken hangi bilgilerin önemli olacağını bilemeyiz. En azından aşağıdaki bilgileri içermeye çalışın: + +- Node.js Sürümü +- Çalıştırdığınız platform (macOS, SmartOS, Linux, Windows) +- Üzerinde çalıştığınız mimari (32bit veya 64bit ve x86 veya ARM) + +Node.js projesi şu anda birkaç ayrı GitHub deposu üzerinden yönetilmektedir, her birinin kendi ayrı sorun veritabanı bulunmaktadır. Mümkünse, bildirdiğiniz herhangi bir sorunu uygun deposuna yönlendirin, ancak yanlış yere yerleştirilirse endişelenmeyin, katkıda bulunan topluluk sizi doğru yöne yönlendirmekten memnuniyet duyacaktır. + +- Node.js'ye özgü sorunları bildirmek için lütfen [nodejs/node](https://github.com/nodejs/node) adresini kullanın +- Bu web sitesine özgü sorunları bildirmek için lütfen [nodejs/nodejs.org](https://github.com/nodejs/nodejs.org/issues) adresini kullanın + +## Kod katkıları + +Node.js'ye hata düzeltmek veya yeni bir özellik eklemek istiyorsanız, lütfen [Node.js Katkı Yönergelerine] (https\://github.com/nodejs/node/blob/main/CONTRIBUTING.md/#pull-requests) başvurduğunuzdan emin olun. Projeye yapılan tüm katkılar için mevcut işbirlikçiler tarafından yapılan inceleme süreci de burada açıklanmaktadır. + +Nasıl başlayacağınızı merak ediyorsanız, ilk katkınıza doğru size rehberlik edebilecek [Node Todo] (https\://www\.nodetodo.org/) adresini kontrol edebilirsiniz. + +## İşbirlikçi olmak + +İşbirlikçi olarak kabul edilerek, katkıda bulunanlar projeye daha da büyük bir etki yapabilirler. Diğer katkı sağlayıcıları, katkılarını gözden geçirerek, sorunları sınıflandırarak ve projenin geleceğini şekillendirmede daha büyük bir rol alarak yardımcı olabilirler. Node.js topluluğu tarafından herhangi bir Node.js deposunda önemli ve değerli katkılar yapan bireyler İşbirlikçi olarak belirlenebilir ve projeye commit erişimi verilebilir. Dikkate alınan faaliyetler şunları içerir (ancak bunlarla sınırlı değildir): + +- kod taahhütleri ve pull request istekleri +- kod taahhütleri ve pull request istekleri +- sorunlar ve pull request istekleri hakkında yorumlar +- node.js web sitesine katkılar +- son kullanıcılara ve acemi katılımcılara sağlanan yardım +- çalışma gruplarına destek +- daha geniş Node.js topluluklarında katkı sağlamak + +Kişiler değerli katkılarının dikkate alınmadığını düşünürlerse, bunu sorun olarak bildirebilir veya bir TSC üyesi ile doğrudan iletişime geçebilir. diff --git a/pages/tr/about/get-involved/events.mdx b/pages/tr/about/get-involved/events.mdx new file mode 100644 index 0000000000000..c90991d60f1a8 --- /dev/null +++ b/pages/tr/about/get-involved/events.mdx @@ -0,0 +1,16 @@ +--- +title: Yaklaşan Etkinlikler +layout: about +--- + +## Yaklaşan Etkinlikler + +Node.js etkinlikleri halka açık ve kullanılabilir. Herkes katılabilir ve katkıda bulunabilir. + +### Yaklaşan Node.js® Toplantıları + +Node.js projesi, projenin yönlerini tartışmak ve planlamak için yıl boyunca çok sayıda toplantı düzenler. + +Önümüzdeki 7 gün içinde aşağıdaki toplantılar yapılacaktır. + + diff --git a/pages/tr/about/get-involved/index.md b/pages/tr/about/get-involved/index.md new file mode 100644 index 0000000000000..e8b872f9cf709 --- /dev/null +++ b/pages/tr/about/get-involved/index.md @@ -0,0 +1,26 @@ +--- +title: Dahil olun +layout: about +--- + +# Dahil Olun + +## Topluluk Tartışması + +- [GitHub sorunlar listesi] (https\://github.com/nodejs/node/issues) Node.js temel özelliklerinin tartışıldığı yerdir. +- Node.js geliştirme hakkında gerçek zamanlı sohbet için aşağıdaki platformlardan birini kullanabilirsiniz + - IRC için, bir [IRC istemcisi](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) ile `#node.js` kanalındaki `irc.libera.chat` adresine gidin veya [bir web istemcisi](https://kiwiirc.com/nextclient/) kullanarak web tarayıcınızdan kanala bağlanın + - Slack için iki seçenek vardır: + - OpenJSF Slack] (https\://slack-invite.openjsf.org/), birkaç Node.js kanalına sahip bir Vakıf tarafından işletilen Slack'tir (`#nodejs-` ile ön eklenmiş kanallar projeyle ilgilidir). + - [Node Slackers](https://www.nodeslackers.com/) Node.js odaklı bir Slack topluluğudur. +- Resmi Node.js Twitter hesabı [nodejs](https://twitter.com/nodejs) şeklindedir. +- Tüm genel ekip toplantılarını içeren [Node.js proje takvimi] (https\://nodejs.org/calendar). + +## Öğrenme + +- Node.js web sitesinin [Resmi Öğrenme bölümü] (https\://nodejs.org/en/learn/). +- [Resmi API referans belgeleri](https://nodejs.org/api/). +- [NodeSchool.io](https://nodeschool.io/) size Node.js kavramlarını etkileşimli komut satırı oyunları aracılığıyla öğretecek. +- [Stack Overflow Node.js etiketi] (https://stackoverflow.com/questions/tagged/node.js) her gün yeni bilgiler toplamaktadır. +- [DEV Topluluğu Node.js etiketi] (https://dev.to/t/node) Node.js projelerini, makalelerini ve eğitimlerini paylaşmanın yanı sıra Node.js ile ilgili konularda tartışmalar başlatmak ve geri bildirim istemek için bir yerdir. Tüm beceri seviyelerindeki geliştiriciler katılabilir. +- [Nodeiflux] (https://discordapp.com/invite/vUsrbjd), Discord'da birbirini destekleyen Node.js arka uç geliştiricilerinden oluşan samimi bir topluluktur. diff --git a/pages/tr/search.mdx b/pages/tr/search.mdx new file mode 100644 index 0000000000000..5db97e62c1b65 --- /dev/null +++ b/pages/tr/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: Arama Sonuçları +--- + + diff --git a/pages/uk/about/branding.mdx b/pages/uk/about/branding.mdx new file mode 100644 index 0000000000000..28175cd78649d --- /dev/null +++ b/pages/uk/about/branding.mdx @@ -0,0 +1,72 @@ +--- +title: Брендинг Node.js +layout: about +--- + +Брендинг Node.js + +Будь ласка, перегляньте [політику торгових марок](https://trademark-policy.openjsf.org/), щоб дізнатися про дозвіл на використання логотипів та знаків Node.js®. + +## Маскот Node.js® + +Маскот Node.js + +## Логотип Node.js® + +### Горизонтальний логотип Node.js® + + + + + + + +
+ Темний горизонтальний логотип Node.js + + Світлий горизонтальний логотип Node.js +
+ +### Складений логотип Node.js® + + + + + + + + + + + + + +
+ Темний складений логотип Node.js® + + Світлий складений логотип Node.js® +
+ Чорний складений логотип Node.js® + + Білий складений логотип Node.js® +
+ +### Значки JS + + + + + + + +
+ Зелений значок JS + + Білий значок JS +
diff --git a/pages/uk/about/get-involved/collab-summit.md b/pages/uk/about/get-involved/collab-summit.md new file mode 100644 index 0000000000000..716d001e69b74 --- /dev/null +++ b/pages/uk/about/get-involved/collab-summit.md @@ -0,0 +1,18 @@ +--- +title: Саміт співавторів +layout: about +--- + +# Саміт співавторів + +Саміт співавторства/Collaboration Summit Node.js ― це "неконференція", на яку збираються поточні та потенційні співавтори, щоб наживо обговорити Node.js та поділитися знаннями. Команди, робочі групи та співавтори зі спільноти збираються двічі на рік для прийняття важливих рішень, водночас маючи змогу попрацювати над ідеями, які вони хочуть просувати особисто. + +## Хто запрошений? + +Участь у Саміті співавторства в основному беруть існуючі учасники та члени спільноти, але він також вітає тих, хто також бажає стати співавтором. Якщо ви новачок у внесенні змін до Node.js, Саміт співавторства може бути гарною можливістю допомогти вам дізнатися, що відбувається в межах спільноти, і зробити внесок вже з тими навичками, які ви хочете покращити. + +Перед самітом співавтори та учасники спільноти надсилають пропозиції щодо створення розкладу подій. Присутні можуть попередньо ознайомитись з подією та в загальному обговорити її з іншими співавторами, перед тим як відвідати. Також буде багато можливостей для нетворкінгу та брейнштормів. + +Ми будемо раді бачити вас на Саміті Співатворів/Collab Summit! Перегляньте [репозиторій саміту](https://github.com/nodejs/summit) +для майбутніх і минулих подій і ознайомтесь із +[відкритими питаннями](https://github.com/nodejs/summit/issues), щоб розуміти, які проблеми співавтори та учасники спільноти хочуть обговорити наживо. diff --git a/pages/uk/about/get-involved/contribute.md b/pages/uk/about/get-involved/contribute.md new file mode 100644 index 0000000000000..781e1119f739a --- /dev/null +++ b/pages/uk/about/get-involved/contribute.md @@ -0,0 +1,47 @@ +--- +title: Долучитись до проєкту +layout: about +--- + +# Долучитись до проєкту + +Ми вдячні за бажання долучитись до Node.js. Існує багато способів та місць де ви можете зробити свій вклад у проєкт, і ми тут, щоб допомогти вам з цим. + +## Запит на загальну допомогу + +Через високий рівень активності у репозиторії "nodejs/node\\`, питання або запити про допомогу щодо використання Node.js слід створювати в репозиторії [допомога по Node.js](https://github.com/nodejs/help/issues). + +## Повідомити про проблему + +Якщо ви виявили те, що, на вашу думку, є проблемою з Node.js, не вагайтесь повідомити про проблему в GitHub. Заповнюючи інформацію про проблему, будь ласка, переконайтеся, що ви можете викласти суть з можливістю відтворити проблему у формі тесту, який не містить жодних зовнішніх залежностей. Тобто тестовий приклад можна виконати без нічого, окрім самого Node.js. + +Повідомляючи про проблему нам також потрібно якомога більше інформації, яку ви зможете надати, про середовище в якому вона виникла. Ми не знаємо, яка інформація буде доречною, намагаючись визначити проблему, тому вкажіть, щонайменше, наступне: + +- Версія Node.js +- Платформа, на якій ви працюєте (macOS, SmartOS, Linux, Windows) +- Архітектура, на якій ви працюєте (32bit або 64bit та x86 або ARM) + +Проєкт Node.js наразі керується через кілька окремих репозиторіїв GitHub, кожен з власним списком проблем/запитів. Якщо це можливо, будь ласка, спрямовуйте будь-які проблеми до відповідного репозиторію, але не хвилюйтеся, якщо вони потраплять не в те місце – спільнота співавторів буде рада скерувати вас у правильному напрямку. + +- Щоб повідомити про характерні Node.js проблеми, скористайтесь [nodejs/node](https://github.com/nodejs/node) +- Щоб повідомити про проблеми із цим сайтом, скористайтесь [nodejs/nodejs.org](https://github.com/nodejs/nodejs.org/issues) + +## Внести зміни в код + +Якщо ви хочете виправити помилки або додати нову функціональність до проєкту, будь ласка, ознайомтесь із [інструкцією як внести зміни до Node.js](https://github.com/nodejs/node/blob/main/CONTRIBUTING.md/#pull-requests). Там також пояснюється процес перегляду співавторами всіх змін до проєкту. + +Якщо вам цікаво, як почати, ви можете переглянути [список завдань Node](https://www.nodetodo.org/), який може зорієнтувати вас яким чином зробити свій перший вклад у проєкт. + +## Стати співавтором + +Стаючи співавтором, користувачі можуть ще більше вплинути на проєкт. Вони можуть допомогти іншим співавторам, перевіряючи їх вклад у проєкт та сортуючи проблеми, а також брати ще більшу участь у формуванні майбутнього Node.js. Особи, яких TSC (Технічний Наглядовий Комітет) визначив такими - що зробили значний і цінний внесок до будь-якого репозиторію Node.js, можуть стати співавторами та отримати доступ до проєкту. Діяльність, яка береться до уваги, включає (та не обмежуюється) якістю: + +- змін/commits та pull requests, що стосуються коду +- змін/commits та pull requests, що стосуються документації +- коментарів до проблем і pull requests +- зробленого внеску у сайт Node.js +- допомоги наданої кінцевим користувачам і новим співавторам +- участі у робочих групах +- участі у ширшій Node.js спільноті + +Якщо особи, що роблять цінний вклад у проєкт, вважають, що вони не розглядались на надання дозволу для внесення змін, тоді вони можуть [створити запит в репозиторії](https://github.com/nodejs/TSC/issues) або [сконтактувати із членом TSC](https://github.com/nodejs/node#tsc-technical-steering-committee) напряму. diff --git a/pages/uk/about/get-involved/events.mdx b/pages/uk/about/get-involved/events.mdx new file mode 100644 index 0000000000000..811ff18768809 --- /dev/null +++ b/pages/uk/about/get-involved/events.mdx @@ -0,0 +1,16 @@ +--- +title: Майбутні події +layout: about +--- + +## Майбутні події + +Події Node.js відкриті та доступні для спільноти. Усі охочі можуть приєднатися та брати в них участь. + +### Майбутні зустрічі Node.js® + +Проєкт Node.js проводить численні зустрічі впродовж року для обговорення та планування аспектів проєкту. + +Ці зустрічі відбудуться в наступні 7 днів. + + diff --git a/pages/uk/about/get-involved/index.md b/pages/uk/about/get-involved/index.md new file mode 100644 index 0000000000000..71e8c0fc64f0d --- /dev/null +++ b/pages/uk/about/get-involved/index.md @@ -0,0 +1,26 @@ +--- +title: Долучитися +layout: about +--- + +# Долучитися + +## Обговорення спільноти + +- [Список проблем на GitHub](https://github.com/nodejs/node/issues) місце для обговорення основної функціональності Node.js. +- Для спілкування про розробку на Node.js в реальному часі скористайтеся однією з наступних платформ + - Для багатокористувацьких конференцій відвідайте `irc.libera.chat` в `#node.js` каналі через [IRC клієнт](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) або під'єднайтесь до каналу через браузер використовуючи [вебзастосунок](https://kiwiirc.com/nextclient/) + - Для Slack є два варіанти: + - [OpenJSF Slack](https://slack-invite.openjsf.org/) - запущений OpenJS Foundation спільнотою Slack з декількома Node.js каналами(канали з префіксом `#nodejs-` стосуються проєкту). + - [Node Slackers](https://www.nodeslackers.com/) — це спільнота Slack із фокусом на Node.js. +- Офіційний Twitter Node.js: [nodejs](https://twitter.com/nodejs). +- [Календар проєкту Node.js](https://nodejs.org/calendar) з усіма публічними командними зустрічами. + +## Навчання + +- [Офіційний розділ навчання](https://nodejs.org/en/learn/) вебсайту Node.js. +- [Офіційна документація по API](https://nodejs.org/api/). +- [NodeSchool.io](https://nodeschool.io/) навчить вас концепцій Node.js за допомогою інтерактивних ігор у командному рядку. +- [Stack Overflow Node.js tag](https://stackoverflow.com/questions/tagged/node.js) щодня збирає нову інформацію. +- [Тег Node.js на DEV Community](https://dev.to/t/node) — це місце, де можна ділитися проєктами, статтями та практичними заняттями з Node.js, а також почати обговорення та просити відгуки до тем, пов'язаних із Node.js. До участі запрошуються розробники всіх рівнів. +- [Nodeiflux](https://discordapp.com/invite/vUsrbjd) — це дружня спільнота бекенд-розробників Node.js, які підтримують один одного в Discord. diff --git a/pages/uk/about/governance.md b/pages/uk/about/governance.md new file mode 100644 index 0000000000000..45d23a97adaea --- /dev/null +++ b/pages/uk/about/governance.md @@ -0,0 +1,31 @@ +--- +title: Управління проєктом +layout: about +--- + +# Управління проєктом + +## Процес пошуку консенсусу + +Node.js дотримується [Consensus Seeking][] моделі прийняття рішень. + +## Співавтори + +Основний GitHub репозиторій [nodejs/node][] підтримується співавторами, які на постійній основі вибираються іншими, чинними, співавторами. + +Особи, які роблять важливий внесок стають співавторами та отримують дозвіл на внесення змін до проєкту. Ці особи визначаються іншими співавторами, а їх номінація на роль співавтора, обговорюється із чинними співавторами. + +Для ознайомлення із поточним списком співучасників, відвідайте [README.md][]. + +Інструкція для співавторів проєкту, підтримується на [collaborator-guide.md][]. + +## Технічний керівний комітет + +Проєкт керується \[Технічним наглядовим комітетом(TSC)]\[], який відповідальний за високорівневе керування проєктом. TSC - це набір активних співавторів, призначених іншими, чинними членами TSC. + +[consensus seeking]: https://en.wikipedia.org/wiki/Consensus-seeking_decision-making +[readme.md]: https://github.com/nodejs/node/blob/main/README.md#current-project-team-members +[tsc]: https://github.com/nodejs/TSC +[technical steering committee (tsc)]: https://github.com/nodejs/TSC/blob/main/TSC-Charter.md +[collaborator-guide.md]: https://github.com/nodejs/node/blob/main/doc/contributing/collaborator-guide.md +[nodejs/node]: https://github.com/nodejs/node diff --git a/pages/uk/about/previous-releases.mdx b/pages/uk/about/previous-releases.mdx new file mode 100644 index 0000000000000..0c4458b601919 --- /dev/null +++ b/pages/uk/about/previous-releases.mdx @@ -0,0 +1,21 @@ +--- +title: Релізи Node.js +layout: about +--- + +Релізи Node.js + +Основні версії Node.js мають статус релізу _Current_ протягом шести місяців, що дає розробникам бібліотек час надати їм підтримку. +Через шість місяців непарні релізи (9, 11 тощо) більше не підтримуватимуться, а парні релізи (10, 12 тощо) отримають статус _Active LTS_ та стануть готовими до загального використання. +Статус релізу _LTS_ означає «довгострокова підтримка (ДСП)», тобто критичні помилки будуть виправлятися впродовж 30 місяців. +Застосунки на продакшні повинні використовувати лише релізи _Active LTS_ та _Maintenance LTS_. + +## Розклад релізів + +![Releases](https://raw.githubusercontent.com/nodejs/Release/main/schedule.svg?sanitize=true) + +Усі деталі, які стосуються розкладу релізів Node.js, доступні [на GitHub](https://github.com/nodejs/release#release-schedule). + +## Шукаєте останній реліз гілки версії? + + diff --git a/pages/uk/about/security-reporting.mdx b/pages/uk/about/security-reporting.mdx new file mode 100644 index 0000000000000..3ce5c1b0317de --- /dev/null +++ b/pages/uk/about/security-reporting.mdx @@ -0,0 +1,65 @@ +--- +title: Звітність про безпеку +layout: about +--- + +Звітність про безпеку + +Для детальнішої інформації про чинні норми безпеки, перейдіть [на цю сторінку](https://github.com/nodejs/node/security/policy). + +## Повідомлення про помилку в Node.js + +Повідомляйте про безпекові проблеми в Node.js через [HackerOne](https://hackerone.com/nodejs). + +Ваш лист буде розглянуто протягом 5 днів, а протягом 10 днів вам буде надіслано більш деталізовану відповідь з вказівками щодо подальшої обробки вашого запиту. + +Після першої відповіді на ваше повідомлення, команда безпеки намагатиметься тримати вас у курсі стосовно прогресу у розв'язанні та оголошенні про проблему. Також, вас можуть попросити надати додаткову інформацію або інструкції стосовно повідомленої помилки. + +### Програма винагород за знайдені помилки від Node.js + +Node.js бере участь в офіційній програмі винагород за знайдені помилки для дослідників у сфері безпеки та заради відповідального публічного розкриття інформації. Програма керується через платформу HackerOne. Для детальнішої інформації відвідайте [HackerOne/nodejs](https://hackerone.com/nodejs). + +## Повідомлення про помилку в сторонніх модулях + +Про помилки в безпеці сторонніх модулів слід повідомляти відповідним особам, які підтримують ці модулі. + +## Політика розкриття інформації + +Ось політика розкриття безпекової інформації в Node.js + +Повідомлення про проблему отримане і призначене особі, яка його оброблятиме. Ця особа координуватиме процес виправлення та релізу. При підтверджені проблеми буде визначений список всіх версії у яких вона присутня. Код перевірятиметься на наявність потенційно подібних проблем. Виправлення підготують для всіх релізів, що досі підтримуються. Ці виправлення не будуть додані до загального репозиторію, а будуть зберігатись локально, до моменту офіційного оголошення про виправлення проблеми. + +Обирається дата закриття цієї вразливості та робиться запит на CVE (Common Vulnerabilities and Exposures (CVE®)) щодо цієї вразливості. + +У день закриття, копія анонсу надсилається списку адресатів, що мають відношення до безпеки в Node.js. Зміни додаються до загального репозиторію і нові збірки розгортаються на nodejs.org. Протягом 6 годин після розсилки повідомлень, копію оголошення буде опубліковано у блозі Node.js. + +Зазвичай дата закриття встановлюється протягом 72 годин від моменту видання CVE. Однак, це може залежати від серйозності та складності розв'язання проблеми. + +Цей процес може зайняти деякий час, особливо коли необхідна координація з командою підтримки інших проєктів. Всі зусилля будуть спрямовані на те, щоб розв'язати проблему якомога швидше, однак, важливо, щоб ми дотримувались вищезгаданого процесу релізу, щоб бути певними, що все відбувається належним чином. + +## Отримання безпекових оновлень + +Сповіщення, що стосуються безпеки, будуть поширюватись наступними методами. + +[Google Group](https://groups.google.com/group/nodejs-sec) +[Node.js Блог](/blog) + +## Коментарі стосовно цієї політики + +Якщо у вас є пропозиції щодо покращення цього процесу, створіть [pull request](https://github.com/nodejs/nodejs.org) або +[додайте запит](https://github.com/nodejs/security-wg/issues/new) на обговорення. + +## Найкращі практики OpenSSF + + + OpenSSF Badge + + +The Open Source Security Foundation (OpenSSF) [значок за застосування кращих практик](https://github.com/coreinfrastructure/best-practices-badge) це спосіб Free/Libre та Open Source Software (FLOSS) проєктів продемонструвати, що вони застосовують ці кращі практики. Проєкти можуть самостійно засвідчити, як вони дотримуються найкращих практик. Власники значка можуть швидко оцінити, які проєкти FLOSS дотримуються найкращих практик, і, як наслідок, з більшою ймовірністю створюватимуть якісніше і безпечніше програмне забезпечення. diff --git a/pages/uk/download/source-code/current.mdx b/pages/uk/download/source-code/current.mdx new file mode 100644 index 0000000000000..3c49438324323 --- /dev/null +++ b/pages/uk/download/source-code/current.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Завантаження Node.js® +subtitle: Завантажте Node.js так, як ви бажаєте. +--- + +
+Мені потрібна версія вихідного коду Node.js. + + +
+ +
+Node.js містить . + +Прочитайте список змін для цієї версії + +Прочитайте блог для цієї версії + +Дізнайтеся, як перевірити підписані SHASUMS + +Дізнайтеся, як зібрати Node.js із вихідного коду. + +
diff --git a/pages/uk/download/source-code/index.mdx b/pages/uk/download/source-code/index.mdx new file mode 100644 index 0000000000000..3c49438324323 --- /dev/null +++ b/pages/uk/download/source-code/index.mdx @@ -0,0 +1,24 @@ +--- +layout: download +title: Завантаження Node.js® +subtitle: Завантажте Node.js так, як ви бажаєте. +--- + +
+Мені потрібна версія вихідного коду Node.js. + + +
+ +
+Node.js містить . + +Прочитайте список змін для цієї версії + +Прочитайте блог для цієї версії + +Дізнайтеся, як перевірити підписані SHASUMS + +Дізнайтеся, як зібрати Node.js із вихідного коду. + +
diff --git a/pages/uk/search.mdx b/pages/uk/search.mdx new file mode 100644 index 0000000000000..df80d434d9e4c --- /dev/null +++ b/pages/uk/search.mdx @@ -0,0 +1,6 @@ +--- +layout: search +title: Результати пошуку +--- + +