Work
Travel
Various
Jekyll を使う
各種コマンド:
Jekyll サーバーの起動、クリーンアップ、更新、バンドルのインストールを行うには、次を実行します:
bundle exec jekyll serve
bundle exec jekyll clean
bundle update jekyll
bundle install
- gemfile を変更した場合は、
bundleを実行する必要があります - 設定 YAML を変更した場合（たとえばテーマを更新した場合）は、
bundle updateを実行する必要があります
Caution
Gemfile.lock が別のバージョンの Bundler を指定していることがあります。次のコマンドで確認してください:
gem list bundler
tail -n +1 Gemfile.lock | sed -n '/BUNDLED WITH/,$p'
このファイルを削除すると問題が解決します。
Important
bundle は絶対に sudo で実行しないでください
Bundler を使用中の Ruby と互換性のあるバージョンに更新し、古いバージョンを確認／アンインストールするには:
sudo gem update --system
sudo gem update bundler
sudo gem install bundler
gem list bundler
sudo gem uninstall bundler -v 2.6.5
場合によっては、Bundler を完全に削除して再インストールします:
sudo rm -f /opt/homebrew/bin/bundle /opt/homebrew/bin/bundler
sudo gem uninstall bundler -aIx
拡張機能の欠落
次のようなメッセージ:
Source locally installed gems is ignoring #<Bundler::StubSpecification name=nokogiri version=1.18.3 platform=ruby> because it is missing extensions
には、次を実行することで対処できます:
gem pristine <module>
bundle install
スタイル設定
- Minima を使用しています
- タブの順序はファイル名で決まるため、
a_などを先頭に付けることができます - フォント一覧: https://fonts.google.com
- minima のファイルの場所は
bundle show minimaで確認できます。
注意書き（Admonitions）:
gemfile の jekyll_plugins グループに次を追加すると、Markdown ファイルで注意書きが有効になります:
gem "jekyll-gfm-admonitions"
注意書きは次のように記述できます:
> [!NOTE]
> Note text line1
> Note text line2
利用可能な注意書きは次のとおりです:
[!NOTE], [!TIP], [!WARNING], [!CAUTION], [!IMPORTANT]
コンテンツの追加
アンダースコアで始まるディレクトリ内のファイルは、 _config.yml ファイルで次のように指定されている場合、Jekyll によって処理されません:
# this add content to the website from the local dirs starting with _
collections:
pi0:
output: true
必要に応じて、ナビゲーション用にパーマリンクを追加できます。
その他の Markdown 機能
- Web リンク:
This site was built using [GitHub Pages](https://pages.github.com/). - セクションへのリンク:
See the [Admonitions](#admonitions) section for more details. - メール:
You can contact me at [gemc@jlab.org](mailto:gemc@jlab.org)