はじめてのReVIEW読了

正月早々３日坊主ならぬ２日坊主だった隠者です。

いや、年末年始の甥っ子姪っ子の攻撃ですっかりHPがゼロでしたので・・・。
コミケで買って来たおもちゃの猫絵のお札をプレゼントしたら、同じ額の本物のお札欲しいなって幼稚園児にねだられて困りました。１万猫が５枚、五千猫が５枚、千猫が５枚ですからねぇ。
どうやら、お駄賃とかでお金を蓄えさせて、欲しいものは自分で買わせてるとの事で、幼稚園児なのにお金に興味津々のようでした。あの年頃は、紙のお金で売買ごっこなんじゃないのかな。ゲーム買うにはあといくらで・・・を真面目に計算する幼稚園児は怖いです。

さて、コミケで売り子をやっていたので、開店直後にテクブのブースに並んで、テクブ本購入してきました。

中でも、一番気になっていたのが、ReVIEW本です。
ReVIEWは、軽量マークアップ形式であるReVIEW記法を使ってテキストベースで書いた内容をEPUBやPDFに変換してくれるツールです。

実は、隠者のお客様はドキュメントについての定型というものがありません。人によっては、Textで書く人、Wordで書く人、HTMLで書く人をはじめ、Excelで書く人や中にはPowerPointで書く人までいる状況でして。正直よくないと考えています。
そこで、お客様にこの辺りのドキュメントのフォーマットを統一できないかという話をしたくて、だいぶ前にこの手のツールを調べていました。

既に個人的にはReVIEWではなくSphinxを使ってドキュメントを用意するようにつとめているのですが、TLではReVIEWを使っている人が多いようなので、もしかしたらReVIEWの方が国内では流行るのかもという気もしていて、今後の動向が気になっています。

ReVIEWは、Rubyのソースコード完全解説本や、Rubyを256倍使う本の無道編の著者である、青木峰郎さんが作成され、現在は、独習○○系本で良く名前をお見かけする武藤健志さんをはじめとする方々がメンテナンスをされている、書籍を書く事に重点を置いて作成されているツールのようです（調べてたくせに制作者がこの方々とは知らなかった）。

ReVIEW本では、環境の構築から、簡単なドキュメントの生成、スタイルをつかった整形まで、電子書籍等を作る場合に必要になりそうな基礎がしっかり入っていました。
特に、悩みそうなスタイル部分と、コマンドの解説のあたりは重宝しそうです。

