CakePHP の Cookbook に翻訳貢献する方法と vagrant

CakePHP の Cookbook に翻訳貢献する方法と vagrant2013-12-23 GMO リサーチ寺田渉

自己紹介

2013/12/23 Facebook: 寺田渉Twitter: @wa_terada

寺田渉

@wa_terada

　　　　　　　　　　寺田渉

こんな人間です！

ボードゲーム大好き！翻訳大好き！

プログラム大好き！


ところで

Cookbook 使ってますか？http://book.cakephp.org/2.0/ja/index.html


http://book.cakephp.org/2.0/ja/index.html

http://book.cakephp.org/2.0/ja/index.html

こういうページですね。


この日本語ページどうやって訳しているかというと

有志が翻訳する↓github にプルリクする↓merge される↓皆さんのもとに届きます。


Facebook に活動のコミュニティがあります

「 CakePHP ドキュメント翻訳」こんな人たちが日々、翻訳をしています！


皆さんもぜひ翻訳で貢献しませんか？

翻訳楽しいですし、自分の翻訳が公式サイトで公開されるとやっぱり感動します。

メンバーはいつでも募集中です！！

ぜひぜひ、ご連絡ください！！


さて、 Vagrant です

もうビルド環境作るのに悩む必要はありません！！

代わりに

　　　　　　と

です！！


どういうことかというと

Cookbook は sphinx の文法で書くので文章を翻訳した後はビルドして正常に表示されるか確認が必要です。


sphinx フォーマット

上記の markdown 的なやつをビルドして下記にします。


認証についてのフラッシュメッセージの表示----------------------------------------

Auth が生成するセッションエラーメッセージを表示するためには、次のコードをあなたのレイアウトに加えなければなりません。``app/View/Layouts/default.ctp`` ファイルに次の２行を加えてください。 content_for_layout 行の前にある body 部の中がよいでしょう ::

echo $this->Session->flash(); echo $this->Session->flash('auth');

ビルドにはこれが必要

このビルドには次のソフトウェアが必要になります。


Make

Python

Sphinx

PhpDomain for sphinx

でもうまく環境つくれないことが。。。

そこで！！

これで誰でも Windows でも Mac でも環境構築に煩わされることなく翻訳に専念できます！！！


準備～ビルド

準備は下記を行うだけ！

そしてビルド！


$ git clone https://github.com/waterada/cakephp_docs_vagrant.git$ cd cakephp_docs_vagrant$ git submodule update --init $ vi forked_docs_path.conf$ vagrant up

12345

$ vagrant ssh [vagrant]$ cd /forked_docs[vagrant]$ make html-ja

123

詳しく説明します


準備 1) vagrant 環境を持ってくる

cakephp_docs_vagrant を clone してsubmodule も取ってきます。


$ git clone https://github.com/waterada/cakephp_docs_vagrant.git$ cd cakephp_docs_vagrant$ git submodule update --init $ vi forked_docs_path.conf $ vagrant up

12345

準備 2) cookbook のパス設定

clone した cookbook (docs) のパスを設定します。

とか

とか。2013/12/23

Facebook: 寺田渉Twitter: @wa_terada

$ git clone https://github.com/waterada/cakephp_docs_vagrant.git$ cd cakephp_docs_vagrant$ git submodule update --init $ vi forked_docs_path.conf $ vagrant up

12345

/Users/waterada/cakephp/docs1

C:/cakephp/docs1

準備 3) vagrant up

Vagrant Up ！


$ git clone https://github.com/waterada/cakephp_docs_vagrant.git$ cd cakephp_docs_vagrant$ git submodule update --init $ vi forked_docs_path.conf$ vagrant up

12345

ビルド


$ vagrant ssh [vagrant]$ cd /forked_docs

12

[vagrant]$ make html-ja3

これで Virtual Box 内のマウントされた docs に移動して

でビルド実行します。

ビルドが終わったら、ローカルの docs 内に build されたものがあるのでブラウザで開いて確認することができます！

　

デモ


ご清聴ありがとうございました。


Technology

CakePHP の Cookbook に翻訳貢献する方法と vagrant