https://github.com/nodejs/i18n
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:
This is my 43rd contribution to Node.js as a translator. For this collaboration, I continued my previous work on Node.js’ version 6 url.md file, which describes the features, characteristics and uses of url
module of Node.
In my previous contribution, i talked about APIs and WHATWG, since they're introduced in the document from the begining:
The url module provides two APIs for working with URLs: a legacy API that is Node.js specific, and a newer API that implements the same WHATWG URL Standard used by web browsers.
In this contribution, I'll explain a important concepts referred in the WHATWG URL API of the url
module.
The first one I'll talk about is hash. It is included as a property of the URL
class, as url.hash
. What does hash mean? Hashing is a data processing mechanism through which a long string of data is transformed into a way shorter string that represents the original one. Reducing a single string might not seem like a big deal, but it comes quite handy at the time we start dealing with enormous amounts of digital information or just wanna have a quicker, more organized, look of the data we have to work with.
If we simplify this concept to a maximum extent... It is like a programming shrink ray!:
Secondly, I would like to discuss what is percent-encoding since many strings of this document refer to this concept at the time of dealing with invalid characters in properties:
- Invalid URL characters included in the value assigned to the
hash
property are percent-encoded.- Invalid URL characters included in the value assigned to the
password
property are percent-encoded.- Any invalid URL characters appearing in the value assigned the
search
property will be percent-encoded.
Percent-encoding is a programming mechanism to encode 8-bit characters into URL-readable data. This way, certain characteres that do not exist within the range of URL universe manage to pass in it and later be translated by web browsers and pages. The mechanism for this codification is to substitute the unavaible character by a %
symbol and, next to it, the hexadecimal representation of the ASCII value of said character.
The characters that need percent encoding are :
, /
, ?
, #
, [
, ]
, @
, !
, $
, &
, '
, (
, )
, *
, +
, ,
, ;
, =
and %
(oh, the irony).
The respective codification for each is the following (thanks, Mozilla, for making such dinamic and useful manuals... Big time!):
Finally, I would like to talk about serialization. In this file, there are a lot of references to URL and domain serialization, as:
toJSON()
method on the URL
object returns the serialized URL.domain
.domain
.In computer science, the process of serialization refers to the mechanism through which a piece of data or an object is transformed into a format that can be buffered or saved in the physical memory of a system as a file. In the case of Java, the objects are turned into byte streams, which can later be changed again into copies of the original objects. It's not magic...
It's just programming.
You can find out more about the aforementioned concepts here:
English:
Setting the value to the default port of the URL
objects given protocol
will result in the port
value becoming the empty string ''
.
Spanish:
Establecer el valor del puerto predeterminado del protocol
dado de los objetos URL
ocasionará que el valor del port
se convierta en la string vacía ''
.
English:
Note that the selection of which characters to percent-encode may vary somewhat from what the [url.parse()
][] and [url.format()
][] methods would produce.
Spanish:
Tenga en cuenta que la selección de los caracteres a ser codificados porcentualmente puede ser distinta de la que los métodos [url.parse()
][] y [url.format()
][] producirían.
English:
That means iterable
can be another URLSearchParams
, in which case the constructor will simply create a clone of the provided URLSearchParams
.
Spanish:
Eso significa que iterable
puede ser otro URLSearchParams
, en cuyo caso el constructor simplemente creará un clon del URLSearchParams
proporcionado.
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.
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.
This translation was made on July 9th, 2019. 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].