[Translation][Spanish] Node.js, from English (1,015 words) [N'34]

Image source

Github Repository

https://github.com/nodejs/i18n

Project Details

By definition, Node.js is a Java Runtime Environment (JRE). But it is more than just that. While common JREs function as machine backups that allow users to smoothly run JavaScript on their browsers and applications, this open-source project functions as an app that manages Java code by itself. It's practical uses for developers are endless. It grants an extraordinarily versatile platform for designing code, programs, websites and other applications. And that isn't all: Node provides a virtual facility for testing the proper work of Java-driven programs and devices –and their planned updates–, helping to find bugs, solve errors, fix code and vastly improving their performance.

I believe all the amazing uses of Node are to be considered by themselves and I declare myself a fan of the project. But, besides, I support it for its functionality as a medium for bringing to reality countless creations that can be as good as Node itself. If you can dream it –and code it in JavaScript–, then your imagination is the only limit!The open translation of Node to thirty-three (33) languages proves the advantages of open-source projects when it comes to diversification of knowledge and worldwide spreading of useful tools.

Ahead, there is the link of the program's webpage:

https://nodejs.org

Contribution Specifications

Translation Overview

This is my 34th contribution to Node.js as a translator. For this collaboration, I continued my previous work, finished translating the CHANGELOG_IOJS.md file (HURRAY! 🎉) and began translating the repl.md file.

In my past reports –the thirty-three of them–, I talked about changelogs, the way they work, and their importance sustaining the work done on projects as big and complex as Node.js. If you wanna document yourself about them, I invite you to check my profile and read the workload of five months of translation and research. But now, ladies and gentlemen, time has come to enter in the REPL era! 😱

Gif source

Firstly, we need to define what is REPL. This acronym stands for Read-Eval-Print-Loop. It is a simplistic, but very versatile, interactive programming environment. In it, users input information to a program through a console, this one reads it, evaluates it and returns determined expected results. REPL is specially useful for JavaScript, since is one of the command-line-alike programs that support the usage of scripts... And is not a coincidence that JavaScript has "script" on its name.

Hey, but, really, Node.js bennefits a lot from using this tool... As it is specified in the REPL document that I started translating, the version of REPL used by Node is one that stands being run as a standalone program or as a inside-program feature, and that is the case here. By this, the developers of Node ensure that the program can switch from one took from another as required by the tasks the user needs to accomplish. In future posts, I'll explain more about the way REPL works, but now I'll talk about two concepts you can find in this translation:

The first one is "special commands". Special commands are orders that users give to console programs through the input of particular arranges of characters already predefined by such programs... I.e., Keywords! These commands unravel the appliance of non-common features and provide users accessibility to non-regular usage modes within these programs. Below, there's a list of Node.js' REPL special commands, as defined in the referred file:

The second one is "special keys". Special keys is a term that refers to features shortcuts that are accessed through the pressing of specific key combinations. Think of the cheat set of your favorite video-game... While having the program open, being run a determined part of its code (you might be in the game's loading screen or in the middle of a fight against Sektor), the pressing of a determined arrangement of keys will have an effect in your gaming experience:

Gif source

The same –I mean, you don't turn into an awesome snowman, but you get me!– happens when you press special key combinations on an open console. Here it is the list of the special key combinations defined for Node.js' REPL, as specified in the translated document:

You can check here for more information about the previously addressed concepts:

• https://stackoverflow.com/questions/13603021/what-is-a-repl-in-javascript
• https://www.computerhope.com/jargon/r/repl.htm
• https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop
• https://www.codecademy.com/articles/command-line-commands
• https://en.wikipedia.org/wiki/Command-line_interface
• https://www.computerhope.com/jargon/s/special-key.htm
• https://www.issco.unige.ch/en/research/tutoriel-informatique/EN/special_keys_keyboard_shortcuts_function_keys_and__hotkeys.html
• https://www.pcmag.com/encyclopedia/term/59603/special-function-key

Image source

• Work example #01:

English:

In general it is recommended that you use <0>NAN</0> as a compatibility layer for your addons.

Spanish:

En general, se recomienda que utilice <0>NAN</0> como una capa de compatibilidad para sus complementos.

• Work example #02:

English:

While running, instances of <0>repl.REPLServer</0> will accept individual lines of user input, evaluate those according to a user-defined evaluation function, then output the result.

Spanish:

Durante su ejecución, las instancias de <0>repl.REPLServer</0> aceptarán líneas individuales de inputs de usuarios, de acuerdo con una función de evaluación definida por los usuarios, y luego emitirán sus resultados como outputs.

• Work example #03:

English:

Instances of <0>repl.REPLServer</0> support automatic completion of inputs, simplistic Emacs-style line editing, multi-line inputs, ANSI-styled output, saving and restoring current REPL session state, error recovery, and customizable evaluation functions.

Spanish:

Las instancias de <0>repl.REPLServer</0> soportan el auto-completado de los inputs, la edición de líneas de estilo Emacs sencilla, inputs multi-líneas, outputs de estilo ANSI, el guardado y recuperación del estado actual de la sesión de REPL, la recuperación de errores, y funciones de evaluación personalizables.

Languages

This translation was made from English to Spanish.

I got plenty experience translating and proofreading this project as an Utopian contributor. I collaborate here as translator and Language Moderator of the Da-Vinci/Utopian Spanish translation team. Besides this project, I have experience translating and proofreading The Curious Expedition, Ancap-ch, Byteball Wiki, OroCrm and BiglyBT.

Word Count

• The amount of words translated in this contribution is: 1,015.

Note: This number is the result of subtracting the complete sum of non-translatable content to the word-count Crowdin has done for the period in which this contribution was done.

• The total amount of words translated in this project (as a Da-vinci/Utopian translator) is: 42,655.

Previous Translations of the Project

• Contribution N'01. Submitted on September 13th, 2018.
• Contribution N'02. Submitted on September 15th, 2018.
• Contribution N'03. Submitted on September 17th, 2018.
• Contribution N'04. Submitted on September 19th, 2018.
• Contribution N'05. Submitted on September 21th, 2018.
• Contribution N'06. Submitted on September 22th, 2018.
• Contribution N'07. Submitted on September 23th, 2018.
• Contribution N'08. Submitted on October 1st, 2018.
• Contribution N'09. Submitted on October 8th, 2018.
• Contribution N'10. Submitted on October 14th, 2018.
• Contribution N'11. Submitted on October 15th, 2018.
• Contribution N'12. Submitted on October 18th, 2018.
• Contribution N'13. Submitted on October 21st, 2018.
• Contribution N'14. Submitted on October 24th, 2018.
• Contribution N'15. Submitted on October 27th, 2018.
• Contribution N'16. Submitted on October 31th, 2018.
• Contribution N'17. Submitted on November 3rd, 2018.
• Contribution N'18. Submitted on November 4th, 2018.
• Contribution N'19. Submitted on November 6th, 2018.
• Contribution N'20. Submitted on November 17th, 2018.
• Contribution N'21. Submitted on November 24th, 2018.
• Contribution N'22. Submitted on December 7th, 2018.
• Contribution N'23. Submitted on December 15th, 2018.
• Contribution N'24. Submitted on December 20th, 2018.
• Contribution N'25. Submitted on December 26th, 2018.
• Contribution N'26. Submitted on December 28th, 2018.
• Contribution N'27. Submitted on December 30th, 2018.
• Contribution N'28. Submitted on January 9th, 2019.
• Contribution N'29. Submitted on January 10th, 2019.
• Contribution N'30. Submitted on January 12th, 2019.
• Contribution N'31. Submitted on January 18th, 2019.
• Contribution N'32. Submitted on January 19th, 2019.
• Contribution N'33. Submitted on January 24th, 2019.

Proof of Authorship

This translation was made between January 25th and 26th. You can check the translation record in my Crowdin account [here], the activity on the project's Crowdin [here] and a summary of recent additions to the project [here].