# 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
<blockquote style = "text-align:right">
**Ao cuidado de Maria**<br>
Seguem os documentos anexos
</blockquote>

## 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

<ul style = "list-style-type: none;padding:0; margin:0;">
  <li><strong>primeiro</strong> fui ao jardim da celeste</li>
  <li><strong>segundo</strong> giroflé giroflá</li>
</ul>

```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

<img width="128px" src="ovo-estrelado.jpg"></img>

enquanto que o resultado de
```latex
\includegraphics[width=64px]{imagens/ovo-estrelado.jpg}
```
é

<img width="64px" src="ovo-estrelado.jpg"></img>


### 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}
```
<div style="text-align:left;background-color:#EEE;border:thin solid gray;">
Alinhado à esquerda.
</div>

Para **centrar** usa-se

```latex
\begin{center}
TEXTO
\end{center}
```
<div style="text-align:center;background-color:#EEE;border:thin solid gray;">
Centrado
</div>

Para alinhar à **direita** usa-se

```latex
\begin{flushright}
TEXTO
\end{flushright}
```
<div style="text-align:right;background-color:#EEE;border:thin solid gray;">
Alinhado à direita.
</div>

### Tabelas
<a name="subsectabelas"></a>

```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}
```