learnxinyminutes-docs/pt-br/latex.md

---
contributors:
    - ["Chaitanya Krishna Ande", "http://icymist.github.io"]
    - ["Colton Kohnke", "http://github.com/voltnor"]
    - ["Sricharan Chiruvolu", "http://sricharan.xyz"]
    - ["Ramanan Balakrishnan", "https://github.com/ramananbalakrishnan"]
    - ["Svetlana Golubeva", "https://attillax.github.io/"]
translators:
    - ["Paulo Henrique Rodrigues Pinheiro", "https://github.com/paulohrpinheiro"]
    - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]
filename: learn-latex-pt.tex
---

```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
% MS Word ou OpenOffice Writer

% 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.
% As opções para um documento aparecem entre [] chaves. Nesse caso
% está especificado que queremos o tamanho da fonte em 12pt.
\documentclass[12pt]{article}

% Em seguida definimos os pacotes que o documento usa.
% Se você quiser incluir gráficos, texto colorido, ou código fonte de outra
% linguagem em outro arquivo em seu documento, você precisa ampliar as
% capacidades do LaTeX. Isso é feito adicionando-se pacotes.
% Serão incluídos os pacotes float e caption para imagens e hyperref
% para links.
\usepackage{caption}
\usepackage{float}
\usepackage{hyperref}

% Podemos definir algumas outras propriedades do documento também!
\author{Chaitanya Krishna Ande, Colton Kohnke, Sricharan Chiruvolu \& \\
Svetlana Golubeva}
\date{\today}
\title{Aprenda \LaTeX{} em Y Minutos!}

% Agora estamos prontos para começar o documento
% Tudo antes dessa linha é chamado "preâmbulo".
\begin{document}
% 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.
% É uma boa prática separar a tabela de conteúdo do corpo do documento. Para
% isso usa-se o comando \newpage
\newpage
\tableofcontents

\newpage

% Muitos artigos de pesquisa possuem um resumo, e pode-se usar comandos
% predefinidos para isso.
% Isso deve aparecer em sua ordem lógica, portanto, após o topo,
% mas antes das seções principais do corpo.
% Esse comando está disponível para os documentos do tipo artigo (article)
% e relatório (report).
\begin{abstract}
 Documentação do \LaTeX{} escrita em \LaTeX! Nada original!
\end{abstract}

% Comandos para seções são intuitivos. 
% Todos os títulos de seção são adicionados automaticamente à tabela de conteúdo.
\section{Introdução}
Olá, meu nome é Colton e juntos estamos explorando o mundo do \LaTeX!

\section{Outra seção}
Esse é o texto para outra seção. Penso que precisamos de uma subseção.

\subsection{Isso é uma subseção} % Subseções também são intuitivas.
Penso que precisamos de mais uma

\subsubsection{Pythagoras}
Muito melhor agora.
\label{subsec:pythagoras}

% Ao usar o asterisco nós impedimos a numeração automática.
% Isso funciona para outros comandos \LaTeX também.
\section*{Essa é uma seção não numerada} 
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{} 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. 

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
amanhã, então façamos uma lista de compras.
\begin{enumerate} % Isso cria o bloco "enumerate".
  % \item faz com que o enumerate incremente
  \item Salada.
  \item 27 melancias.
  \item Uma lebre.
  % pode-se também sobrescrever o número do item usando []
  \item[quantas?] Pistolas de água médias.

  Não é um item da lista, mas faz parte do bloco enumerate.

\end{enumerate} % Todos os blocos devem ter um final (end{}).

\section{Matemática}

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!

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.

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.
% 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.
% Podemos entrar no modo matemática a partir do modo texto com os símbolos $.
% O oposto também pode ocorrer. Variáveis podem ser renderizadas no modo
% matemática.
% Também podemos entrar no modo matemática com \[\]

\[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{} 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. 
Vamos escrever uma equação para ver como se faz:
$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$

Frações (numerador/denominador) podem ser escritas dessa forma:

% 10 / 7
$$ ^{10}/_{7} $$

% Frações relativamente complexas podem ser escritas como
% \frac{numerator}{denominator}
$$ \frac{n!}{k!(n - k)!} $$ \\

Também podemos escrever equações em um ``bloco de equação''.

% Apresenta matemática com o 'bloco' equação
\begin{equation} % entra no modo matemática
    c^2 = a^2 + b^2.
    \label{eq:pythagoras} % para referência
    \end{equation} % toda declaração \begin precisa de uma declaração end

Podemos então referenciar nossa nova equação!
A equação~\ref{eq:pythagoras} é também conhecida como Teorema de Pitágoras que é
também assunto da Seção~\ref{subsec:pythagoras}. Muitas coisas podem ser
rotuladas: figuras, equações, seções, etc.

Somatórios e Integrais são escritas com os comandos sum e int:

% Alguns compiladores LaTeX irão reclamar se existirem linhas em branco
% em um bloco de equação.
\begin{equation} 
  \sum_{i=0}^{5} f_{i}
\end{equation} 
\begin{equation} 
  \int_{0}^{\infty} \mathrm{e}^{-x} \mathrm{d}x
\end{equation} 

\section{Figuras}

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
    % Inclui uma figura com escala de 0.8 do tamanho da página.
    %\includegraphics[width=0.8\linewidth]{right-triangle.png} 
    % Comentado para propósitos de compilação. Por favor, use sua imaginação.
    \caption{Triângulo retângulo com lados $a$, $b$, $c$}
    \label{fig:right-triangle}
\end{figure}

\subsection{Tabelas}
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.
  % 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 &  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{} não compilar algo (o código fonte)}
Digamos que precisamos incluir algum código dentro do nosso
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("Olá mundo!")
  a%b; % olha só! Podemos usar os sinais % no bloco verbatim. 
  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{} pdf.
(sim, esse documento é compilável). \\

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. 
     Os passos para compilar se parecem (em Linux) com: \\
     \begin{verbatim} 
        > pdflatex learn-latex.tex
     \end{verbatim}
  \end{enumerate}

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
passo 2 várias vezes, para gerar arquivos *.aux intermediários.}.
% É assim que você adiciona notas de rodapé em seus documentos!

Você escreve toda a informação de formatação em texto puro, no passo 1. O
momento da compilação no passo 2 é responsável por produzir o documento no
formato que você definiu no passo 1.

\section{Links}
Nós podemos inserir links em nosso documento. Para isso nós necessitamos incluir
o pacote hyperref no preâmbulo com o comando:
\begin{verbatim} 
    \usepackage{hyperref}
\end{verbatim}

Existem dois tipos principais de links: URL visíveis \\
\url{https://learnxinyminutes.com/latex/}, ou
\href{https://learnxinyminutes.com/latex/}{um texto alternativo}
% Você não pode adicionar espaços extras ou símbolos especiais no texto
% alternativo, pois isso causará problemas na compilação.

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!

% Frequentemente você precisa de uma seção de referências em seu documento.
% A forma mais fácil de configurá-la é usando uma seção de bibliografia
\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{} wikibook: {\em 
https://en.wikibooks.org/wiki/LaTeX}
  \bibitem{latextutorial} An actual tutorial: {\em http://www.latex-tutorial.com}
\end{thebibliography}

% end the document
\end{document}
```

## Mais sobre 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/)