買い物ログ別館/Kaimono-log bekkan

gepub 0.6.3 with GEPUB::Builder

2012-02-24T10:40:04Z

Released gepub 0.6.3. It includes GEPUB::Builder, easy and powerful way to create a EPUB3 file. gepub0.6.3をリリースしました。EPUB3生成の簡単(だけど、EPUB3メタデータの大部分が扱える)インタフェース、GEPUB::Builderが含まれています。例は以下の通り。

simple example

rather complicated example

gepub EPUB builder API

2012-02-21T21:26:14Z

gepubにEPUB生成インタフェースを追加しようとしています(まだ実装してません!)。以下に、今の案での、使い方例を示します。基本的な考え方は

まずアイテムを定義(titleとかfile)
続いてその属性を定義(alt, file_as, mime typeとか)

です。ご意見いただけると嬉しいです。 I'm planning to add EPUB builder interface to gepub(not implemented at all, yet). Here is my current idea how GEPUB::Builder interface looks like. Its style is:

define item (e.g. title, creator, etc)
set attributes to last defined item (e.g. alt, file_as, mimetype, etc)

If you have any comment or suggestion, please tell me!

simple example

rather complicated example

gepub 0.6.1リリースしました: EPUB3対応、パース対応

2012-02-20T21:13:00Z

(English entry is here) 昨晩、gepub 0.6.1をリリースしました。gepubは、rubyで書かれた汎用EPUBライブラリです。主にメタデータを取り扱うことを目的としています。 0.6の代表的な新機能は次のとおり。

EPUB3対応。EPUB3 Publicationで定義された全てのメタデータを扱えます(扱えないなら、それはバグです)
EPUBファイルのパース
新しいEPUB生成インタフェース

詳しくは、github レポジトリのREADMEやexamplesをどうぞ。 gepubはもともと、good-enough EPUB generatorを目指していました。が、「必要十分」を目標にすると、十分からほど遠いことになってしまう、ということにようやく気付きました。gepub0.5.0は「私には」必要十分でしたが、非常に貧弱な機能しかありませんでした。あたらしいgepubは「汎用」EPUBライブラリを目指します。まだまだ汎用とはいえませんし、そもそもバグだらけですが、自分で使いながら改善していきたいなーと思っております。

Released gepub 0.6.1: a generic EPUB library, supports EPUB3

2012-02-20T14:10:00Z

Released new version of gepub. gepub is a generic EPUB parser/generator for Ruby. Its main focus is to handle metadata in EPUB. New features in version 0.6.0 includes:

supports EPUB3. It can(or should) handle every metadata defined in EPUB Publications 3.0.
Parse existing EPUB files.
New easy-to-use EPUB generating interface.

Please check the readme and examples on the github repository for more information. The original goal of gepub was to be a 'good-enough' EPUB generator. But, if you set a goal like 'good-enough', it will be rearly enough. gepub 0.5.0 has very poor functionality on handling metadata, no parsing, and only supports EPUB2.0. Now, the new goal of the library is to be a 'generic' EPUB library. It's not generic enough and not stable yet, but I'm willing to make it enough and stable.

KOJIMA Satoshi

iBooks AuthorはEPUBオーサリングツールではない

2012-01-20T09:25:00Z

Appleから電子書籍を作れるアプリ iBooks Author がでました。作った電書をibooks フォーマットという初耳のファイルに出力して中を眺めると、だいぶEPUBぽい。ということは、これはEPUBのオーサリングツールなんでしょうか? ibooksファイルとEPUBをざっくり比べてみました。

EPUBと同じところ

zipアーカイブである
mimetypeという名前のファイルがある
OEBPSで定義されたMETA-INF/container.xmlがある
opf2.0のファイルがある
ナビゲーション用にncxファイルがある
コンテンツは基本的にxhtmlである

EPUBと違うところ

