Initial commit. In a broken state, do not use.

content/locales/ar_EG/lessons/markdown/converter-textos-markdown-28-11-2017.md

@@ -0,0 +1,19 @@
+# Introdução ao Markdown
+
+## Convertendo Textos
+
+Depois de aprender alguns símbolos que permitem formatar textos com o Markdown, agora será mostrado como converter esses textos para outros formatos. Para converter, utilizaremos um programa chamado Pandoc. Este programa aceita vários formatos, tanto de entrada (arquivo original que deseja converter), quanto de saída (arquivo que será gerado a partir do arquivo original). Abaixo serão listados os principais formatos suportados: Formatos de entrada: Markdown, TXT, HTML, EPUB, DOC e DOCX (formato de arquivos do Word a partir da versão 2007). Formatos de saída: Markdown, TXT, HTML, RTF, EPUB, DOC e DOCX.
+
+## Convertendo o Arquivo
+
+Vamos converter o arquivo já criado para outros formatos. Para isso, abra o terminal, mude para o diretório onde está o arquivo e digite o seguinte comando: *pandoc -o Testando Markdown.doc Testando Markdown.txt* Esse comando está escrito da seguinte forma: Primeiro vem o nome do programa, o Pandoc. Em seguida, vem o parâmetro "-o", que representa o arquivo de saída (output em inglês). Depois do parâmetro vem o nome e o formato do arquivo a ser gerado, e em seguida, o nome e extenção do arquivo original. "Pandoc, o arquivo de saída (representado pelo parâmetro -o) será Testando Markdown.doc, e o arquivo a ser convertido é Testando Markdown.txt". Esse é o comando para converter qualquer formato que desejar. Observação: Os arquivos formatados com Markdown geralmente possuem a extenção (.md), mas também podem ser escritos em arquivos de texto simples (.txt).
+
+### Exercícios
+
+1. Abra o terminal, vá até o diretório onde salvou o arquivo das aulas anteriores e o converta para o próprio formato do markdown.
+
+2. Converta o mesmo arquivo para formatos do Word (DOC e DOCX).
+
+3. Tente fazer o inverso, converta os arquivos gerados novamente para Markdown (experimente mudar o nome do arquivo a ser gerado para não perder o original).
+
+4. Converta para outros formatos disponíveis e veja o resultado.

content/locales/ar_EG/lessons/markdown/enfase-de-textos-em-markdown-26-11-2017.md

@@ -0,0 +1,29 @@
+# Introdução ao Markdown
+
+## Ênfase de Textos
+
+Em certos momentos, destacar uma determinada frase ou palavra no texto é conveniente, principalmente para reforçar o sentido daquele trecho. Para isso, existem duas formas: Itálico e negrito. A principal diferença entre eles é que o itálico deixa as letras mais deitadas, enquanto o negrito deixa mais forte a cor das letras destacadas.
+
+## Escrevendo em Itálico
+
+Para escrever uma palavra ou frase em itálico, basta colocar um "*" (asterisco) no começo e outro no fim da mesma. Exemplo: *Esta frase está em itálico.*
+
+## Escrevendo em Negrito
+
+O negrito é muito semelhante. Mas em vez de um, são dois asteriscos no início e dois no fim. Exemplo: **Esta frase está em negrito.**
+
+## Itálico e Negrito
+
+Também é possível deixar um texto em itálico e negrito simultaneamente. Para isso, basta utilizar três asteriscos no início e no fim do texto. Exemplo: ***Esse texto está em itálico e negrito.***
+
+### Exercícios
+
+1. Abra o mesmo arquivo de testes em markdown para editá-lo.
+
+2. Escreva palavras e frases em itálico.
+
+3. Escreva palavras e frases em negrito.
+
+4. Formate textos com itálico e negrito simultaneamente.
+
+5. Salve e feche o arquivo.

content/locales/ar_EG/lessons/markdown/introducao-ao-markdown-26-11-2017.md

@@ -0,0 +1,25 @@
+# Introdução ao Markdown
+
+O Markdown é uma simples linguagem de marcação. Com poucos e simples caracteres, é possível formatar seu texto em um simples editor, adicionar títulos, subtítulos, links, listas, etc., e depois converter para vários outros formatos. Para converter esses textos, utilizaremos o programa Pandoc, que permite conversões entre vários formatos diferentes.
+
+Começaremos com simples exemplos de formatação com Markdown. Depois, será ensinado como realizar a conversão.
+
+## Parágrafos
+
+Um parágrafo é uma linha de texto comum, não exige nenhum caractere especial. Basta dar alguns espaços antes de começar a escrever na linha para indicar que é um parágrafo.
+
+## Títulos e Subtítulos
+
+Os títulos são marcados com um "#" (cardinal ou jogo-da-velha) no início da sua linha. Os títulos vão do nível 1 a 6. O título de nível 1 é o que possui letras maiores, e quanto maior o nível, menor o título. Ou seja, os demais podem ser considerados subtítulos. Ou, supondo que tenhamos um título de nível 3 e outro de nível 4, o de nível 4 é um subtítulo em relação ao de nível 3. O nível do título é definido pela quantidade de "#" antes dele. Ou seja, se tivermos: *# Este Exemplo* é de nível 1, *## O Segundo Exemplo* é de nível 2, e assim sucessivamente.
+
+Antes de avançarmos, vale uma observação importante apartir de agora. Como já foi possível notar, o Markdown usa caracteres bastante comuns para formatar o texto. E se você quiser usar algum deles, como um "#", mas sem querer indicar um título? Para isso, usamos o caractere "\" (barra invertida) antes do caractere que deseja usar. Assim, ele assume o sentido literal e não é interpretado pelo Markdown. Se quiser usar a própria barra invertida, basta digitá-la duas vezes.
+
+### Exercícios
+
+1. Abra seu editor de textos favorito, crie um arquivo chamado "Testando Markdown.txt", por exemplo, e comece a escrever um texto com os primeiros caracteres de formatação ensinados.
+
+2. Escreva títulos e subtítulos.
+
+3. Escreva o símbolo "#" antes de algum texto, mas faça com que não seja interpretado como caractere de formatação.
+
+4. Salve o arquivo criado.

