Portuguese Translation Progress

[iliakan]

Maintainer List

@luizclr, @odsantos, @Mr-Saxobeat, @jonnathan-ls, @leopoldovcfonseca, @nazarepiedady, @murillorossetti

For New Translators

Please read this first (click to open)

To translate an article:

1. Check that no one else has claimed your article in the checklist below.
2. Comment below with the title of the article that you would like to translate, exactly as listed, e.g. An Introduction to JavaScript.
   • Please take only one article at a time.
3. Fork this repo, translate the article in your fork and submit a pull request!
   • The pull request title should be same as the article, e.g. An Introduction to JavaScript (just like comment)

Please be prompt with your translations! If you find that you can't commit any more, let maintainers know so they can assign the page to someone else.

For Maintainers

Click to open

We recommend that a translation has 2 reviews to be merged.

Please let others know what you do, on community boards and chats, invite them to join. Translations become better if more people see them.

Translations are tracked below, like this:

• Home Page (@iliakan) Portuguese Translation Progress #1

Our helpful bot watches comments and adds the translator nick and PR id, marks completed, when PR is merged. You can read the details at https://javascript.info/translate/bot.

If something doesn't work right, please contact @iliakan.

Team translation

More details about team translation: https://javascript.info/translate/bot.

Only maintainers can check/uncheck items below. If you're not, please write in a comment what you take to translate, the title, exactly as in the list.

The JavaScript language

An introduction

• An Introduction to JavaScript (@mrodrigochaves)
• Manuals and specifications (@Mr-Saxobeat) Manuals and specifications #53
• Code editors (@mrodrigochaves)
• Developer console (@mrodrigochaves)

JavaScript Fundamentals

• Hello, world! (@mrodrigochaves)
• Code structure (@mrodrigochaves)
• The modern mode, "use strict" (@daliannyvieira)
• Variables (@mrodrigochaves)
• Data types (@mrodrigochaves) and (@jonnathan-ls) Data types #243
• Interaction: alert, prompt, confirm (@EvertonCosmo)
• Type Conversions (@PauloBacelar) Type Conversions #212
• Basic operators, maths (@betofc89) and (@Peruibeloko ) Basic operators, maths #412
• Comparisons (@Andres-ibanez) Translate comparisons #15
• Conditional branching: if, '?' (@jonnathan-ls) Conditional branching: if, '?' #246
• Logical operators (@jonnathan-ls) Logical operators #401
• Nullish coalescing operator '??' (@ermogenes) nullish-coalescing-operator finished #195
• Loops: while and for (@alvar-o) Loops: while and for #77
• The "switch" statement (@odsantos) The "switch" statement #108
• Functions (@dheyson)
• Function expressions (@AlexPHorta) Function expressions #162
• Arrow functions, the basics (@allanpaza) Arrow functions, the basics #163
• JavaScript specials (@odsantos) JavaScript specials #146

Code quality

• Debugging in the browser (@zenobiopereira) Debugging in the browser #399
• Coding Style (@odsantos) Coding style #167
• Comments (@odsantos) Comments #168
• Ninja code (@Mr-Saxobeat) Ninja code #182
• Automated testing with Mocha (@odsantos) Automated testing with Mocha #164
• Polyfills and transpilers (@odsantos) Polyfills and transpilers #215

Objects: the basics

• Objects (@odsantos)
• Object references and copying (@danilolmc) Object references and copying #408
• Garbage collection (@odsantos) Garbage collection #174
• Object methods, "this" (@odsantos) Object methods, "this" #176
• Constructor, operator "new" (@PedroDousseau) Constructor, operator "new" #400
• Optional chaining '?.'
• Symbol type (@danilolmc) Symbol type #409
• Object to primitive conversion (@odsantos) Object to primitive conversion #193

Data types

• Methods of primitives (@DouglasMV)
• Numbers (@nazarepiedady)
• Strings (@odsantos) Strings #197
• Arrays (@odsantos) Arrays #105
• Array methods (@adriavieira314) Array methods #109
• Iterables (@marcoarib) Iterables #118
• Map and Set (@gabifs) Map and Set #405
• WeakMap and WeakSet (@kiniggit)
• Object.keys, values, entries (@marcoarib)
• Destructuring assignment (@theomelo)
• Date and time (@nataliakeller)
• JSON methods, toJSON (@dlgasparotto) JSON methods, toJSON #185

Advanced working with functions

• Recursion and stack (@allanpaza)
• Rest parameters and spread syntax (@anapaulalemos)
• Variable scope, closure (@dlgasparotto)
• The old "var" (@EvertonCosmo)
• Global object (@anapaulalemos) Global object #123
• Function object, NFE (@odsantos) Function object, NFE #204
• The "new Function" syntax (@tfbio) The "new Function" syntax #156
• Scheduling: setTimeout and setInterval (@vmlage)
• Decorators and forwarding, call/apply (@nazarepiedady) Decorators and forwarding, call/apply #218
• Function binding (@sidglas)
• Arrow functions revisited (@mauehara)