拡張子がちがう
mimetypeの中身が違う。EPUBでは"application/epub+zip"、ibooksフォーマットでは"application/x-ibooks+zip"
opfのmanifestにapplication/x-ibooks+linehintsとかimage/x-thumb-jpegなんてmediatypeをもつitemがある(EPUBではmediatypeを限定していないので「違う」というのは正確ではないですが)
cssに-ibooks-というプレフィクスがついたものがある

違うフォーマットだよね

拡張子が.epubじゃない上に、中のmimetypeがapplication/epub+zipじゃない。これは"ibooksフォーマットはEPUBじゃないよ"という意志の現れだとかんじました。これは拡張されたEPUBではなく、よく似ているけど全く別のフォーマットだと私は捉えました。

EPUBオーサリングツールじゃない

つまり「iBooks AuthorはiPad iBooks専用電子書籍のオーサリングツール」なのであって、「変な拡張をしたEPUBを吐き出す困ったツール」ではないのだと思います。もうちょっと乱暴に「電子書籍アプリの簡単作成ツール」といってしまってもよいのじゃないかなあ。

GDD2011JP DevQuiz 私の書いた回答コードその2

2011-09-13T12:13:12Z

GDD DevQuiz、今年の本命はスライドパズル。拡張された15パズルです。まずはJavaで解いて、最後にgo言語で上積みしました。 Java実装 Go実装問題文は以下のとおり。

幅が 3 マスから 6 マスで、高さが 3 マスから 6 マスのボードが与えられます。各マスは、パネルが置かれているか、壁があるか、空白であるかのいずれかです。パネルには 1 から 9 あるいは A から Z のいずれかの文字が書かれており、同じ文字の書かれたパネルは存在しません。壁は 0 個以上存在し、空白のマスはただ 1 つだけ存在します。例えば、次のようなボードが与えられます。ここで、壁は = で、空白は 0 で表されています。

40=
215
=86

空白は、上下左右のマスのパネルと入れ替えることができます。上のマスのパネルと入れ替えることを U とよび、同様に、下左右のマスのパネルと入れ替えることをそれぞれ D, L, R とよぶものとします。壁を空白やパネルと入れ替えることはできません。
パズルを解くというのは、与えられたボードの各マスを操作して、ゴール状態に持っていくことです。
ゴール状態とは、上の行から各行順番に、左から右に 1, 2, 3, 4, ..., 9, A, ..., Z という順にパネルが並び、最も右下のマスに空白が配置された状態のことです。壁のあるマスに対応するパネルは存在しません。例えば、左上のマスが壁であれば、ボード上に 1 のパネルは存在しません。
(中略)
いま、使うことができる L, R, U, D それぞれの総数があたえられます。この総数は全パズルで共有されています。例えばあるパズルを解くために L を使い切ってしまった場合、他のパズルでは L を使うことはできません。この総数を超えないようにしながら、なるべくたくさんのパズルを解いてください。

このパズル、5000問あるのです。そして一問が0.01点。100問といてやっと1点。手で解くことをある程度防ぐ設問ですね。 15パズルでの評価関数は各駒のゴールに対するマンハッタン距離合計を使うのがポピュラーな模様。その方向で、A*探索をRubyで試しに実装してみてあまりの遅さに音をあげてすぐにJavaにうつりました。まずはメモリをじゃぶじゃぶつかって試みてみました。この時点で一晩で1000問程度回答。かなり厳しいです。次はゴール状態から初期状態に向かってのA*探索を同時に走らせる双方向A*探索してみました。これでもくろみ通り、探索空間が小さくなってかなり成績があがり、3300問程度。その後はパラメータを少し調整し、メモリを増やすなどして、4300問まで頑張りました。メモリ使いすぎで探索中にMacBook使えないのが辛くて、こんどはメモリをあんまり使わない反復深化深さ優先探索(IDDFS)を実装してみました。が、新たな解はほとんどみつけてくれません。このあたりで飽きたのでgoでIDDFSを実装しなおして遊んでいたら「探索したノード数が一定数を超えたらその時点で評価値最良のノードひとつだけ残してそこから再度探索する」という乱暴な枝狩りをおもいつきました。これがそれなりに効果的で、最終的には4818問で終了しました。この問題、30人近くが5000問すべてを解いています。そのひとたちは、そもそもメモリの使い方を最初からすごくしぼっていて、私の無駄遣い富豪プログラミングとは一線を画している様です。評価関数もいろいろ工夫されています。コード公開しているひと多数なので、後でじっくりみてみようと思ってます。

