Portuguese Translation Progress
iliakan opened this issue · 366 comments
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:
- Check that no one else has claimed your article in the checklist below.
- 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.
- 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)
- The pull request title should be same as the article, e.g.
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:
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) #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) #243
- Interaction: alert, prompt, confirm (@EvertonCosmo)
- Type Conversions (@PauloBacelar) #212
- Basic operators, maths (@betofc89) and (@Peruibeloko ) #412
- Comparisons (@Andres-ibanez) #15
- Conditional branching: if, '?' (@jonnathan-ls) #246
- Logical operators (@jonnathan-ls) #401
- Nullish coalescing operator '??' (@ermogenes) #195
- Loops: while and for (@alvar-o) #77
- The "switch" statement (@odsantos) #108
- Functions (@dheyson)
- Function expressions (@AlexPHorta) #162
- Arrow functions, the basics (@allanpaza) #163
- JavaScript specials (@odsantos) #146
Code quality
- Debugging in the browser (@zenobiopereira) #399
- Coding Style (@odsantos) #167
- Comments (@odsantos) #168
- Ninja code (@Mr-Saxobeat) #182
- Automated testing with Mocha (@odsantos) #164
- Polyfills and transpilers (@odsantos) #215
Objects: the basics
- Objects (@odsantos)
- Object references and copying (@danilolmc) #408
- Garbage collection (@odsantos) #174
- Object methods, "this" (@odsantos) #176
- Constructor, operator "new" (@PedroDousseau) #400
- Optional chaining '?.'
- Symbol type (@danilolmc) #409
- Object to primitive conversion (@odsantos) #193
Data types
- Methods of primitives (@DouglasMV)
- Numbers (@nazarepiedady)
- Strings (@odsantos) #197
- Arrays (@odsantos) #105
- Array methods (@adriavieira314) #109
- Iterables (@marcoarib) #118
- Map and Set (@gabifs) #405
- WeakMap and WeakSet (@kiniggit)
- Object.keys, values, entries (@marcoarib)
- Destructuring assignment (@theomelo)
- Date and time (@nataliakeller)
- JSON methods, toJSON (@dlgasparotto) #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) #123
- Function object, NFE (@odsantos) #204
- The "new Function" syntax (@tfbio) #156
- Scheduling: setTimeout and setInterval (@vmlage)
- Decorators and forwarding, call/apply (@nazarepiedady) #218
- Function binding (@sidglas)
- Arrow functions revisited (@mauehara)
Object properties configuration
Prototypes, inheritance
- Prototypal inheritance (@flaviohblima) #230
- F.prototype (@flaviohblima) #231
- Native prototypes (@flaviohblima) #233
- Prototype methods, objects without proto
Classes
- Class basic syntax (@thiagocardoso1988) #248
- Class inheritance (@PauloBacelar)
- Static properties and methods (@thiagocardoso1988)
- Private and protected properties and methods (@danilolmc) #410
- Extending built-in classes (@danilolmc) #413
- Class checking: "instanceof" (@danilolmc) #398
- Mixins (@danilolmc) #382
Error handling
Promises, async/await
- Introduction: callbacks (@nildo)
- Promise (@portothree)
- Promises chaining (@kiniggit) #120
- Error handling with promises (@kiniggit)
- Promise API (@mjfneto)
- Promisification (@kiniggit)
- Microtasks (@kiniggit)
- Async/await (@adroaldopagliari)
Generators, advanced iteration
Modules
- Modules, introduction (@adriavieira314)
- Export and Import (@anapaulalemos)
- Dynamic imports (@danilolmc) #419
Miscellaneous
- Proxy and Reflect (@danilolmc) #422
- Eval: run a code string (@odsantos) #270
- Currying (@dekisr)
- Reference Type (@danilolmc) #423
- BigInt (@danilolmc) #430
- Unicode, String internals (@notFaceroll) #426
- WeakRef and FinalizationRegistry
Browser: Document, Events, Interfaces
Document
- Browser environment, specs (@daniellic9)
- DOM tree (@almirleandro)
- Walking the DOM (@exploitmik)
- Searching: getElement*, querySelector* (@danilolmc) #432
- Node properties: type, tag and contents
- Attributes and properties (@denis-rossati)
- Modifying the document
- Styles and classes (@danilolmc) #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) #229
- Resource loading: onload and onerror
Miscellaneous
Frames and windows
Binary data, files
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
Animation
- Bezier curve (@lucastrvsn)
- CSS-animations (@mauehara) #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) #147
- Character classes (@odsantos) #274
- Unicode: flag "u" and class \p{...} (@Peruibeloko) #415
- Anchors: string start ^ and end $ (@Peruibeloko) #420
- Multiline mode of anchors ^ $, flag "m" (@Peruibeloko) #421
- Word boundary: \b (@Peruibeloko) #424
- Escaping, special characters (@Peruibeloko) #425
- Sets and ranges [...] (@Peruibeloko) #427
- Quantifiers +, *, ? and {n} (@Peruibeloko) #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) #141
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!
Maybe there is a well-known glossary for web terms ?
@rafaelgou you don’t need a permission to join. Just tell us what is you’re translating.
Thanks, @iliakan. I'm researching a starting glossary and a way to store what we decide to unify during translation.
Welcome, @rafaelgou ! I'm following a list according to the topic above: For new translators.
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
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?
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.
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.
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 =)
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.
@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).
I'm translating 1-js/05-data-types/02-number/
I'm translating Comparisons and Operators
Logical operators
Translating /1-js/05-data-types/03-string/
Translating /1-js/05-data-types/04-array/
Translating /1-js/05-data-types/05-array-methods
Translating /1-js/05-data-types/06-iterable/
Translating /1-js/05-data-types/07-map-set-weakmap-weakset/
Translating /1-js/05-data-types/08-keys-values-entries/
Operators
Manuals and specifications
Operators
Hi. I want to help translate. I will start with Conditional operators: if, '?'
Anyone wants to become a maintainer? @mrodrigochaves seems to be offline.
@Luizlc10 done!
Hi, @rmasouza. To take an item from the checklist you should comment only its title as this one #1 (comment)
Hi, @rmasouza. To take an item from the checklist you should comment only its title as this one #1 (comment)
ok, thanks
Conditional operators: if, '?'
Error: the article already has meta information in the Progress Issue "(@rmasouza)"
Hi, @rmasouza . I've already added you to this chapter. That's the reason of the error above. Just for the next time you will choose a chapter, comment only its title. =)
Functions
Interaction: alert, prompt, confirm
Please translate only one chapter/Item per pull request (check the list above - e.g. Strings, Array, Array methods and so on). Do not translate a whole section in a single pull request. This way is easier to make code review. =D
Hi,
In the section 1 in english ("An introduction") there are four articles, where the article 1.2 ("Manuals and Specifications") is what I'm translating. But here in the portuguese repo already has a 1.2 article wich is named as the 1.3 ("Code Editors") article in the english version. What is suposed to do? Rename the articles folder?
Maybe upstream changes not merged? Please compare it with the English version and bring in sync.
Hi, @Mr-Saxobeat . Yes, this is not up to dated! I've just became a maintainer and didn't have time to sync it with master yet. I will be busy this weekend at least but I'll do it soon.
The "switch" statement
Object methods, "this"
Ninja code
Loops: while and for
Hi @mrodrigochaves ,
Would it be possible to contribute for the Portuguese translation ?
Thanks,
Osvaldo .
I can update the list of maintainers, if existing ones don't respond. Please let me know if you know JS well enough to review PRs of others.
Hi @iliakan, if you do not mind, I would like to begin translating basic articles, and if in conformance to your standards you might add me to a reviewer role.
However, from a quick look at the list of topics, I believe to be able to review most of the articles' translations with main exceptions to promises, yet some from Code quality, and a few more which I'm unsure of. So, I would also be pleased to additionally contribute as a reviewer.
I also have a legal copy of Flanagan's JavaScript, the Definitive Guide (updated to this year, although still appearing to have only new features from ECMAScript 5) for support.
Some suggestions for glossary terms research might be Gramática léxica
, Wikipédia:Dicionário and Política de Privacidade - Glossário de termos-chave/pt-pt.
Thanks.
I am starting by translating Logical operators. Thanks.
Do we have enough maintainers for Portuguese Translation?
Please let me know if you'd like to join and know JS enough to review PRs of others =)
I am afraid I do not know, @iliakan Ilya.
I would be glad to join and review PR's. Please do add me as a maintainer.
I believe to also have finished the first page translation and hope to soon open an issue an PR.
Thanks.
@odsantos I checked your github profile and couldn't find any evidence that you're good at JS. Are you? Do you have enough experience with JS?
@ikniaziuk I believe it is better to wait for some possible translations and then take a decision. Thanks.
@iliakan I'd like to be a reviewver. I'm just learning JS, but I think that comparing with the english version I would target the errors.
Logical operators
Comparisons
It seems that Comparisons have already been translated.
The "switch" statement
Hi, please would it be possible to de-reference Logical operators for myself.
I tried to wrongly request it days ago but has already been assigned to another person.
Thanks.
Function expressions and arrows
Updated contributors, removed @mrodrigochaves , added @odsantos , @luizclr
@iliakan Hi, some topics in the list seem translated but are unchecked. Would you like me to review them? Should I check any after that?
Thanks.
Hi, please would it be possible to de-reference Logical operators for myself.
I tried to wrongly request it days ago but has already been assigned to another person.
Thanks.
@odsantos
Hi, when you tried to reference the Logical operators the bot didn't marked you, because it needs to comment only the name of the topic. So, now I'm makerd as the translator of that topic.
Is there some reason the "Manuals and specifications" article isn't referencing the associated PR #53?
@Mr-Saxobeat please translate something, and let it be reviewed =)
About references - the bot only makes them correctly if PR has the right title.
Okay!
Well, I can't find any error in the title. Did I miss something?
@Mr-Saxobeat I left some comments requesting changes for #53.
Thanks.
JavaScript specials
@Mr-Saxobeat I finished the review to #53. Thanks.
Debugging in Chrome
Coding Style
@Mr-Saxobeat I replied to your changes to #53, which had previously been requested. Thank you.
Polyfills
Comments
Automated testing with Mocha
@Mr-Saxobeat Hi, I reviewed your changes to #53 some days ago. Thanks.
@Mr-Saxobeat Hi, I reviewed your changes to #53 some days ago. Thanks.
@odsantos Hi, sorry, I coundn't solve. But when I have a time I will review. :)
Rest parameters and spread operator
@Mr-Saxobeat Hi, I reviewed your changes to #53 some days ago. Thanks.
@odsantos Hi, sorry, I coundn't solve. But when I have a time I will review. :)
No worries. Thanks.
@iliakan No, Ilya, by any means.
It has been a great experience. Appreciated, for the kindness.
Hi guys,
I want to help to translate it.
How can I start?
Hi, you can start reading the "For New Translators" topic of the main comment of this issue, at the top! :)
Interaction: alert, prompt, confirm
Error: the article already has meta information in the Progress Issue "(@EvertonCosmo)"
Interaction: alert, prompt, confirm
@doougui As noted on the instructions, it is necessary to choose an unassigned lesson. Thanks.