summaryrefslogtreecommitdiffhomepage
path: root/pt-br/latex-pt.html.markdown
blob: b4ddd36a41fb43e9e8c73aeadbb47fce7ea26f84 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
---
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/)