RstudioをGitHubとプロジェクトテンプレートで管理する

4件のコメント / GitHub, Rstudio, 技術系 / By

Rstudioを使うにあたり整理方法を決めておかないと、プロジェクトが増えれば増えるほど、どのスクリプトが最新で、どのような内容で、そこで生成したファイルがどこにいったのか、わからなくなってきます。今は良いかもしれませんが、未来の自分が、今の状況をきっと覚えてはいないでしょう。

Github を使ってバージョン管理する

GithubとRstudioの連携について、すでにこちらの記事によくまとまっています((Github入門. Accessed February 21, 2021. https://kunisatolab.github.io/main/how-to-github.html))。詳しいGitの使い方について知りたい方は、@u_ribo さん((Uryu Shinyaさん (@u_ribo) / Twitter. Twitter. Accessed February 21, 2021. https://twitter.com/u_ribo))の こちらの記事が役に立ちます((RStudioではじめるGitによるバージョン管理. Qiita. Accessed February 21, 2021. https://qiita.com/uri/items/6b94609f156173ed43ed))。

Cloneの作成

私の場合は、テーマ（プロジェクト）が見つかったら、まずはGitHubにログインしてプライベート・リポジトリを作成します。Repositories > New を選択。Repository nameにプロジェクト内容がわかるように名前をつけて、Create repository します。特に公開するものでなければ Private とします。

リポジトリのページにジャンプしたら、CodeからHTTPSのURLをコピーしておきます。

Rstudioを開きます（localhost:8787、デスクトップ版でも問題ないですが、ここでは Docker環境下のRstudioを想定しています。下記記事もご参照ください。）

Rの冒頭記載コードの統一化：{pacman}の活用、環境の初期化とメモリ領域の解放

File > New Project > Version Control > Git を選択します。Repository URLに先程コピーしたURLを貼り、Profect directory name と、サブディレクトリを設置する場所を指定したら、 Create Projectに進みます。

GitHubに登録している Usernameとパスワードを聞かれるので、それぞれ入力が完了すると、プロジェクトが開きます。これでCloneは完了です。

以降は、プロジェクトを開いたら、Pullで自分のPCのファイルを最新にする→作業後にCommmitで変更履歴を残し、PushでGitHubリポジトリを最新にしておくことが日課になります。使い方は先程紹介した こちら((Github入門. Accessed February 21, 2021. https://kunisatolab.github.io/main/how-to-github.html)) と こちら((RStudioではじめるGitによるバージョン管理. Qiita. Accessed February 21, 2021. https://qiita.com/uri/items/6b94609f156173ed43ed))の記事を参照してください。「そもそもGitとは？」という方は、ドットインストールのgit入門((dotinstall. git入門 (全22回). ドットインストール. Accessed February 21, 2021. https://dotinstall.com/lessons/basic_git))がおすすめです。

Docker上のRstudioで最初にCommitをしようとすると、

fatal: unable to auto-detect email address (got 'hogehoge@hogehoge.(none)')Code language: JavaScript (javascript)

といったエラーが出るかもしれません。その場合は、RstudioのConsoleの横にあるTerminalから、

git config --global user.email {mail}
git config --global user.name {name}Code language: PHP (php)

を入力してください。{mail}は自身のメールアドレス、{name}に自分の名前を入力してください。その後は問題なくCommitできると思います。こちらを参考にしました。

プロジェクト内の整理

プロジェクトフォルダの中は予めルールを決めておいた方が良いです。私は、こちら((RStudioで卒論・修論執筆. Accessed February 21, 2021. https://kunisatolab.github.io/main/how-to-write-with-rstudio.html))を参考に、このように整理してみました。

フォルダを一つ一つ作成しても良いのですが、先程使用したRstudioのConsoleの横にあるTerminalから、

mkdir {data,thesis,analysis,function,materials}Code language: JavaScript (javascript)

と一行入力すれば、それぞれフォルダを作成することができます。

こちら((RStudioで卒論・修論執筆. Accessed February 21, 2021. https://kunisatolab.github.io/main/how-to-write-with-rstudio.html))で紹介されている {senshuRmd} を使う方法も便利です((Rmarkdown template for thesis format at Department of Psychology, Senshu University. Accessed February 21, 2021. https://ykunisato.github.io/senshuRmd/index.html))。{senshuRmd}は専修大学人間科学部心理学科での卒論・修論用にフォーマット調整をしたRMarkdownテンプレートとのことですが、学外の我々でも十分利用価値があります。

R でこのように入力・実行してみてください。{pacman}についてはこちらの記事で紹介しています。

Rの冒頭記載コードの統一化：{pacman}の活用、環境の初期化とメモリ領域の解放
if (!require("pacman")) install.packages("pacman")
pacman::p_load_gh("senshuRmd")
set_rc_ccp("thesis") #thesisでもプロジェクト名でも良いですCode language: PHP (php)

そうすると、先程のフォルダのほか、テンプレートが自動生成されます。

thesisフォルダには卒論・修論用Rmdテンプレート（thesis.Rmd, reference.bib, apa-6th-edition.csl）、が追加されています。

この、thesis.Rmd の中が、また至れり尽せりといった感じで、卒論・修論全体の注意事項、序文で書くこと、文献の引用について、本文のそれぞれの項目（先行研究、目的、方法、考察、結論などなど）について記載する際の注意事項が掲載されています。

行動開始までのモチベーションの閾値が低くても行動できるように、整理整頓にはこのようなテンプレートを有り難く使わせてもらいつつ、作業環境をなるべく快適にしていきたいものです。

「RstudioをGitHubとプロジェクトテンプレートで管理する」への4件のフィードバック

  1. ピンバック: Zotero で citation keys を設定する ( zotero-better-bibtex ) - shoei05

  2. ピンバック: サブディレクトリで管理している Rmarkdown のデフォルトパスを設定する - shoei05

  3. ピンバック: Rstudio のプロジェクトフォルダにある .git と .Rproj.user を Dropbox 非同期に設定する - shoei05

  4. ピンバック: よく使うR小技集(随時更新) - shoei05

コメントする

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA


上部へスクロール