SMAT 2012

Marco Antônio Piteri

Helder C. R. de Oliveira

Anderson Gregório da Silva

Universidade Estadual Paulista Júlio de Mesquita Filho - UNESP

Faculdade de Ciências e Tecnologia – Campus de Presidente Prudente

Comandos de estruturação de Documentos.

Ambientes no LaTeX:

Verbatim;

Alinhamento de Textos;

Listas;

Códigos.

Referências Cruzadas.

Referências Bibliográficas.

Qualquer documento possui uma estrutura de organização interna. Para simplificar,

vamos pensar num livro;

Quando olhamos para um livro é possível perceber vários elementos que definem a sua

estrutura interna, inclusive as posições em que estes elementos ocorrem no interior de

um documento. Entre os elementos mais perceptíveis, podemos citar: partes (pouco

usado), capítulos, seções, subseções, subsubseções, parágrafos e apêndices.

Comandos específicos no LaTeX para estruturar (segmentar) um documento:

Observe que existe uma hierarquia entre os comandos, com exceção docomando \part.

Com exceção dos comandos \part e \chapter, os demais estão disponíveis em todas

as classes pré-definidas (article, book, report).

Estes comandos (de estrutura) também auxiliam no processo de automatização de váriastarefas realizadas pelo LaTeX, como:

nome e número de capítulos e seções em headers;

construção da tabela de conteúdos com os capítulos, seções, subseções, etc;

Os comandos para outros elementos estruturais, como: referências bibliográficas,tabelas de índices, listas de figuras e índices remissivos, serão tratadosoportunamente (quase todos).

\part book, report e article

\chapter book, report

Assim, nas classes book e report o nível mais alto é \chapter.

Os capítulos são divididos em seções usando-se o comando \section, que por sua vezé dividido em subseções com o comando \subsection, e assim, sucessivamente;

Um artigo (classe article) é dividido em seções, logo, a hierarquia começa com o comando\section. Como vocês sabem, não existem artigos com capítulos.

Forma Geral destes comandos:

\comando_nome_seção[nome_curto_da_seção]{título_da_seção}

Exemplos nos próximos slides.

Exemplos de uso destes comandos:

...

\chapter[Geração de Malhas Tridimensionais]{Geração de Malhas

Tridimensionais Usando a Técnica de Avanço da fronteira}

\chapter{Conceitos Gerais}

\section{Fundamentação Teórica}

\subsection{Primitivas Geométricas}

\subsection{Primitivas Topológicas}

...

Observe os nomes curtos e longos no primeiro capítulo. O nome curto será usado noheader (a opção é sua) e na tabela de conteúdos, enquanto o nome longo, será usado napágina do respectivo capítulo.

Após o processo de compilação, o LaTeX:

cria um documento com esta estrutura interna e com os respectivos nomes de cadauma das divisões (partes, capítulos, seções, subseções, etc);

faz a numeração automática de todas elas em seu documento;

cria uma “tabela de conteúdo” (Sumário) com as respectivas entradas, incluindo aspáginas onde elas estão;

utiliza estas entradas para acrescentar informações nos headers (se você desejar).

Observação: Se a opção nome_curto_da_seção estiver presente, então ela será usadacomo entrada, em substituição ao nome título_da_seção, por exemplo, na tabela deíndices (Sumário).

ex01.tex

Um elemento muito importante no LaTeX é a noção de ambiente, que pode ser visto comopartes/componentes integrantes de um documento, com características especiais;

Ambientes são utilizados para alterar determinadas propriedades de um texto, como porexemplo, sua endentação (centralizado, justificado a esquerda ou a direita), ou ainda,agrupar um conjunto de comandos a determinadas estruturas (figuras, tabelas, etc);

Figuras, tabelas, equações, listas, alinhamentos e listas, entre outros, são tratados peloLaTeX como ambientes;

Todos ambientes no latex são limitados superiormente pelo comando \begin{...} e,inferiormente, pelo comando \end{...}.

Forma geral:

\begin[opções_do_ambiente]{nome_do_ambiente}

... comandos associados ao ambiente

\end{nome_do_ambiente}

Observação: Vamos explorar vários tipos de ambientes ao longo deste minicurso. OLaTeX também fornece recursos para que você possa criar seus próprios ambientes.

