Portuguese Translation Progress

[iliakan]

Maintainer List

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

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) #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

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

JavaScript Fundamentals

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

Code quality

• [X] Debugging in the browser (@zenobiopereira) #399
• [x] Coding Style (@odsantos)
• [x] Comments (@odsantos)
• [x] Ninja code (@Mr-Saxobeat) #182
• [x] Automated testing with Mocha (@odsantos)
• [X] Polyfills and transpilers (@odsantos) #215

Objects: the basics

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

Data types

• [X] Methods of primitives (@DouglasMV)
• [ ] Numbers (@nazarepiedady)
• [ ] Strings
• [ ] Arrays
• [x] Array methods (@adriavieira314) #109
• [ ] Iterables
• [X] Map and Set (@gabifs) #405
• [ ] WeakMap and WeakSet
• [ ] Object.keys, values, entries
• [ ] Destructuring assignment
• [ ] Date and time
• [ ] JSON methods, toJSON

Advanced working with functions

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

Object properties configuration

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

Prototypes, inheritance

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

Classes

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

Error handling

• [ ] Error handling, "try...catch"
• [ ] Custom errors, extending Error

Promises, async/await

• [x] Introduction: callbacks (@nildo)
• [ ] Promise
• [X] Promises chaining (@kiniggit) #120
• [ ] Error handling with promises
• [ ] Promise API
• [ ] Promisification
• [ ] Microtasks
• [ ] Async/await

Generators, advanced iteration

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

Modules

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

Miscellaneous

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

Browser: Document, Events, Interfaces

Document

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

Introduction to Events

• [ ] Introduction to browser events
• [ ] 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

Forms, controls

• [ ] Form properties and methods
• [ ] Focusing: focus/blur
• [ ] Events: change, input, cut, copy, paste
• [x] Forms: event and method submit (@brunacborgesm) #449

Document and resource loading

• [ ] Page: DOMContentLoaded, load, beforeunload, unload
• [X] Scripts: async, defer (@larissaiurk) #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 (@gabifs) #450
• [ ] TextDecoder and TextEncoder
• [ ] Blob
• [ ] File and FileReader

Network requests

• [ ] Fetch
• [ ] 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
• [X] CSS-animations (@mauehara) #128
• [x] JavaScript animations (@karlasamantha)

Web components

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

Regular expressions

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

[iliakan]

@Luizlc10 done!

[luizclr]

Hi, @rmasouza. To take an item from the checklist you should comment only its title as this one https://github.com/javascript-tutorial/pt.javascript.info/issues/1#issuecomment-521220542

[romulomessias]

Hi, @rmasouza. To take an item from the checklist you should comment only its title as this one #1 (comment)

ok, thanks