Limarka com Docker

Utilizando o limarka através de um container

A utilização do limarka através do docker possui as seguintes vantagens:

• Possibilita instalação isolada.
• Não causa conflitos de dependências.
• Melhor desempenho que máquina virtual.
• Remover a aplicação consiste apenas em remover a imagem do limarka.

Instalação do Docker

O método de Instalação do Docker depende do seu sistema operacional.

Ubuntu: Para instalar o Docker Community Edition no Ubuntu siga essas instruções. Certifique-se de realizar essas configurações após a instalação.

Digite o comando a seguir para baixar a imagem do limarka e aguarde o download:

docker pull limarka/limarka

Verifique o tamanho da imagem do limarka:

$ docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
limarka             custom              69df204e77d5        15 hours ago        794MB
limarka/limarka     latest              dc1454c894c4        15 hours ago        793MB
ruby                2-slim              3adca3f881c0        11 days ago         126MB

Para testar o limarka digite: docker run limarka/limarka --version

$ docker run limarka/limarka --version
limarka 1.0.2
pandoc 2.5
(...)
pdftk 2.02 a Handy Tool for Manipulating PDF Documents
Latexmk, John Collins, 25 October 2018. Version 4.61
XeTeX 3.14159265-2.6-0.99999 (TeX Live 2018)
kpathsea version 6.3.0

Gerando uma imagem customizada

A imagem docker do limarka vem com o TinyTex (uma distribuição mínima do LaTeX) e alguns pacotes básicos para compilação do modelo baseado no abntex2. Esta imagem é suficiente para gerar a maioria dos trabalhos.

Para verificar os pacotes disponíveis na imagem do limarka digite:

$ docker run --entrypoint=tlmgr limarka/limarka list --only-installed \
  | tr -d ':' | cut -f 2 -d ' ' | column
abntex2				hyperref			metafont.x86_64-linux
amscls				hyphen-base			mfware
amsfonts			ifetex				mfware.x86_64-linux
amsmath				ifluatex			microtype
babel				iftex				natbib
babel-portuges			ifxetex				oberdiek
bibtex				inconsolata			pdfpages
bibtex.x86_64-linux		knuth-lib			pdftex
booktabs			kpathsea			pdftex.x86_64-linux
caption				kpathsea.x86_64-linux		plain
cm				l3kernel			scheme-infraonly
dehyph				l3packages			tetex
dvipdfmx			lastpage			tetex.x86_64-linux
dvipdfmx.x86_64-linux		latex				tex
dvips				latex-bin			tex-ini-files
dvips.x86_64-linux		latex-bin.x86_64-linux		tex.x86_64-linux
ec				latex-fonts			texlive.infra
enumitem			latexconfig			texlive.infra.x86_64-linux
eso-pic				latexmk				textcase
etex				latexmk.x86_64-linux		times
etoolbox			lipsum				tipa
euenc				listings			titling
fancyvrb			lm				tools
fontspec			lualibs				unicode-data
framed				luaotfload			upquote
geometry			luaotfload.x86_64-linux		url
glyphlist			luatex				xcolor
graphics			luatex.x86_64-linux		xetex
graphics-cfg			makeindex			xetex.x86_64-linux
graphics-def			makeindex.x86_64-linux		xetexconfig
gsftopk				mathspec			xkeyval
gsftopk.x86_64-linux		memoir				xunicode
helvetic			metafont			zapfding

mas você não está limitado a ela.

Nossa solução para possibilitar utilização de outros pacotes LaTeX é a geração uma imagem customizada com o Limarka. Por exemplo, o pacote subfig possibilita inserir figuras uma a lado da outra ou em mosaico, como mostrado a seguir:

Para instalar novos pacotes do LaTeX

esses pacotespara destravar o potencial do LaTeX

Configure um alias para executar o limarka através do docker

Adicione a seguinte linha ao arquivo ~/.bash_aliases

alias limarka='docker run --mount src=`pwd`,target=/trabalho,type=bind limarka/limarka $@'

NOTE: Feche o terminal e abra novamente para o alias poder funcionar.

Entendendo o comando

Dentro do docker, para o limarka ter acesso aos arquivos do computador é necessário montar o volume /trabalho com o diretório do seu trabalho.

Editores de texto Markdown

Mesmo utilizando um container docker, você precisará de um editor de texto para editar os arquivos Markdown. Consulte as demais páginas de instalação (no canto direito) para instalar um editor de texto.

Baixando e descompactando o modelo

A próxima seção explicará como baixar um modelo, mas lembre-se que a execução do limarka no container será necessário montar o diretório do modelo no volume /trabalho.