ブログを引っ越して、RStudio + Github pages環境にした

初期設定

githubのSSH設定やRStudioとgithubとの関係等の説明は省略します。

1. githubでレポジトリを作成する。レポジトリを “githubのアカウント名.github.io” にすると、非常に楽。(ルート相対パスの問題が生じるのを回避)
2. レポジトリを作ったら出てくるclone用のリンク (httpsでもsshでもok) をコピーしておく
3. RStudioで New Project > Version Control > Gitと進み、2を貼り付ける
4. new_site()を走らせる (下を参照)。

# blogdownのインストール
install.packages("blogdown")

# hugoのインストール
library(blogdown)
blogdown::install_hugo()

# 新しいサイトを作る
## themeを指定して、好きなhugoテーマにできる。
new_site(theme = "zhaohuabing/hugo-theme-cleanwhite") 

5. new_site() を走らせると、「今見る？」みたいな質問がくるが、nを選択して拒否
6. config.yamlを編集して、publishDir: “docs” を追加する。どこの行でもいけるっぽいが、インデントはなしで。この作業で、gh pagesのdocsから読むことに対応できる (FYI)
7. build_site(), render_site(), 最後にserve_site() と唱えると、webサイトがローカルに立ち上がる。すげえ。
8. ルートディレクトリのconfig.yamlと、config.toml (pathは themes/ (中略) / example/Site/config.toml) を編集して、baseurlを自分のgithub pagesを指定。今回のケースでは、https:// githubのアカウント名 .github.io で良い (see 1)
9. commitして、pushする。
10. githubに移動。レポジトリのsettingに行って、pagesタブへ。
11. “Your GitHub Pages site is currently being built from the /docs folder in the main branch.”にする。

これで一旦見れるようになるはず。まずはここをチェックポイントとすると良さげです。 config.yamlあたりは、沼ポイント多めに感じました。いったん動くものを作ってから編集することがおすすめ。(ほんと常識がなさすぎて、いろいろとわからん)

hugoテーマによっては、この時点で走らないものもありました。おそらく自分のせいなんですが、とっとと諦めました。

記事の書き方

1. new_post(title = “記事の名前”, ext = “.Rmd”)
   Markdownで書くなら拡張子変えればok
2. build_site()
3. render_site()
4. commit & push

buildとrenderを忘れがちなので注意。

写真を入れる場合は、/content/post/日付とタイトル/index_files に写真を入れるのがおすすめ。 パスは ./index_files/hoge.png と、通常のMarkdownの通り書けば、workします。

参考にしたもの

参考にしたものは次の記事たち。

• 神記事
• blogdownの公式?サイト
• 同じテーマを使った方のブログ記事
• 自分が選んだhugoテーマのdemoページやgithub。自分のwebサイトが動かないのは「必ず自分側に原因があるはず」という姿勢でやりつつ、適当に諦める。

あとは、とにかくネットサーフィンしてました