技術書典7で初執筆した経験をすべて公開

技術書典 7 で初執筆しました。

記事の目的

• 執筆でどういったことをしたのかの備忘録
• 執筆を考えている人の助けになりたい

実際に販売する本は ↓ のものです。

技術書典7: silverbirder 詳細

Web Componentsを誰でも簡単に使えるように紹介します！[無料見本誌あり/サンプルコードあり]

techbookfest.org

きっかけ

大学時代の友人である castaneai くんが技術書典 6 で初執筆しました。

#技術書典 6に初サークル参加（App Engine本を出しました） - castaneaiのブログ

4月14日に開催された技術書典6 にサークル参加しました。Google App Engine を使った Webアプリ開発入門の本です。 （▼PDF版は今でも販売中です！） castaneai.booth.pm 作って、頒布して、いろいろな学びがあったのでつらつらと書いていく。 本を作るきっかけ 以前から技術記事を書くのが好きだったので、その延長線上に「本を書く」が浮かんでた。 しかし、本はブログ記事とは違ってぽちっと作れるものでもないので、「いつかは書きたいな〜」という気持ちだけあった。 しかし、そんな中で「技術書典」を見かけて「あ、技術書の同人誌、そういうのもあるのか！」と気付かされる。 そ…

castaneai.hatenablog.com

castaneai くんの話を聞いていると、得られるメリット(実績、交流)が大きいことと、 製本までのフローがそこまで難しくないことを知りました。 そこから、私も参加しようと思えるようになりました。 castaneai くんは、今回の技術書典 7 も参加するみたいです。興味がある方は是非お立ち寄りください。

技術書典7: castaneai 詳細

gRPCをゆるふわに解説していきます！！

techbookfest.org

何をするのか

大きく分けて３つのステップになります。

1. 文章作成
2. 製本
3. 販売準備

それぞれ説明していきます。

1. 文章作成

本は何よりも文章が必要です。 ただ文章を書くだけでは、本になりません。 書籍化するためのツールを使うと効率よく進みます。

1.1. 書籍化ツール

文章を書き、本っぽい見た目にする必要があります。 Re:VIEW Starter というツールを使うと、学習コストゼロで、良い感じの本が出来上がります。

Re:VIEW Starter

kauplan.org

次のコマンド１つで本の PDF が作られます。

docker run --rm -v $PWD:/work kauplan/review2.5 /bin/bash -c "cd /work; rake pdf"

良い感じの本の PDF が作成されました、最高です。

1.2. 他ツール

他にも次のようなツールがあります。

• textlint
  • テキストの表記ゆれを防止
• CircleCI
  • GitOps 的な執筆が可能
• Review Live Reload
  • テキスト更新後の自動 Preview

執筆当初は、これらのツールを調査していました。 しかし、一人で 100 ページ未満の規模の本を書くなら、特に必要ないかなと思ったので導入しませんでした。 実際、なくても困りませんでした。

1.3. レビュー

文章を書いて終わる訳ではないです。 文章の構成や表現が適切に伝わっているか確認する必要があります。 読んでもらいたい対象読書に近い人を探して、レビューしてもらいます。

1.3.1. 1st レビュー

文章をざっくりと作り終えた時点でレビューしてもらいます。 イメージとしては、各章とそれぞれの第一節ぐらいが書き終えている感じです。

各章の構成がおかしくないかをレビューしてもらいます。構成がおかしいと、読者は困惑してしまいます。 後々になって構成を変更すると、後戻りコストが高く付きます。

※ 実際は時間の都合上していません。

1.3.2. 2nd レビュー

各章の文章をとりあえず書き終えた段階でレビューしてもらいます。 これも、1st レビューと同様の目的です。 2st レビューでは、もう少し細かいレベルで章(節)構成をレビューしてもらいます。

1.3.3. 3rd レビュー

コンテンツの構成に問題なければ、ようやく文章の中身をレビューしてもらいます。 例えば、次のようなものを見てくれました。

