lesson: 2 レッスン2 基本的なサイト設定

以下，02_sampleディレクトリを使います。該当ディレクトリ内のプロジェクトファイルを開いてください。

サイトの全体設定は_site.ymlファイルに記述していきます。以下このファイルの内容を説明していきます。

2.1 サイト名

name: "サイトタイトル"

• サイトのタイトルを文字列で指定します
• このサイトを開いた時，ウィンドウの一番上やタブに表示されます

2.2 navbar関連

navbar: 
  title: "My ウェブサイト"
  left:
    - text: "ホーム"
      href: index.html
    - text: "趣味"
      href: shumi.html

• navbar:以降ぶら下がるのがいわゆるメニューバー設定
  • title:はサイト名として常に表示される
  • left:以降ぶら下がっているのが項目で，左揃えで配置される
    • -とその下にぶら下がるのが1項目分の情報
      • -text:は表示文字列，href:がリンク先
• この他，色々設定できますが省略します
  • 詳しくは公式ドキュメントのここにほぼすべて書いてあります

2.3 output関連

output:
  html_document:
    theme: cosmo
    highlight: textmate
    toc: true
    toc_float:
      collapse: false
    df_print: "kable"
    include:
      after_body: footer.html
    css: site_style.css

• 通常のR Markdownでのoutputの指定と同様です
  • 設定可能項目はたくさん
  • (現時点での)最新一覧は以下の資料を
    R Markdownのhtml_documentで指定できるyamlヘッダ項目について - Qiita
• この設定が(原則)全てのRmdファイルに当たります
  • 個別のRmdファイルに記述すれば，そっちが優先されて上書きされます

2.4 output_dir

output_dir: "docs"

• buildで生成される，Webサイトに必要なファイル一式を出力する場所を指定
  • ここにできたものをまるっとWebサーバーに設置すればOK
  • 標準では_siteディレクトリ
  • github.ioに設置を考えているなら，docsがおすすめ