content/locales/ar_EG/lessons/markdown/links-e-imagens-em-markdown-27-11-2017.md

@@ -0,0 +1,29 @@
+# Introdução ao Markdown
+
+## Incerindo Links e Imagens
+
+Ao escrever um texto, você pode precisar incerir um link de algum site ou imagem disponível na Internet. O Markdown também possui caracteres especiais para esses casos. Quanto aos links, existem os internos, que referenciam para outros trechos do próprio documento, e os externos, que referenciam para outros sites.
+
+## Links Internos
+
+Para referenciar um trecho do próprio documento, como um link que leve de volta ao início do texto, por exemplo, faça o seguinte. Primeiro, escreva o texto que vai referenciar o link de referência. Logo em seguida, coloque o nome do link entre colchetes. Na linha seguinte, escreva novamente o nome que deu ao link entre colchetes e, logo depois, coloque o símbolo de "#" e o identificador do trecho onde deseja referenciar. Exemplo: Voltar ao [Início](#inicio).
+
+## Links Externos
+
+Para incerir o link de um site e algum texto que o descreva, siga os seguintes passos: Primeiro, coloque o texto descritivo do link entre colchetes. Logo em seguida, na mesma linha, o endereço do link deve estar entre parênteses. Exemplo: *[F123](http://f123.org)*
+
+## Imagens
+
+Incerir imagens é bem semelhante, a única diferença é que deve ser incerido um ponto de exclamação "!" antes de abrir o colchete. *![Foto de um computador pequeno](http://f123.org/wp-content/uploads/2017/07/F123-Talking-Computer-2.jpg)*
+
+### Exercícios
+
+1. Abra o arquivo "Testando Markdown.txt" e vá para o fim do mesmo.
+
+2. Incira uma referência para outro trecho do documento.
+
+3. Incira um link de algum site de sua preferência e coloque um texto descritivo.
+
+4. Faça o mesmo com uma imagem.
+
+5. Salve e feche o arquivo.

content/locales/ar_EG/lessons/markdown/listas-em-markdown-27-11-2017.md

@@ -0,0 +1,44 @@
+# Introdução ao Markdown
+
+## Listas
+
+As listas são bastante convenientes. Listar tópicos, enumerar uma sequência determinada de instruções, tudo isso é possível com listas. Existem dois tipos de listas: Listas com Marcadores (ou simplesmente listas não ordenadas) e listas ordenadas. Vamos diferenciar ambas e descobrir como fazer?
+
+## Listas Não Ordenadas
+
+Essas listas são bastante convenientes quando necessitamos listar tópicos, mas que não necessariamente sigam alguma ordem específica. Possuem apenas marcadores, mas não são ordenadas. O Markdown possui três caracteres diferentes para formatar essas listas, são equivalentes. Os caracteres são: "*" (asterisco), "+" (mais) e "-" (menos). Veja os exemplos:
+
+Lista com asteriscos:
+
+- Primeiro tópico.
+- Segundo tópico.
+
+Lista com sinal de mais
+
+- Primeiro tópico.
+- Segundo tópico.
+
+Lista com sinal de menos
+
+- Primeiro tópico.
+- Segundo tópico.
+
+## Listas Ordenadas
+
+As listas ordenadas são bastante úteis quando há a necessidade de ordenar os tópicos, como o passo a passo de uma receita, por exemplo, que precisa seguir uma sequência para dar certo. Para formatar esse tipo de lista, utilize o símbolo "@" (arroba) seguido de um ponto. A lista será ordenada automaticamente.
+
+Exemplo: @. Primeiro tópico. @. Segundo tópico.
+
+### Exercícios
+
+1. Abra o arquivo "Testando Markdown.txt" e vá para o final.
+
+2. Escreva uma lista com marcadores usando asterisco.
+
+3. Escreva uma lista com marcadores usando mais.
+
+4. Escreva uma lista com marcadores usando menos.
+
+5. Escreva uma lista ordenada.
+
+6. Salve e feche o arquivo.

content/locales/ar_EG/lessons/markdown/notas-de-rodape-08-12-2017.md

@@ -0,0 +1,13 @@
+# Introdução ao Markdown
+
+## Notas de Rodapé
+
+Uma nota de rodapé é bastante útil para referenciar um site, link ou detalhes a respeito de determinado assunto. A nota é composta por dois elementos: Uma marcação no texto que fará referência a essa nota, e uma definição da nota que aparecerá no fim do documento. Veja o exemplo: *Leia sobre isso no livro. [^1]*
+
+Ou seja, o "1" na primeira linha está referenciando os detalhes que estão na segunda. Note que o "1" é apenas uma referência para marcar a nota, poderia escrever qualquer outro número, a ordem nesse caso não importa. As notas serão ordenadas à medida que forem referenciadas no texto.
+
+### Exercícios
+
+1. Abra o arquivo de testes do markdown.
+
+2. Incira notas de rodapé espalhadas pelo texto. Não se importe com a ordem dos números.