View on GitHub

Begin-Latex-in-minutes

馃摐 Brief Intro to LaTeX for beginners that helps you use LaTeX with ease.

English涓枃Espa帽ol 路 Portugu锚s 路 Fran莽ais袪褍褋褋泻懈泄Deutsch鏃ユ湰瑾Polski


Comece com o LaTeX em minutos

(Portuguese translator鈥檚 acknowledgement: I tried to translate this guide as the original meaning of the author as much as i could. If you think the translation is inappropriate, please feel free to modify it or add missing stuff you think would make this guide better. If you like this guide, please share to more people.)

Aviso: Todo conte煤do escrito abaixo 茅 de minha pr贸pria experi锚ncia na faculdade e da leitura de diversos materiais. Eu n茫o sou nem professional nem especialista, mas um estudante com uma grande paix茫o pela linguagem. Qualquer um pode abrir uma discuss茫o na se莽茫o issue, ou um pull request no caso de algo que deve ser modificado ou adicionado. Se voc锚 considera meu trabalho valioso, uma doa莽茫o 茅 muito apreciada.

Tabela de Conte煤dos

O que 茅 LaTex?

LaTeX, que 茅 pronunciado 芦Lah-tech禄 ou 芦Lay-tech禄 (para rimar com 芦blech禄), 茅 um sistema de prepara莽茫o de documentos para a tipografia de alta qualidade. 脡 usado geralmente para documentos t茅cnicos ou cientif铆cos, m茅dios ou grandes, mas tamb茅m pode ser usado para quase todas as formas de publica莽茫o.

Por qu锚 usar LaTeX?

LaTeX n茫o vem sem incovenientes, mas ainda vale a pena aprend锚-lo.

Configurar LaTeX

Precisar谩s do seguinte:

  1. Uma distribui莽茫o LaTeX. Eu estou usando MiKTeX para Windows.
  2. Um editor LaTeX. Eu estou usando TeXMaker para facilitar a edi莽茫o, embora qualquer editor de texto possa criar ou modificar um arquivo LaTeX.
  3. Um visualizador de PDF. (opcional) Qualquer visualizador de pdf servir谩. Isto ser谩 usado para que voc锚 veja o resultado de seu trabalho.

Ademais, voc锚 precisa escolher um compilador. O compilador padr茫o para maioria dos editores 茅 o pdfLateX, mas se voc锚 precisar de suporte para as fontes TTF/OTF do seu sistema, use LuaLateX.

Tamb茅m 茅 poss铆vel escolher uma solu莽茫o online como ShareLaTeX. Por favor olhe nas Ferramentas adicionais para uma ampla variedade de op莽玫es.

Primeiro Arquivo LaTeX

Vamos fazer o famoso Hello World no LaTeX. Se voc锚 j谩 tem instalado o TexMaker, primeiro crie um novo arquivo com a extens茫o .tex. Ent茫o digite o seguinte c贸digo abaixo para renderizar o 鈥淗ello World!鈥 e pressione o bot茫o de 鈥渃onstru莽茫o r谩pida鈥. Para outros editores LaTeX, deve ser f谩cil seguir o mesmo procedimento.

\documentclass[a4paper]{article}

\begin{document}

Hello World !  % Este 茅 o seu conte煤do

\end{document}

Voc锚 deve ver isso no TexMaker:

Um olhar mais profundo

:eyes: Um olhar mais profundo sobre seu primeiro arquivo LaTeX mostra que :

:zap: Aten莽茫o :zap:

Uso multil铆ngue

Algumas linguagens ou idiomas n茫o funcionar茫o de imediato(como 茅 o caso do portugu锚s com seus acentos). Para usar o LaTeX com outras linguagens, temos algumas op莽玫es:

:white_check_mark: Primeiro m茅todo :white_check_mark:

O primeiro m茅todo est谩 incluindo 鈥減acotes鈥 (Voc锚 ir谩 aprender sobre isso depois) porque o compilador padr茫o do pdfLaTeX, est谩 limitado 脿 256 caracteres e v谩rios problemas de codifica莽茫o. Por exemplo:

\documentclass[a4paper]{article}

\usepackage[T5]{fontenc}
\usepackage[utf8]{inputenc}

\begin{document}

Xin ch脿o th岷 gi峄沬. This is Hello World in Vietnamese.

\end{document}

Aqui n贸s usamos os pacotes usepackage[T5]{fontenc} e usepackage[utf8]{inputenc} . Isso 茅 realmente simples de entender, o pacote ir谩 importar a codifica莽茫o das fontes para exibir seu conte煤do corretamente. Se voc锚 est谩 usando TexMaker o codigo anterior ser谩 exibido da seguinte maneira:

vs sem os pacotes :package::

:umbrella: Uma situa莽茫o complicada 茅 lidar com caractere Chin锚s-Japon锚s-Koreano. Aqui, usepackage{CJKutf8} com\begin{CJK}{UTF8} e \end{CJK} s茫o bastante 煤teis. Aqui est谩 um exemplo da forma de escrever em Japon锚s :jp: :