Object properties configuration

• Property flags and descriptors (@herbertpdl) Property flags and descriptors #219
• Property getters and setters (@herbertpdl)

Prototypes, inheritance

• Prototypal inheritance (@flaviohblima) Prototypal inheritance #230
• F.prototype (@flaviohblima) F.prototype #231
• Native prototypes (@flaviohblima) Native prototypes #233
• Prototype methods, objects without proto

Classes

• Class basic syntax (@thiagocardoso1988) Class basic syntax #248
• Class inheritance (@PauloBacelar)
• Static properties and methods (@thiagocardoso1988)
• Private and protected properties and methods (@danilolmc) Private and protected properties and methods #410
• Extending built-in classes (@danilolmc) Extending built-in classes #413
• Class checking: "instanceof" (@danilolmc) Class checking: "instanceof" #398
• Mixins (@danilolmc) Mixins #382

Error handling

• Error handling, "try...catch" (@jpvasquesc)
• Custom errors, extending Error (@rkaustchr)

Promises, async/await

• Introduction: callbacks (@nildo)
• Promise (@portothree)
• Promises chaining (@kiniggit) Promises chaining #120
• Error handling with promises (@kiniggit)
• Promise API (@mjfneto)
• Promisification (@kiniggit)
• Microtasks (@kiniggit)
• Async/await (@adroaldopagliari)

Generators, advanced iteration

• Generators (@danilolmc) Generators #414
• Async iteration and generators (@danilolmc) Async iteration and generators #418

Modules

• Modules, introduction (@adriavieira314)
• Export and Import (@anapaulalemos)
• Dynamic imports (@danilolmc) Dynamic imports #419

Miscellaneous

• Proxy and Reflect (@danilolmc) Proxy and Reflect #422
• Eval: run a code string (@odsantos) Eval: run a code string #270
• Currying (@dekisr)
• Reference Type (@danilolmc) Reference Type #423
• BigInt (@danilolmc) BigInt #430
• Unicode, String internals (@notFaceroll) Unicode, String internals #426
• WeakRef and FinalizationRegistry

Browser: Document, Events, Interfaces

Document

• Browser environment, specs (@daniellic9)
• DOM tree (@almirleandro)
• Walking the DOM (@exploitmik)
• Searching: getElement*, querySelector* (@danilolmc) Searching: getElement*, querySelector* #432
• Node properties: type, tag and contents (@addev93)
• Attributes and properties (@denis-rossati)
• Modifying the document
• Styles and classes (@danilolmc) Styles and classes #433
• Element size and scrolling (@danilolmc)
• Window sizes and scrolling
• Coordinates

Introduction to Events

• Introduction to browser events (@cesarkohl)
• Bubbling and capturing
• Event delegation
• Browser default actions
• Dispatching custom events

UI Events

• Mouse events
• Moving the mouse: mouseover/out, mouseenter/leave
• Drag'n'Drop with mouse events
• Pointer events
• Keyboard: keydown and keyup
• Scrolling (@vnscosta)

Forms, controls

• Form properties and methods (@recalderon)
• Focusing: focus/blur
• Events: change, input, cut, copy, paste
• Forms: event and method submit

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer (@larissaiurk) Scripts: async, defer #229
• Resource loading: onload and onerror

Miscellaneous

• Mutation observer
• Selection and Range
• Event loop: microtasks and macrotasks

Frames and windows

• Popups and window methods
• Cross-window communication
• The clickjacking attack

Binary data, files

• ArrayBuffer, binary arrays
• TextDecoder and TextEncoder
• Blob
• File and FileReader

Network requests

• Fetch (@vitorinoaraujo)
• FormData
• Fetch: Download progress
• Fetch: Abort
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects
• XMLHttpRequest
• Resumable file upload
• Long polling
• WebSocket
• Server Sent Events

Storing data in the browser

• Cookies, document.cookie
• LocalStorage, sessionStorage
• IndexedDB

Animation

• Bezier curve (@lucastrvsn)
• CSS-animations (@mauehara) CSS-animations #128
• JavaScript animations (@karlasamantha)

Web components

• From the orbital height
• Custom elements (@gabifs)
• Shadow DOM and events
• Template element (@HakaCode)
• Shadow DOM slots, composition
• Shadow DOM styling
• Shadow DOM and events

Regular expressions

