-
-
Notifications
You must be signed in to change notification settings - Fork 113
2-ui/1-document/01-browser-environment/article.md #86
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
odsantos
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi Danielli,
Thanks for the high quality work.
I hope to not give you much trouble. Would you please consider these changes?
Be also free for making suggestions.
Much appreciated,
Osvaldo.
| A linguagem JavaScript foi inicialmente criada para navegadores web. Desde então, tem evoluído e se tornado uma linguagem com muitos usuários e plataformas. | ||
|
|
||
| A platform may be a browser, or a web-server, or a washing machine, or another *host*. Each of them provides platform-specific functionality. The JavaScript specification calls that a *host environment*. | ||
| A plataforma pode ser um navegador, ou servidor web, ou uma máquina de lavar, ou outro *host*. Cada um deles fornece funcionalidades específicas da plataforma. Nas especificações JavaScript são conhecidas como *ambiente de hospedagem*. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- ", ou um servidor web,"
- "...ou outro hospedeiro (host)."
(hospedeiro is in italics) - "...funcionalidades específicas
dapara a plataforma." - "
Nas especificaçõesNa especificação de JavaScriptsão conhecidasé conhecida como ambiente de hospedagem (host environment)."
| A plataforma pode ser um navegador, ou servidor web, ou uma máquina de lavar, ou outro *host*. Cada um deles fornece funcionalidades específicas da plataforma. Nas especificações JavaScript são conhecidas como *ambiente de hospedagem*. | ||
|
|
||
| A host environment provides platform-specific objects and functions additional to the language core. Web browsers give a means to control web pages. Node.js provides server-side features, and so on. | ||
| Um ambente de hospedagem fornece objetos específicos de platarfoma e funções adicionais ao núcleo da linguagem. Navegadores web dão um significado para páginas de controle web. Node.js fornece aplicações server-side, e assim vai. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...fornece objetos específicos
depara aplatarfomaplataforma..." - "Navegadores web dão um
significado para páginas de controle webmeio para controlar páginas web." - "O Node.js fornece
aplicaçõesfuncionalidades para servidores (server-side), e assimvaipor diante."
(server-side is in italics, as in general non-Portuguese complementary terms - not main terms like JavaScrit or Node.js)
|
|
||
| 1. First, it is a global object for JavaScript code, as described in the chapter <info:global-object>. | ||
| 2. Second, it represents the "browser window" and provides methods to control it. | ||
| 1. Primeiro, existe um objeto global para o código JavaScript, como descrito no capítulo <info:global-object>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...
existeele é um objeto global paraocódigo em JavaScript,"
| Yes, you heard that right. The HTML spec at <https://html.spec.whatwg.org> is not only about the "HTML language" (tags, attributes), but also covers a bunch of objects, methods and browser-specific DOM extensions. That's "HTML in broad terms". Also, some parts have additional specs listed at <https://spec.whatwg.org>. | ||
| >>>>>>> 852ee189170d9022f67ab6d387aeae76810b5923 | ||
| Sim, voce ouviu direito. A especificação HTML <https://html.spec.whatwg.org> não é somente sobre a "Linguagem HTML" (tags, attributes), mas também abrange vários objetos, métodos e específicas extensões DOM para navegadores. Isso é "HTML em termos amplos". Tamém, algumas partes tem especificações adicionais listadas em <https://spec.whatwg.org>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...especificação HTML em https://html.spec.whatwg.org não..."
- "...(tags,
attributesatributos),..."
(tags is in italics) - "...e extensões ao DOM específicas para navegadores."
- " "HTML em termos
amplosgerais". " - "
TamémTambém, algumas..."
| DOM specification | ||
| : Describes the document structure, manipulations and events, see <https://dom.spec.whatwg.org>. | ||
| Especificação DOM | ||
| : Descreve a estrutura de documento, manipulações e eventos, ver em <https://dom.spec.whatwg.org>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...estrutura
dedo documento," - ",
verveja em..."
| CSSOM specification | ||
| : Describes stylesheets and style rules, manipulations with them and their binding to documents, see <https://www.w3.org/TR/cssom-1/>. | ||
| Especificação CSSOM | ||
| : Descreve folhas de estilo e regras de estilo, manipulações delas e sua documentação obrigatória, ver em <https://www.w3.org/TR/cssom-1/>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- ", manipulações
delas e sua documentação obrigatóriacom elas e suas ligações a documentos,verveja em..."
| HTML specification | ||
| : Describes the HTML language (e.g. tags) and also the BOM (browser object model) -- various browser functions: `setTimeout`, `alert`, `location` and so on, see <https://html.spec.whatwg.org>. It takes the DOM specification and extends it with many additional properties and methods. | ||
| Especificação HTML | ||
| : Descreve a linguagem HTML (e.g. tags) e também o BOM (Modelo de Objeto do Navegador) -- várias funçoes de navegador: `setTimeout`, `alert`, `location` e assim vai, ver em <https://html.spec.whatwg.org>. Besicamente a especificação DOM expandida com várias propriedades e métodos adicionais. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "(
e.g.ex. tags)" - "...e assim
vai, verpor diante, veja em ..." - "
BesicamenteBásicamente, a especificação..."
| Porfavor anote os links acima, como existe muita coisa para aprender é impossível abranger e lembrar de tudo. | ||
|
|
||
| When you'd like to read about a property or a method, the Mozilla manual at <https://developer.mozilla.org/en-US/search> is a nice resource, but reading the corresponding spec may be better: it's more complex and longer to read, but will make your fundamental knowledge sound and complete. | ||
| Quando voce quiser ler sobre uma propriedade ou método, o manual do Mozilla está em <https://developer.mozilla.org/en-US/search> é uma boa fontei, mas ler a espcificação correspondente pode ser melhor: é mais complexo e longo para ler, mas irá fazer seu conhecimento básico completo. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "Quando
vocevocê quiser..." - "....manual
doda Mozillaestáem..." - "...boa
fonteifonte," - "...mais
complexocomplexa e..."
|
Please make the requested changes. After it, add a comment "/done". |
|
Hi Danielli @daniellic9, congratulations for pursuing a computer's degree. Much appreciated, |
|
/done |
odsantos
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi Danielli,
I hope not to give you much trouble with this new review.
Thanks,
Osvaldo.
| 2. Segundo, ele representa a "janela de navegação" e fornece métodos de controle. | ||
|
|
||
| For instance, here we use it as a global object: | ||
| Por exemplo, nós o usamos como objeto global: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "Por exemplo, aqui nós o usamos..."
| A plataforma pode ser um navegador, ou um servidor web, ou uma máquina de lavar, ou outro *hospedeiro* (host). Cada um deles fornece funcionalidades específicas para a plataforma. Na especificação JavaScript é conhecida como *ambiente de hospedagem* (host environment). | ||
|
|
||
| A host environment provides platform-specific objects and functions additional to the language core. Web browsers give a means to control web pages. Node.js provides server-side features, and so on. | ||
| Um ambente de hospedagem fornece objetos específicos para a platafoma e funções adicionais ao núcleo da linguagem. Navegadores web dão um meio paracontrolar páginas web. Node.js fornece funcionalidades para servidores (*server-side*), e assim por diante. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "Um
ambenteambiente de hospedagem..." - "...meio
paracontrolarpara controlar páginas web." - " O Node.js fornece ..."
| # Ambiente do Navegador, especificações | ||
|
|
||
| The JavaScript language was initially created for web browsers. Since then, it has evolved and become a language with many uses and platforms. | ||
| A linguagem JavaScript foi inicialmente criada para navegadores para a web. Desde então, tem evoluído e se tornado uma linguagem com muitos usuários e plataformas. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...tornado
umanuma linguagem..."
| 1. First, it is a global object for JavaScript code, as described in the chapter <info:global-object>. | ||
| 2. Second, it represents the "browser window" and provides methods to control it. | ||
| 1. Primeiro, ele é um objeto global para o código JavaScript, como descrito no capítulo <info:global-object>. | ||
| 2. Segundo, ele representa a "janela de navegação" e fornece métodos de controle. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "... e fornece métodos
de controlepara a controlar."
| ``` | ||
|
|
||
| And here we use it as a browser window, to see the window height: | ||
| E nós o usamos como janela de navegação, para ver a altura da janela: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "E aqui nós o usamos como janela..."
| ```smart header="DOM is not only for browsers" | ||
| The DOM specification explains the structure of a document and provides objects to manipulate it. There are non-browser instruments that use it too. | ||
| ```smart header="DOM não é somente para navegadores" | ||
| A especificação DOM explica a estrutura de um documento e fornece objetos para manipulação. Existem instrumentos que não são de navegador que também usam-o. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "... fornece objetos para
manipulaçãoa manipular." - "...também
usam-oa usam."
(usam a especificação)
|
|
||
| - The [navigator](mdn:api/Window/navigator) object provides background information about the browser and the operating system. There are many properties, but the two most widely known are: `navigator.userAgent` -- about the current browser, and `navigator.platform` -- about the platform (can help to differ between Windows/Linux/Mac etc). | ||
| - The [location](mdn:api/Window/location) object allows us to read the current URL and can redirect the browser to a new one. | ||
| - O objeto de [navigator](mdn:api/Window/navigator) fornece informações de suporte sobre o navegador e o sistema operacional. Existem muitas propriedades, mas as duas mais usadas são: `navigator.userAgent` -- sobre o navegador atual, e `navigator.platform` -- sobre a plataforma (pode ajudar a diferenciar entre Windows/Linux/Mac etc). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "O objeto
de[navigator]..."
| Yes, you heard that right. The HTML spec at <https://html.spec.whatwg.org> is not only about the "HTML language" (tags, attributes), but also covers a bunch of objects, methods and browser-specific DOM extensions. That's "HTML in broad terms". Also, some parts have additional specs listed at <https://spec.whatwg.org>. | ||
| >>>>>>> 852ee189170d9022f67ab6d387aeae76810b5923 | ||
| Sim, voce ouviu direito. A especificação HTML em <https://html.spec.whatwg.org> não é somente sobre a "Linguagem HTML" (*tags*, atributos), mas também abrange vários objetos, métodos e específicas extensões ao DOM específicas para navegadores. Isso é "HTML em termos gerais". Também, algumas partes tem especificações adicionais listadas em <https://spec.whatwg.org>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...métodos e
específicasextensões ao DOM específicas para..."
| : Descreve a linguagem HTML (ex. tags) e também o BOM (Modelo de Objeto do Navegador) -- várias funçoes de navegador: `setTimeout`, `alert`, `location` e assim por diante, veja em <https://html.spec.whatwg.org>. Basicamente a especificação DOM expandida com várias propriedades e métodos adicionais. | ||
|
|
||
| Now we'll get down to learning DOM, because the document plays the central role in the UI. | ||
| Agora iremos nos aprofundar em aprender DOM, porque a documentação tem papel principal na UI. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...tem um papel..."
| Porfavor anote os links acima, como existe muita coisa para aprender é impossível abranger e lembrar de tudo. | ||
|
|
||
| When you'd like to read about a property or a method, the Mozilla manual at <https://developer.mozilla.org/en-US/search> is a nice resource, but reading the corresponding spec may be better: it's more complex and longer to read, but will make your fundamental knowledge sound and complete. | ||
| Quando você quiser ler sobre uma propriedade ou método, o manual da Mozilla em <https://developer.mozilla.org/en-US/search> é uma boa fonte, mas ler a espcificação correspondente pode ser melhor: é mais complexa e longo para ler, mas irá fazer seu conhecimento básico completo. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- "...
espcificaçãoespecificação correspondente pode ser melhor: é mais complexa elongolonga para ler,"
|
Please make the requested changes. After it, add a comment "/done". |
|
Hi @daniellic9 is this still in progress? |
|
Hi @daniellic9 , My previous review seems not addressed. Still working on this? Is the review not correct? Thanks, |
|
@peruibeloko, @jonnathan-ls, @odsantos, we need some solution to this pull request. I am thinking on to close it and start a new one with updates applied and conflicts resolved. |
|
@peruibeloko, @odsantos, and @jonnathan-ls, I am considering to close this pull request, what do you think? |
|
Sounds good |
No description provided.