jekyllによる香取研究室webサイトの設定

参考URL

インストール

ubuntuにjekyllをインストール

参考: http://jekyllrb-ja.github.io/docs/installation/ubuntu/

sudo apt-get install ruby-full build-essential zlib1g-dev
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
gem install jekyll bundler

追加で必要なgemをインストール

bundle add webrick
bundle install

テーマをインストール

gem install jekyll-theme-yat
bundle install

再インストール

※よくわからない。不要な操作

$ gem uninstall --all
$ gem install jekyll bundler

$ sudo gem install jekyll bundler
$ sudo gem install i18n

サイトの初期設定

すでにGithubに存在するjekyllのサイトを編集する場合の設定

$ cd ~/ownCloud
$ git clone git@github.com:katorilab/katorilab.github.io.git
$ jekyll new -f katorilab.github.io
$ cd katorilab.github.io

使い方

ローカルサーバでテスト

ローカル環境でのテスト、サーバー立ち上げて、chromeで確認:

$ cd katorilab.github.io
$ bundle exec jekyll serve
$ bundle exec jekyll serve --incremental

http://localhost:4000/ を開く。

GitHub にアップロード

pushすると数分後に変更が反映される。

ファイルの構成

_data

navigation.yml サイドバーの設定

_includes

_pages 固定ページ

_posts ニュース記事

ポストのtags:award, activity, research

_site 

生成されたページはこの中に入る。このディレクトリはGithubにはpushしない。Github上にその他のファイルをpushした際にGithub上で生成作業が自動的に実行される。

assets

プロジェクト直下

実験中の設定

関連ツール

gem

gem は Ruby のパッケージマネージャーです。Ruby のライブラリやアプリケーション(一般に「gem」と呼ばれます)を管理するためのツールです。

主な機能

bundle

bundle コマンドは、Rubyプロジェクトにおける依存関係(dependency)の管理を行うためのツールで、Bundlerと呼ばれるプロジェクトが提供しています。Bundlerは特定のプロジェクトで必要なgem(Rubyのライブラリやフレームワーク)とそのバージョンを管理するために使用されます。

主な機能

Jekyll

Jekyll(ジキル)は、静的サイトジェネレーターの一つです。Rubyで書かれており、Markdown、Liquid テンプレートエンジン、YAML などを使用してウェブサイトを生成します。Jekyllは特にブログやドキュメンテーション、個人サイトなどに適しており、GitHub Pagesとの連携も簡単にできます。

主な特長と機能

主要なコマンド

###