Sobre este Curso

Este site está, ainda, em fase de construção e refinamento. Os conteúdos estão incompletos e sub-otimizados.

Os autores de textos académicos não devem preocupar-se com (nem sequer têm de saber) as inúmeras regras tipográficas que produzem um documento bem apresentado.

Editores diferentes requerem regras tipográficas distintas. Variam as fontes, o alinhamento do texto, a forma das referências bibliográficas, etc.

O $\text{LATEX}$ proporciona exatamente esta possibilidade: enquanto autor pode focar-se no conteúdo, livre de tarefas triviais, como a formatação, referências, etc.

Neste curso pretende-se proporcionar uma introdução prática ao uso do $\text{LATEX}$:

Os conceitos são apresentados com exemplos e seguidos de exercícios.

Não sendo possível, numa introdução, cobrir em profundidade os tópicos abordados, é proporcionada uma lista de recursos online onde esses tópicos são apresentados de forma mais completa.

Convenções

Os exemplos são indicados assim:

Os exercícios:

A sintaxe é introduzida desta forma:

\emph{texto destacado}

E em geral, o código $\text{LATEX}$ tem os seguinte aspeto:

\documentclass{article}
\begin{document}
    Exemplo de texto em \LaTeX.
\end{document}

com o resultado apresentado assim:

Primeiros Passos

Objetivos deste capítulo

• Fazer o primeiro documento $\text{LATEX}$.
• Organizar um documento por secções, etc.
• Fazer listas (numeradas, de itens e de termos).
• Fazer comandos e ambientes simples.
• Encontrar documentação, exemplos, ajuda, etc.

Preparação

Objetivos: Instalar o $\text{LATEX}$, programas auxiliares e confirmar que está tudo a funcionar corretamente.

Instalação do $\text{LATEX}$: Distribuições

O $\text{LATEX}$ consiste num conjunto de vários programas. Uma distribuição é uma determinada seleção de programas, que pode incluir editores, estilos, classes, etc.

As distribuições mais comuns são:

• TeX Live para qualquer sistema operativo (recomendado).
• MacTeX variante do TeX Live para macOS.
• MiKTeX para Windows.

Para escrever documentos podem ser usados vários editores:

• TeXStudio para qualquer sistema operativo.
• LyX para principiantes inseguros.
• VSCode, ou o VSCodium(recomendado) com a extensão LaTeX Workshop para utilizadores seguros.

Serviços Online

Também pode usar o $\text{LATEX}$ sem o instalar no seu computador, usando um editor online.

• Uma vantagem desta opção é a facilidade de colaboração entre vários autores.
• Por outro lado fica dependente de acesso internet e terá de criar uma conta pessoal, o que implica partilhar o seu email...

Os serviços de edição $\text{LATEX}$mais comuns são:

• O Overleaf, traduzido para português, é, talvez, o serviço mais completo. Oferece a possibilidade (paga) de colaboração e de sincronizar com o Dropbox e com o Google Drive.
• O TeXPage e Paperia são semelhantes ao Overleaf.

Informação online

• Entrada: $\text{LATEX}$ Project.
• Perguntas/Respostas: TeX@stackexchange.
• Comunidade: $\text{LATEX}$ Community e TUG.
• Exemplos: TeXample.net.
• Modelos: $\text{LATEX}$ Templates.
• Wikilivro: em Português e em Inglês, mais completo.

Além destes endereços, the web is your friend.

\documentclass{article}
\begin{document}
    Primeiro documento.
\end{document}

Organização

Objetivos: Fazer documentos estruturados, com divisões, listas, e comandos.

Classe, Preâmbulo e Conteúdo

\documentclass{article} % Classe do documento
% Preâmbulo
\begin{document}
% Conteúdo
\end{document}

Opções Comuns no Preâmbulo