• 口調の統一 (です、ます）
• 言葉の統一 (本、書籍）
• 主語の明確化
• 文章を短くする
• 内容の誤り修正
• 誤字脱字
• 図や表の挿入

また、GoogleDrive 上で PDF をレビューするのが便利です。 直接文章にコメントできるので、オススメです。

1.5. 本のタイトル

本を買ってもらうためには、本のタイトルは重要です。 本の内容を推測しやすく、かつ、注目してもらえるタイトルにしようと考えました。 私は、特定の技術の入門書を書いたので、「特定の技術 + 入門」という組み合わせにしようと思いました。 結果、「はじめての WebComponents 入門」というタイトルにしました。

1.6. イラストの作成

本には、文章だけでなくイラストが必要になります。 例えば、次のようなイラストが必要になります。

• 表表紙
• 裏表紙
• 背表紙
• 文章中に挿入するイラスト

また、少し内容が異なりますが、次のようなイラストも必要です。

• サークル配置図 案内
• サークルカット
• サークルカット（グレートーン）

表紙用のテンプレートがありますので、それを使います。

背表紙の幅はページ数によって変化します。 私は、70 ページほど予定していたので 4mm 幅で背表紙を描きました。 幅計算は、テンプレート内に詳細が記載されていますので、ご参考下さい。 （日光企画のお姉さんに指摘頂きました）

1.6.1. 初イラスト

私は Photoshop や Illustrator を使ったことがありません。 まずは、環境準備からです。

• iPad
• Magic Pencil

これらを購入しました。 iPad と Magic Pencil を使うと、紙に書いている感覚で、イラストを書けるようになります。 特に良かったのは「手の小指側の面が iPad に接しても無視される」ので、 手の小指側の面を iPad にひっつけながらイラストがかけます。 iPad, Magic Pencil は買って正解でした。 ソフトウェアは、次のとおりです。

• Clip Studio
  • メインのイラストツール
  • iPad
• Good Notes
  • 説明用のイラストツール
  • iPad
• AnyFont
  • 日本語用の Font
  • iPad
• Fire Alpaca
  • イラストの調整
  • iMac

お絵かきが苦手だったので、知人に助けてもらい、なんとか作れました。

2. 製本

製本には、技術書典オススメの日光企画さんにお願いしました。 製本する際には、用紙の種類であったり綴じ方であったりと決める必要があります。

私は、あまりこだわりがないので一般的なものを選択しました。 それは、次のようになります。

【保存版】 #技術書典 初出展マニュアル【表紙入稿データサンプル付き】 - #がみぶろ

gami(@jumpei_ikegami)と申します。 2018年10月8日に開催された「技術書典5」で、『完全SIer脱出マニュアル』という本を頒布しました。 jumpei-ikegami.hatenablog.com 技術書典とは、技術書オンリー同人誌即売会です。 技術書典 僕が所属するサークル「しがないラジオ」は、 技術書典へのサークル参加はおろか、同人誌を作ること自体が初めてでした。 なんとか無事に入稿も終え、当日を迎えることができました。 しかし、正直に言って、同人誌作りのノウハウはインターネット上にまだまだ足りないと思います。 特に入稿作業にまつわる細かい情報について、 印刷用語や…

jumpei-ikegami.hatenablog.com

を参考にしました。

本文はじまりのページは、nombre をというものを設定する必要があります。 Re:VIEW Starter は nombre 対応していて、次のコマンドを叩くだけです。

docker run --rm -v $PWD:/work kauplan/review2.5 /bin/bash -c "cd /work; rake pdf:nombre"

用紙についてこだわりたい方は、次のリンクにあるようにサンプルを手に入れると良いでしょう。

natuna.jp

natuna.jp

3. 販売準備

3.1. 物品購入

技術書典では、会場で本を販売することになります。 販売するサークルブースを目立たせるために、いくつか物品を準備しました。

#技術書典 開催前に準備しておくといいもの｜mochikoAsTech

技術書典サークル参加勢に向けて「これ持ってくと便利！」とか「ここに注意して！」とか準備しておくといいもの・ことをまとめましたー。 持ち物編 ダイソーの折りたたみ式カードスタンド、こんな感じで値札を入れて置くのに便利。角度も変えられるし、使わないときは真っ平らにたためるので鞄の中で場所も取らないよー。2つで100円。白いカードも入ってるので手書きで値段書くだけですぐ使える。#技術書典 pic.twitter.com/urTTxqn7fT — mochiko＠4/14 技術書典6【あ02】で #技術をつたえるテクニック を頒布 (@mochikoAsTech) March 26,

note.mu

【技術書典5 入稿後〜イベント前夜編】入稿して気が抜けているときに読みたい宣伝活動と事前準備の話 - VTRyo Blog

「セイチョウ・ジャーニーができるまで」シリーズ第5弾です。 この記事のおしながき

blog.vtryo.me

yagitch.comの用意周到な技術書典6（イベント直前編）｜yagitch

みなさん、技術書典6お疲れ様でした！ この記事では私が技術書典6で冊子400部完売するまでにやったすべてのことをまとめていこうと思います。はじめから読むならこちらからどうぞ。 入稿後のタスク 本の入稿が終わり、本が出ることだけは確定しましたが、その時点で追加でやることは山ほどありました。この時点ではまだ表紙は決まったばかりなので、それぞれの告知チャネルで表紙を反映したお知らせに差し替える必要があります。TLには既にサークルチェックを終えた人が出てきていたので、急がないと古い情報のまま読み飛ばされてしまいます。 しかしそれより急がないといけないのはダウンロードカードのデータ作成で

note.mu

印刷する手段は 3 つあります。

• 細かいもの
  • 1 つのファイルにしてセブンイレブン印刷
• 大きなもの
  • ソクプリで印刷
• 大量印刷
  • プリントパックで印刷

3.2. 電子書籍の準備

ピクシブ社のサービスである Booth を利用しました。

BOOTH - 創作物の総合マーケット

BOOTH（ブース）とは、pixivと連携した、創作物の総合マーケットです。無料で簡単にショップを作成でき、商品の保管・発送代行サービスも提供しています！

booth.pm

特に専門的な知識が必要なことがなく、本の PDF を登録するだけです。 せっかく足を運んで会場に来て頂いた方のために、電子書籍と物理本の違いを出そうと考えました。 （中身のデータは同じです） そこで、物理本を購入して頂いた方には、無料で電子書籍をプレゼントすることにしました。 技術書典ではよくある方法だそうです。

また、サンプルの本をアップロードし、無料でダウンロードできるようにすることで、 事前に本の中身を確認できるようにしました。

ただ、ダウンロード数を見る限り、あまり数は多くありませんでした。 Google Analytics (初登録)と Booth が連携できるので、流入数を見れるのですが、 離脱率が 86%という悲しい結果を知りました。ここは改善の余地がありそうです。

pixiv ID 登録しないとダウンロードできないので、ここが駄目ならサービスを使わない方が良いかもしれません。 見本誌に限っては、GoogleDrive で渡すようにするとかですかね。

3.3. 支払い手段の準備

技術書典では、次のような支払手段を用意しました。

• 公式かんたん後払い
• pixiv pay

前者は、技術書典で口座情報を登録すると利用できます。 後者は、アプリをダウンロードして商品を登録するだけです。無料です。

他にも PayPay や Kyash といった手段も用意しようか迷ったのですが、やめました。 理由は、支払い方法が若干複雑そうでしたからです。

4. その他

宣伝

この本のことを広く知ってもらうためには、宣伝が必要です。 私が取った宣伝手段は次の通りです。

1. Twitter で "#技術書典 7" タグ
2. LINE の OpenChat や TL
3. FaceBook
4. 本の内容と関係する勉強会ハッシュタグ
5. 会社
6. 友人

あとは、勉強会に参加して宣伝する手段もあります。

「興味を持ってくれそうな人」が「多い」場を探す必要があります。 例えば、4 番は事前に connpassで関係がありそうな勉強会を調べて、 該当ハッシュタグで宣伝したりしました。 また、積極的に 1 番を実施していると、他のサークル参加さんがリツイートしてくれるため、とても助かりました。

Twitter で宣伝するために、16:9 の画像を用意したりもしました。

被チェック数と販売冊数

被チェック数は、お客さんが気になる本をチェックした数になります。 この数字から、印刷する冊数を決める大きな要因になります。

印刷部数の決め方ガイド〜技術書典7に向けて｜yagitch

技術書典に初めてサークル出展する方に向けて、印刷部数をどうやって決めたら良いのか？ 需要をどうやって予測したらいいのか？ ということを順序立てて解説していこうと思います。 なお、ここに書いていることはすべて一サークル主がまとめただけの非公式のものです。 情報源は ・技術書典5〜6の公式アンケート調査結果 ・運営主催の事前イベントでの公開情報 ・サークル主たちのブログ記事・ツイート等 ・自分の経験（技術書典5、6にサークル参加） の4つです。 結論は最後にまとめています。 売れ行きを左右する要因 まず、売れ行きを左右する要因たちを挙げてみます（だいたい重要度順）。噂レベルの

note.mu

恥ずかしい話になりますが、私は毎朝この数字を見ていました。（笑）

GitHub - silverbirder/get-checked-number-for-techbook

Contribute to silverbirder/get-checked-number-for-techbook development by creating an account on GitHub.

github.com

被チェック数を定期的に取得する API をサクッと作って、CloudFunction で稼働させています。

このようにどの時間やどの曜日にチェックされるのかがわかるようになります。

今回、300 冊を印刷することにしました。間違いなく残ってしまうと思うので、 とらのあなさんへ委託しようと考えています。

技術同人誌の委託販売なら、とらのあなにお任せください！ - とらのあな総合インフォメーション

技術書典にご出展されるみなさま、はじめまして。同人ショップとらのあなです。 とらのあなでは技術同人誌作品のご委託を承っております。 お預けいただいた作品は、店頭と通販にてイベント終了後すぐに販売いたします。 また、当社エンジニア部署「虎の穴ラボ」の全面協力により、「エンジニアによる手書きPOPの作成」 「特設ウェブページでの紹介」など、他にはないサービスもございます。

news.toranoana.jp

残ってしまったいくつかの本は、お家に保存用として持ち帰ろうと考えています。（笑）

公式ツイッター

公式ツイッターアカウントをフォローしておくと、なにかと便利です。

twitter.com

twitter.com

Google カレンダー 登録

技術書典のスケジュールが登録されている Google カレンダーを、ご自身のカレンダーにも登録することをオススメします。

いつまでに何をしないといけないのか逆算できるので、知っておいたほうが良いです。

スケジュールと実績

公式予定と私の実績は次のとおりです。

※ レビュー依頼中に、表紙等のイラスト作成を並行して進めていました。

サンプルコードを書いている時は、「こんな話も増やそうかな？」と楽しい気分になれました。 原稿を書いている時は、「予定日の ◯◯ 日には終わらせないと…」という苦しい時期がありました。 なんだかんだで、日光企画さんの早割チケットを手に入れれたので満足です。

終わりに

私が今回、初執筆した経験を包み隠さずすべて公開しました。 執筆をやってみてよかったことは次のとおりです。

• 本を作るのは、意外と簡単
  • ツールやサービスが十分整っている
• 書いた本が好きになる
  • いろんな人にみてほしい
  • 書いた知識は、とても定着する
• コミュニティが楽しい
  • "#技術書典"のハッシュタグはオススメ
  • フォロワーが増えた

逆につらかったことは次のとおりです。

• ずーっと本のことを考える
• 締め切りに追われる
• 文章力のなさを痛感する

初執筆しようと考えている人にとって、何かの助けになれば幸いです。

あとは、技術書典 7 当日を楽しむだけ！！