はじめに
先日、Kindleで技術書『Java 21 スペシャリスト育成問題集 〜300問で鍛える実務Javaエンジニアの知識体系〜』を個人出版しました。全20章・300問の5択問題集で、Java 21の言語仕様からSpring Boot、JPA、テスト、DevOps、可観測性まで、実務バックエンド開発の知識体系を問題形式で鍛える構成です。
この記事は書籍の内容紹介ではなく、出版まで・出版後今日までに戦った2つの品質問題の記録です。
- コンテンツ品質:5択×300問で発生する「正解位置の偏り」と「選択肢の長さバイアス」
- レンダリング品質:KindleのEnhanced Typesetting(KFX)が原稿のスタイルを容赦なく上書きしてくる問題
どちらも「原稿を書き上げた後」に待っている戦いで、事前に知っていれば工数を大幅に節約できたはずのものです。同じ道を通る方の参考になれば幸いです。
第1の敵:正解位置の偏りと長さバイアス
問題集には「解かずに当てられる」メタパターンが潜む
5択問題を300問書くと、著者が意識していなくても統計的な偏りが生まれます。全問題を集計して分かった偏りは2種類ありました。
1. 正解位置の偏り
人間が問題を書くと、正解の選択肢を特定の位置(特にBやC)に置きがちです。読者が「迷ったらCを選ぶ」で期待値以上に正答できてしまうと、問題集としての測定機能が壊れます。
2. 「最長の選択肢が正解」パターン
これが厄介でした。正解の選択肢は正確さを期すために自然と説明が長くなり、誤答(ダミー)は短くなりがちです。全300問について各選択肢の文字数をCSVに吐き出し、「正解の文字数 > 誤答の平均文字数」となる問題にフラグを立てて集計したところ、無視できない割合で該当していました。資格試験の受験テクニックとして知られる「一番長い選択肢を選べ」がそのまま通用する状態です。
対策:配分をデータで管理する
対策は次の2段階で行いました。
- 長さバイアス:フラグが立った問題について、誤答選択肢に条件や補足を足して長さを平準化(正解を削るのではなく誤答を膨らませる方向で。正解の記述の正確さを落とさないため)
- 位置バイアス:300問の正解位置を A53 / B53 / C52 / D52 / E52 にほぼ均等再配分
再配分は手作業では不可能なので、「問題番号 → 現在の正解位置 → 新しい正解位置」を定義したリマップ計画CSVを作り、スクリプトで一括適用しました。1問の適用は選択肢の入替だけでは済みません。
- 正解選択肢と移動先選択肢のテキストを入替
- 解説の「正解は X.」表記を追従
- 「他の選択肢が誤りである理由」など、選択肢記号を参照している解説6見出しをすべて追従
- 巻末の正答一覧(第97章)の該当行を更新
適用後は「本文・リマップ計画・巻末正答一覧」の三者照合スクリプトを回し、不一致0件を確認して完了、という運用です。
失敗談:機械的に直したら、それ自体がパターンになった
正直に書きますが、最初のリマップは失敗しました。
配分を均すことだけを考えて機械的に割り付けた結果、単一正解の問題の正解位置が A→B→C→D→E→A→B→…と完全に循環する配置になってしまったのです。偏りは消えましたが、代わりに「前の問題の正解がCなら次はD」という、元の偏りよりよほど悪質なメタパターンを自分の手で埋め込んでいました。
v2の計画では、配分(A53/B53/C52/D52/E52)を保ったまま循環性だけを崩すように再設計し、単一正解212問を再リマップしました(複数正解の38問は位置概念が異なるため据え置き)。
教訓:「偏りがない」と「規則性がない」は別物。乱数っぽく見えるかの検証まで含めて品質管理です。
第2の敵:EPUB/KFXレンダリング
Kindle Previewer 3は実機を再現しない
原稿はMarkdownからEPUBを生成し、KDPにアップロードする構成でした。ここで最初にハマったのが検証環境です。
Kindle Previewer 3で完璧に表示されても、実機のKindleでは崩れます。KindleのEnhanced Typesetting(KFX)はPreviewerのレンダリングと一致しないケースがあり、最終的に信頼できる検証方法は次の2つだけでした。
- Send to Kindle で実機に送って確認
- KDPに実際にアップロードし、ストアからダウンロードして確認
「Previewerで確認したからOK」は通用しない、というのが最大の学びです。
Enhanced Typesettingブロッカーの除去
KFXでの配信にはEPUB内に「ETブロッカー」と呼ばれる要素が含まれていないことが条件になります。生成したEPUBから除去が必要だったのは次のようなものです。
- form系要素
- 空のアンカータグ
- 負の値を持つCSSプロパティ
display: noneoverflow-x-
a:hover疑似クラス
Markdown→EPUB変換ツールが出力するデフォルトのCSSやテンプレートにこれらが普通に含まれているため、生成のたびに後処理スクリプトで除去する運用にしました。
<code>タグはKFXに上書きされる
技術書として一番深刻だったのがこれです。インラインコードを意味論的に正しい <code> タグでマークアップしていると、KFXがフォントやサイズ指定を独自スタイルで上書きし、意図したレンダリングになりません。
対策は、セマンティクスを捨てて <span class="icode"> のようなクラス付きspanに変換すること。本書では6,000箇所以上のインラインコードを一括変換しました。もちろん手作業ではなくスクリプトで、変換前に対象件数をassertで検証してから適用しています。
# イメージ(実際は置換対象の件数をassertで固定してから実行)
count = html.count('<code>')
assert count == expected_count, f"想定外の件数: {count}"
html = html.replace('<code>', '<span class="icode">').replace('</code>', '</span>')
フォントサイズは「指定しない」が正解の領域がある
本文(body / p / li)にfont-sizeを指定すると、読者側のフォントサイズ変更機能と競合します。最終的に落ち着いた方針は、
- 本文:font-size指定なし(読者のリーダー設定に委ねる)
- コードブロック・表・奥付:本文比で相対的に小さく指定
という「制御する場所と手放す場所を分ける」設計でした。
再生成との戦い
もう1つ運用上の罠として、原稿を修正してMarkdownからEPUBを再生成すると、EPUBに直接施したCSS修正やETブロッカー除去がすべて消えます。修正一式を再適用可能なスクリプト群として整備しておかないと、原稿を1文字直すたびに手作業が全部やり直しになります。EPUBへの後処理は最初から自動化前提で組むことを強くおすすめします。
学んだこと
- 問題集の品質は「1問1問の正しさ」だけでなく、300問を集合として見たときの統計的性質(正解位置の分布、長さの分布、規則性の有無)で決まる
- 偏りの修正はCSVで計画を管理し、スクリプトで適用し、照合スクリプトで検証する。手作業とセルフレビューでは300問を守り切れない
- 「原稿が正しいこと」と「Kindleで読める形になること」は完全に別の戦い。KFXは原稿のセマンティクスを尊重してくれない
- 検証は実機とストア配信物で行う。Previewerは参考程度
書籍について
『Java 21 スペシャリスト育成問題集 〜300問で鍛える実務Javaエンジニアの知識体系〜』
- Java 21の新機能に加え、コレクション、並行処理、JPMS、設計、JPA/Hibernate、Spring Boot、REST、セキュリティ、テスト、DevOps、可観測性、デバッグまで全20章・300問
- Java 21正式機能 / Preview機能 / Jakarta仕様 / Spring Boot固有機能を明確に区別して解説
- 対象読者:Javaの基本文法を学習済みで、実務レベルを目指すエンジニア
- 価格:発売後4週間は450円、以降は定価900円
サンプルコードはGitHubで公開しています(Gradleマルチモジュール構成):
https://github.com/x5gtrn/java21-specialist-training-workbook-sample-code-ja