Rubima on Jekyll

次期るびま本体のサイトです。

記事について

記事は、articles/号数/_posts/日付-記事名.mdとして作成してください。画像ファイルなどはimages/号数-記事名以下に配置してください。 記事はPull Requestで受け付け、リリースのタイミングでmergeします。

書式

Markdownです。具体的には、kramdownを使っています。 詳細な文法はkramdownのSyntaxページを参照してください。

ローカル環境構築

$ git clone [email protected]:rubima/magazine.rubyist.net.git
$ cd magazine.rubyist.net
$ bundle install
$ bundle exec jekyll serve -I

http://127.0.0.1:4000/ にローカル開発サーバーが起動し、Markdownから生成されたHTMLページを確認することができます。

リリース作業について

次の手順で行います。今のところ、GitHub Pages上で動かすことを考えています。

1. 受け付けたリリース対象の記事のPull Requestをmergeします。
2. 次のことがTravisでできそうなので、実装すれば良さそう。

• JEKYLL_ENV=production bundle exec jekyll buildを実行します。
• docsにサイトが生成されるのでgit commitしてgh-pageブランチにcommit、git pushします。

上記のようにしているのは、amazonの書影をとるためにpluginを使用しているため。これを解決できれば、特にcloneしなくても動かせるものと考えています。

rubima.github.io へのリリース

　 ../rubima.github.io/ に rubima/rubima.github.io が chekout されている場合は下記のような操作をします。

$ \cp -pr docs/* ../rubima.github.io/
$ cd ../rubima.github.io/
$ git checkout -b (ブランチ名)
$ git add .
$ git commit
$ git push -u origin (ブランチ名)

https://github.com/rubima/rubima.github.io からプルリクエストを作成しmasterブランチにマージします。

移行

URLがhttp://magazine.rubyist.net/?xxxからhttps://magazine.rubyist.net/xxxに変わるため、なんらかの移行作業が必要になるかと思います。 案としては、以下のもの。

1. 移行しない。リリースのタイミングで切り替える。
2. 現システムを動かしているサイトにてURLが変わったことを表示するようする。

影響

• るりま
  • いくつかのページにおいてhttp://magazine.rubyist.net/を参照しているところがあるので、修正を依頼するpull requestを出す。
• www.ruby-lang.org
  • 過去のリリースのお知らせについてURLを変更するPull Requestを出す？
• 地域Ruby会議レポート
  • URLを変更するPull Requestを出す