Instalação de programas

Este capítulo fornece instruções sobre como instalar os programas necessários para se trabalhar com o Rmarkdown. Em primeiro lugar, é necessário ter o ambiente R instalado. Em seguida, necessitamos de um ambiente de desenvolvimento integrado (do inglês Integrated Development Environment, IDE; acesse este link para saber o que é um IDE e quais as vantagens de se utilizá-lo), que será onde o usuário poderá escrever seus textos. Também deve-se instalar um ambiente LaTeX para poder gerar arquivos em formato pdf, e, por fim, deve-se instalar um organizador de bibliografias, JabRef, para lidar com arquivos em formato bib (veja aqui o que é um arquivo bib).

Objetivos de aprendizado

  • Instalar o R e pacotes necessários
  • Instalar o Rtools
  • Instalar distribuição LaTeX
  • Instalar um IDE
  • Instalar um organizador de bibliografias
Dica de OURO!

Usuários Windows, sugiro fortemente que vocês busquem a configuração do sistema para ativar a VISUALIZAÇÃO DE EXTENSÕES DE ARQUIVOS O que é isso???
Isso significa poder ver no Explorador de arquivos que tipo de arquivo você está observando. Por exemplo, arquivos do programa Word terminam geralmente ou em .doc ou em .docx; arquivos Excel, .xlsx; arquivos Rmarkdown, .rmd, e assim por diante. Caso vocês não saibam como ativar essa opção, leiam como fazer neste endereço: https://support.microsoft.com/pt-br/windows/extens%C3%B5es-de-nome-de-arquivo-comuns-no-windows-da4a4430-8e76-89c5-59f7-1cdbbc75cb01.

R

Acesse o sítio https://www.r-project.org/ (Figura 1.1). A depender do seu sistema operacional (SO), há maneiras diferentes de se instalar o R.

Figura 1.1: Página inicial do sítio de instalação do ambiente R: https://www.r-project.org/.
  1. Windows:
    • Acesse o site CRAN e clique no link para baixar a versão mais recente do R para Windows.
    • Execute o instalador baixado e siga as instruções do assistente de instalação.
  2. Mac OS X:
    • Vá para o site CRAN e baixe o instalador para a versão mais recente do R para Mac OS X.
    • Abra o arquivo baixado e siga as instruções do assistente de instalação.
  3. Linux:
    • Dependendo da sua distribuição Linux, você pode instalar o R usando o gerenciador de pacotes. Por exemplo, para Ubuntu, você pode usar o comando sudo apt-get install r-base.
    • Consulte a documentação específica da sua distribuição para obter instruções detalhadas.

Pacotes R necessários

Os pacotes R abaixo (veja este capítulo do livro Curso básico de introdução à linguagem R para entender o que são pacotes de R) são necessários para podermos compilar os diferentes formatos a serem trabalhados na disciplina. Uma vez que o usuário tenha o R instalado, abra o ambiente R e execute os comandos abaixo, um a um:

install.packages("rmarkdown") # Mais importante
install.packages("blogdown") # Blogs
install.packages("bookdown") # Livros, teses e afins
install.packages("xaringan") # Apresentações
install.packages("officer") # Produtos Word, Powerpoint, Excel

Rtools para usuários Windows

Em teoria, não deveria ser necessário instalar o Rtools, um conjunto de ferramentas para compilar pacotes R do código fonte (os pacotes geralmente são instalados a partir do arquivo já compilado, o chamado arquivo binário). Porém, já vi pessoas tendo problemas para fazer o Rmarkdown funcionar em função de não conseguirem instalar o pacote stringi no Windows. Por isso, aos usuários Windows, recomendo a instalação do Rtools.

Para instalar o Rtools, siga o procedimento abaixo:

  1. Na página de instalação do Windows por meio do sítio https://www.r-project.org/, você verá a opção Rtools como última opção. Clique nesse nome (Figura 1.2).
Figura 1.2: Veja a opção Rtools com destaque em azul circundando o nome. Esta é a tela de instalação do R para usuários Windows.
  1. Em seguida, uma nova tela aparece e lá você deve escolher a versão do Rtools em função da sua versão de R. Se o R que você possui é a versão 4.4.x, instale o Rtools 4.4; se é a versão 4.3, instale o Rtools 4.3; e assim sucessivamente (Figura 1.3).
