Relatório 02 - Como fazer relatórios

---

1 Objetivo

Descrever sobre a criação de relatórios pelo RStudio:

• Instalação Git;
• Cadastro no GitHub;
• Instalar pacotes (no R);
• Estrutura base;
• Introdução ao RMarckdown;
• Sincronizar alterações;
• Página online do repositório;

2 Apresentação do relatório

Diante do objetivo do relatório apresentaremos nas próximas subseções, os pontos a serem discutidos.

2.1 Instalação do Git

• Instalar o Git

2.2 Cadastro no GitHub

• Para criar o cadastro, devemos acessar: (https://github.com/)

Clicar em Sign up

• Definir email e senha;
• Realizar as demais definições;

É importante lembrar que seu email e senha devem ser guardados e serem acessíveis.

2.3 Instalar pacotes (no R)

Podemos instlar os pacotes rmarkdown, knitr, tinytex, postcard via RStudio. Todas as instalações podem ser feitas de uma só vez da seguinte forma:

# "nomeando" os pacotes

pkgs <- c("rmarkdown", "knitr", "tinytex", "postcard")

# Para instalar

install.packages(pkgs)

Esses pacotes auxiliam na produção dos relatórios com suas funções, possibilitando criação de textos em HTML, compilações em LaTex e impressão em PDF, visualização de arquivos Markdown no R, entre outros. ## Estrutura base

• Usando o RStudio
  • Configure:
    • RStudio > Tools > Global Options… > Terminal > General > Shell > New Terminal open with: Git Bash > Apply (Botão);
• Criar repositório no GitHub da seguinte forma: (ACRESCENTAR)
• Criar https desse repositório:
  • Entre no repositório > Procure o botão “Code” > Copie o HTTPS . Se considerarmos o nome do repositório como “discestcomp”: (https://anaf08.github.io/discestcomp/)
  • Clone o repositório em:
    • File > New Project… > Version Control > Git > Repository URL > insira o https do repositório Git;
    • Escolher o diretório onde o repositório será clonado no computador em: “Create project as subdirectory of:”. Lembre-se de escolher diretórios (pastas) com nomes sem acento, com espaços.

2.4 Introdução a RMarckdown

• Para escrever em itálico: (*itálico*) itálico;
• Para escrever em negrito: (**negrito** ou __negrito__) Negrito;
• Inserir link: [inserir aqui uma nomenclatura ou anotação referente ao link](nome_imagem);
• Inserir imagens: ![nomenclatura ou anotação](link);
  • Para aumentar ou diminuir a imagem, basta colocar ao final: {width=xx%};
• Nota de rodapé: Ana Flavia^[Aluna de Engenharia Civil da UFSJ];

2.5 Sincronizar alterações

• Pela aba do Terminaç Studio:
  • git add . : Adcionar alterações localmente;
  • git commit -m "...": Comentar;
  • git push: Enviar ao repositório as alterações;
  • Para tudo isso ser feito, inserimos na ordem:

   $ git add .
   $ git commit -m "comentario"
   $ git push

Outra maneira de fazermo esses passos é no próprio GitHub, no terceiro quadrante, opção Git e logo depois no botão Commit(Passo 1).Abrirá uma nova janela e no lado esquerdo os arquivos que foram alterados, você deve selcionar aqueles que deseja subir para o GitHub, teremos um espaço ” commit message ” para fazer o comentário. Clicar no botão Commit e depois em Push(Passo 2), finalizado !!!

• 

  Passo 1

• 

  Passo 2

2.6 Página online do repositório

Com seu GitHub aberto, vamos seguir o seguinte passo a passo:

• Settings > Pages > Select Bench:main > Select Folder:root > SAVE > adicionar seu nome (ex: https://anaf08.github.io/discestcomp/);

É importante lembrar que o arquivo será um HTML e devemos salva-lo com index, caso contrário drá erro.