O texto no interior de um ambiente verbatim permanece exatamente como está, ou seja,os comandos do LaTeX não são interpretados, inclusive os espaços existentes (linhase colunas), são deixados como está.

Usado em geral para inserir códigos de programas respeitando a endentação (formatação)original;

O ambiente verbatim foi reimplementado pelo pacote verbatim (acrescentando algumasfuncionalidades extras).

Permitem explorar diferentes formas de alinhamento de um texto ou, outros elementos deseu documento.

Centralizado:

\begin{center} linha1 \\ linha2 \\ ... \end{center}

Alinhado à esquerda:

\begin{flushleft} linha1 \\ linha2 \\ ... \end{flushleft}

Alinhado à direita:

\begin{flushright}linha1 \\ linha2 \\... \end{flushright}

Observação: Textos alinhados não são hifenizados.

Para uma única linha, o comando

\centerline{texto_que_será_centralizado} pode ser usado.

Exemplo:

Resultado:

Exemplo:

Resultado:

Exemplo:

Resultado:

Há três tipos básicos de listas no LaTeX: enumerate, itemize, description;

Os diferentes ambientes podem ser combinados (aninhamento de listas) em até 3 níveis;

No ambiente itemize cada um dos itens possui uma marca (símbolo gráfico) (bullet).

No ambiente enumerate cada um dos itens possui uma numeração (números, letras,letras e números, ...)

No ambiente description cada um dos itens pode ter uma “palavra chave/descritor” queidentifica o respectivo item e serve para descrevê-lo;

Cada item na lista_de_itens deve ser precedido do comando \item que especifica a

criação de um novo item na lista;

O texto pode ser tão longo quanto se deseja;

Ao se fazer o aninhamento de listas, o estilo da marca (símbolo gráfico - itemize) e o estiloda numeração (enumerate) mudam, em cada um dos níveis;

Há pacotes específicos para aumentar as capacidades de manipulação de listas;

O rótulo no ambiente description é destacado (negrito ou cor) no momento da impressãofinal;

É possível escolher/alterar os símbolos gráficos (bullets), bem como as numerações emcada um dos níveis. Não vamos fazer isso aqui.

Exemplo:

ex02.tex

Exemplo:

Resultado:

Exemplo:

Resultado:

Observação: Dependendo da classe utilizada, o uso de aninhamentos reduz o tamanhoda fonte nos níveis inferiores. O comando \normalsize{texto}, resolve o

problema, ver próximo slide.

Resultado:

Resultado:

Resultado:

Listings é um pacote usado para colocar “códigos fontes” em documentos LaTeX;

Fácil de usar!;

Permite configurar o ambiente como colocando número de linhas e boxes...

É possível adicionar um código de duas maneiras:

Inline: O código fica dentro do .tex;

Input: O código fica dentro de um arquivo separado;

Muitas linguagens suportadas: ABAP, ACSL, Ada, Algol, Ant, Assembler, Awk, bash, Basic, C, C++, Caml, CIL, Clean, Cobol, Comal 80, command.com, Comsol, csh, Delphi, Eiffel, Elan, erlang, Euphoria, Fortran, GCL, Gnuplot, Haskell, HTML, IDL, inform, Java, JVMIS, ksh, Lingo, Lisp, Logo, make, Mathematica, Matlab, Mercury, MetaPost, Miranda, Mizar, ML, Modula-2, MuPAD, NASTRAN, Oberon-2, OCL, Octave, Oz, Perl, Pascal, PHP, PL/I, Plasm, PostScript, POV, Prolog, Promela, PSTricks, Python, R, Reduce, Rexx, RSL, Ruby, S, SAS, Scilab, sh, SHELXL, Simula, SPARQL, SQL, tcl, TeX, VBScript, Verilog, VHDL, VRML, XML, XSLT

\documentclass{article}

\usepackage{listings}

\begin{document}

\lstset{language=C}

\begin{lstlisting}

#include <stdio.h>

int main() {

printf("Hello World!\n");

printf("Usando Listings");

return 0

}

\end{lstlisting}

\end{document}

Inline: ex04.tex

Input: ex05.tex

São referências internas aos diferentes elementos que estruturam e constituem umdocumento em LaTeX e que permitem criar uma “ligação lógica” entre eles;

As referências mais comuns são feitas à: capítulos, seções, figuras, tabelas, equações ereferências bibliográficas. Podem ser feitas em qualquer parte do texto.

