Simplified Chinese translation of Node.js #9 - 1179 words

Repository

Github: https://github.com/nodejs/i18n

Crowdin link: https://crowdin.com/project/nodejs

Simplified Chinese page: https://crowdin.com/project/nodejs/zh-CN#

Project Details

Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine.

Node.js is a free, cross-platform, open source server environment to execute JavaScript outside of a browser. Traditionally, JavaScript is used for client side scripting and runs by a JavaScript engine embedded within a browser. With Node.js, JavaScript can be used to write command line programs or server side scripting. By this way, developers only need to learn a single programming language to do both server side and client side programming.

Node.js is built on Chrome’s V8 JavaScript execution engine which was initially built for Google Chrome. Instead of interpreting JavaScript in real time, V8 compiles JavaScript code to native binary machine code to improve the performance. Node.js has an event driven architecture which makes it suitable for web applications with many I/O operations. That is why Node.js is very fast compared to similar technologies. libuv is used to handle asynchronous events across operating systems.

Contribution Specifications

I have used Node.js in a few small projects but never got a chance to see a whole picture of this amazing and popular framework. I am very exciting to start translating Node.js and very looking forward to my new learning journey!

Translation overview

The whole project consists of 1,048,272 words. victory622 has started working on this project. Since this project is extremely large therefore collaborations are required. I will be concentrating on the translation of v8.x folder which has 353,483 words to translate.

This submission

In this submission, I have been still working on Buffer.md. The context is about how to fill a buffer with existing data and associated issues, how to search within a buffer via includes and indexOf methods, how to get an iterator of a buffer, and how to read data from a specific offset.

Regarding the translation, the translation of this string worths mentioning. The source string is “If <0>value</0> contains invalid characters, it is truncated; if no valid fill data remains, no filling is performed:” The source string did not explain clearly if it is after truncation or not, before checking “if no valid fill data remains”. To double check, I tested with the following code:

const buf = Buffer.allocUnsafe(5);
console.log(buf.fill('a'));
console.log(buf.fill('aazz', 'hex'));
console.log(buf.fill('zz', 'hex'));

The result shows:

Therefore, the translation has been changed from:

“如果 <0>value</0> 包含无效字符，则会被截断；如果没有有效的填充数据保留，则不进行填充：”

to:

“如果 <0>value</0> 包含无效字符，则会被截断；如果截断后没有有效的填充数据保留，则不进行填充：”

Languages

I translate Node.js from English to Simplified Chinese.

Word Count

Regarding the number of words, this is my eighth contribution to Node.js project and I have translated 1179 words in this submission.

Before:

I have been working on the api folder and have translated 9053 words before this submission.

After:

The number of words being translated becomes 10232.

Total: 10232 - 9053 = 1179 words

Proof of Authorship

My translation activities can be viewed in my Crowdin profile: https://crowdin.com/profile/aafeng/activity