New translation: remark-plugin-tutorial.md #271
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
ernestoresende
requested review from
henriquepw,
iaurg,
jessescn and
thayannevls
as code owners
ernestoresende
changed the title
henriquepw
suggested changes
Jul 24, 2020
|
|
||
| In certain instances, a developer may want to customize the content of the Markdown file and extend it functionally in useful ways; for example, use cases such as [adding syntax highlighting](/packages/gatsby-remark-prismjs/), [parsing and creating responsive images](/packages/gatsby-remark-images), [embedding videos](/packages/gatsby-remark-embed-video), and many others. In each of these examples, a plugin will be injected with the Markdown Abstract Syntax Tree (AST) and manipulate content based on certain node types or content in particular nodes. | ||
| Em certas instâncias, o desenvolvedor pode querer customizar o conteúdo de um arquivo Markdown e extender sua funcionalidade de algumas maneiras úteis; por exemplo, em casos como a adição de [realce da sintaxe em trechos de código](/packages/gatsby-remark-prismjs/), [interpretação e criação de imagens responsivas](/packages/gatsby-remark-images), [inserção de vídeos](/packages/gatsby-remark-embed-video), e muitos outros. Em cada um destes exemplos, um plugin será injetado através da Árvore de Sintaxe Abstrata do Markdown (na sigla em inglês, AST) e manipular conteúdo baseado em certos tipos de nó ou conteúdos de um nó em particular. |
There was a problem hiding this comment.
Suggested change
| Em certas instâncias, o desenvolvedor pode querer customizar o conteúdo de um arquivo Markdown e extender sua funcionalidade de algumas maneiras úteis; por exemplo, em casos como a adição de [realce da sintaxe em trechos de código](/packages/gatsby-remark-prismjs/), [interpretação e criação de imagens responsivas](/packages/gatsby-remark-images), [inserção de vídeos](/packages/gatsby-remark-embed-video), e muitos outros. Em cada um destes exemplos, um plugin será injetado através da Árvore de Sintaxe Abstrata do Markdown (na sigla em inglês, AST) e manipular conteúdo baseado em certos tipos de nó ou conteúdos de um nó em particular. | |
| Em certas instâncias, o desenvolvedor pode querer customizar o conteúdo de um arquivo Markdown e estender sua funcionalidade de algumas maneiras úteis; por exemplo, em casos como a adição de [realce da sintaxe em trechos de código](/packages/gatsby-remark-prismjs/), [interpretação e criação de imagens responsivas](/packages/gatsby-remark-images), [inserção de vídeos](/packages/gatsby-remark-embed-video), e muitos outros. Em cada um destes exemplos, um plugin será injetado através da Árvore de Sintaxe Abstrata do Markdown (na sigla em inglês, AST) e manipular conteúdo baseado em certos tipos de nó ou conteúdos de um nó em particular. |
docs/docs/remark-plugin-tutorial.md
Outdated
| @@ -1,37 +1,37 @@ | |||
| --- | |||
| title: Remark Plugin Tutorial | |||
| title: Tutorial de Plugins para o Remark | |||
There was a problem hiding this comment.
Suggested change
| title: Tutorial de Plugins para o Remark | |
| title: Tutorial do Plugin Remark |
ou
Suggested change
| title: Tutorial de Plugins para o Remark | |
| title: Usando o Plugin Remark |
There was a problem hiding this comment.
Fiz as alterações requisitadas nos comentários de código.
Como mencionado acima, o documento trata da criação de sub-plugins para o plugin Remark, e não um tutorial sobre o uso do plugin Remark em si. Optei por alterar o título para "Criando sub-plugins do Remark". O que acha?
thayannevls
suggested changes
Aug 16, 2020
Co-authored-by: Thayanne Luiza <[email protected]>
Co-authored-by: Thayanne Luiza <[email protected]>
Co-authored-by: Thayanne Luiza <[email protected]>
thayannevls
approved these changes
Aug 19, 2020
henriquepw
approved these changes
Aug 20, 2020
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Qual o objetivo dessa pull request?
Qual arquivo foi traduzido/corrigido?
https://github.com/gatsbyjs/gatsby-pt-BR/blob/master/docs/docs/remark-plugin-tutorial.md
Algum comentário em relação a tradução?
Há certa ambiguidade na tradução do título 'Remark Plugin Tutorial' → 'Tutorial do Plugin Remark', já que o tutorial não refere-se ao plugin Remark em si, e sim à produção de sub-plugins para o mesmo. Traduzi para 'Tutorial de Plugins para o Remark'. Sintam-se livres para sugerir mudanças.
É citada com frequência a Markdown Abstract Syntax Tree. Optei por traduzir o termo para Árvore de Sintaxe Abstrata do Markdown e mencioná-lo nos parágrafos seguintes por sua sigla em inglês (AST), obedecendo o fluxo do documento original. Sintam-se livres para sugerir mudanças.
Em todas as ocorrências no documento o termo node foi traduzido para o termo nó, como sugerido por outro registro do glossário, 'DOM Node'.
Trechos de código foram mantidos em seus formatos originais.