learnxinyminutes-docs/pt-br/latex-pt.html.markdown
2022-07-07 23:52:51 +02:00

331 lines
13 KiB
TeX

---
language: latex
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"]
lang: pt-br
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/docs/latex/}, ou
\href{https://learnxinyminutes.com/docs/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/)