ちなみに仕事で使うつもりといったSphinxですが、こちらはPythonで書かれたツールで、reStructuredText記法を使ってテキストベースで書いた内容をHTMLやPDFやEPUB形式に変換してくれるツールです。まぁ、ReVIEWと思いっきりかぶっているのですが、使った感触では、ReVIEWは書籍のような出版系に、Sphinxの方はHTMLベースでの運用も含めた仕様書やマニュアル系に向いている気がしています(注：個人的な感想ですが）。

ReVIEWの方の調査は半端で止めてしまった（というか、仕事の環境の都合で早めに断念した）ため拡張方法は不明ですが、Sphinxはいろいろと拡張できるように設計されているようで、拡張モジュールもいくつか提供されていて、特にテキストでの表記から図を生成できる、blockdiagとかmscgenとかinheritance_diagramとか、慣れは必要なものの便利な機能もあったりします。

取っ付きやすさと面でいうと、機能がしぼられている分、ReVIEWの方が取っ付きやすいように思いますけど、仕様書のために使いたいと思うと、少し物足りない感がありますね。

ただ、Sphinxの残念なところは、PDF化の時に、なんだか思い通りに出力させるのが大変だった気がしています。とりあえず、仕事上はHTMLでも十分な感じなので、一応は満足しているのですが。

何にせよ、どうせなら仕様書もテキストベースに切り替えて、きっちりバージョン管理したいものですねぇ。

基礎から学ぶ組み込みAndroid

3日坊主3日目の隠者でございます。
どうもこのブログ、BeagleBoardで検索にかかって訪れる方々が多いようでして。
そんな方々に書籍のご紹介ということで。

坂本俊之・出村成和・渡辺晶之

「基礎から学ぶ 組み込みAndroid」

(C&R研究所 2011/1/5 初版)

Androidの書籍というとアプリケーション開発関連の書籍が多いのですが、こちらはオタ・・・じゃなかった、組み込みの方向けの書籍です。

目次は、日本Androidの会のMLにも流れたから出しておいてもいいですかねぇ。著者の方から怒られたらごめんなさいして取り下げようかな・・・。

1. 組み込みAndroidの概要
2. 組み込み開発に必要な準備
3. アプリケーション作成の基礎
4. Android SDKによるハードウェア制御
5. Android NDKによるアプリケーション作成
6. Androidのハードウェアへのポーティング
7. デバイス制御ライブラリの作成
8. Androidの内部構造
9. 赤外線を使ったAndroidの制御（ブレッドボードで実装）
10. Webカメラを使った赤外線カメラ
11. GPSレシーバーを使った地図の表示
12. オーディオ出力を使ったロボット制御（半田つけ必要）
13. WebViewを使ったキオスク端末

といった章立てとなっています。流れ的には、

• 基礎編
1. まずは、バイナリを落としてきてxMでAndroidを動かしてみて
2. アプリの作成方法を学びつつ、SDKでの下回りの使い方、NDKについて学んだ後
3. xM向けのソースコードの入手、ビルド、SGXドライバの追加という簡単な動かすための手順を学んでみて
4. GPIOを使うデバイスドライバとNDKからの利用法の基礎を簡潔に学び
• 応用編
1. 赤外線受信機をBeagleBoardにつないでアプリまでの流れを追い
2. Webカメラのつなぎ込み
3. GPSのつなぎ込む
4. BeagleBoardで制御する簡単な2輪ロボを作りコントロール
5. 最後に軽く実務的にどんなことが行われてるのかの紹介？

となっているようです。なお、最後の5番については、実は隠者もまだ読み終わってません。ごめんなさい。それと、実践編については、正月が開けて時間ができたら機材の購入をしてやってみたいなと思ってはいるのですが、年末にかけて軽く読んだ程度で止まってるんですよね。

流れの組み方は非常によい形でできていて、初学者に教えていくのには良い構成ではないでしょうか。順序よく学んでいくのに適している気がします。

注意事項としては、これは、手元の未知のハードウェアへAndroidをポーティングできるようにしようという目的の書籍ではないです。ポーティングの話は、TIの用意したコードを使ってビルドするというレベルの話ですね。

デバイスドライバに関しても最低限書籍を最後までやり遂げるために必要な知識レベルまでです。それはまぁ、デバイスドライバに関する本を真面目に書くと、それだけで1冊になるわけですけど・・・。

それと、この通りうまく進んでいる間は良いのですが、経験則上、この本だけを渡して初心者に勉強させようと思うと、途中で躓くと立ち止まってしまいますね。困った時の辞書的に使う本ではなく、組み込みAndroidレッスン的に使うための書籍だと思います。

ISBN : 978-4-86354-076-7
定価  : 4200円+税

ちょっとお値段は高めですが、小難しい事はさけ、できるだけわかり安く、動かしてみよう！って方向で書かれている良い本です。BeagleBoard-xMを購入して、Androidを動かしかたからよくわからない方や、動かした後の次の一歩をどうしようか悩んでいる方には特におすすめですね。

なお、下記のamazonの画像付きリンクはアフィリエイトのリンクです。うさんくさいアフェリエイトは踏みたくない方は、こちら をどうぞ。




P.S.
Twitterでのこの書籍関係のハッシュタグは、#embandbook のようです。

1/11 編集について: 途中へんな編集をしたまま投稿してたようで、おかしな部分を修正しました。
1/11 追記 : 著者の一人が、そのうち横浜PF部に遊びに来て下さるそうなので、その時サインペンと一緒に本を渡すと、サインもらえるかと思います。