GDD2011JP DevQuiz 私の書いた回答コードその1

2011-09-13T03:38:57Z

今年の11月に、Google Developer's Dayというイベントがあります。一昨年までは先着順で瞬間的にチケットがなくなっていたらしいです(参加してないので知りませんが) 昨年から参加者には基本的に「開発者向けクイズを解く」ことが課せられるようになりました。その得点上位のひとから順に、入場の権利が与えられるのです。開発者向けイベントなのだから、合理的ですね。昨年にひきつづき、今年も挑戦しました。各問題のために書いたコードをここにだしておきます。まずは、簡単なほうの問題5つのうち、私がといた3つから。 (この5つの問題は、2つだけ点数にカウントされるのです)

Web Game

シンプルな神経衰弱ゲームです。カードはクリックすることでめくることができます。全 64 セットを解くことで問題クリアとなります。

色が違うだけのカードが、最大1024枚出てくる神経衰弱。これを手でやろうなんていうプログラマはほとんどいないでしょう。親切なことに、「ヒント」としてGoogle Chromeの機能拡張の例が出ています。これをベースに使えばとても簡単。JavaScriptでDOMさわってクリックして色チェックして覚えて、というだけOKです。 manifestを含むコードはここに置いています。 https://gist.github.com/1213056

Go!

Go 言語で、PNG 画像を入力として受け取り、その画像が何色使っているかを返す関数func CountColor(png io.Reader) intを実装してください。PNG 画像は io.Reader 型で与えられます。なお、入力の画像は R G B の各色の値が 0 から 255 までの 256 段階のいずれかであり、不透明（アルファチャンネルの値が常に 255）であることが保証されています。

これも、goのimage/pngライブラリを使えば実に簡単です。

一人ゲーム

数がいくつか与えられます。なるべく少ない手数で数を全て取り除いてください。あなたは 1 手で、
- 全ての数を半分にする（端数は切り捨て）
- 5 の倍数 (0 を含む) を全て取り除く
のどちらかの操作をすることができます。

簡単簡単、とおもったらちょっとだけひっかかりました。「5で割りきれてかつ2で割りきれない数が残っている」ときに、その数を含めて5の倍数を取り除くのが良い場合と、良くない場合があるのです。結局、こんなコード書きました。幅優先探索。

キューから取り出した数セットの要素すべて5でわりきれれば終了
要素のなかに5で割り切れるが2で割りきれないものがあったら、5の倍数を取り除いたものをキューに入れる
全要素を2で割ったものをキューに入れる

ウクレレコードおぼえるアプリを作ってみた

2011-06-17T23:27:37Z

半年ほど前からウクレレ習っています。我が師匠は突然「じゃあC9は?」と質問し、右往左往する我々をみてほくそ笑んでいるのです。ほくそ笑まれるだけでも悔しいので、コードをおぼえるためのWebアプリを作ってみました。 UkuChord タップ(またはクリック)すると答えがでて、さらにタップすると次の問題が出ます。表示の向きを変えることもできます。まだコードのデータが不十分ですし、間違いもあるかもしれません。 iPhone向けです。PC/MacのSafariやChromeでも動作します。おそらくFirefoxでもじょうぶ。IE8では動かないはずです。Androidでも動くそうです。 iPhoneでは、「ホーム画面に登録」すると、本物のアプリみたいにふるまいます。タップすると単独のアプリであるかのように、Safariとは別に起動します。コードは上のサイトから見放題ですが、一応githubにも入れました。つっこみご指導いただけると、とっても嬉しいです。 https://github.com/skoji/ukuchord.js 実はHTML5なアプリをはじめて作ったのですが、あんまりにも簡単にできて驚きましたよ。