\documentclass[a4paper]{article}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{min}
銇撱伄瑷樹簨銈掕銈撱仹銇勩仧銇犮亶銇傘倞銇屻仺銇嗐仈銇栥亜銇俱仚銆
%Thank you for reading this article.
\end{CJK} 

\end{document}

T茫o f谩cil quanto comer :sushi: e :bento: :

:white_check_mark: Segundo m茅todo :white_check_mark:

Outro m茅todo vi谩vel 茅 se voc锚 mudar seu compilador TeX para LuaLaTeX (ou XeLaTeX). Usando fontspec e polyglossia, o Unicode ir谩 funcionar corretamente:

\documentclass[a4paper]{article}

\usepackage{fontspec}
\usepackage{polyglossia}
%\setmainfont[]{DejaVu Serif}

\begin{document}

Xin ch脿o th岷 gi峄沬. This is Hello World in Vietnamese.

\end{document}

A fonte padr茫o (Latin Modern) n茫o suporta todos os caracteres. Voc锚 pode, no entanto, usar qualquer outra fonte instalada no seu sistema descomentando a linha \setmainfont. ( As fontes TTF e OTF s茫o totalmente suportadas).

Listas

:straight_ruler: 脡 muito importante organizar bem o seu documento. Ent茫o, vamos come莽ar a colocar seus itens em uma lista.
Dois tipos de listas s茫o comuns n茫o ordenadas e ordernadas. Cada uma pode ser f谩cilmente manipulada em um documento LaTeX :

Aqui est茫o, como os dois tipos de lista s茫o exibidos na sa铆da:

Paragr谩fo e se莽茫o

:blue_book: N贸s iniciamos uma se莽茫o com \section e um paragr谩fo com \paragraph . :orange_book: Voc锚 tamb茅m pode adicionar uma subse莽茫o com \subsection e um subparagr谩fo com \subparagraph

Fazendo uma tabela de conte煤dos

:metal: 脡 煤til para abrir se莽玫es e subse莽玫es com uma \tableofcontents

Exemplo:

:bangbang: Dica : Voc锚 pode usar \newpage se voc锚 quiser criar uma nova p谩gina.

Notas de rodap茅

脡 extremamente f谩cil usar footnote+label+ref para fazer todos os tipos de notas de rodap茅 que voc锚 queira. Por exemplo:

Hi let me introduce myself\footnote{\label{myfootnote}Hello footnote}.
... (later on)
I'm referring to myself \ref{myfootnote}.

:point_down: :point_down: Podes v锚-lo ? :point_down: :point_down:

:bangbang: Dica : Voc锚 pode usar \newline para fazer uma nova linha.

O que 茅 um pacote?

LaTeX oferece uma gama de fun莽玫es por padr茫o, mas em algumas situa莽玫es pode ser 煤til utilizar os chamados pacotes. Para importar um pacote no LaTeX, voc锚 simplesmente adiciona \usepackage :package:

Aqui est谩 um exemplo de como usar dois pacotes para exibir express玫es matem谩ticas:

Mais 茅pico 茅 como os circuitos s茫o exibidos:

:construction: Voc锚 deve pesquisar mais no google se voc锚 quiser um pacote que atenda a sua exig锚ncia. Por exemplo, amsmath 茅 amplamente usado para escrever express玫es matem谩ticas, circuitikz 茅 para o desenho de circuits, etc..Explicar todos seria imposs铆vel neste tutorial.

Tabela

Um exemplo pr谩tico :thought_balloon: :

\begin{table}[h!]
  \centering
  \caption{Caption for the table.}
  \label{tab:table1}
  \begin{tabular}{l|c||r}
    1 & 2 & 3\\
    \hline
    a & b & c\\
  \end{tabular}
\end{table}

:star2: Isto 茅 o que ser谩 renderizado :star2: :

Vejamos detalhadamente :eyes: :

:bangbang: Dica Voc锚 pode usar um pacote :package: chamado booktabs \usepackage{booktabs} para uma visualiza莽茫o melhor da tabela.

Adicionando imagens

Para adicionar um arquivo de imagem ao LaTeX, voc锚 precisa usar um ambiente de figuras e o pacote graphicx.

\begin{figure}
  \includegraphics[width=\linewidth]{filename.jpg}
  \caption{What is it about?}
  \label{fig:whateverlabel}
\end{figure}

:bangbang: Dica: Coloque [width=\linewidth] para dimensionar a imagem para o tamanho do documento. Se voc锚 quiser que a imagem seja flutuante, ent茫o voc锚 precisa atribuir ao 铆nicio um certo valor. Tamb茅m, fig 茅 para tornar dispon铆vel uma refer锚ncia da imagem em um uso posterior.

\begin{figure}[h!]

:passport_control: Os valores aceitos s茫o :

Aqui est谩 a imagem que ser谩 renderizada :

Insira c贸digo no LaTeX

:white_check_mark: Primeiro m茅todo :white_check_mark:

Um aspecto da compila莽茫o de texto 茅 que ela 茅 muito importante para programadores e desenvolvedores, 茅 como profissionalmente se insere c贸digo em um documento. Para LaTeX, o processo 茅 simples e muito profissional. N贸s apenas envolvemos o c贸digo com algum conte煤do pr茅-definido.

