Repository navigation
Translate 'Coordinates' to Portuguese - #509
Conversation
Includes the 4 exercise subfolders and head.html's demo handler. SVGs (coordinates.svg, coordinates-negative.svg, document-and-window-coordinates-scrolled.svg) contain only DOMRect/ coordinate property identifiers (x, y, top, left, pageX, clientY, etc.), so left untouched. The Lorem ipsum filler text is kept in Latin per convention; the joke blockquote was translated since it's genuine readable content shown in the exercise demos. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
| As coordenadas relativas ao documento começam a partir do canto superior-esquerdo do documento, não da janela. | ||
|
|
||
| In CSS, window coordinates correspond to `position:fixed`, while document coordinates are similar to `position:absolute` on top. | ||
| No CSS, as coordenadas da janela correspondem a `position:fixed`, enquanto as coordenadas do documento são parecidas com `position:absolute` no topo. |
There was a problem hiding this comment.
Importante: aqui o "on top" do original não quer dizer "no topo" da página, e sim "no nível superior", ou seja, um position:absolute aplicado diretamente na raiz do documento (como o próprio artigo diz no início: "parecido com position:absolute na raiz do documento"). Do jeito que está, o leitor pode entender que se trata de um elemento posicionado no alto da página. Sugestão:
| No CSS, as coordenadas da janela correspondem a `position:fixed`, enquanto as coordenadas do documento são parecidas com `position:absolute` no topo. | |
| No CSS, as coordenadas da janela correspondem a `position:fixed`, enquanto as coordenadas do documento são parecidas com `position:absolute` aplicado no nível superior do documento. |
| - `pageY` = `clientY` + altura da parte vertical rolada para fora do documento. | ||
| - `pageX` = `clientX` + largura da parte horizontal rolada para fora do documento. |
There was a problem hiding this comment.
Importante: "rolada para fora do documento" pode ser lido como se essa parte saísse do documento, o que muda o sentido. O original fala da parte do documento que, com a rolagem, saiu da área visível da janela. Sugestão:
| - `pageY` = `clientY` + altura da parte vertical rolada para fora do documento. | |
| - `pageX` = `clientX` + largura da parte horizontal rolada para fora do documento. | |
| - `pageY` = `clientY` + altura da parte vertical do documento que foi rolada para fora da área visível. | |
| - `pageX` = `clientX` + largura da parte horizontal do documento que foi rolada para fora da área visível. |
Pelo mesmo motivo, a linha 19 ("agora rolado para fora") ficaria mais clara como "agora fora da área visível".
| // add it for 5 seconds in the document | ||
| let message = createMessageUnder(elem, 'Hello, world!'); | ||
| // Uso: | ||
| // adiciona ela por 5 segundos no documento |
There was a problem hiding this comment.
Opcional: na norma escrita, o pronome oblíquo é o mais adequado como objeto direto ("adiciona-a"), e o verbo "adicionar" pede a preposição "a" ("ao documento"). Sugestão:
| // adiciona ela por 5 segundos no documento | |
| // adiciona-a ao documento por 5 segundos |
| Os cantos externos são basicamente o que obtemos de [elem.getBoundingClientRect()](https://developer.mozilla.org/en-US/docs/DOM/element.getBoundingClientRect). | ||
|
|
||
| Coordinates of the upper-left corner `answer1` and the bottom-right corner `answer2`: | ||
| Coordenadas do canto superior-esquerdo `answer1` e do canto inferior-direito `answer2`: |
There was a problem hiding this comment.
Opcional: em português, os adjetivos de posição como estes costumam ser escritos sem hífen: "canto superior esquerdo", "canto inferior direito". A mesma forma com hífen aparece em outras partes da tradução: nos títulos deste arquivo (linhas 14 e 22), em task.md desta tarefa (linhas 17 a 20) e em article.md (linhas 80, 102 e 198). Sugestão para esta linha:
| Coordenadas do canto superior-esquerdo `answer1` e do canto inferior-direito `answer2`: | |
| Coordenadas do canto superior esquerdo `answer1` e do canto inferior direito `answer2`: |
- Fix meaning: "position:absolute on top" means applied at the
document's top level, not an element positioned at the top of
the page
- Fix meaning: the "scrolled-out" part is the part that left the
visible area, not a part that left the document itself
- Remove hyphens from position terms ("superior esquerdo", "inferior
direito"), which is the standard unhyphenated PT-BR form
- Use the oblique pronoun "adiciona-a" with its required preposition
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
Obrigado pela revisão, @gabifs! Corrigido:
|
Resumo
Traduz o artigo "Coordinates" para o português, incluindo os 4 exercícios desta pasta e o handler de demonstração em
head.html.Os SVGs (
coordinates.svg,coordinates-negative.svg,document-and-window-coordinates-scrolled.svg) contêm apenas identificadores de propriedades doDOMRect/coordenadas (x,y,top,left,pageX,clientYetc.), por isso ficaram como estão. O texto de preenchimento "Lorem ipsum" foi mantido em latim, conforme a convenção; a piada em blockquote foi traduzida, já que é conteúdo legível de fato, mostrado nas demos dos exercícios.Conforme comentado na #1.
Plano de teste