Merge pull request #4430 from mribeirodantas/update-latex-pt

[latex/pt-br] Update/improve pt-br translatoin of LaTeX

pt-br/latex-pt.html.markdown

@@ -8,6 +8,7 @@ contributors:
     - ["Svetlana Golubeva", "https://attillax.github.io/"]
 translators:
     - ["Paulo Henrique Rodrigues Pinheiro", "https://github.com/paulohrpinheiro"]
+    - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]
 lang: pt-br
 filename: learn-latex-pt.tex
 ---
@@ -16,10 +17,10 @@ filename: learn-latex-pt.tex
 % Todas as linhas de comentários começam com %
 % Não existem comentários multilinhas
 
-$ LaTeX não é um programa processador de textos "Visual" como
+% LaTeX não é um programa processador de textos "Visual" como
 % MS Word ou OpenOffice Writer
 
-$ Todo comando LaTeX começa com uma barra invertida (\)
+% Todo comando LaTeX começa com uma barra invertida (\)
 
 % Documentos LaTeX começam com a definição do tipo que será % compilado
 % Os tipos de documento podem ser livro, relatório, apresentação, etc.
@@ -37,14 +38,11 @@ $ Todo comando LaTeX começa com uma barra invertida (\)
 \usepackage{float}
 \usepackage{hyperref}
 
-% Para poder usar caracteres acentuados, use o seguinte pacote:
-\usepackage[utf8]{inputenc}
-
 % Podemos definir algumas outras propriedades do documento também!
 \author{Chaitanya Krishna Ande, Colton Kohnke, Sricharan Chiruvolu \& \\
 Svetlana Golubeva}
 \date{\today}
-\title{Aprenda \LaTeX \hspace{1pt} em Y Minutos!}
+\title{Aprenda \LaTeX{} em Y Minutos!}
 
 % Agora estamos prontos para começar o documento
 % Tudo antes dessa linha é chamado "preâmbulo".
@@ -52,6 +50,7 @@ Svetlana Golubeva}
 % Se informarmos os campos author (autores), date (data), "title" (título),
 % LaTeX poderá cria uma página inicial para nós.
 \maketitle
+
 % Se tivermos seções, poderemos criar uma tabela de conteúdo. Para isso,
 % o documento deve ser compilado duas vezes, para que tudo apareça na ordem
 % correta.
@@ -69,7 +68,7 @@ Svetlana Golubeva}
 % Esse comando está disponível para os documentos do tipo artigo (article)
 % e relatório (report).
 \begin{abstract}
- Documentação do \LaTeX \hspace{1pt} escrita em \LaTeX! Nada original!
+ Documentação do \LaTeX{} escrita em \LaTeX! Nada original!
 \end{abstract}
 
 % Comandos para seções são intuitivos. 
@@ -93,11 +92,17 @@ Muito melhor agora.
 Afinal nem todas as seções precisam ser numeradas!
 
 \section{Algumas notas sobre texto}