• Patterns and flags (@fsdude) Patterns and flags #147
• Character classes (@odsantos) Character classes #274
• Unicode: flag "u" and class \p{...} (@Peruibeloko) Unicode: flag "u" and class \p{...} #415
• Anchors: string start ^ and end $ (@Peruibeloko) Anchors: string start ^ and end $ #420
• Multiline mode of anchors ^ $, flag "m" (@Peruibeloko) Multiline mode of anchors ^ $, flag "m" #421
• Word boundary: \b (@Peruibeloko) Word boundary: \b #424
• Escaping, special characters (@Peruibeloko) Escaping, special characters #425
• Sets and ranges [...] (@Peruibeloko) Sets and ranges [...] #427
• Quantifiers +, *, ? and {n} (@Peruibeloko) Quantifiers +, *, ? and {n} #429
• Greedy and lazy quantifiers (@Peruibeloko)
• Capturing groups
• Backreferences in pattern: \N and \k<name>
• Alternation (OR) |
• Lookahead and lookbehind
• Catastrophic backtracking
• Sticky flag "y", searching at position
• Methods of RegExp and String (@fsdude) Methods of RegExp and String #141

[rafaelgou]

Hi, @mrodrigochaves, can I join the effort? Do we have a glossary/style guide? If not, is there any from other languages that we could use as a starting point?

Thanks!

[iliakan]

Maybe there is a well-known glossary for web terms ?

[iliakan]

@rafaelgou you don’t need a permission to join. Just tell us what is you’re translating.

[rafaelgou]

Thanks, @iliakan. I'm researching a starting glossary and a way to store what we decide to unify during translation.

[mrodrigochaves]

Welcome, @rafaelgou ! I'm following a list according to the topic above: For new translators.

[DouglasMV]

Hi I'm going to help translate.
I will start with the "Methods of primitives" article at 1-js/05-data-types/01-primitives-methods

[iliakan]

When I look at Wikipedia, there's only pt.wikipedia.org.

Does it really make sense to have separate pt-br.javascript.info and pt-pt.javascript.info? Or we can join the efforts to have just pt.javascript.info?

[DouglasMV]

As a brazilian i can tell you that if i read a technical text, wich is the case, in Portugal's portuguese, I can understand but i cleary know i'm reading pt-pt not pt-br. But i cannot write in pt-pt only in pt-br. I hope that helps to clear a little bit how they are different.

[mrodrigochaves]

Hello @iliakan,

I understand your placement.
My suggestion is: either keep pt-br.javascript.info, or switch to pt.javascript.info.

However, I would have to keep native contributors from Brazil or Portugal, not from both countries, because of the difference that @DouglasMV commented above.

[iliakan]

Thanks, I saw that Wikipedia has only PT, so I joined pt-br and pt-pt into PT.
If Wiki is ok with that, we should be fine too =)

[iliakan]

For Wiki: an article must be either pt-pt or pt-br, not mixed.

I guess, if both regions understand each other, that rule is enough to keep both contributors.
That said, pt-pt version did not ever came to life.

[iliakan]

@mrodrigochaves may I wonder, what's your email? I'm making a non-public list of emails of all maintainers, to have a backup contact (if the translation appears to be dead or something).

[DouglasMV]

I'm translating 1-js/05-data-types/02-number/

[Andres-ibanez]

I'm translating Comparisons and Operators

[Andres-ibanez]

Logical operators

[DouglasMV]

Translating /1-js/05-data-types/03-string/

[DouglasMV]

Translating /1-js/05-data-types/04-array/

[DouglasMV]

Translating /1-js/05-data-types/05-array-methods

[DouglasMV]

Translating /1-js/05-data-types/06-iterable/

[DouglasMV]

Translating /1-js/05-data-types/07-map-set-weakmap-weakset/

[DouglasMV]

Translating /1-js/05-data-types/08-keys-values-entries/

[LASalvador]

Operators

[Mr-Saxobeat]

Manuals and specifications

[luizclr]

Operators

[romulomessias]

Hi. I want to help translate. I will start with Conditional operators: if, '?'

[iliakan]

Anyone wants to become a maintainer? @mrodrigochaves seems to be offline.

[luizclr]

@iliakan I do.

[Peruibeloko]

Greedy and lazy quantifiers

[danilolmc]

Searching: getElement*, querySelector*

[danilolmc]

Styles and classes

[nazarepiedady]

Numbers

[347fabricio]

Loops: while and for

[javascript-translate-bot]

Error: the article already has meta information in the Progress Issue "(@alvar-o) #50" ⁉️

[347fabricio]

I would like to translate Loops: while and for, but @alvar-o has already chosen it.

It has been started in 2019.

[danilolmc]

Element size and scrolling

[addev93]

Node properties: type, tag and contents

[p1padev]

Optional chaining '?.'

[odsantos]

Hi @iliakan , I forgot. Please, should variables be translated? Thanks.

[iliakan]

@odsantos usually variable names are not translated.