Com bastante felicidade, apresento meu primeiro livro sobre análise de dados. Esse livro é um esforço muito grande para reunir conceitos em estatística de uma maneira que seja academicamente responsável, mas também palatável ao meu público principal (estudantes de Psicologia).

Apesar de seu ser um usuário fluente em R, uma das maiores limitações que encontrei para desenvolver este livro foi conseguir fazer a conexão entre o R markdown e o Github. Após muito tempo pesquisando (e falhando!), consegui ter sucesso e compartilho abaixo algumas dicas que podem auxiliar.

Passo 1. Para fazer seu próprio livro, você precisará ter o R, o Rstudio, uma conta no Github e o pacote bookdown instalado.
Essas tarefas consomem algum tempo e o melhor tutorial para seguir é este. Ele é direto, resumido e objetivo. Siga o tutorial por completo.

Passo 2. Depois de fazer a instalação e seguir os passos acima, ao abrir o projeto bookdown-demo, sua pasta local será parecida com esta abaixo. Repare que eu tenho diferentes capítulos e cada um deles tem um número relacionado. Por definição o capítulo “index.Rmd” (que não está apresentado na imagem) é o primeiro capítulo e não precisa ter nennhum número associado.

Passo 3. Você pode (e deve) alterar tudo o que quiser. Sempre que você fizer alguma alteração, você deverá salvar localmente o arquivo. A atualização no github ocorre em dois passos! Primeiro, após salvar seus arquivos localmente, é necessário que, em você clique em Build e selecione Build book e bookdown::gitbook.

Ao fazer isso, o R vai renderizar seu livro. Isso costuma demorar um pouco. Ao fim, o R irá apresentar para você em uma janela, tal como a abaixo. [Ignore o Republish na imagem].

Não faça nada nesta tela. Apenas a feche!

Depois e fazer isso, o segundo passo pode ser feito. Clique em Git, depois clique em Commit.

Uma janela vai abrir. Ela se chama Rstudio: Review Changes.

Você deverá marcar todos os arquivos (na parte à esquerda). Em seguida, na parte à direita, escreva um texto qualquer para descrever o que você fez. Clique em Commit (na parte inferior). Uma janela preta irá aparecer. Espere um pouco e , nesta janela, clique em Close após você perceber que o R já fez o commit.

Em seguida, na parte superior, esta janela de Review Changes irá indicar “your branch is ahead by 1 commit”.

Clique agora em Push. Uma janela preta irá abrir. Espere um pouco e, quando a mensagem do “your branch..” desaparecer, clique em Close e feche também a janela Review Changes.

Você irá reparar que a sua lista em Git estará vazia. Isso indica que a sua versão local é a versão que está no Github.

Passo 4. Acesse seu githhub pelo site .io . No meu caso https://anovabr.github.io/mqt/

Mensagens colaterais: É muito importante você seguir o Passo 1 integralmente. Isso é fundamental para você indicar que o local do seu arquivo é a pasta /docs e fazer a ponte entre o R e o Github. Você também pode publicar seu livro usando o deploy do R connect, que não ilustrei aqui para não ficar muito longo.

Um forte abraço a todos
Luis Anunciação
Psicometria (PUC-Rio)