learnlatex.org

Acessando documentação e obtendo ajuda

Há várias formas de acessar a documentação de um pacote ou classe.

texdoc

Se você instalou um sistema TeX (e.g., TeXLive ou MiKTeX) e incluiu a documentação quando instalou, você pode acessá-la localmente usando a ferramenta de linha de comando texdoc. Usando:

texdoc < pct >

abrirá a documentação do pacote <pct>. Esse utilitário buscará a documentação disponível e abrirá a qual ele achar mais próxima do termo de busca que você digitou. Você pode lsitar e escolher dentre todos os resultados compatíveis que ele encontrar usando:

texdoc -l < pct >

texdoc.net

texdoc.net é um website que funciona de forma similar ao texdoc. Você pode buscar a documentação que o site tem disponível assim como você faria com texdoc -l e escolher dentre os resultados.

CTAN

CTAN é a rede abrangente de arquivos TeX (Comprehensive TeX Archive Network). A maioria dos pacotes LaTeX são publicados lá. Você pode buscar no site por um pacote para acessar sua documentação. Geralmente os pacotes são salvos em ctan.org/pkg/<nome-pct> e você pode acessar o arquivo leia-me (README) e a documentação dos pacotes armazenados lá.

Livros sobre LaTeX

Há vários livros disponíveis que podem ajudar você a aprender sobre o LaTeX. Como um iniciante, você vai ganhar muito conhecimento de um guia estruturado para iniciantes, pois eles podem dar muito mais detalhes do que mostramos aqui. Você também pode querer acessar uma referência com mais detalhes e recomendações.

O time LaTeX tem uma lista de livros escrita em sua maioria pelos membros. Os mais notáveis são o guia oficial de Lamport e o abrangente LaTeX Companion.

Outros livros focados no aprendizado de LaTeX incluem:

Obtendo ajuda

Há vários fóruns online para fazer perguntas sobre o LaTeX; talvez o mais popular atualmente seja o TeX - LaTeX StackExchange. Sempre que você fizer uma pergunta, é melhor primeiro deixar o seu exemplo claro: o que é conhecido como um ‘exemplo funcional mínimo’ (‘minimal working example‘—MWE). Isso não significa que o código deve funcionar (você não estaria perguntando se estivesse), mas significa que você fez o seu melhor para deixar o exemplo claro e mínimo (que contém apenas o necessário para demonstrar o problema).

Como construir um MWE? Normalmente o mais fácil é começar de:

\documentclass{article}
\usepackage[T1]{fontenc}
\begin{document}
Text
\end{document}

e adicionar um trecho por vez até que o problema apareça. Você pode tentar ‘desmembrando’ seu arquivo, tirando partes não relacionadas ao problema, mas isso pode demorar.

Se você precisar mais texto para mostrar quebras de página ou outros efeitos, pacotes como lipsum podem ser usados para gerar texto de enchimento enquanto o código fonte continua pequeno.

Uma coisa que é bom que você tenha disponível é o log; esse arquivo é criado pelo LaTeX sempre que você o executa e tem o mesmo nome do seu arquivo principal mas com extensão .log. Dependendo da interface do seu computador, você pode precisar ativar ‘mostrar extensões’ para descobrir qual arquivo é o log.

Veja mais sobre este tópico
Próxima lição