diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown index dc50cac1..61ebf14c 100644 --- a/pt-br/markdown-pt.html.markdown +++ b/pt-br/markdown-pt.html.markdown @@ -6,6 +6,7 @@ translators: - ["Miguel Araújo", "https://github.com/miguelarauj1o"] - ["Gabriele Luz", "https://github.com/gabrieleluz"] - ["Monique Baptista", "https://github.com/bfmonique"] + - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"] lang: pt-br filename: learnmarkdown-pt.md @@ -20,22 +21,21 @@ puxar o projeto (pull request) ## Elementos HTML Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é um arquivo Markdown válido. + ```md - - - - +``` ## Cabeçalhos Você pode criar elementos HTML `

` até `

` facilmente antecedendo o texto -que deseja estar nesse elemento por um número de hashes (#) +que deseja estar nesse elemento por um número de hashes (#). +```md # Isto é um cabeçalho

## Isto é um cabeçalho

### Isto é um cabeçalho

@@ -44,7 +44,7 @@ que deseja estar nesse elemento por um número de hashes (#) ###### Isto é um cabeçalho

``` -Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2 +Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2. ```md Isto é um cabeçalho h1 @@ -55,6 +55,7 @@ Isto é um cabeçalho h2 ``` ## Estilos de texto simples + O texto pode ser facilmente denominado como marcação itálico, negrito ou tachado usando: ```md @@ -66,10 +67,10 @@ __E este também está._ ***Este texto está em negrito e itálico.*** **_E este também está_** -*--Danouse! Este também__* +*__Danou-se! Este também__* ``` -Em GitHub Flavored Markdown, que é usado para processar arquivos Markdown +No GitHub Flavored Markdown, que é usado para processar arquivos Markdown GitHub, nós também temos: ```md @@ -84,13 +85,14 @@ uma ou múltiplas linhas em branco. Este é um parágrafo. Eu estou digitando em um parágrafo, não é legal? Agora, eu estou no parágrafo 2. -... Ainda continuo no parágrafo 2! :) +Ainda continuo no parágrafo 2! -Eu estou no parágrafo três. + +Eu estou no parágrafo três! ``` Se você quiser inserir uma tag HTML `
`, você pode acabar com um parágrafo -com dois ou mais espaços e, em seguida, começar um novo parágrafo +com dois ou mais espaços e, em seguida, começar um novo parágrafo. ```md Termino com dois espaços (destacar-me para vê-los). @@ -98,7 +100,6 @@ Termino com dois espaços (destacar-me para vê-los). Há um
acima de mim! ``` - Bloco de citações são fáceis e feito com o caractere >. ```md @@ -106,14 +107,16 @@ Bloco de citações são fáceis e feito com o caractere >. > Quebrar manualmente suas linhas e colocar um `>` antes de cada linha ou você pode > deixar suas linhas ficarem muito longas e quebrarem por conta própria. Não faz diferença, > desde que eles começam com um `>`. - > Você também pode usar mais de um nível >> De recuo? +> O quão legal é isso? + ``` ## Listas -As listas não ordenadas podem ser feitas usando asteriscos, positivos ou hífens + +As listas não ordenadas podem ser feitas usando asteriscos, positivos ou hífens. ```md * Item @@ -141,8 +144,8 @@ Listas ordenadas são feitas com um número seguido por um ponto. 3. Item três ``` - +Você não tem poder para rotular os itens corretamente e a remarcação ainda deixará os +itens em ordem, mas isso pode não ser uma boa idéia. ```md @@ -150,9 +153,10 @@ itens em ordem, mas isso pode não ser uma boa idéia --> 1. Item dois 1. Item três ``` + (Isto é processado da mesma forma que o exemplo acima) -Você também pode usar sublistas +Você também pode usar sublistas. ```md 1. Item um @@ -163,61 +167,56 @@ Você também pode usar sublistas 4. Item quatro ``` -Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) de HTML +Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) de HTML. ```md -As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas -- [ ] Primeira tarefa a completar +As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas. +- [ ] Primeira tarefa a completar. - [ ] Segunda tarefa a completar -A caixa de seleção abaixo será exibida como uma checkbox HTML marcada +A caixa de seleção abaixo será exibida como uma checkbox HTML marcada. - [x] Essa tarefa foi completa - ``` - ## Blocos de código + Você pode indicar um bloco de código (que utiliza o elemento ``) pelo recuo -uma linha com quatro espaços ou uma guia +uma linha com quatro espaços ou uma guia. + ```md - Isto é código - É assim, sacou? - + Isto é código + É assim, sacou? ``` Você pode também re-guia (ou adicionar mais quatro espaços adicionais) para o recuo -dentro do seu código +dentro do seu código. ```md - my_array.each do |item| + my_array.each do |item| puts item end - ``` +``` Código embutido pode ser criada usando o caractere de crase `` ` `` ```md -John não sabia nem o que o função `goto()` fazia! +John não sabia nem o que o função `go_to()` fazia! ``` -Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código -```md - ``` ruby - def foobar - puts "Hello world!" - end - ``` -``` -======= -\`\`\`ruby +No GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código. + +
+```ruby
 def foobar
