Instalação no Linux

Atualmente a utilização do limarka através do docker é a alternativa mais fácil e recomendada, experimente ela antes!

A seguir estão as instruções da instalação do limarka no Linux.

Dependências (instalação no sistema)

OBS para usuários do Ubuntu 18.04: O pacote pdftk está faltando no repositório oficial. Uma alternativa é adicionar um repositório que contém um fork do pacote: sudo add-apt-repository ppa:malteworld/ppa, atualizar as dependências sudo apt update e continuar com uma das opções abaixo. Pretendemos no futuro não precisar mais dele.

OBS para usuários do Linux Mint 19.2: O pacote build-essential não está pré-instalado na distribuição. Para instalar a dependência execute o comando sudo apt install build-essential para a instalação do limarka ocorrer sem erros.

pandoc

OBS: Deve-se instalar a última versão do pandoc manualmente. Não utilize a da sua distribuição pois pode está desatualizada.

Vá para a página de releases do pandoc e baixe a última versão e instale. Exemplo:

wget https://github.com/jgm/pandoc/releases/download/2.5/pandoc-2.5-1-amd64.deb
sudo dpkg -i pandoc-*.deb

Instalação do Latex

Temos duas alternativas para instalação do Latex:

• TinyTeX (183 mb)
• texlive (4 GB)

Escolha uma delas para instalar.

Alternativa 1: Instalação com o TinyTeX (menor)

O TinyTeX é a versão do Latex utilizada internamente nos testes do limarka desde 2019. Para instalá-lo, junto com os demais pacotes necessários do limarka execute:

wget -qO- "https://raw.githubusercontent.com/abntex/limarka/master/bin/install-latex.sh" | sh

Instale as demais dependências:

sudo apt-get install ruby-full pdftk poppler-utils xclip make gcc

NOTE: TinyTeX é instalado em ~/.TinyTeX e em ~/bin. Certifique-se que ~/bin esteja no seu PATH (echo $PATH).

Próximo passo: instalar o limarka

Alternativa 2: Instalação com o texlive (maior e mais completa)

OBS: A instalação do texlive (completo ou essencial) costuma demorar vários minutos, ou até horas, dependendo da sua conexão com a internet. A vantagem é que você não terá erros caso deseje utilizar pacotes não instalados previamente.

Para instalar as dependências do limarka com o texlive completo (4 GB) abra um terminal e execute nele:

sudo apt-get install ruby-full pdftk poppler-utils xclip latexmk texlive-full make gcc

Para instalar as dependências do limarka com o texlive essencial abra um terminal e execute nele:

sudo apt-get install ruby-full pdftk poppler-utils xclip latexmk texlive texlive-publishers texlive-lang-portuguese texlive-latex-extra texlive-fonts-recommended texlive-xetex make gcc

Próximo passo: instalar o limarka

Arch Linux

No arch linux o processo é um pouco diferente. É preciso duas etapas: uma com pacotes no repositório oficial e outra com o repositório da comunidade (AUR).

1. Instalando pacotes do repositório oficial:

   sudo pacman -S ruby pandoc poppler xclip texlive-core texlive-bin texlive-latexextra

2. Instalando pacotes do AUR (repositório da comunidade):

   yaourt -S pdftk-bin abntex2

OBS: Utilizamos o gerenciador de pacotes yaourt apenas como um exemplo. Sobre pacotes AUR, leia a documentação do Arch Linux.

OBS: Recomenda-se utilizar o pacote pdftk-bin ao invés do pdftk, pois tem a compilação mais rápida e atende às necessidades do Limarka.

Ubuntu 17.10.1

Foi notificado que nesse sistema as bibliotecas libffi6 libffi-dev também são necessárias para compilação.

Limarka

Checando dependências

Antes de prosseguir, certifique-se que todas as dependências estão instaladas:

pandoc --version
xelatex --version 
latexmk --version
pdftk --version 
ruby --version

Instalando o limarka

Para instalar o limarka digite em um terminal:

sudo gem install limarka

NOTE: Este é o mesmo comando para atualizar o limarka, caso possua uma versão anterior instalada.

Versão em desenvolvimento

Para utilizar a versão em desenvolvimento do limarka adicione --pre na instalação:

sudo gem install limarka --pre

Verificando instalação