\documentclass{article}
% Fontes internacionais de melhor qualidade.
\usepackage[T1]{fontenc}
% Carateres internacionais.
\usepackage[utf8]{inputenc}
% Traduções para Português.
\usepackage[portuges]{babel}
% \"portuges\"!!!
% Incluir imagens
\usepackage{graphicx}
\begin{document}
    % Conteúdo
\end{document}

Divisões de um Documento

• Secções e Subsecções em todos os tipos de documentos.
• Capítulos e Partes em livros (ou monografias).
• Divisões Não Numeradas.

(veja mais em Document Structure)

Secções e Subsecções

\section{Aula 1}
%
% Resumir o que vai ser apresentado hoje.
%
Nesta aula ...

\subsection{Preparação}
%
% 1. Instalar o $\LaTeX$
% 2. Escolher um editor
% ...
%
Para instalar o $\LaTeX$ ...

Partes e Capítulos

Em documentos mais extensos, como livros ou monografias, além das secções e subsecções, também é comum usarem-se partes e capítulos.

Divisões Não Numeradas

• Certos comandos têm um comportamento padrão. Por exemplo \section{...} inicia uma secção automaticamente numerada.
• Porém, frequentemente estamos interessados num comportamento alternativo. Por exemplo, iniciar uma secção não numerada.
• O comportamento alternativo (em alguns casos) é ativado acrescentado um * ao nome do comando: \section*{...}.
• Para as divisões dos documentos (partes, capítulos, secções e subsecções) o comportamento alternativo consiste em não numerar a respetiva divisão.

Listas

• Listas Não Ordenadas.
• Listas Ordenadas.
• Listas de Termos.

(ver mais em List Structures)

Listas Não Ordenadas

\begin{itemize}
    \item Meia dúzia de ovos.
    \item 100g de açúcar.
    \item 500g de farinha.
    \item 0,5L de leite.
\end{itemize}

Listas Ordenadas

\begin{enumerate}
    \item Separar as claras das gemas.
    \item Bater as claras em castelo.
    \item Misturar bem o leite com as gemas.
    \item ...
\end{enumerate}

Listas de Termos

\begin{description}
    \item[Energia] 1870kJ.
    \item[Lípidos] 16,0g.
    \item[Hid. Carb.] 68,6g.
\end{description}

Comandos Simples

Objetivos: Usar e fazer comandos ou ambientes para introduzir texto ou formatação frequente.

Comandos e Ambientes

Nos exercícios anteriores encontrámos vários comandos:

1. \section{...}.
2. \item ....
3. \emph{...}. Teste rápido: O que faz este comando?
4. etc.

E também encontrámos ambientes:

1. \begin{document} ... \end{document}.
2. \begin{itemize} ... \end{itemize}.
3. etc.

A diferença essencial entre um comando e um ambiente é:

• comando "Faz isto aqui".
• ambiente "Funciona desta forma daqui até ali".

Definir Comandos e Ambientes

Embora o $\text{LATEX}$ defina imensos comandos e ambientes, e os packages aumentem esta lista, por vezes (de facto, quase sempre) põe-se a necessidade de definirmos os nossos próximos comandos ou ambientes.

• Repetições frequentes ("por exemplo, ").
• Consistência ("por exemplo, ", "e.g. ")
• Controlo (substituir os "e.g. " por "por exemplo, ")

Definir um Comando

\newcommand{\COMANDO}[NÚM.ARGUMENTOS]{ ... }