-%\section{Espaçamento % É necessário mais informação sobre intervalos de espaço.
-\LaTeX \hspace{1pt} geralmente é muito bom sobre colocar texto onde ele deve
+%\section{Espaçamento} % É necessário mais informação sobre intervalos de espaço.
+\LaTeX{} geralmente é muito bom sobre colocar texto onde ele deve
 ser posto. Se 
 uma linha \\ deve \\ ser \\ quebrada \\ adicione \textbackslash\textbackslash
-\hspace{1pt} ao código de seu documento. \\ 
+\hspace{1pt} ao código de seu documento. 
+
+Separe parágrafos por linhas vazias.
+
+Você precisa adicionar um til após abreviações (se não forem seguidas de vírgula)
+para um espaço sem quebra, senão o espaçamento após o ponto será muito largo:
+E.g., i.e., etc.~são exemplos de abreviações.
 
 \section{Listas}
 Listas são uma das coisas mais fáceis de criar no \LaTeX! Preciso fazer compras
@@ -112,21 +117,21 @@ amanhã, então façamos uma lista de compras.
 
   Não é um item da lista, mas faz parte do bloco enumerate.
 
-  \end{enumerate} % Todos os blocos devem ter um final (end{}).
+\end{enumerate} % Todos os blocos devem ter um final (end{}).
 
 \section{Matemática}
 
-Um dos usos iniciais para \LaTeX \hspace{1pt} foi a produção de artigos
+Um dos usos iniciais para \LaTeX{} foi a produção de artigos
 acadêmicos e técnicos. Usualmente nos campos da matemática e ciência. Assim, é
-necessários que consigamos incluir alguns símbolos especiais em nosso texto! \\
+necessários que consigamos incluir alguns símbolos especiais em nosso texto!
 
 A matemática tem muitos símbolos, além dos quais se pode encontrar no teclado;
 símbolos para relações e conjuntos, setas, operadores, e letras gregas, apenas
-para mencionar alguns.\\
+para mencionar alguns.
 
 Conjuntos e relações são essenciais em muitos textos de pesquisa em matemática.
 Aqui está como você pode indicar como todo x que pertence
-a X, $\forall$ x $\in$ X. \\
+a X, $\forall$ x $\in$ X.
 % Perceba que é necessário adicionar os sinais $ antes e depois dos símbolos.
 % Isso é porque quando escrevendo, estamos em modo texto.
 % Mas os símbolos de matemática só existem no modo matemática.
@@ -138,15 +143,14 @@ a X, $\forall$ x $\in$ X. \\
 \[a^2 + b^2 = c^2 \]
 
 Minha letra grega favorita é $\xi$. Eu também gosto da $\beta$, $\gamma$ e $\sigma$.
-Eu ainda não encontrei uma letra grega que o \LaTeX \hspace{1pt} não tenha!\\
+Eu ainda não encontrei uma letra grega que o \LaTeX{} não tenha!\\
 
 Operadores são parte essencial de um documento sobre matemática:
 funções trigonométricas ($\sin$, $\cos$, $\tan$),
 logaritmo e exponencial ($\log$, $\exp$), 
-limites ($\lim$), etc. 
-possuem comandos pré-definidos em LaTex. 
+limites ($\lim$), etc.~possuem comandos pré-definidos em LaTex. 
 Vamos escrever uma equação para ver como se faz:
-$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$ \\
+$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$
 
 Frações (numerador/denominador) podem ser escritas dessa forma:
 
@@ -183,8 +187,10 @@ Somatórios e Integrais são escritas com os comandos sum e int:
 
 \section{Figuras}
 
-Insiramos uma Figura. O local para colocar a figura pode ser difícil
-de determinar. Eu tenho sempre que verificar as opções toda vez.
+Insiramos uma Figura. O local para colocar a figura pode ser difícil de determinar.
+Operações básicas são [t] para o topo, [b] para base, [h] para aqui (aproximadamente).
+Eu tenho sempre que verificar as opções toda vez.
+% Veja https://en.wikibooks.org/wiki/LaTeX/Floats,_Figures_and_Captions para mais detalhes
 
 \begin{figure}[H] % H aqui é uma opção para o local da figura. 
     \centering % centra a figura na página
@@ -201,36 +207,45 @@ Também podemos incluir tabelas da mesma forma que figuras.
 \begin{table}[H]
   \caption{Título para a Tabela.}
   % os argumentos {} abaixo descrevem como cada linha da tabela é desenhada.
-  % Aqui também, Preciso ver isso. Toda. E. Cada. Vez.
+  % O básico é simples: uma letra para cada coluna, para controlar o alinhamento:
+  % Operações básicas são: c, l, r e p para centro, esquerda, direita e parágrafo
+  % opcionalmente, você pode adicionar um | para linha vertical
+  % Veja https://en.wikibooks.org/wiki/LaTeX/Tables para mais detalhes
   \begin{tabular}{c|cc} 
-    Número &  Sobrenome & Primeiro Nome \\ % Colunas são separadas por &
+    Número &  Primeiro Nome & Sobrenome \\ % Colunas são separadas por &
     \hline % uma linha horizontal
     1 & Biggus & Dickus \\
     2 & Monty & Python
   \end{tabular}
+  % Vai ficar mais ou menos assim:
+  % Número | Primeiro Nome  Sobrenome
+  % -------|---------------------------  % por causa do \hline
+  %   1    |   Biggus        Dickus
+  %   2    |   Monty         Python
 \end{table}
 
-\section{Fazendo o \LaTeX \hspace{1pt} não compilar algo (o código fonte)}
+\section{Fazendo o \LaTeX{} não compilar algo (o código fonte)}
 Digamos que precisamos incluir algum código dentro do nosso
-documento \LaTeX \hspace{1pt}, para isso precisamos com o \LaTeX \hspace{1pt}
+documento \LaTeX{}, para isso precisamos com o \LaTeX{}
 não tente interpretar esse texto e que apenas inclua ele no documento. Fazemos
 isso com o bloco verbatim.
 
 % Existem outros pacotes (por exemplo, minty, lstlisting, etc.)
 % mas verbatim é o básico
 \begin{verbatim} 
-  print("Hello World!")
+  print("Olá mundo!")
   a%b; % olha só! Podemos usar os sinais % no bloco verbatim. 
-  random = 4; #decided by fair random dice roll
+  random = 4; #decidido por um lançamento honesto de dado
+  Veja https://www.explainxkcd.com/wiki/index.php/221:_Random_Number
 \end{verbatim}
 
 \section{Compilando} 
 
 Imagino que agora você esteja pensando como compilar esse fantástico documento
-e visualizar a gloriosa glória que é um pdf gerado por \LaTeX \hspace{1pt} pdf.
+e visualizar a gloriosa glória que é um pdf gerado por \LaTeX{} pdf.
 (sim, esse documento é compilável). \\
 
-Finalizando o documento usando \LaTeX \hspace{1pt} consiste nos seguintes passos:
+Finalizando o documento usando \LaTeX{} consiste nos seguintes passos:
   \begin{enumerate}
     \item Escrever o documento em texto puro (o ``código fonte'').
     \item Compilar o código fonte para gerar um pdf. 
@@ -240,7 +255,7 @@ Finalizando o documento usando \LaTeX \hspace{1pt} consiste nos seguintes passos
      \end{verbatim}
   \end{enumerate}
 
-Existem editores de \LaTeX \hspace{1pt} que combinam os passos 1 e 2 no mesmo
+Existem editores de \LaTeX{} que combinam os passos 1 e 2 no mesmo
 sistema de software. Assim, você pode ver o passo 1, mas não o passo 2 por
 completo. Passo 2 estará acontecendo escondido\footnote{Por exemplo, quando usar
 referências (como Equação~\ref{eq:pythagoras}), pode ser necessário executar o
@@ -267,6 +282,27 @@ Existem dois tipos principais de links: URL visíveis \\
 Esse pacote também produz uma lista de thumbnails no documento pdf gerado e
 ativa os links na tabela de conteúdo.
 
+\section{Escrevendo em ASCII ou outras codificações}
+
+Por padrão, historicamente LaTeX aceita entradas que são puro ASCII (128),
+mas não ASCII extendido, o que significa sem acentos (à, è etc.) e símbolos não latinos.
+
+É fácil inserir acentos e símbolos latinos básicos através de atalhos de barra invertida
+como \,c, \'e, \`A, \ae e \oe etc.  % Para ç, é, À, etc
+% Veja https://en.wikibooks.org/wiki/LaTeX/Special_Characters#Escaped_codes para mais detalhes
+
+Para escrever diretamente em UTF-8 quando compilando com pdflatex, use
+\begin{verbatim}
+    \usepackage[utf8]{inputenc}
+\end{verbatim}
+A fonte selecionada precisa suportar os glifos usados em seu documento. Você precisa adicionar
+\begin{verbatim}
+    \usepackage[T1]{fontenc}
+\end{verbatim}
+
+Desde LuaTeX e XeLaTeX, suporte para UTF-8 vem embutido por padrão, tornando a vida muito
+mais fácil para escrever em alfabetos não latinos.
+
 \section{End}
 
 Por enquanto é isso!
@@ -276,7 +312,7 @@ Por enquanto é isso!
 \begin{thebibliography}{1}
   % como em outras listas, o comando \bibitem pode ser usado para itens da lista
   % cada entrada pode ser citada diretamente no corpo do texto
-  \bibitem{latexwiki} The amazing \LaTeX \hspace{1pt} wikibook: {\em 
+  \bibitem{latexwiki} The amazing \LaTeX{} wikibook: {\em 
 https://en.wikibooks.org/wiki/LaTeX}
   \bibitem{latextutorial} An actual tutorial: {\em http://www.latex-tutorial.com}
 \end{thebibliography}
@@ -289,3 +325,6 @@ https://en.wikibooks.org/wiki/LaTeX}
 
 * The amazing LaTeX wikibook: [https://en.wikibooks.org/wiki/LaTeX](https://en.wikibooks.org/wiki/LaTeX)
 * An actual tutorial: [http://www.latex-tutorial.com/](http://www.latex-tutorial.com/)
+* A quick guide for learning LaTeX: [Learn LaTeX in 30 minutes](https://www.overleaf.com/learn/latex/Learn_LaTeX_in_30_minutes)
+* An interactive platform to learn LaTeX (installationfree) [learnlatex.org/](https://www.learnlatex.org/)
+* Stack Exchange's question and answer site about TeX, LaTeX, ConTeXt, etc. [tex.stackexchange.com](https://tex.stackexchange.com/)