rake1.9.1 post title="[ファイル名]"

でファイルを作成._posts/直下にYYYY-MM-DD-[ファイル名].mdという名前のファイルが生成されるので,そのファイルにMarkdown形式で入力する(日本語ファイル名はよろしくないという噂を聞いた気がする).

あとは github に push するだけ.例えば,

git add .
git commit -m "hogehoge"
git push origin master

などで更新できる.ファイルが予期しない場所にあると

Generating... Invalid Date: '' is not a valid datetime.
Liquid Exception: exit in _layouts/post.html

というエラーが出たりする.例えば,Markdownファイルがhoge.github.ioディレクトリ直下にあるとエラーが出る. また他の注意点としては,余分なファイルを消すなどの操作をした場合は,git add -A .などとする必要がある.

デバッグ用にローカルでサイトを見たいときには,

jekyll serve --watch

また,下書きで保存したいときは,_draft/以下にMarkdownファイルを置いて

jekyll serve --drafts

とする.

としてブラウザでlocalhost:4000にアクセスする.

MathJaxの設定

Writing math equations on Octopress - Carpe diem (Felix’s blog)などを参考にして設定する.

$$
	p(x) = \frac{1}{\sqrt{2\pi}} \exp\left(-\frac{x^2}{2}\right)
$$

美しい.

titleの設定(追記:2014/09/04)

デフォルトの設定だと,HTMLのヘッダー内のtitleが「記事のタイトル - ブログのタイトル」という形式になっていないので修正する.

_includes/themes/bootstrap-3/default.html内で以下の部分を

<title>{{ page.title }}</title>

以下のように書き直す

<title>{{ page.title }} - {{ site.title }}</title>

上記コードのなかで{が全角になっているのは,エスケープのためであってそれ以上の意味はない.コピペの際には注意してほしい.

ビルド時のwarningが起こる問題 (追記:2014/09/11)

デフォルトのままでjekyll serve --watchなどを実行すると以下のようなwarningが出る.

     Build Warning: Layout 'nil' requested in atom.xml does not exist.
     Build Warning: Layout 'nil' requested in rss.xml does not exist.

無視しても良いのだが,気になるので修正したい.

“Build Warning: Layout ‘nil’ requested in atom.xml does not exist.” · Issue #2712 · jekyll/jekyll

上記のページを参考にして,atom.xml と rss.xml 中の layout: nillayout: nullに変えれば良い.

syntax highlightの設定 (追記:2014/09/23)

Jekyll - Syntax highlightingを参考にしてsyntax highlightの設定をする.

  1. pip や easy_install などで pygments をインストールする.
  2. (デフォルトでこうなっているはずだが,)_config.ymlでhighlighter: pygmentsとなっているか確認する.
  3. pygmentize -S default -f html > pygments.csshoge.github.io/以下にcssファイルを生成する.
  4. 使っているdefault.htmlのヘッダ部分に<link rel="stylesheet" href="/pygments.css">を追加する.
  5. 以下のような感じでハイライトできる.
{% highlight ruby %}
def foo
  puts 'foo'
end
{% endhighlight %}

def foo
  puts 'foo'
end


blog comments powered by Disqus

Published

31 July 2014

Tags