環境設定メモ: RVM + Ruby 1.9.2 + Rails3

2011-01-05T07:20:26Z

MacBook (SnowLeopard)でRails3の環境をつくりはじめました。

readlineのインストール

readline入れとかないとirbで日本語使えないということなので、readline-6.1をインストール。単純にconfigure/make/sudo make install。

RVMのインストール

http://rvm.beginrescueend.com/の指示に基本的には従う、が、scripts/installが実行されなかったので手動で実行する。 .bash_profileに、次の追記をする。

 [[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"

Ruby 1.9.2をインストールする

rvm install ruby-1.9.2 --with-readline-dir=/usr/local

Railsをインストール

rvm use 1.9.2
gem install rails

電書部マークアップvalidatorを作ってみた

2010-11-12T09:07:10Z

電書部の技術班。今年はこればっかりやっていた気がする。 gihyo.jpで、電書部の技術解説の記事「電書部技術班，電子書籍配信サーバーに挑む」がはじまっています。その中でEPUB変換まわりの原稿書きました。第4回　電書用マークアップYDMLを使った原稿作成と，YDMLパーサ第5回　電書原稿からEPUBをつくりだす何気ないふうを装いつつも、少しどきどきしながらYDMLという言葉を出しました。でもどこからも何の突っ込みもなくてそれはそれでちょっとさみしいものです。 YDMLパーサ記事について「なんでXMLパーサでやらないの?」という趣旨のつっこみがtwitterで入りました。思い起こすとそもそもパーサジェネレータ作った理由は

YDMLとは違うマークアップを目論んでいた
DSLぽいものをRubyで作ってみたかった
とにかく作ってみたかった

そんなことでした。が、何をぼけていたのか、テキスト混合ノードはXML的にはwell-formedじゃないからという恥ずかしい説明をしてしまいました。恥ずかしいのでその経緯はリンクしません。(tweet消してはいないので探せばみつかります) XMLでのvalidateくらいやってみるかと思い立ってやってみましたら、RelaxNGの勉強からはじめたのに1時間くらいで出来てしまい愕然としました。 YDMLを少しだけ改変(ルートのエレメント定義して、書式が変なタグを修正)してwell-formed XMLにしたものにたいして、RelaxNG compact syntaxでスキーマを定義し、それをcompactじゃないsyntaxに変換したうえでNokogiri::XML::RelaxNGに喰わせています。ちゃんとvalidateはできるのですが、validじゃなかったときのエラーメッセージが分かりづらい。場合によっては分かりづらいを通り越して意味不明なので実用性低めです。でもせっかく作ったのでgithubにあげました。 https://github.com/skoji/ydml_simple_validator

gepub 0.1.1 をリリースしました。

2010-07-07T03:30:00Z

必要十分を目指すrubyで書いたepubライブラリ・gepubのversion 0.1.1をリリースしました。はじめてminor versionが1になったよ。gem install gepub で降ってくるはず。ソースはこちら。http://github.com/skoji/gepub 主な変更点。

インタフェースをいちから書き直して、itemを生成してbookに追加するというモデルにしました。だいぶシンプルになってる、といいなあ。
圧縮前epubのディレクトリを作成せずに、直接epubを生成するようにしました
ソースとなるデータをファイルではなくIOオブジェクトで渡すようにしました

IOオブジェクトで渡すようになったのは地味な変更だけど、地味に使いやすいんじゃないかと思っております。これまでのGEPUB::GeneratorではなくGEPUB::Bookをつかってください。 GEPUB::Generatorは0.2.0のタイミングで削除する予定です。使い方はgithubに置いてあるexample.rbをご参照ください。例は少しずつ充実させます。この後は、

メタデータをもうちょっとちゃんと書き込めるようにする
インタフェースがまだおかしい気がするのでみなおす
XMLライブラリをNokogiriにする

などなどを考えていますが、予定は気まぐれに変わります。こうなるといいなー、なんていうのがあればお知らせください。ないだろうけど。電子書籍部でつかっているテキストto EPUBのコードも遠からず公開する予定です。

EPUB生成ライブラリを作ってみた

2010-05-04T02:46:40Z

(2010/5/5 : githubにあげました)

EPUB生成のライブラリをrubyで作ってみました。ブツはこちら。http://github.com/skoji/gepub

コンテンツ指定のファイルは/content.opfに固定
identifierのschemeはURLに固定
identifierの名前はBookIDに固定

などなどいろいろ決め打ちにしています。

利用例はこんなです。

require 'rubygems'
require 'gepub'
require 'fileutils'


epubdir = "testepub" # epubのコンテンツを置くディレクトリ
title = "samplepub"  # epubのファイル名


FileUtils.rm_rf(epubdir)
FileUtils.mkdir(epubdir)

# epub メタデータ作成
epub = GEPUB::Generator.new(title)
epub.author="the author"
epub.publisher="the publisher"
epub.date = "2010-05-03"
epub.identifier = "http://www.skoji.jp/testepub/2010-05-03" # identifierはURLのみ

# サンプルのコンテンツ生成。通常は、別途作成しているはず。
[ 'coverpage', 'chapter1', 'chapter2' ].each {
  |name|
  File.open(epubdir + "/#{name}.html", 'w') {
    |file|
    file << <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
  <head>
    <title>sample #{name} </title>
  </head>
  <body>
  <h1>#{name}</h1>
<p>here comes the contents for #{name}</p>
  </body>
</html>
EOF
  }
}

# "coverpage"は表紙を想定。従って目次のデータには入れない。
# spineに入れた順にリーダでは表示される。
epub.addManifest('cover', "coverpage.html", 'application/xhtml+xml')
epub.spine.push('cover')


epub.addManifest('chap1', "chapter1.html", 'application/xhtml+xml')
epub.spine.push('chap1')
epub.addNav('chap1', 'Chapter 1', "chapter1.html")

epub.addManifest('chap2', "chapter2.html", 'application/xhtml+xml')
epub.spine.push('chap2')
epub.addNav('chap1', 'Chapter 2', "chapter2.html")

# この他にcssとかイメージがあれば、それもManifestへ追加する。
# cssやイメージはspineやaddNavへの追加は不要。

# container.xml/contents.opf/toc.ncxなどのファイルを生成
epub.create(epubdir)

# 生成したディレクトリから、epubファイル作成
epub.create_epub(epubdir, ".")

サンプル書いて気付きましたが、EPUB::Creatorというクラスの役割がぶれてるなあ。

EPUB入門メモ

2010-04-07T21:11:51Z

EPUBに関するメモ。

リンク

元締め International Digital Publishing Forum EPUB仕様日本語訳をしている、ろすさんのサイト厨二病棟わかりやすげなまとめ Epub Format Construction Guide ePubのメタデータはダブリンコア dublin core metadata element 仕様でかいし、自前でつくるときはvalidatorがないと不安です epub validator Hello world的な、達人出版会の記事はじめてのEPUB

その他

コンテンツのXHTMLには、langやxml:langを指定しておく。そうしないとAdobe Digital Editionでは日本語文字化けする(validatorに怒られるのだけど...) zipでつくるときは、こんなんがよい。

zip -0X testbook.epub mimetype
zip -9rXD testbook.epub -x mimetype

mimetypeは非圧縮(-0)で先頭に。他のコンテンツは圧縮してよし(-9)。属性は不要なので-X。ディレクトリは保存しなくてよいので-D。など。

The Art of Unit Testing

2010-01-28T03:50:49Z

最近読んだ"The Art of Unit Testing: With Examples in .net"という本がとっても良かった。Unit Testをはじめようとしているひと、運用で悩んでいる人は今すぐ読め! ってくらい良かった。

この本は、ユニットテストの基本的な考え方と基本的な書き方から始まります(Part 1)。

そして、ユニットテストで必須のテクニックである依存性の取り除きかたについて語られます(Part 2)。

その上で、ユニットテストをどう配置し走らせるか、どうやってリファクタするか、どんなふうに自動ビルドで運用するか、など実際に運用するときの考え方や方法論を解説します。そしてユニットテストのコードで陥りがちな罠(ひとつのテストにAssertion多すぎ、テストの名前が分からん、Setupに詰め込みすぎ、実行順序に依存、などなど)とその回避基準も明示します(Part 3)。

さらに、組織へのユニットテストを導入するにはどうするか(新しいことには抵抗がつきものです)を説明し、「タフ」な質問( 「これはどのくらい時間をとるの?」「これでほんとに効果がでるの?」など)にどう応えるか、回答例のカタログとともに説明します。最後の章では所謂"レガシーコード"に、どのようにユニットテストを適用していくのか、という話題に切り込みます(Part 4)。

上記で要約したとおり、「ユニットテスト」の話題に関する1から10までをカバーしてる本です。これだけ盛りだくさんで、厚さは300ページ程度と薄いのもよいです。でも内容は決して薄くないですよ。これからユニットテストを学ぶひとが最初から通読するのにはとても向いていますし、ある程度実践してるけど、いろいろうまくいっていない人(それは私)にも読み応えあります。

テスト駆動開発ベースの本や、JUnitの使い方の本はいままでもいろいろありましたが、ユニットテストの話題を網羅した、適切なサイズの本はこれまでなかったのではないかと思います。

"xUnit Test Patterns: Refactoring Test Code (Addison-Wesley Signature Series)"や、"レガシーコード改善ガイド (Object Oriented SELECTION)"を読む前に読むのもよいのではないかと推測します(推測なのは、どっちも未だ読んでいないので...)

翻訳されていないのが惜しいです。もし誰も版権とっていないのならば、翻訳したいなー、と本気で思っています。アンオフィシャルに蠢き中ですが、既に翻訳はじまってるよ、などの情報ご存じの方いらっしゃったら教えてください。

そして、ひろってくださる出版社募集中。

アレグザンダー祭りで印象に残った一言など

2010-01-24T10:40:58Z

先日、オブジェクト俱楽部のイベントアレグザンダー祭りに行ってきました。もりだくさんすぎて、未だに消化しきれていないのですが、一点強烈に印象に残ったのは、メインスピーカのJim Coplien氏による、おおむねつぎのような発言です。

俺たちは有用性が証明されたかどうかでなく、流行や気持ちよさ、直観、「のみ」で技術や方法論を追いかけている(ことが多い)

今週になってからtwitterでの議論の中で、こんな発言がありました:

if your only learning comes from asking other people what *they* think - how can you claim to personally know anything?

(このひとは、The Art of Unit Testing: With Examples in .net の著者です。良書なので近々紹介します)

これは開発関連のツールに関連した議論の中で出てきた発言です。意図は、先のJim Coplienの発言と同じだと、私は理解しました。

肝に銘じます。

買い物ログ別館/Kaimono-log bekkan

gepub 0.6.3 with GEPUB::Builder

simple example

rather complicated example

gepub EPUB builder API

simple example

rather complicated example

gepub 0.6.1リリースしました: EPUB3対応、パース対応

Released gepub 0.6.1: a generic EPUB library, supports EPUB3

iBooks AuthorはEPUBオーサリングツールではない

EPUBと同じところ

EPUBと違うところ

違うフォーマットだよね

EPUBオーサリングツールじゃない

GDD2011JP DevQuiz 私の書いた回答コードその2

GDD2011JP DevQuiz 私の書いた回答コードその1

Web Game

Go!

一人ゲーム

ウクレレ コードおぼえるアプリを作ってみた

環境設定メモ: RVM + Ruby 1.9.2 + Rails3

readlineのインストール

RVMのインストール

Ruby 1.9.2をインストールする

Railsをインストール

電書部マークアップvalidatorを作ってみた

gepub 0.1.1 をリリースしました。

EPUB生成ライブラリを作ってみた

EPUB入門メモ

リンク

その他

The Art of Unit Testing

アレグザンダー祭りで印象に残った一言など

ウクレレコードおぼえるアプリを作ってみた