-    puts "Hello world!"
+    puts "Olá mundo!"
 end
-\`\`\` 
+```
-O texto acima não requer recuo, além disso o GitHub vai usar a sintaxe highlight da linguagem que você especificar após a \`\`\`. + +O texto acima não requer recuo, além disso o GitHub vai usar a sintaxe +highlight da linguagem que você especificar após ```. ## Linha Horizontal + Linhas horizontais são facilmente adicionados com três ou mais asteriscos ou hífens, com ou sem espaços. @@ -229,6 +228,7 @@ com ou sem espaços. ``` ## Links + Uma das melhores coisas sobre a marcação é o quão fácil é fazer ligações. Colocar o texto a ser exibido entre parênteses rígidos [] seguido pela url em parênteses () @@ -248,31 +248,29 @@ Caminhos relativos funcionam também. [Ir para música](/música/). ``` -Markdown também suporta ligações de estilo de referência +Markdown também suporta ligações de estilo de referência. -```md -[Clique neste link] [link1] para mais informações sobre isso! -[Além disso, verifique este link] [foobar] se você quiser. +
[Clique nesse link][link1] para mais informações!
+[Também cheque esse link][foobar] se você quiser.
 
-[link1]: http://test.com/ "Legal!"
-[foobar]: http://foobar.biz/ "OK!"
-```
+[link1]: http://test.com/ "Legal!"
+[link2r]: http://foobar.biz/ "Certo!"
O título também pode estar entre aspas simples ou entre parênteses, ou omitido inteiramente. As referências podem estar em qualquer lugar no documento e os IDs de referência pode ser qualquer um, desde que eles são únicos. -Existe também a "nomeação implicita", que permite que você use o texto do link como o id +Existe também a "nomeação implicita", que permite que você use o texto do link como o id: -```md -[Este] [] é um link. +
[Isso][] é um link.
 
-[este]: http://thisisalink.com/ 
-```
+[Isso]: http://thisisalink.com/
-Mas não são usados normalmente + +Mas não são usados normalmente. ## Imagens + As imagens são feitas da mesma forma que as ligações, mas com um ponto de exclamação na frente! ```md @@ -281,13 +279,12 @@ As imagens são feitas da mesma forma que as ligações, mas com um ponto de exc E estilo de referência funciona como esperado -```md -![Este é o pairar-texto.][Myimage] +
![Esse é o alt-attribute.][myimage]
 
-[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui" 
-```
+[Minha imagem]: relative/urls/cool/image.jpg "se precisar de um título, está aqui"
## Miscelânea + ### Auto-links ```md @@ -307,10 +304,11 @@ Quero digitar * Este texto entre asteriscos *, mas eu não quero que ele seja em itálico, então eu faço o seguinte: \*Este texto entre asteriscos \*. ### Tabelas + Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente complicadas, mas se você realmente quer: -```md +```md | Col1 | Col2 | Col3 | | :----------- | :------: | ------------: | | esquerda-alin| Centrado | direita-alinh |