Skip to content

Commit

Permalink
Merge pull request #211 from urrameu/main
Browse files Browse the repository at this point in the history
Many small fixes to the PT translation
  • Loading branch information
josephwright authored Nov 8, 2023
2 parents 9d713a3 + 8b4e9f2 commit 78cd8e4
Show file tree
Hide file tree
Showing 32 changed files with 372 additions and 388 deletions.
16 changes: 4 additions & 12 deletions pt/extra-01.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
layout: "lesson"
lang: "pt"
title: "Mostruário LaTeX - Exemplos para estudo adicional"
title: "Galeria LaTeX - Exemplos para estudo adicional"
description: "Esta lição mostra exemplos diversos de outros pacotes populares que não foram apresentados nas lições principais."
toc-anchor-text: "Mostruário LaTeX"
toc-anchor-text: "Galeria LaTeX"
toc-description: "Exemplos para estudo adicional."
---

# Mostruário
# Galeria

<span
class="summary">Esta lição mostra exemplos diversos de outros pacotes
Expand All @@ -18,7 +18,7 @@ pacotes fundamentais. O LaTeX conta com uma vasta biblioteca de pacotes de
extensão e é usado em muitas áreas. Aqui daremos alguns exemplos, sem qualquer
explicação mas com links para a documentação dos respectivos pacotes no
[texdoc.org](https://texdoc.org).
Os exemplos foram retirados da documentação dos pacotes exceto onde dito o
Os exemplos foram retirados da documentação dos pacotes exceto quando dito o
contrário.

<p
Expand Down Expand Up @@ -46,34 +46,26 @@ Pacote: [`xskak`](https://texdoc.org/pkg/xskak)

{% include extra-01-example-xskak.md %}


## Poesia

Classe: [`memoir`](https://texdoc.org/pkg/memoir)

{% include extra-01-example-memoir.md %}


## Desenho
<!-- not 2017 -->
Pacote: [`tikz`](https://texdoc.org/pkg/tikz)


{% include extra-01-example-tikz.md %}


## Plotagem de funções

Pacote: [`pgfplots`](https://texdoc.org/pkg/pgfplots)


{% include extra-01-example-pgfplots.md %}


## Música

Pacote: [`musixtex`](https://texdoc.org/pkg/musixtex)



{% include extra-01-example-musixtex.md %}
34 changes: 17 additions & 17 deletions pt/language-01.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,28 @@
---
layout: "lesson"
lang: "pt"
title: "Lição específica para a língua Portuguesa"
description: "Esta lição mostra detalhes específicos de linguagem para escrever textos em Português. O foco é na hifenização e nos textos localizados."
title: "Lição específica para a língua portuguesa"
description: "Esta lição mostra detalhes específicos de linguagem para escrever textos em português. O foco é na hifenização e nos textos localizados."
next: "extra-01"
toc-anchor-text: "LaTeX na Língua Portuguesa"
toc-description: "Lição específica para a língua Portuguesa."
toc-anchor-text: "LaTeX na língua portuguesa"
toc-description: "Lição específica para a língua portuguesa."
---

# Especificidades para usar o LaTeX em textos em Português
# Especificidades para usar o LaTeX em textos em português

<span
class="summary">Esta lição mostra detalhes específicos para escrever textos
em português usando o LaTeX, com foco nos padrões de hifenização e nos textos
localizados.</span>

Como a língua Portuguesa usa o alfabeto Latino, assim como a língua Inglesa, o
LaTeX funciona quase corretamente com a língua Portuguesa por padrão; há poucos
Como a língua portuguesa usa o alfabeto latino, assim como a língua inglesa, o
LaTeX funciona quase corretamente com a língua portuguesa por padrão; há poucos
ajustes a fazer. As únicas coisas que devem ser mudadas para escrever em
Português no LaTeX são os padrões de hifenização e os textos localizados (por
português no LaTeX são os padrões de hifenização e os textos localizados (por
exemplo a palavra 'Capítulo', que por padrão aparece 'Chapter').

O pacote `babel` fornece duas variantes da língua Portuguesa: Português Europeu
e Brasileiro, que podem ser carregados com as opções `portuguese` e `brazilian`,
O pacote `babel` fornece duas variantes da língua portuguesa: português europeu
e brasileiro, que podem ser carregados com as opções `portuguese` e `brazilian`,
respectivamente:

```latex
Expand All @@ -34,20 +34,20 @@ respectivamente:
\end{document}
```

Ambas as opções carregam os padrões de hifenização da língua Portuguesa, e
Ambas as opções carregam os padrões de hifenização da língua portuguesa, e
modificam os textos localizados de acordo (há pequenas diferenças nesses textos
entre as duas versões do idioma: por exemplo com `brazilian` o comando
`\tableofcontents` cria um "Sumário", enquanto que com `portuguese` o título
do caopitulo fica "Conteúdo").

É importante utilizar o idioma correto no pacote `babel` para ter os padrões de
hifenização corretos carregados. O exemplo a seguir mostra o mesmo texto
escrito utilizando o padrão de hifenização da Língua Portuguesa, e abaixo, o
padrão do Inglês. Veja como no PDF (quando compilado com o `pdflatex`) a
palavra "gravadas" é hifenizada corretamente como "gra-vadas" em Português, mas
não é possível hifenizar em Inglês. Outro exemplo é a palavra "conhecidas", que
é hifenizada em Inglês como "con-hecidas", que é uma divisão silábica incorreta
em Português.
escrito utilizando o padrão de hifenização da língua portuguesa, e abaixo, o
padrão do inglês. Veja como no PDF (quando compilado com o `pdflatex`) a
palavra "gravadas" é hifenizada corretamente como "gra-vadas" em português, mas
não é possível hifenizar em inglês. Outro exemplo é a palavra "conhecidas", que
é hifenizada em inglês como "con-hecidas", que é uma divisão silábica incorreta
em português.

```latex
\documentclass{article}
Expand Down
4 changes: 2 additions & 2 deletions pt/lesson-01.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,12 +41,12 @@ Pessoas usam nomes diferentes para descrever esse processo. Como usar o LaTeX

Para arquivos simples, você só precisa executar o LaTeX uma vez no seu arquivo
para ter o PDF completo. Mas conforme você adicionar coisas mais complicadas,
como referências cruzadas, citações, figuras, e sumários, você precisará
como referências cruzadas, citações, figuras e sumários, você precisará
executar o LaTeX mais de uma vez. Vamos lhe dizer quando for o caso.

## LaTeX ou pdfLaTeX ou ...

Na [próxima lição](lesson-02), nós vamos ver que o LaTeX não é um único
programa. Para simplificar as coisas, nós vamos focar em uma versão em
particular, o pdfLaTeX, para criar os seus PDFs. Nós também vamos ver outros
programas, e porque você usaria eles, mais adiante no curso.
programas, e por que você os usaria, mais adiante no curso.
19 changes: 9 additions & 10 deletions pt/lesson-02.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: "lesson"
lang: "pt"
title: "Trabalhando com LaTeX"
description: "Esta lição explica o que é um sistema TeX e quais os mais comuns, lista alguns dos editores de texto comumente utilizados para LaTeX, e os sistemas online que contam também com editores integrados."
description: "Esta lição explica o que é um sistema TeX e quais os mais comuns, lista alguns dos editores de texto comumente utilizados para LaTeX e os sistemas online que contam também com editores integrados."
toc-anchor-text: "Trabalhando com LaTeX"
toc-description: "Sistemas TeX e editores de texto."
---
Expand All @@ -11,7 +11,7 @@ toc-description: "Sistemas TeX e editores de texto."

<span
class="summary">Esta lição explica o que é um sistema TeX e quais os mais
comuns, lista alguns dos editores de texto comumente utilizados para LaTeX,
comuns, lista alguns dos editores de texto comumente utilizados para LaTeX
e os sistemas online que contam também com editores integrados.</span>

Diferente de muitos programas de computador, o LaTeX não é uma única aplicação
Expand Down Expand Up @@ -46,17 +46,16 @@ sistema instalar, você escolha o TeX Live.
Arquivos LaTeX são arquivos de texto simples, então podem ser editados com
qualquer editor de texto. No entanto, é conveniente ter um editor projetado
para trabalhar com o LaTeX, pois eles têm funcionalidades como compilação em
um clique dos seus arquivos, visualizadores de PDF embutidos, e realce de
um clique dos seus arquivos, visualizadores de PDF embutidos e realce de
sintaxe. Uma funcionalidade muito útil em todos os editores modernos de LaTeX
é o SyncTeX: a habilidade de clicar no seu código fonte e ir direto para aquele
local exato no PDF, e vice-versa.
local exato no PDF e vice-versa.

Há muito mais editores de LaTeX do que podemos listar aqui: há uma [lista
compreensiva no StackExchange]
(https://tex.stackexchange.com/questions/339/latex-editors-ides).
abrangente no StackExchange](https://tex.stackexchange.com/questions/339/latex-editors-ides).
Um editor básico, [TeXworks](https://tug.org/texworks), é distribuído no
TeX Live e no MiKTeX, tanto para Windows como para Linux, e o
[TeXShop](https://pages.uoregon.edu/koch/texshop/) é istribuído com o MacTeX.
[TeXShop](https://pages.uoregon.edu/koch/texshop/) é distribuído com o MacTeX.

<p
class="hint">
Expand All @@ -68,16 +67,16 @@ TeX Live e no MiKTeX, tanto para Windows como para Linux, e o

Há vários sites poderosos, que lhe permitem não ter um sistema TeX
ou editor instalados no seu computador. Esses websites lhe permitem editar seus
arquivos em uma página no navegador, e executam o LaTeX nos bastidores, e
arquivos em uma página no navegador, executam o LaTeX nos bastidores e
mostram o arquivo PDF produzido.

Alguns desses sites combinam o LaTeX com funcionalidades similares a um
processador de texto, enquanto que outros são mais focados em deixar você ver
o arquivo LaTeX fonte, assim fornecem uma experiência mais parecida com ter um
sistema TeX local.

Há sistemas que permitem que você execute o LaTeX sem precisar registar, e nós
usamos um desses, o [TeXLive.net](https://texlive.net), que permite que você
Há sistemas que permitem que você execute o LaTeX sem precisar se registrar, e
nós usamos um desses, o [TeXLive.net](https://texlive.net), que permite que você
edite e teste os exemplos que fornecemos. Para trabalhos mais completos, os
melhores sistemas online requerem que você registre-se antes de usá-los. Isso
lhe permite salvar seu trabalho, mas também ajuda que os sites não fiquem
Expand Down
6 changes: 3 additions & 3 deletions pt/lesson-03.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
layout: "lesson"
lang: "pt"
title: "Estrutura básica de um documento LaTeX"
description: "Esta lição mostra a estrutura básica de um documento LaTeX, e como produzir um PDF com ele, assim como os principais caracteres especiais usados para controlar o LaTeX."
description: "Esta lição mostra a estrutura básica de um documento LaTeX e como produzir um PDF com ele, assim como os principais caracteres especiais usados para controlar o LaTeX."
toc-anchor-text: "Estrutura do documento"
toc-description: "A estrutura básica de um documento."
---

# Estrutura de um documento LaTeX

<span
class="summary">Esta lição mostra a estrutura básica de um documento LaTeX,
class="summary">Esta lição mostra a estrutura básica de um documento LaTeX
e como produzir um PDF com ele, assim como os principais caracteres especiais
usados para controlar o LaTeX.</span>

Expand All @@ -19,7 +19,7 @@ documento se parece e como processá-lo com sucesso. Também é a sua primeira
chance de ver [como usar os exemplos](help) aqui no `learnlatex.org`.

Se você está usando uma instalação local de LaTeX, no seu editor crie um arquivo
chamado `first.tex`, e copie-e-cole o texto abaixo, ou digite-o.
chamado `first.tex` e copie-e-cole o texto abaixo, ou digite-o.

Se você está usando um sistema online, você pode apenas clicar no botão 'LaTeX
Online' ou 'Abrir no Overleaf' no exemplo para experimentá-lo!
Expand Down
10 changes: 5 additions & 5 deletions pt/lesson-04.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: "lesson"
lang: "pt"
title: "Estrutura Lógica"
description: "Esta lição mostra alguns comandos básicos de formatação, e compara-os com formatação semântica usando comandos de secionamento e listas."
description: "Esta lição mostra alguns comandos básicos de formatação e compara-os com formatação semântica usando comandos de secionamento e listas."
toc-anchor-text: "Estrutura Lógica"
toc-description: "Estrutura e representação visual."
---
Expand Down Expand Up @@ -37,7 +37,7 @@ Texto em \textit{itálico e com \textit{itálico} aninhado}.

Você pode provavelmente adivinhar que `\textit` é um comand para fazer texto em
itálico, mas ele _sempre_ deixa coisas em itálico, então não funciona com mais
níveis de texto aninhado. Veja como `\emph` sabe quando está aninado.
níveis de texto aninhado. Veja como `\emph` sabe quando está aninhado.
Também há ocasiões em que ênfase não é o mesmo que itálico; por exemplo, em
apresentações, cores são geralmente uma opção melhor. Com marcação lógica, não
temos que nos preocupar com os detalhes no corpo do documento.
Expand All @@ -53,7 +53,7 @@ maioria das pessoas escreve o título e então simplesmente aumenta o tamanho da
fonte e deixa o texto negrito, seguido por uma quebra de linha. No LaTeX, usar
marcação é _mais fácil_ que fazer a formatação manualmente; podemos usar o
comando `\section`, que cuida da numeração, mudança de fonte, espaçamento
vertical, etc., e mantém o resultado uniforme ao longo do documento.
vertical etc. e mantém o resultado uniforme ao longo do documento.

```latex
\documentclass{article}
Expand Down Expand Up @@ -96,7 +96,7 @@ Ainda podemos ir além: o próximo 'abaixo' é `\paragraph`, mas quase sempre
'detalhe demais' em seções. (Sim, `\paragraph` é um comando de secionamento, e
_não_ uma forma de iniciar um novo parágrafo!)

Você pode se pergutar sobre o título de um documento. Há vários comandos
Você pode se perguntar sobre o título de um documento. Há vários comandos
especiais para isso, mas nem todos os documentos os usam, então abordamos isso
na [lição extra paralela a esta](more-04).

Expand Down Expand Up @@ -138,7 +138,7 @@ comandos `\chapter`. Como eles parecem? Tente `\paragraph` e (até mesmo)
`\subparagraph` para ver como eles funcionam: por padrão eles _não_ adicionam
números.

Faça algumas listas, e insira uma lista dentro da outra. Como o formato dos
Faça algumas listas e insira uma lista dentro da outra. Como o formato dos
números ou marcadores muda? Você pode ter apenas quatro níveis de listas por
pardão no LaTeX, mas mais que quatro níveis nesse caso tende a ser um mau sinal
de qualquer forma!
16 changes: 8 additions & 8 deletions pt/lesson-05.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,25 +82,25 @@ de linhas [adiante](lesson-11). Também veja como a classe `letter` cria um
novo ambiente para cada carta, e tem comandos especializados.

As classes padrão `article`, `report` e `book` têm opções `10pt`, `11pt` e
`12pt` para mudar o tamanho da fonte, e `twocolumn` para fazer um documento com
`12pt` para mudar o tamanho da fonte e `twocolumn` para fazer um documento com
duas colunas.

## Classes ricas em funções

As classes padrão são muito estáveis, mas isso significa que também são bem
conservativas quanto à aparência e à gama de comandos disponíveis. Ao longo do
conservadoras quanto à aparência e à gama de comandos disponíveis. Ao longo do
tempo, algumas classes poderosas foram escritas, que lhe permitem alterar o
design tem ter que fazer coisas manualmente (que nós abordaremos
design sem ter que fazer coisas manualmente (que nós abordaremos
[adiante](lesson-11)).

A _American Mathematical Society_ fornece variantes das classes padrão (`amsart`
e `amsbook`) com um design mais tradicional, mais próximo do que é usado em
artigos científicos de matemática.

As duas maiores e mais populares classes 'estendidas' são a coleção KOMA-Script
e a classe memoir. KOMA-Script oferece um conjunto de classes que são
'paralelos' às classes padrão: `scrartcl`, `scrreprt`, `scrbook`, e `scrlttr2`,
enquanto há apenas uma classe `memoir` que é como uma extensão de `book`.
e a classe memoir. KOMA-Script oferece um conjunto de classes que refletem as
classes padrão: `scrartcl`, `scrreprt`, `scrbook` e `scrlttr2`; já `memoir` é
apenas uma classe, essencialmente uma extensão de `book`.

Essas classes estendidas têm muitos pontos de personalização, que vamos explorar
um pouco em um exercício. Você pode se perguntar como sabemos quais são esses
Expand All @@ -117,8 +117,8 @@ comparadas a documentos gerais no LaTeX, então as abordamos na lição de

## Exercícios

Explore como mudar a classe de document entre as padrão, as da coleção
KOMA-Script, e `memoir` afeta a aparência do documento.
Explore como mudar a classe de documento entre as padrão, as da coleção
KOMA-Script e `memoir` afeta a aparência do documento.

```latex
\documentclass{article} % Mude a classe aqui
Expand Down
18 changes: 9 additions & 9 deletions pt/lesson-06.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: "lesson"
lang: "pt"
title: "Estendendo o LaTeX usando pacotes e definições"
description: "Esta lição mostra como você pode estender o LaTeX de acordo com a sua necessidade e mudar a aparência do document usando diferentes pacotes, e mostra como você pode definir seus próprios comandos."
description: "Esta lição mostra como você pode estender o LaTeX de acordo com a sua necessidade e mudar a aparência do documento usando diferentes pacotes, e mostra como você pode definir seus próprios comandos."
toc-anchor-text: "Estendendo o LaTeX"
toc-description: "Usando pacotes e definições."
---
Expand All @@ -11,7 +11,7 @@ toc-description: "Usando pacotes e definições."

<span
class="summary">Esta lição mostra como você pode estender o LaTeX de acordo
com a sua necessidade e mudar a aparência do document usando diferentes
com a sua necessidade e mudar a aparência do documento usando diferentes
pacotes, e mostra como você pode definir seus próprios comandos.</span>

Depois de declarar uma classe, no preâmbulo você pode modificar funcionalidades
Expand All @@ -36,7 +36,7 @@ Isso é configurado pelo pacote `babel`.
%\usepackage[brazilian]{babel}
\usepackage[width = 6cm]{geometry} % To force hyphenation here
\usepackage[width = 6cm]{geometry} % Para forçar a hifenização neste exemplo
\begin{document}
Expand All @@ -48,8 +48,8 @@ em diferentes idiomas, então deve ser longo para ter no mínimo uma separação
\end{document}
```

Tente descomentar o a linha que carrega o pacote `babel` e veja o efeito. (As
regras de hifenização padrão são Inglês Americano.)
Tente des-comentar (ativar) a linha que carrega o pacote `babel` e veja o efeito. (As
regras de hifenização padrão são para o inglês americano).

O pacote `babel` faz muito mais que hifenização, dependendo do idioma em
questão; nós damos [alguns detalhas extra](more-06) se você precisar.
Expand Down Expand Up @@ -126,7 +126,7 @@ Algo sobre \kw{maçãs} e \kw{laranjas}.
\end{document}
```

Na definição, `[1]` é o número de argumentos (nesse caso um), e `#1` simboliza
Na definição, `[1]` é o número de argumentos (nesse caso um) e `#1` simboliza
o primeiro argumento que é fornecido ao comando
(`maçãs` ou `laranjas`, nesse exemplo). Você pode usar até nove argumentos, mas
geralmente é melhor usar poucos argumentos; um ou até nenhum.
Expand All @@ -136,7 +136,7 @@ para produzir um documento. Comandos também ajudam a separar a formatação de
informações. Se, por exemplo, for decidido usar um estilo diferente para
palavras-chave, ao invés de editar o documento inteiro, você simplesmente
modifica a definição do comando. Aqui carregamos o pacote `xcolor` para
utilizar cores, e usamos cor azul ao invés de negrito na formatação.
utilizar cores e usamos cor azul ao invés de negrito na formatação.

```latex
\documentclass{article}
Expand All @@ -153,15 +153,15 @@ Algo sobre \kw{maçãs} e \kw{laranjas}.
\end{document}
```

Cuidado que ao definir muitos comandos com múltiplos argumentos pode tornar o
Observe que definir muitos comandos com múltiplos argumentos pode tornar o
código do documento difícil de entender por estar usando uma sintaxe própria.
A habilidade de definir comandos específicos ao documento deve ser usada com
cautela.

## Exercícios

Tente escrever texto em outros idiomas e veja como `babel` afeta a hifenização:
você pode encontrar algum texto na internet, e adivinhar a opção que carrega o
você pode encontrar algum texto na internet e adivinhar a opção que carrega o
idioma escolhido.

Tente alterar as margens no exemplo com `geometry`. Você pode modificar margens
Expand Down
Loading

0 comments on commit 78cd8e4

Please sign in to comment.