Skip to content

Commit

Permalink
pt-br: Convert noteblocks to GFM Alerts (part 5) (#22769)
Browse files Browse the repository at this point in the history
* pt-br: Convert noteblocks to GFM Alerts (part 5)

This PR converts the noteblocks for the Portugese Brazilian locale to GFM Alerts syntax, using a [conversion script](https://github.com/queengooborg/mdn-toolkit/blob/main/upgrade-noteblock.js). This is part 5. Note: manual adjustments have also been made to correct some issues, including capitalization, syntax, duplicated keywords and more.

* Apply suggestions from code review

Co-authored-by: Josiel Rocha <1158643+josielrocha@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Update index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Fixes

* Fix flaws

---------

Co-authored-by: Josiel Rocha <1158643+josielrocha@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
3 people authored Aug 8, 2024
1 parent 4644abd commit 5c0ffa1
Show file tree
Hide file tree
Showing 100 changed files with 289 additions and 151 deletions.
3 changes: 2 additions & 1 deletion files/pt-br/web/html/global_attributes/accesskey/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ O [atributo global](/pt-BR/docs/Web/HTML/Global_attributes) **`accesskey`** forn

{{EmbedInteractiveExample("pages/tabbed/attribute-accesskey.html","tabbed-shorter")}}

> **Nota:** Na especificação do WHATWG, diz que você pode especificar vários caracteres separados por espaço, e o navegador usará primeiro o que ele suportar. No entanto, isso não funciona na maioria dos browsers. O IE/Edge usa o primeiro que ele suporta sem problemas, desde que não haja conflitos com outros comandos.
> [!NOTE]
> Na especificação do WHATWG, diz que você pode especificar vários caracteres separados por espaço, e o navegador usará primeiro o que ele suportar. No entanto, isso não funciona na maioria dos browsers. O IE/Edge usa o primeiro que ele suporta sem problemas, desde que não haja conflitos com outros comandos.
A maneira de ativar a tecla de acesso depende do navegador e de sua plataforma:

Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/html/global_attributes/hidden/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ Pode ser correto, entretanto, usar o atributo ARIA `aria-describedby`para refere

Similarmente, um elemento canvas com atributo `hidden` poderia ser usado como buffer por um script de gráficos, e um controle de formulário, usando seu atributo form, poderia referir-se a um elemento `form` com atributo `hidden`.

> **Nota:** Mudar o valor da propriedade {{cssxref("display")}} no CSS de um elemento com o atributo `hidden` sobrescreve o comportamento. Por exemplo, elementos com o estilo `display: flex;` serão mostrados independente da presença do atributo `hidden`.
> [!NOTE]
> Mudar o valor da propriedade {{cssxref("display")}} no CSS de um elemento com o atributo `hidden` sobrescreve o comportamento. Por exemplo, elementos com o estilo `display: flex;` serão mostrados independente da presença do atributo `hidden`.
## Especificações

Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/html/global_attributes/id/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ O valor deste atributo é uma string opaca: isso significa que os desenvolvedore

O valor deste atributo não deve conter lacunas (espaços, tabulações etc.). Navegadores tratam IDs inadequadas que contenham lacunas como se as lacunas fossem parte do ID. Em contraste com o atributo **class**, que permite múltiplos valores separados por espaço, os elementos podem ter somente um único ID.

> **Nota:** Utilizar caracteres exceto letras e dígitos ASCII, `'_'`, `'-'` e `'.'` pode causar problemas de compatibilidade, já que eles não eram permitidos no HTML 4. Embora esta restrição fora suspensa no HTML 5, um ID deve iniciar com uma letra para fins de compatibilidade.
> [!NOTE]
> Utilizar caracteres exceto letras e dígitos ASCII, `'_'`, `'-'` e `'.'` pode causar problemas de compatibilidade, já que eles não eram permitidos no HTML 4. Embora esta restrição fora suspensa no HTML 5, um ID deve iniciar com uma letra para fins de compatibilidade.
## Especificações

Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/html/global_attributes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,8 @@ Além dos atributos globais HTML básicos, os seguintes atributos globais també
- [`id`](/pt-BR/docs/Web/HTML/Global_attributes/id)
- : Define um identificador exclusivo (ID) que deve ser único em todo o documento. Seu objetivo é identificar o elemento ao vincular (usando um identificador de fragmento), um script ou estilo (com CSS).

> **Nota:** Os 5 atributos seguintes são partes do [Recursos de Microdados WHATWG HTML](http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#microdata).
> [!NOTE]
> Os 5 atributos seguintes são partes do [Recursos de Microdados WHATWG HTML](http://www.whatwg.org/specs/web-apps/current-work/multipage/links.html#microdata).
- [`itemid`](/pt-BR/docs/Web/HTML/Global_attributes/itemid) {{experimental_inline}}
- : O identificador único e global de um item.
Expand Down
8 changes: 5 additions & 3 deletions files/pt-br/web/html/global_attributes/itemprop/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -194,7 +194,8 @@ An element introducing a property can also introduce multiple properties at once
</div>
```

> **Note:** Note: There is no relationship between the microdata and the content of the document where the microdata is marked up.
> [!NOTE]
> There is no relationship between the microdata and the content of the document where the microdata is marked up.
### Same structured data marked up in two different ways

Expand Down Expand Up @@ -282,7 +283,8 @@ A property is an unordered set of unique tokens that are case-sensitive and repr

1. A string that contains no "**.**" (U+002E FULL STOP) characters and no "**:**" characters (U+003A COLON) and is used as a proprietary item property name (again, one not defined in a public specification).

> **Note:** the rules above disallow ":" characters in non-URL values because otherwise they could not be distinguished from URLs. Values with "." characters are reserved for future extensions. Space characters are disallowed because otherwise the values would be parsed as multiple tokens.
> [!NOTE]
> The rules above disallow ":" characters in non-URL values because otherwise they could not be distinguished from URLs. Values with "." characters are reserved for future extensions. Space characters are disallowed because otherwise the values would be parsed as multiple tokens.
## Values

Expand Down Expand Up @@ -421,7 +423,7 @@ Names are unordered relative to each other, but if a particular name has multipl

### Result

{{EmbedLiveSample('HTML_2', '', '', '', 'Web/HTML/Global_attributes/itemprop')}}
{{EmbedLiveSample('HTML_2')}}

## Specifications

Expand Down
6 changes: 4 additions & 2 deletions files/pt-br/web/html/global_attributes/lang/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,10 @@ O [atributo global](/pt-BR/docs/Web/HTML/Global_attributes) **`lang`** ajuda a d

Se o valor do atributo é uma _string vazia_ (`lang=""`), o idioma é definido como _unknown (desconhecido)_; se a tag de idioma não é válida conforme o BCP47, ela é definida como _invalid (invalida)_.

> **Note:** ## Sintaxe da tag de idiomaA sintaxe completa do BCP47 é profunda o suficente para caracterizar dialetos de linguagem extremamente expecíficos, mas a maioria dos usos são bem mais simples.Uma tag de idioma é feita de _subtags de idioma_ separadas por hífen, onde cada subtag indica uma certa propriedade da língua. As três subtags mais comuns são:- Subtag de idioma - : Necessária. Um código de 2 ou 3 caracteres que define o idioma base, tipicamente escrita em letras minúsculas. Por exemplo, o código para Inglês é `en` e o código para Português é `pt`.
>
## Sintaxe da tag de idioma

A sintaxe completa do BCP47 é profunda o suficente para caracterizar dialetos de linguagem extremamente expecíficos, mas a maioria dos usos são bem mais simples.Uma tag de idioma é feita de _subtags de idioma_ separadas por hífen, onde cada subtag indica uma certa propriedade da língua. As três subtags mais comuns são:- Subtag de idioma - : Necessária. Um código de 2 ou 3 caracteres que define o idioma base, tipicamente escrita em letras minúsculas. Por exemplo, o código para Inglês é `en` e o código para Português é `pt`

> - Subtag de script
> - : Opcional. Essa subtag define o sistema de escrita usado para a linguagem, e sempre tem 4 caracteres, com a primeira letra maiúscula. Por exemplo, Francês em Braile é `fr-Brai` e `ja-Kana` é Japonês escrito no alfabeto Katakana. Se a língua é escrita em uma maneira tipicamente comum, como Inglês no alfabeto Latino, não é necessário o uso da subtag.
> - Subtag de região
Expand Down
6 changes: 4 additions & 2 deletions files/pt-br/web/html/global_attributes/tabindex/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,14 @@ Ele aceita valores inteiros, com diferentes resultados dependendo do valor desse

- um _valor negativo_ (geralmente `tabindex="-1"`) significa que o elemento não deve ser localizado pela navegação sequencial do teclado, mas pode ser focável visualmente ou com JavaScript. Isso é mais útil para criar widgets accessíveis com JavaScript.

> **Note:** Um valor negativo é útil quando você tem conteúdo fora da tela que aparece com um evento específico. O usuário não poder focar em nenhum elemento com um `tabindex` negativo utilizando o teclado, porém um script pode o fazer utilizando o [método](/pt-BR/docs/Web/API/HTMLElement/focus) `focus()`.
> [!NOTE]
> Um valor negativo é útil quando você tem conteúdo fora da tela que aparece com um evento específico. O usuário não poder focar em nenhum elemento com um `tabindex` negativo utilizando o teclado, porém um script pode o fazer utilizando o [método](/pt-BR/docs/Web/API/HTMLElement/focus) `focus()`.
- `tabindex="0"` significa que o elemento deve ser focável e que pode ser localizado pela navegação sequencial do teclado, mas a sua posição será definida pela ordem no código-fonte do documento;
- um _valor positivo_ significa que o elemento deve ser focável e que pode ser localizado pela navegação sequencial do teclado, e a sua posição definida pelo valor do número. Sendo assim, `tabindex="4"` seria focado antes de `tabindex="5"`, mas depois de `tabindex="3"`. Se vários elementos possuírem o mesmo valor positivo de `tabindex`, a sua posição na ordenação será definida pela sua posição no código-fonte do documento. O valor máximo do `tabindex` é 32767. Se não especificado, assume o valor padrão 0.

> **Warning:** Evite usar valores do `tabindex` maiores que 0. Ao fazer isso dificulta para pessoas que dependem de tecnologias assistivas para navegar e operar o conteúdo da página. Ao invés disso, escreva o documento com os elementos em uma sequência lógica.
> [!WARNING]
> Evite usar valores do `tabindex` maiores que 0. Ao fazer isso dificulta para pessoas que dependem de tecnologias assistivas para navegar e operar o conteúdo da página. Ao invés disso, escreva o documento com os elementos em uma sequência lógica.
Se o atributo `tabindex` for definido em um elemento div {{htmlelement("div")}}, seu conteúdo filho (interno) não poderá ser rolado utilizando as teclas direcionais a menos que seja definido `tabindex` no conteúdo também. [Veja este fiddle para entender melhor os efeitos de rolagem do tabindex](https://jsfiddle.net/jainakshay/0b2q4Lgv/).

Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/http/basics_of_http/mime_types/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,8 @@ Este é o valor padrão para um arquivo binario. Como é um arquivo binário des

Este é o valor padrão para arquivos de texto. Mesmo se realmente significa arquivo textual desconhecido, os navegadores assumem que eles podem exibi-lo.

> **Nota:** Note que `text/plain` não significa qualquer tipo de dados textuais. Se eles esperam um tipo específico de dados textuais, eles provavelmente não consideram uma correspondência. Especificamente se eles baixarem um arquivo `text/plain` de um elemento {{HTMLElement ("link")}} declarando arquivos CSS, eles não o reconhecerão como arquivos CSS válidos se forem apresentados com `text/plain`.
> [!NOTE]
> Note que `text/plain` não significa qualquer tipo de dados textuais. Se eles esperam um tipo específico de dados textuais, eles provavelmente não consideram uma correspondência. Especificamente se eles baixarem um arquivo `text/plain` de um elemento {{HTMLElement ("link")}} declarando arquivos CSS, eles não o reconhecerão como arquivos CSS válidos se forem apresentados com `text/plain`.
> O CSS mime tipo `text/css` deve ser usado.
### `text/css`
Expand Down
9 changes: 6 additions & 3 deletions files/pt-br/web/http/caching/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -256,7 +256,8 @@ O servidor retornará `304 Not Modified` se o valor do cabeçalho `ETag` que ele

Mas se o servidor determinar que o recurso solicitado deve ter agora um valor 'ETag' diferente, o servidor responderá com um '200 OK' e a versão mais recente do recurso.

> **Nota:** ao avaliar como usar `ETag` e `Last-Modified`, considere o seguinte:
> [!NOTE]
> Ao avaliar como usar `ETag` e `Last-Modified`, considere o seguinte:
> Durante a revalidação de cache, se ambos `ETag` e `Last-Modified` estiverem presentes, `ETag` terá precedência.
> Portanto, se você está considerando apenas o armazenamento em cache, você pode pensar que 'Last-Modified' é desnecessário.
> No entanto, `Last-Modified` não é apenas útil para cache; em vez disso, é um cabeçalho HTTP padrão que também é usado por sistemas de gerenciamento de conteúdo (CMS) para exibir a hora da última modificação, por rastreadores para ajustar a frequência de rastreamento e para outras finalidades.
Expand Down Expand Up @@ -566,7 +567,8 @@ Observe que o número `41` tem a `max-age` mais longa (1 ano), mas com `public`.

O valor `public` tem o efeito de tornar a resposta armazenável mesmo se o cabeçalho `Authorization` estiver presente.

> **Nota:** A diretiva `public` só deve ser usada se houver necessidade de armazenar a resposta quando o cabeçalho `Authorization` for definido.
> [!NOTE]
> A diretiva `public` só deve ser usada se houver necessidade de armazenar a resposta quando o cabeçalho `Authorization` for definido.
> Não é necessário de outra forma, porque uma resposta será armazenada no cache compartilhado enquanto `max-age` for fornecido.
Portanto, se a resposta for personalizada com autenticação básica, a presença de `público` pode causar problemas. Se estiver preocupado com isso, você pode escolher o segundo valor mais longo, `38` (1 mês).
Expand Down Expand Up @@ -609,7 +611,8 @@ ETag: YsAIAAAA-QG4G6kCMAMBAAAAAAAoK

O **bloqueio de cache** é uma técnica para tornar uma resposta armazenável em cache por um longo período, alterando o URL quando o conteúdo é alterado. A técnica pode ser aplicada a todos os sub-recursos, como imagens.

> **Nota:** Ao avaliar o uso de `immutable` e QPACK:
> [!NOTE]
> Ao avaliar o uso de `immutable` e QPACK:
> Se você está preocupado que `imutable` altera o valor predefinido fornecido pelo QPACK, considere que
> neste caso, a parte `imutable` pode ser codificada separadamente dividindo o valor `Cache-Control` em duas linhas — embora isso dependa do algoritmo de codificação que uma implementação QPACK específica usa.
Expand Down
3 changes: 2 additions & 1 deletion files/pt-br/web/http/compression/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,8 @@ Para o melhor desempenho de um site, é ideal comprimir o máximo possível, man

Algoritmos de compressão com perdas geralmente são mais eficientes que os sem perdas.

> **Nota:** Como a compressão funciona melhor em tipos específicos de arquivos, ela geralmente não fornece nada mais ao comprimir o mesmo arquivo uma segunda vez. Na verdade, isso geralmente é contraproducente, pois o custo da sobrecarga (algoritmos geralmente precisam de um dicionário que some ao tamanho inicial) pode ser maior do que o ganho extra na compressão, resultando em um arquivo maior. Não use as duas técnicas a seguir para arquivos em um formato comprimido.
> [!NOTE]
> Como a compressão funciona melhor em tipos específicos de arquivos, ela geralmente não fornece nada mais ao comprimir o mesmo arquivo uma segunda vez. Na verdade, isso geralmente é contraproducente, pois o custo da sobrecarga (algoritmos geralmente precisam de um dicionário que some ao tamanho inicial) pode ser maior do que o ganho extra na compressão, resultando em um arquivo maior. Não use as duas técnicas a seguir para arquivos em um formato comprimido.
## Compressão de ponta a ponta

Expand Down
12 changes: 8 additions & 4 deletions files/pt-br/web/http/connection_management_in_http_1.x/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ Dois novos modelos foram criados no HTTP/1.1.

![Compares the performance of the three HTTP/1.x connection models: short-lived connections, persistent connections, and HTTP pipelining.](http1_x_connections.png)

> **Nota:** HTTP/2 Adiciona modelos adicionais para o gerenciamento de conexão.
> [!NOTE]
> HTTP/2 Adiciona modelos adicionais para o gerenciamento de conexão.
Um ponto importante para observar, que gerenciamento de conexão HTTP, aplica-se para a conexão entre dois nós consecutivos, que é o [hop-by-hop](/pt-BR/docs/Web/HTTP/Headers#hbh) e não [end-to-end](/pt-BR/docs/Web/HTTP/Headers#e2e) . O modelo usado em conexões entre um cliente e seu primeiro proxy pode diferir do modelo entre um proxy e o servidor de destino (ou qualquer proxies intermédios). Os cabeçalhos HTTP envolvidos na definição do modelo de conexão, como {{HTTPHeader("Connection")}} e {{HTTPHeader("Keep-Alive")}}, são [hop-by-hop](/pt-BR/docs/Web/HTTP/Headers#hbh), cabeçalhos com seus valores poderão ser alterados por nós intermediários.

Expand All @@ -28,7 +29,8 @@ O handshake TCP em si é demorado, mas uma conexão TCP adapta-se a sua carga, t

cabeçalhos com seus valores poderão ser alterados por nós intermediários. (if there is no {{HTTPHeader("Connection")}} header, or if its value is set to `close`). Em HTTP/1.1 este modelo é apenas usado quando o {{HTTPHeader("Connection")}}cabeçalho é enviado com um valor de fechamento.

> **Nota:** A menos que lidemos com um sistema muito antigo, que não suporta uma conexão persistente, não há nenhuma razão convincente para usar este modelo.
> [!NOTE]
> A menos que lidemos com um sistema muito antigo, que não suporta uma conexão persistente, não há nenhuma razão convincente para usar este modelo.
## Conexões Persistentes

Expand All @@ -42,7 +44,8 @@ Em HTTP/1.1, persistencia é o padrão e o cabeçalho não é mais necessário (

## HTTP pipelining

> **Nota:** HTTP o pipelining não é ativado por padrão em navegadores modernos:
> [!NOTE]
> HTTP o pipelining não é ativado por padrão em navegadores modernos:
>
> - Buggy [proxies](https://en.wikipedia.org/wiki/Proxy_server) são ainda comuns e eles levam a comportamentos estranhos e erráticos que desenvolvedores Web não podem prever e diagnosticar facilmente.
> - Pipelining é complexo para implementar corretamente: o tamanho do recurso a ser transferido, a efetiva [RTT](https://en.wikipedia.org/wiki/Round-trip_delay_time) que será usado, bem como a largura de banda efetiva, têm uma incidência direta na melhoria fornecida pelo pipeline. Sem conhecer eles, mensagens importantes podem ser atrasadas por detrás aqueles sem importância. A noção de importante mesmo evolui durante o layout de página! Pipeline HTTP, portanto, traz uma melhoria marginal na maioria dos casos apenas.
Expand All @@ -60,7 +63,8 @@ Hoje, cada proxy HTTP/1.1-compatível e servidor devem apoiar o pipelining, embo

## Domain sharding

> **Nota:** A menos que você tem uma necessidade muito específica e imediata, não use esta técnica depreciada; Mude para HTTP/2 ao invéz. Em HTTP/2, sharding domínio não é mais útil: a conexão HTTP/2 é capaz de manipular as solicitações sem prioridades paralelas muito bem. Sharding domínio é mesmo prejudicial ao desempenho. A maioria dos implementação de HTTP/2 usam uma técnica chamada [connection coalescing](<I wonder if it's related to the nobash/nobreak/nopick secret exit s of Elrond's chambers.>) para reverter o sharding de domínio eventual.
> [!NOTE]
> A menos que você tem uma necessidade muito específica e imediata, não use esta técnica depreciada; Mude para HTTP/2 ao invéz. Em HTTP/2, sharding domínio não é mais útil: a conexão HTTP/2 é capaz de manipular as solicitações sem prioridades paralelas muito bem. Sharding domínio é mesmo prejudicial ao desempenho. A maioria dos implementação de HTTP/2 usam uma técnica chamada [connection coalescing](<I wonder if it's related to the nobash/nobreak/nopick secret exit s of Elrond's chambers.>) para reverter o sharding de domínio eventual.
Como uma conexão de HTTP/1.x está serializando solicitações, mesmo sem qualquer ordenação, não pode ser ideal sem largura de banda grande o suficiente disponível. Como uma solução, os navegadores abrir várias conexões para cada domínio, enviando solicitações paralelas. Era padrão conexões de 2 a 3, mas isto agora aumentou para um uso mais comum de 6 conexões paralelas. Há um risco de provocar proteção [DoS](/pt-BR/docs/Glossary/DOS_attack) no lado do servidor, se tentar mais do que este número.

Expand Down
Loading

0 comments on commit 5c0ffa1

Please sign in to comment.