\newcommand{\eg}[1]{(por exemplo, \#1)}
...
e temos \eg{com os comandos} melhor desempenho.

(ver mais em Macros)

Definir um Ambiente

\newenvironment{AMB}[NÚM.ARGUMENTOS]{INÍCIO}{FIM}

\newenvironment{ac}[1]% Ambiente "ac", com um argumento
{\begin{flushright}\textbf{A/C #1}}% Início
{\end{flushright}}% Fim
...
\begin{ac}{Dona Ingrácia}
    Seguem os documentos anexos.
\end{ac}

\begin{exercicio}{1}
    \cotacao{5}Quem foi o primeiro rei de Portugal?
\end{exercicio}

Documentos Comuns

Objetivos deste capítulo

• Usar o $\text{LATEX}$ para fazer uma apresentação.
• Definir tabelas.
• Importar imagens.
• Posicionar elementos flutuantes.
• Usar os comandos mais comuns em publicações académicas.

Apresentações

A Classe beamer

As apresentações são documentos da classe beamer, que proporciona várias opções para definir o aspeto e a navegação.

\documentclass{beamer}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[portuges]{babel}
\begin{document}
    \begin{frame}{Título da Página}
        % Conteúdo da primeira página
    \end{frame}
\end{document}

(ver mais em Presentations)

O Aspeto das Apresentações

O aspeto de uma apresentação tem duas componentes:

• O conjunto de cores.
• A forma e presença de elementos como rodapés, cabeçalhos, barras laterais, caixas, etc.

\documentclass{beamer}
\usetheme{boxes} % Elementos
\usecolortheme{dolphin} % Cores
...

Navegação nas Apresentações

• Tabela de conteúdos. Numa página: \tableofcontents
• Barra de navegação (vazia). No preâmbulo: \setbeamertemplate{``navigation symbols``}{}
• Nomes das secções e subsecções: Depende do tema escolhido em \usetheme{ ... }

Destaques

As caixas de destaque são feitas com um ambiente block:

\begin{block}{Destaque}
    As caixas de destaque são definidas no ambiente \texttt{block}.
    ...
\end{block}

Para destacar um fragmento de texto pode usar-se o comando \alert{destacar um fragmento de texto}.

Página de Rosto

% Preâmbulo
\title{Titulo}
\subtitle{Subtitulo}
\author{Nomes}
\date{Data}
\institute{Instituição}
\begin{document}
    \begin{frame}[plain]
        \titlepage
    \end{frame}
\end{document}

Progresso "passo-a-passo"

• Pode ser interessante revelar gradualmente o conteúdo de uma página.
• Este efeito é aplicado com o comando \pause.

\begin{itemize}
    \item Pode ser interessante
    \pause revelar gradualmente o conteúdo de uma página.
    \pause
    \item Este efeito é aplicado com o comando \texttt{pause}.
\end{itemize}

Tabelas e Figuras

As tabelas e as figuras são dos elementos mais comuns num documento.

Tabelas

As tabelas são definidas com o ambiente tabular.

\begin{tabular}{lr|c}
    \textbf{Nome} & \textbf{Apelido} & \textbf{Idade}
    \hline
    Francisco & Coelho & 56
    ...
\end{tabular}

• As colunas são definidas por lr|c.
  • Três colunas, com alinhamentos esquerdo, direito, centro.
  • Uma barra vertical entre a segunda e a terceira coluna.
• As linhas são separadas por \.
• Em cada linha, as colunas são separadas por &.
• A linha horizontal é feita com \hline.

(ver mais em Tables)

Observações sobre as Tabelas

O ambiente tabular permite inserir diretamente tabelas (relativamente) pequenas no documento, indicando o conteúdo de cada "célula".

Para tabelas grandes (distribuídas por várias páginas), ou para incluir dados externos (provenientes, por exemplo, de uma folha de cálculo) são usados outros ambientes, que vamos explorar numa aula posterior.

Figuras

\usepackage{graphicx}% No Preâmbulo
...
\includegraphics[OPÇÕES]{figura}% No Documento

Exemplo (Logótipo da Universidade de Évora)

\includegraphics[width=0.25\textwidth]{logotipo.png}

inclui no documento a imagem que está no ficheiro logotipo.png.

Neste exemplo, a imagem é reduzida de forma a ficar com 25% da largura da mancha de texto onde o comando é aplicado:

(ver mais em Importing Graphics)

Opções para Figuras

O comando \includegraphics está definido no package graphicx, que tem de ser declarado no preâmbulo:

\usepackage{graphicx}               % No preâmbulo
...
\includegraphics[...]{imagem.png}   % No documento

As opções do comando \includegraphics permitem especificar:

• A largura width = ....
• A altura height = ....
• Outras scale, angle, keepaspectratio, etc.

Os valores da largura e da altura podem ser expressos em unidades absolutas:

• pontos pt.
• comprimento mm, cm, etc.

Esses valores também podem ser dados em unidades relativas:

• ao texto \textwidth, \textheight.
• à linha \linewidth.
• às letras em.

Formatos de Imagem nas Figuras

No comando \includegraphics[...]{imagem} a imagem indicada é (o caminho para) um ficheiro externo ao documento.

• São aceites todos os formatos mais comuns de imagem: jpg, png, bmp, etc.
• É boa ideia "arrumar" todas as imagens numa única diretoria relativa ao documento.

Por exemplo:

monografia/             % pasta "principal"
    tese.tex            % documento "principal"
    imagens/            % sub-pasta com imagens
        diagrama1.jpg   % uma imagem usada no documento

Publicações Académicas

Alguns periódicos são muito específicos sobre o estilo dos artigos submetidos (por exemplo, na Elsevier e na Springer).

• A apresentação do título, autores, contactos, etc.
• O número de colunas.
• A posição, dimensões e formato das imagens e tabelas.
• A bibliografia.

Também é comum as editoras proporcionarem estilos ou mesmo classes $\text{LATEX}$ específicas para as suas publicações.

Aqui vamos tratar alguns pontos comuns neste tipo de documentos:

• Elementos Flutuantes.
• Etiquetas e referências internas ao documento.
• Bibliografia (ou referências externas).

Elementos Flutuantes

Por vezes elementos como tabelas ou figuras devem ser posicionadas (por exemplo) no topo das páginas ou em páginas específicas.

Também alguns documentos (por exemplo, monografias) devem ter índices de figuras e de tabelas.

Além disso, pode ser necessário fornecer uma legenda e numerar esses elementos.

(ver mais em Floats, Figures and Captions)

Tabelas Flutuantes

\begin{table}[POS]
    \caption{LEGENDA}
    TABELA
\end{table}

Figuras Flutuantes

\begin{figure}[POS]
    FIGURA \caption{LEGENDA}
\end{figure}

Índices de Tabelas e de Figuras

O uso dos ambientes table e figureé semelhante: determina-se o tipo de posicionamento e o conteúdo (que pode ser, ou não, uma tabela ou uma figura) com uma legenda opcional.

Mas estes ambientes têm outros efeitos (benéficos!): Passam a ser "conhecidos" nos índices internos de tabelas e figuras e podem ser colocados no documento com os comandos \listoftables e\listoffigures.

Tabela Flutuante e Índice de Tabelas

Referências e Bibliografias

Quase todos os elementos numerados (divisões, tabelas, figuras, etc) podem ser referidos noutro local do documento.

\label{ETIQUETA}    % Cria uma etiqueta
...
\ref{ETIQUETA}      % Insere uma referência 
\pageref{ETIQUETA}  % Insere uma referência à página

(ver mais em Labels and Cross-referencing)

Para uma secção, subsecção, etc, a etiqueta deve ser criada logo a seguir ao início da divisão.

\section{Estado da Arte}\label{sec:estado.da.arte}

Para uma tabela ou figura, etc, a etiqueta deve ser criada logo a seguir à legenda.

\begin{table}[b]
    \caption{Planetas}\label{tab:planetas}
    % tabular ...
\end{table}

Bibliografias

• A bibliografia é produzida a partir das citações no texto.
• A descrição das obras é definida numa base de dados externa, com um formato próprio e extensão.bib.
• Nessa base, cada obra tem uma chave única. Por exemplo,hawking1975particle.
• No documento, uma obra é citada via essa chave:\cite{hawking1975particle}.
• A lista das obras citadas é gerada automaticamente com

\bibliographystyle{ESTILO}
\bibliography{BASE-BIBLIOGRAFICA}

• O ESTILO depende do tipo de documento. Há inúmeras opções disponíveis: plain ,unsrt,abbrv,alpha, etc.

(ver mais em Bibliography Management)

Fazer Citações

Programas para as Bases Bibliográficas

Embora o formato das bases bibliográficas seja (relativamente) simples, pode ser mais conveniente usarem-se programas dedicados a esta tarefa.

Detalhe de um documento

Exportar bibliografia

(ver mais em Helpful tools e em Mendeley)

Monografias e Livros

Objetivos:

• Usar o $\text{LATEX}$ para fazer um documento "grande".
• Separar um documento por vários ficheiros.
• Escolher fontes.

Documentos "Grandes"

A classe book

As monografias ou livros, em geral:

• Estão divididas em
  • Prefácio Com a página de rosto, dedicatória, índices, sumário.
  • Corpo Com o texto principal e apêndices.
  • Epílogo Com a bibliografia, índice remissivo, etc.
• Em cada divisão são usadas diferentes regras tipográficas (por exemplo, no prefácio a numeração das páginas costuma ser em numerais romanos).
• Têm uma extensão considerável, com várias (muitas) tabelas, figuras, secções, capítulos, etc.

Prefácio, corpo e epílogo

\documentclass{book}
% Preâmbulo: Packages, Comandos
\begin{document}
    \frontmatter
    % Prefácio: Páginas de Rosto, Dedicatória, etc.
    \mainmatter
    % Corpo: Capítulos Principais
    \appendix
    % Anexos: Capítulos Complementares
    \backmatter
    % Epílogo: Bibliografia, Índice Remissivo, etc
\end{document}

\usepackage{lipsum} % No Preâmbulo
\lipsum % Vários Parágrafos de Texto
\lipsum[3] % Três Parágrafos de Texto

% No Preâmbulo
\title{Título deste Livro}
\author{Nome do Autor}
% No Conteúdo
\frontmatter
\maketitle

\frontmatter 
\maketitle 
\tableofcontents
\listoffigures
\listoftables

Separar um documento

• Facilmente um documento "grande" chega aos milhares de linhas.
• Num único ficheiro, gerir e navegar pode tornar-se um exercício penoso.
• Há várias formas de aliviar essa tarefa:
  • O \input{FICHEIRO} insere diretamente o conteúdo doFICHEIRO.
  • A dupla de comandos \includeonly{FICHEIROS} e \include{FICHEIRO} permite uma gestão mais sofisticada.

(ver mais em Modular Documents)

Separar com \input

A forma mais direta de separar um documento por vários ficheiros consiste em usar o comando \input{FICHEIRO}.

\begin{document}
    \input{sec01}
    % \input{sec02}
\end{document}

% !TeX root = principal.tex
\section{Introdução}
% Conteúdo desta secção

O Problema de separar com \input

• Com o comando\input{...} ativamos e desativamos completamente certa partes do documento.
• Nem sempre esse comportamento é ideal.
  • Por vezes queremos apenas "esconder" o texto sem "esquecer" que esse texto existe.
  • Por exemplo, um capítulo "escondido" ainda deve criar uma entrada na tabela de conteúdos e as suas figuras e tabelas nas respetivas listas.

Separar com \include

% Preâmbulo
\includeonly{sec01}
\begin{document}
    \include{sec01}
    \include{sec02}
\end{document}

% !TeX root = principal.tex
\section{Introdução}
% Conteúdo desta secção

O comando \includeonly{sec01} esconde as secções não indicadas mas sem as ignorar.

Fontes

No $\text{LATEX}$ é difícil mudar arbitrariamente as fontes. E há uma boa razão para isso: Más fontes dificultam a legibilidade de um documento.

• Em geral, o $\text{LATEX}$ usa as suas próprias fontes, que são excelentes, divididas em três famílias:

• Com Serifas: \rmdefault → com serifas.

• Sem Serifas: \sfdefault → sem serifas.

• Mono-espaço: \ttdefault → mono-espaçado.

• Também é possível usarem-se outras fontes disponíveis no computador (como, por exemplo, neste fragmento) mas os resultados dependem da qualidade da fonte escolhida.

(ver mais em Fonts)

Variantes Pontuais

Variantes Locais

Tamanhos (Locais)

Variantes Globais

% Preâmbulo
\renewcommand{\familydefault}{FAMÍLIA}
% FAMÍLIA = \rmdefault, \sfdefault ou \ttdefault

% !TEX program =750xelatex
% Preâmbulo
\usepackage{fontspec}
\setmainfont{FONTE-NO-COMPUTADOR}

Figuras de Alta Qualidade

Gráficos de Funções

(ver mais em Documentação do package pgfplots)

Diagramas

(ver mais em TikZ)

Usos Especiais

Usos Especiais

Objetivos:

• Dimensionar as páginas e a mancha de texto.
• Escrever expressões matemáticas.
• Usar acrónimos.
• Usar hiperligações.
• Colocar dados externos em tabelas.
• Formatar tabelas "grandes".
• Fazer um índice remissivo.

Dimensão da página e do texto

As dimensões da página, texto, cabeçalhos, rodapés, etc são tratadas com o package geometry.

Uso do package geometry:

% No Preâmbulo
\usepackage{geometry}
\geometry{OPÇÕES}

As OPÇÕES mais comuns incluem:

• paper = ...: Tamanho da página. Por exemplo, paper = a4paper.

• textwidth = ...: Largura da mancha (de texto). Por exemplo, textwidth = 10cm.

• left = ...: Largura da margem esquerda. Por exemplo, left = 2cm.

• right = ...: Largura da margem direita. Por exemplo, right = 2cm.

• Exercício: Dimensão da Página e do Texto<

1. Crie um documento da classearticle.

2. Use o package lipsum para gerar texto.

3. Use o package geometry para definir um documento para ser impresso em páginas A4, com 5 mm na margem esquerda e 5 cm na margem direita.

(ver mais em Documentação do package geometry)

Expressões Matemáticas

O $\text{LATEX}$ tem excelente suporte para expressões como $a=b\times h$ ou $$e^{i\pi }=-1.$$

Sintaxe para Expressões Matemáticas fragmento $ 2x = 3 $ produz $2x=3$.

equação $$ f(x) < \sin(x)$$ produz $$f(x)<\sin (x).$$

expoente $x^{2+\alpha} \leq 1$ produz $x^{2+\alpha }\le 1$.

índice $X_j \geq \sum_i x_{ij}$ produz $X_j\ge {\sum }_i{x}_{ij}$.

(ver mais em Mathematics)

Acrónimos

Sintaxe

% No Preâmbulo
\usepackage{acro}
\DeclareAcronym{ETIQUETA}{
    short = FORMA CURTA, $2long  = FORMA LONGA }
% No Documento
\ac{ETIQUETA}
..
\printacronyms% Lista de Acrónimos

(ver mais em Documentação do package `acro ou em Glossary: alternativa mais completa, com glossários))

• Exercício: Acrónimos

1. Crie um documento da classe article.
2. Use o package acro para ter acrónimos.
3. Defina, no preâmbulo, alguns acrónimos ao seu gosto.
4. Escreva um pequeno texto em que use esses acrónimos.
5. Crie (automaticamente) a lista de acrónimos.
6. (pontos extra) Veja na documentação do package acro como se faz para:
   • Tornar a escrever a forma longa.
   • Definir plurais.

Hiperligações

(ver mais em Hyperlinks)

Dados Externos

(ver mais em Documentação do package csvsimple)

Tabelas Grandes

(ver mais em Table across several pages)

Índice Remissivo

(ver mais em Indexing)