Há quatro comandos básicos para esse propósito:

\label, \ref, \pageref e \cite.

Descrição dos comandos:

\label{marca_texto} Associa o rótulo/identificador marca_texto a um dos

elementos em seu documento. É usado para identificar figuras, tabelas, capítulos,seções e equações;

\ref{marca_texto} Usado para inserir no documento uma referência a uma figura,

equação, tabela, capítulo ou seção, que foi previamente identificada pelo rótulomarca_texto;

\pageref{marca_texto} Insere o número de uma página na posição onde está

sendo feita a referência. Este número corresponde à página onde foi colocado o rótulomarca_texto. É utilizado principalmente quando fazemos uma referência a umelemento distante do ponto onde ela se encontra;

\cite{...} Usado para indicar no corpo do texto a referência bibliográfica que

auxilia e dá suporte a sua narrativa (veremos mais à frente);

Onde:

marca_texto: é um rótulo/identificador que é colocado, em geral, no interior de ambientesdo tipo: figuras, tabelas, equações, capítulos e seções;

Após a associação do rótulo marca_texto com um dos elementos mencionados acima, épossível referenciá-lo em qualquer parte do texto;

Após o processo de compilação, o efeito é o seguinte:

No caso do comando \ref{marca_texto}, há uma substituição exatamente no ponto

onde foi realizada a referência, por um número que permite identificar o elementoreferenciado, na lista deste tipo de elemento (figuras, tabelas, equações, ...);

Vale lembrar que todas as figuras e tabelas possuem um número único, assim como asequações matemáticas (numeração opcional);

Vamos explorar o tópico de referências cruzadas diretamente no documento exemplo(monografia);

ex03.tex

Muitas pessoas contribuíram com o desenvolvimento dos mais variados pacotes,que integrados ao TeX/LaTeX, aumentam os recursos existentes (novasfuncionalidades);

Um programa externo muito popular para gerenciar referências bibliográficas é oBibTeX, escrito por Oren Patashnik;

Este programa automatiza a criação da seção de “Referências Bibliográficas”num documento LaTeX, segundo um estilo pré-definido (regras de formatação,ordem dos campos de cada tipo de entrada, etc), a partir de todas as citaçõesque foram realizadas no corpo do documento;

As entradas são armazenadas num arquivo com a extensão .bib e devem satisfazerum conjunto de regras (formato bibtex);

Há vários editores (front-ends em diferentes ambientes) que editam e gerenciamarquivos.bib de uma forma muito simples. Recomendamos o uso do JabRef;

Uma grande vantagem no uso de um arquivo.bib é a possibilidade de usar estemesmo arquivo para todos os documentos que você escreve. Para manteratualizado este arquivo, é só acrescentar novas entradas;

Um arquivo.bib é um arquivo de texto (ASCII). Qualquer um das centenas de Editoresde Textos que você conhece pode ser usado, desde que você siga o padrão bibTeX;

Existe um estilo que segue as normas da ABNT para referências bibliográficas (Nãovamos abordar aqui).

Há duas formas básicas para se organizar a seção de Referências Bibliográficas em seudocumento:

Todas as entradas (informações relativas as suas referências, como: autores,editora,ano de publicação, etc) estão no próprio (interior) documento .tex;

Usando um arquivo.bib: Essa é a forma séria de se construir bibliografias;

Primeira Forma:

Manual: Simples, ineficiente e redundante, mas funciona.

A partir do ambiente:

\begin{thebibliography}[num]

...

\end{thebibliography}

que deve estar no interior do documento onde você deseja inserir (local) sua bibliografia;

O parâmetro num indica o número máximo de rótulos permitidos. Assim,\begin{thebibliography}[99] indica ao LaTeX que nenhuma referência pode

ter um número maior que 99.

Cada entrada (referência bibliográfica) tem a forma:

\bibitem[opção]{rótulo} informações referentes a cada uma das entradas (todos os

campos);

Onde:

opção: não é um argumento obrigatório. Se não for especificado, as referências serãonumeradas automaticamente;

rótulo: usado para identificar qual obra você está referenciando no interior dodocumento. Isso é feito por meio do comando \cite{rótulo};

Cada entrada em sua base bibliográfica deve ter um rótulo único;

Método manual: ex02.tex

Usando JabRef: ex03.tex