Figura 1.3: Tela de escolha da versão do Rtools a ser instalado.
  1. Após escolher a versão do Rtools, selecione agora o instalador. Selecione a opção destacada na Figura 1.4.
Figura 1.4: Instalador do Rtools a ser utilizado, com destaque na cor verde abaixo da opção sugerida.
  1. Após baixar o instalador do Rtools, execute o arquivo e siga as instruções do assistente de instalação.

Distribuição LaTeX

Para poder gerar um arquivo PDF, é necessário possuir uma distribuição LaTeX no seu sistema. A maneira mais fácil de ter uma distribuição LateX atualmente é por meio da instalação do pacote R tinytex (Xie 2019). Uma vez que o usuário tenha o R instalado, execute os comandos abaixo para poder instalar o pacote e, em seguida, usar a função tinytex::install_tinytex() para instalar o LaTeX localmente. Siga as instruções da tela.

install.packages('tinytex')
tinytex::install_tinytex()

Ambiente de desenvolvimento integrado - IDE

Recomenda-se que o IDE RStudio seja instalado no seu computador, pois ele melhora a experiência da interação do usuário com os múltiplos recursos oferecidos pela linguagem Rmarkdown, em especial os inúmeros pacotes desenvolvidos por funcionários desta empresa, os pacotes rmarkdown e bookdown. Ademais, IDEs como este software têm o objetivo de prover ao usuário mais ferramentas na interação entre o código e o resultado da execução do código, além de facilitar o uso de ferramentas alternativas para construção de texto mesclado com códigos (e.g., LaTeX, Markdown etc), o que permite uma dinamicidade na construção de textos acadêmicos.

  1. Acesse o site da RStudio (Figura 1.5) e baixe a versão mais recente do RStudio Desktop para o seu sistema operacional;

  2. Execute o instalador baixado e siga as instruções do assistente de instalação.

Figura 1.5: Página inicial do sítio de instalação do RStudio: https://posit.co/download/rstudio-desktop/.

Existem outras alternativas de IDE. Fique à vontade para escolher. Listo algumas alternativas abaixo:

Organizador de bibliografias

Existem vários organizadores de bibliografia. Eu utilizo o JabRef. Caso você já faça uso de um e consiga gerar arquivos bib, ótimo. Prossiga nele!

Caso ainda não tenha, sugiro que instale o JabRef, seguindo os passos abaixo:

  1. Visite o site do JabRef (Figura 1.6) e baixe a versão mais recente para o seu sistema operacional;

  2. Após o download, execute o instalador e siga as instruções do assistente para concluir a instalação.

Figura 1.6: Página inicial do sítio de instalação do JabRef: https://www.jabref.org/#downloads.

Pandoc

Aviso

Caso o usuário tenha optado por utilizar um IDE diferente do RStudio, será necessária a instalação do Pandoc.

  1. Visite o site oficial do Pandoc (Figura 1.7) e encontre as instruções de instalação específicas para o seu sistema operacional;

  2. Siga as instruções fornecidas para baixar e instalar o Pandoc em seu sistema.

Figura 1.7: Página inicial do sítio de instalação do Pandoc: https://pandoc.org/installing.html.

Verificação da instalação

Após a conclusão das instalações, você pode verificar se já está apto a escrever em Rmd se o procedimento abaixo funcionar. Caso não funcione, cheque se o passo a passo acima foi seguido corretamente, cheque as mensagens que o computador informa. E se ainda assim não obtiver sucesso, entre em contato comigo que tentarei ajudar. Ou busque ajuda com um amigo ou com o Google.

  1. Abra o RStudio e crie um novo arquivo Rmd (siga as instruções aqui presentes).

  2. Uma tela será aberta e lá você poderá incluir o nome do autor, título do arquivo e tipo de produto desejado (HTML, PDF ou WORD).

  3. Salve o arquivo e o compile (para compilar um Rmd, siga essas instruções).

Se você gerar o arquivo HTML, PDF ou WORD, a depender do que você selecionou, então está tudo certo, podemos prosseguir para os próximos capítulos. Agora você está pronto para começar a utilizar essa ferramenta para criar documentos e aproveitar ao máximo a análise de dados e a geração de relatórios.