Example :

\documentclass[a4paper]{article}

\begin{document}

Hello world!

\begin{verbatim}
#include <iostream>

int main()
{
	std::cout << "hello world!\n";
	return 0;
}
\end{verbatim}

\end{document}

:speech_balloon: LaTeX suporta sintaxe para essas linguagens :speech_balloon:

Como voc锚 pode ver, com o {verbatim} voc锚 pode f谩cilmente inserir c贸digo sem se preocupar em como a sintaxe ir谩 ser formatada. Aqui est谩 como ser谩 exibida, limpo e profissional :

:white_check_mark: :white_check_mark: Segundo M茅todo :white_check_mark: :white_check_mark:

Esse m茅todo d谩 a voc锚 mais op莽玫es, incluindo inserir c贸digo inline, fazer estilos pr贸prios de c贸digo, escolher uma linguagem espec铆fica para o c贸digo, importar c贸digo de outro arquivo em um mesmo diret贸rio鈥. Com este m茅todo, voc锚 n茫o usa {verbatim} , mas inclue um pacote :package: chamado listings.

Considere o seguinte exemplo :

\documentclass[a4paper]{article}

\usepackage{listings}
\usepackage{color}

\lstdefinestyle{mystyle}{
keywordstyle=\color{magenta},
backgroundcolor=\color{yellow},
commentstyle=\color{green},
basicstyle=\footnotesize,
}
\lstset{style=mystyle}

\begin{document}


Hello world!

\begin{lstlisting}[language=Python]

print "Hello World!"

\end{lstlisting}

\lstinputlisting[language=C++]{hello.cpp}

Lorem ipsum dolor sit amet \lstinline{print "Hello World"} , consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.


\end{document}

Aqui podemos observar:

  1. Para inserir um bloco de c贸digo , inicia-se com \begin{lstlisting} e finaliza-se com \end{lstlisting}
  2. Para importar o c贸digo de um arquivo em um mesmo diret贸rio, voc锚 pode usar lstinputlisiting{name_of_file}
  3. Para especificar uma linguagem, use [language=C++]
  4. Para inserir c贸digo inline, use \lstinline
  5. Para aplicar estilos pr贸pios, use o \usepackage{color} e defina seu pr贸prio estilo ent茫o defina uma lista com seu pr贸prio tema (Por favor veja o c贸digo abaixo). Voc锚 pode modificar v谩rias coisas com seu pr贸prio estilo, mas voc锚 precisa ler a documenta莽茫o para saber que propriedade modificar.
  6. Interessado ?? Mais Aqui.

Aqui est谩 como o c贸digo acima compila no TexMaker :

V谩rios arquivos no LaTeX

Quando n贸s usamos LaTeX, n贸s podemos ter problemas de gerenciamento quando um documento 茅 muito grande. No entanto, n贸s podemos devemos dividir o arquivo de forma que o conte煤do se torne mais f谩cil de manipular.

Vejamos um exemplo:

% main.tex
\documentclass[a4paper]{article}

\begin{document}

Hello Latex, This is my first part.

Hello Latex, This is my second part.

\end{document}

脡 apenas um arquivo LaTeX normal. Agora, vamos dividir o documento em duas partes usando o comando \input keyword:

% main.tex
\documentclass[a4paper]{article}

\begin{document}

Hello Latex, This is my first part.

\input{second_file}

\end{document}
% second_file.tex
Hello Latex, This is my second part.

Agora o arquivo principal 茅 diferente, mas melhor documentado e mais leg铆vel. Aqui est谩 o resultado no TexMaker:

multi_file.png

:bangbang: Dica : Para legibilidade, clareza e manuten莽茫o, 茅 muito recomendado que voc锚 divida seu arquivo principal sistematicamente, hierarquicamente e cientifcamente. N茫o divida sem raz玫es ou voc锚 ter谩 uma bagun莽a depois.

Ferramentas Adicionais

Distribui莽玫es

Editores LaTeX

Compiladores LaTeX

HOORAY !!

:tada: Obrigado por completar este tutorial. Isso 茅 basicamente tudo que voc锚 precisa saber sobre LaTeX. :hammer:
Se voc锚 est谩 muito interessado, mais informa莽玫es do LaTeX podem ser encontradas aqui ou em toda web, dependendo do que voc锚 precisa.

Licen莽a

LICEN脟A P脷BLICA PARA FAZER O QUE LHE AGRADA
Copyright (C) 2016 Luong Vo
脡 permitida a c贸pia e distribui莽茫o de c贸pias literais ou modificadas deste documento de licen莽a, e a modifica莽茫o 茅 permitida desde que o nome seja alterado. (Alterar 茅 permitido enquanto o nome for alterado).
TERMOS E CONDI脟脮ES DE C脫PIA, DISTRIBUI脟脙O E MODIFICA脟脙O: Claro, FA脟A O QUE LHE AGRADA.

Uma cerveja no seu pa铆s pode comprar uma refei莽茫o no meu.