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’s 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 “Hello World!” e pressione o botão de “construçã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 “pacotes” (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ới. 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ới. 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.