# Cábula LaTeX
[TOC]
## Definir Comandos e Ambientes
### Definir um comando
```latex
\newcommand{\COMANDO}[NUM.ARGUMENTOS]{...}
```
por exemplo
```latex
\newcommand{\bdia}[1]{Bom dia \emph{#1}}
...
\bdia{Maria}, como estás?
```
produz
> Bom dia _Maria_, como estás?
### Definir um ambiente
```latex
\newenvironment{AMB}[NÚM.ARGUMENTOS]{INÍCIO}{FIM}
```
por exemplo
```latex
\newenvironment{ac}[1]
{\begin{flushright} \textbf{Ao cuidado de #1} \\}
{\end{flushright}}
...
\begin{ac}[Maria]
Seguem os documentos anexos
\end{ac}
```
produz
**Ao cuidado de Maria**
Seguem os documentos anexos
## Conteúdo: Listas (não numeradas, numeradas e definições)
### Lista de itens não numerados
* fui ao jardim da celeste
+ giroflé giroflá
```latex
\begin{itemize}
\item fui ao jardim da celeste
\item giroflé giroflá
\end{itemize}
```
### Lista de itens numerados
1. fui ao jardim da celeste
+ giroflé giroflá
```latex
\begin{enumerate}
\item fui ao jardim da celeste
\item giroflé giroflá
\end{enumerate}
```
### Lista de definições
- primeiro fui ao jardim da celeste
- segundo giroflé giroflá
```latex
\begin{description}
\item[primeiro] fui ao jardim da celeste
\item[segundo] giroflé giroflá
\end{description}
```
## Conteúdo: Partes, Capítulos, Secções e Subsecções
```latex
\part{Canto I} % disponível apenas na classe book
\chapter{O Consílio dos Deuses} % disponível apenas nas classes report e book
\section{Debate entre Baco e Vénus}
\subsection{Vénus apresenta as suas razões}
```
Também há versões "estrela", não numeradas:
```latex
\part*{Canto I} % disponível apenas na classe book
\chapter*{O Consílio dos Deuses} % disponível apenas nas classes report e book
\section*{Debate entre Baco e Vénus}
\subsection*{Vénus apresenta as suas razões}
\paragraph{Cum poder tão singelo e tão pequeno}
```
Os parágrafos (explícitos) também organizam o texto.
## Conteúdo: Imagens, Alinhamentos, Tabelas
### Imagens
```latex
\usepackage{graphicx}
...
\includegraphics[OPÇÕES]{FICHEIRO.EXTERNO}
```
Por exemplo
```latex
\includegraphics[width=128px]{imagens/ovo-estrelado.jpg}
```
produz
enquanto que o resultado de
```latex
\includegraphics[width=64px]{imagens/ovo-estrelado.jpg}
```
é
### Alinhamentos
Para alinhar um parágrafo inteiro _devem usar-se_ estes ambientes. Se for necessário fazer um alinhamento mais complexo (por exemplo, no cabeçalho de um documento) pode ser usada uma [tabela](#subsectabelas).
Para alinhar à **esquerda** usa-se
```latex
\begin{flushleft}
TEXTO
\end{flushleft}
```
Alinhado à esquerda.
Para **centrar** usa-se
```latex
\begin{center}
TEXTO
\end{center}
```
Centrado
Para alinhar à **direita** usa-se
```latex
\begin{flushright}
TEXTO
\end{flushright}
```
Alinhado à direita.
### Tabelas
```latex
\begin{tabular}{COLUNAS}
LINHA \\
LINHA \\
...
\end{tabular}
```
O argumento `COLUNAS` define o número e o alinhamento de cada coluna. Cada coluna pode estar centrada,`c`, alinhada à esquerda, `l`, ou à direita, `r`. Além disso, também pode ser usado o símbolo `|` para desenhar linhas verticais.
Em cada linha as colunas são separadas pelo símbolo `&` e terminam com `\\`.
Também pode ser usado o comando `\hline` para desenhar uma linha horizontal.
Por exemplo
```latex
\begin{tabular}{l|ccr}
\textbf{Aluno (número)} & \textbf{1ª Frequência} & \textbf{2ª Frequência} & \textbf{Resultado}\\
\hline
12345 & 17,9 & 15,3 & \emph{aprov.} \\
53142 & 12,1 & 6,9 & \emph{reprov.} \\
...
\end{tabular}
```
produz (aproximadamente) a tabela
Aluno (número) | 1ª Frequência | 2ª Frequência | Resultado
:-----|:-------------:|:-------------:|---------:
12345 | 17,9 | 15,3 | _aprov._
53142 | 12,1 | 6,9 | _reprov._
...
## Conteúdo: Posicionamento de figuras e de tabelas
O posicionamento de elementos que não fazem parte do texto **deve ser feito automaticamente**.
### Figuras
O ambiente `figure` posiciona automaticamente um dado `CONTEÚDO` que, _em princípio_, será uma imagem externa ou um gráfico. É boa prática incluir uma legenda (abaixo), com `\caption{...}`, e uma identificação interna, `\label{...}`, para fazer referências, `\ref{...}`, no texto.
```latex
\begin{figure}
CONTEÚDO (por exemplo, uma imagem ou um gráfico)
\caption{Legenda desta figura}
\label{fig:ID.INTERNO}
\end{figure}
... ver a Figura \ref{fig:ID.INTERNO} ...
```
### Tabelas
O ambiente `table` posiciona automaticamente um dado `CONTEÚDO` que, _em princípio_, será uma tabela. É boa prática incluir uma legenda (acima), com `\caption{...}`, e uma identificação interna, com `\label{...}`, para fazer referências, `\ref{...}`, no texto.
```latex
\begin{table}
\caption{Legenda desta tabela}
\label{tab:ID.INTERNO}
CONTEÚDO (por exemplo, uma tabela)
\end{table}
... consulte a Tabela \ref{tab:ID.INTERNO} ...
```
## Internacionalização
### Conjunto internacional de carateres
Suporte para carateres como ç, ã, í, ñ, _etc_
```latex
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
```
### Tradução "automática"
De termos fixos como "secção", "figura", "teorema", _etc_
```latex
\usepackage[portuges]{babel}
```
> Por razões históricas tem-se mantido o erro ortográfico (até pelo _nao_) nesta opção para português...
## Apresentações (`beamer`)
### Aspeto
```latex
\usetheme{default} % aspeto geral (elementos e cores)
\usecolortheme{default} % cores
```
### Comandos comuns
```latex
\alert{DESTAQUE}
\pause % construção sucessiva de conteúdo
\small % reduzir um pouco o tamanho do texto
```
### Página
```latex
\begin{frame}{TÍTULO}
TEXTO
\end{frame}
```
### Bloco
```latex
\begin{block}{TÍTULO}
TEXTO
\end{block}
```
### Colunas
```latex
\begin{column}[t] % ou [c] ou [b]
\column{0.33\textwidth} % ou 0.33\textwidth ou 10em ou ...
COLUNA 1 (um terço da largura)
\column{0.64\textwidth}
COLUNA 2 (dois terços da largura)
\end{column}
```