Setup

Jekyll 設定

以下の設定は Widnows で実施しています。

前提条件: Rubyはインストール済み。

  1. 必要なものをインストールする

     gem install jekyll bundler

  2. 既存のプロジェクトを Jekyll 対応にする場合:

     jekyll new --force .

  3. 以下のファイルができる

    • Gemfile
    • Gemfile.lock
    • _config.yml
    • about.markdown
    • index.markdown

  4. GitHub Pages のガイドライン に従って、Gemfile を編集する：

    1. gem "jekyll", "~> 4.*.*" の部分をコメントアウト
    2. gem "github-pages", group: :jekyll_plugins の部分を有効にする。

  5. Bundle 設定に従って更新する

     bundle udpate

  6. お試し

     bundle exec jekyll server
    • エラーが出る:
     C:/Ruby30-x64/lib/ruby/gems/3.0.0/gems/jekyll-3.9.0/lib/jekyll/commands/serve/servlet.rb:3:in `require': cannot load such file -- webrick (LoadError)
    • gem "webrick" を Gemfile に追加する

Docker を使う場合の Setup

Windows 10 Home で Docker を使う

基本参考文献: Install Docker Desktop on Windows

  1. Windows 10 Home で WSL2 を有効にする:
    • Windows Subsystem for Linux Installation Guide for Windows 10 を参考に WSL2 を有効にする。
      1. dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
      2. dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
      3. Download the Linux kernel update package
  2. Docker をインストールする
    • 問題:
      1. Virturization Technologyがないと言われる – BIOSを設定してVirturizationをONにする。
        • 対策: 利用しているASUSのPCの場合、以下の設定が必要（VMS ONだけだとブートしなくなった）
          • VMS Technology: ON (Default OFF)
          • Frame Buffer Size: Auto (Defaultは512だった)
        • 参考文献:

      2. 通常ユーザ（※私は普段、管理者権限がないユーザでログインしている）でログインした際に、 以下のようなポップアップが表示されるが、Windows 10 Home の場合、グループポリシーのGUIが無い。

        You are not allowed to use Docker, You must be in the “docker-users” group.

Know How

index.html は何から生成されるか？

  • GitHub Pages では jekyll-readme-index が有効になっているので、README.md が index.html に変換される。この仕様は GitHub の性質に合致している。
    • index.md / index.html がレポジトリにある場合は、 README.md は無視されることになる。
    • GitHub Pages で有効になっているプラグインは、以下を参照:
      • About GitHub Pages and Jekyll > Pugins

参考文献