$ limarka check
OK.
$ limarka --version
limarka 1.0.1
pandoc 2.5
Compiled with pandoc-types 1.17.5.4, texmath 0.11.1.2, skylighting 0.7.4
Default user data directory: /home/eduardo/.pandoc
Copyright (C) 2006-2018 John MacFarlane
Web:  http://pandoc.org
This is free software; see the source for copying conditions.
There is no warranty, not even for merchantability or fitness
for a particular purpose.
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]

pdftk 2.02 a Handy Tool for Manipulating PDF Documents
Copyright (c) 2003-13 Steward and Lee, LLC - Please Visit: www.pdftk.com
This is free software; see the source code for copying conditions. There is
NO warranty, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Latexmk, John Collins, 25 October 2018. Version 4.61
XeTeX 3.14159265-2.6-0.99999 (TeX Live 2018)
kpathsea version 6.3.0
Copyright 2018 SIL International, Jonathan Kew and Khaled Hosny.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the XeTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the XeTeX source.
Primary author of XeTeX: Jonathan Kew.
Compiled with ICU version 61.1; using 61.1
Compiled with zlib version 1.2.11; using 1.2.11
Compiled with FreeType2 version 2.9.0; using 2.9.0
Compiled with Graphite2 version 1.3.11; using 1.3.11
Compiled with HarfBuzz version 1.7.6; using 1.7.6
Compiled with libpng version 1.6.34; using 1.6.34
Compiled with poppler version 0.63.0
Compiled with fontconfig version 2.11.0; using 2.11.94

As versões mostradas provavelmente serão diferentes das suas, mas certifique-se que elas atendem as configurações mínimas.

Incompatibilidade do pandoc

$ limarka check
Traceback (most recent call last):
	11: from /home/eduardo/.rvm/gems/ruby-2.5.1/bin/ruby_executable_hooks:15:in `<main>'
	10: from /home/eduardo/.rvm/gems/ruby-2.5.1/bin/ruby_executable_hooks:15:in `eval'
	 9: from /home/eduardo/.rvm/gems/ruby-2.5.1/bin/limarka:23:in `<main>'
	 8: from /home/eduardo/.rvm/gems/ruby-2.5.1/bin/limarka:23:in `load'
	 7: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/limarka-0.8.0/exe/limarka:10:in `<top (required)>'
	 6: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/thor-0.20.0/lib/thor/base.rb:466:in `start'
	 5: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/thor-0.20.0/lib/thor.rb:387:in `dispatch'
	 4: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/thor-0.20.0/lib/thor/invocation.rb:126:in `invoke_command'
	 3: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/thor-0.20.0/lib/thor/command.rb:27:in `run'
	 2: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/limarka-0.8.0/lib/limarka/cli.rb:30:in `check'
	 1: from /home/eduardo/.rvm/gems/ruby-2.5.1/gems/limarka-0.8.0/lib/limarka/check.rb:23:in `check'
/home/eduardo/.rvm/gems/ruby-2.5.1/gems/limarka-0.8.0/lib/limarka/check.rb:33:in `verifica_compatibilidade': Versão incompatível do pandoc. Versão compatível: 1.19.1 <= Versão < 2.0.0 (Limarka::VersaoIncompativelError)

Caso a versão do pandoc não for compatível, você poderá ver o erro acima. Instale a versão apropriada e tudo funcionará.

Editores de texto

O linux possui vários editores de texto que podem ser utilizados:

• gedit com plugins (no Ubuntu a instalação vem sem os plugins)
• emacs, com markdown-mode e flyspell é fantástico.
• vim
• sublime
• atom (possui corretor ortográfico para português a partir da versão 1.37.0-beta)

Editores de referências

Escolha apenas um desses:

• JabRef, siga as instruções dessa página para instalar e configurar o JabRef para utilização com o limarka (em conjunto com o abnTeX2).

    sudo apt-get install jabref
  

• Mendeley: não é um editor, mas é capaz de exportar as referências para o formato bibtex, utilizado pelo limarka.

• Docear: é um suite de pesquisa, recomendado apenas para usuários com bastante afinidade com informática. Ele possui um JabRef incorporado dentro dele.

Leitores de PDF

O Evince, leitor de PDF padrão do Ubuntu, pode ser utilizado. Na realidade o limarka é intensivamente testado com ele.

Um leitor mais completo é o pdf-xchange-viewer, que pode ser instalado no Linux através do wine. É o leitor recomendado caso tenha optado por gerir as referências de sua pesquisa com o Docear.