Sumário

1 Mais informações sobre mim

Acesse: Marco Antônio Cândido da Silva

2 Página dos alunos da disciplina

3 Visão geral sobre os relatórios

Este projeto está disponível em https://github.com/bendeivide/discestcomp.git.

3.1 O que é necessário?

pkgs <- c("rmarkdown", "knitr", "tinytex", "postcards")
install.packages(pkgs)

3.2 Diretório/Repositório

A estrutura base de nossos relatórios deve seguir a seguinte estrutura de diretório:

  • Usando RStudio -> GitBash (Via terminal)
    • Configure o terminal da seguinte forma:
      • RStudio > Tools > Global Options… > Terminal > General > Shell > New Terminal open with: Git Bash > Apply (Botão)
  • Crie um repositório no GitHub com <nome_github>.github.io:
    • Assim, o link do seu repositório será: <nome_github>.github.io.
    • Se já existir esse repositório, use discestcomp:
      • Assim, o link do seu repositório será: <nome_github>.github.io/discestcomp.
  • Ao ser criado o repositório GitHub, precisamos copiar o https desse repositório:
  • Clone no RStudio esse repositório em:
    • File > New Project… > Version Control > Git > Repository URL > insira o https do repositório Git;
    • Escolha o diretório onde esse repositório será clonado em seu computador em: “Create project as subdirectory of:”. Lembre-se de escolher diretórios (pastas) com nomes sem acento, com espaços. De preferência, crie uma pasta no disco C com no “repos”, isto é, C:/repos1. Caminhos longos dificultam a renderização do projeto. Experiência pessoal!

3.3 GitHub/RStudio

Para sincronizarmos as alterações do nosso repositório local com o repositório GitHub, faremos a sequência de comandos:

  • Usando o Git Bash (Pela aba Terminal no RStudio)
    • Adicionar todas as alterações no projeto (localmente)
    • Comentar a alteração (localmente)
    • Enviar as alterações para o respositório https://github.com/nome_usuario/discestcomp
    • Nessa ordem, temos os comandos:
$ git add .
$ git commit -m "Comentário a ser inserido!"
$ git push

Podemos também fazer esses passos por meio de botões no RStudio. No terceiro quadrante, procure pela aba Git, depois o botão Commit. Ao clicar, abrirá uma nova janela. No seu lado esquerdo será apresentado todos os arquivos alterados. Selecione os arquivos que deseja subi para o GitHub. Ao selecionar, no seu lado direito, haverá um espaço, em commit message, para realizar o comentário, vulgarmente chamamos commitar. Feito isso, clique no botão commit, e depois no botão push. Pronto, alterações enviadas!

3.4 Estrutura do repositório

A estrutura de nosso projeto será da seguinte forma:

  • discestcomp/index.html é a página principal. Sempre use index.Rmd para renderizar a página em HTML;
  • images é o subdiretório que criamos algumas imagens. Para as imagens necessárias nos relatórios, insira nos diretórios dos relatórios;
  • info é o diretório que representa a página das informações adicionais de cada aluno. Sempre use index.Rmd para renderizar a página em HTML. Caso deseje alterar a foto ./info/logo.png por uma sua, insira em ./info/, a respectiva imagem, renomeando-a por logo.png, lembre-se da extensão da imagem, .png;
  • Todos os subdiretórios ./rel0X representam os locais para desenvolver os relatórios. Para X = 1, isto é, ./rel01, temos o desenvolvimento do relatório 1, e assim sucessivamente. Para a criação de mais relatórios, copie um desses subdiretórios como modelo para o desenvolvimento do próximo. Por exemplo, se criarmos o relatório 03, copie um dos subdiretórios referidos, e renomei-o como ./rel03. Sempre use index.Rmd para renderizar a página em HTML. Para saber como inserir o link desse relatório na página principal, discestcomp/index.Rmd, veja a subseção 4. Relatórios.

4 Relatórios

Para linkar os relatórios basta usar o código (Exemplo Relatório 01):

- [Relatorio 01 (Insira a data)](rel01/index.html){target="_blank"}

Relatórios desenvolvidos:

  1. Pensando no SO Win.↩︎