Descrever passo a passo como construir o relatório no RStudio para o Github.
Para a contrução do relário, é necessário seguir os tópicos abaixo.
A seguir será apresentado quais passos devem ser seguidos antes do desenvolvimento do relatório.
O Git é um programa que identifica as mudanças realizadas em determinados arquivos e sincroniza tais alterações no modo online. Para realizar a instalação na máquina clique aqui.
O GitHub é um serviço baseado em nuvem que hospeda o sistema de controle Git. Por meio dele, é possível acompanhar qualquer alteração que o Git identificou e quem a efetuou, além de permitir a restauração do código removido ou modificado. Para ter acesso ao GitHub, basta entrar no site e criar uma conta seguindo os passos indicados.
O repositório é uma “pasta” dentro do GitHub onde é possível reunir todas as alterações sincronizadas pelo Git, permitindo um melhor gerenciamento de um determminado projeto. Para a criação do repositório, basta abrir sua conta no GitHub e ir em “Novo repositório”. A seguinte aba será aberta:
Nela é interessante nomear o repertório com seu nome de proprietário
e acrescentar github.io
para facilitar na utilização do
link futuramente gerado. Antes de concluir a criação, certifique-se que
a caixa Público
e Adicionar um arquivo README
estejam marcadas.
Após a criação do repositório, dentro da página criada, vá em
Código
e copie o link apresentado;
No RStudio:
Tools > Global Options… > Terminal >
New terminal open with
escolherGit Bash
File > New Project > Version Control > Git > o próximo passo está na imagem abaixo
Nesta aba, insira o link copiado do passo anterior, insira o nome igual ao repositório criado no GitHub e escolha a pasta dentro da sua máquina.
O relatório criado em RStudio nada mais é que a escrita em um programa que será traduzido para outras linguagens, de acordo com sua escolha.
Para sua criação é necessário seguir os passos abaixo:
File > New File > R Markdown… >
New R Markdown
Nesta nova janela, nomeie o arquivo de index
para
conseguir abri-lô como página diretamente pelo GitHub. Em
Default Output Format
permite escolher os formatos de saída
do texto, podendo gerar um HTML
, PDF
ou
Word
. Assim, o arquivo em Rmd
será aberto na
aba superior a esquerda do RStudio e está pronta para entrar em uso.
Acriação de um relátorio base irá proporcionar a funcionalidade de
unir todos os outros relatórios em uma única página na internet. Para
isso, basta usar a estrutura de anexar link a um texto e os relatórios
sejam todos salvos como index
, porém em pastas
diferentes.
Exemplo:
[Relatório xx (--/--/----)](relxx/index.html){target="_blank"}
Onde x
é o número do relatório no título e
relxx`` é o nome da pasta onde o
Rmd` foi salvo.
Após escrever o relatório, é necessário clicar em Knit
,
na opção to HTML
. Este passo irá mostrar como ficará a
página da web. Para enviar para o GitHub existem duas maneiras:
Git
>Commit
> seleciona tudo > faz o comentário >commit
>Push
.
$ git add .
$ git commit -m "comentário"
$ git push
Dentro do GitHub, após ter enviado o relatório seguindo um dos passos anteriores, no repositório clonado, vá em:
Settings
>Pages
> Publique a página.
Esses passos irá gerar o link de uma página, na qual é o relatório desenvolvido.
O relatório pode ser utilizado para criar uma página na internet contendo por exemplo: estudos, explicações e currículos.
Assim, como outros programas textuais, há maneiras de se diferenciar letras, títulos e pontuações. No R Markdown funciona da seguinte maneira:
(_Itálico_)
Itálico;(**negrito**)
negrito;[nome_do_link](link)
link![](nome_da_imagem)
#
##
-
"tab" -
Para mais detalhes sobre os pontos discutidos, acesse Programação em R (Nível Básico).