SlideShare a Scribd company logo
1 of 46
Download to read offline
GitHubで

雑誌・書籍を作る
稲尾尚徳
WEB+DB PRESS編集部(技術評論社)
2014/06/01 GitHub Kaigi
どんな雑誌・書籍を
作っているか
WEB+DB PRESS
• 初公開! 6月24日発売
• 明日入稿だけどたぶん

この表紙で確定
• @naoyaさんのGitHubの記事
もあります
WEB+DB PRESS plus
• 現在40冊
• @hirocasterさんのGitHubの本もあります
どんな人と

作っているか
執筆陣は一流のエンジニア
@naoyaさん :雑誌、書籍( 3冊!)、ムック
@hirocasterさん:雑誌、書籍、ムック
@amatsudaさん :雑誌、ムック
@miyagawaさん :雑誌( Vol.2から!)、ムック
@kenchanさん :雑誌、ムック
@yandodさん :雑誌、書籍( 2冊!)
!
※本日の登壇者・運営チームより(登場順。漏れがあったらすみません)
※会場にはもっとたくさん!
どのように
作っているか
使っているツール
• GitHubで原稿管理とやりとり
• md2inaoで原稿テキストの変換
• Adobe InDesignで紙面レイアウト
md2inaoとは何か
• Markdownで書かれたテキストを、

WEB+DB PRESS/WEB+DB PRESS plus用の
InDesignテキストに変換するツール
• ソースコードの文字数チェック機能なども備えて
いる
md2inaoの

簡単な歴史
詳細はこちら
https://gist.github.com/inao/baea09bc6fc53551886b
md2inao以前(∼2010年)
プログラミング雑誌の原稿中でもぜったいに登場しない

全角を駆使した編集記号での執筆をお願いしていた。
• ■大見出し
• ◆b/◆太字◆/b◆
• ◆i/◆イタリック◆/i◆
• ◆ルビ/◆技評◆ぎひょう◆/ルビ◆
この編集記号からInDesignテキストに変換するプログラム
を、別途編集部で持っていた。

https://github.com/inao/idtagreplacer
markdown2inao.plの誕生
(2010年)
「そんなわけのわからない記法で書けるか!」

ってことで、@typesterさんが自身の執筆用に
Markdownから編集記号に変換するスクリプトを
作り、Gistでも公開してくださった。
markdown2inao.plの成長
(2010∼2012年)
その後、@hsbtさん、@hokacchaさん、

@suzukiさん、@syohexさんといった方が、

Gist上で少しずつ、そして時には大きく改善してく
ださった。
markdown2inao.plから
md2inaoへ(2013年)
昨年春、@naoyaさんが連載スタートを機に

GistからGitHubに移行し、名前もmd2inaoにあら
ため、マニュアル、テスト、Travis CI、Web版な
どもそろえてくださった。
md2inao.plができるまで - Togetterまとめ
http://togetter.com/li/465621
もはやinaoではない
現在のmd2inaoは、InDesignテキストに変換する
機能も備えたため、編集もMarkdownで行い、
MarkdownからInDesignテキストに直接変換して
います。
ですので実態としては、もはやmd2inaoではなく
md2indesignです。
md2inaoの近況
2013年春の@naoyaさんの怒涛の更新ラッシュが
去ったあと、しばらく沈黙が続いていましたが、
ここ最近、@gfxさんの特集の執筆を機に、@gfx
さんによるCPAN化、@naoyaさんによるHeroku
への自動デプロイ機能など、再び進化しました。
md2inaoの今後、あるいは

おんぶにだっこな開発の未来
@gfxさんの記事も明日印刷所に入稿しちゃうの
で、再びの沈黙も予想されています。
なお、現在Issueは14個ほど挙がっています。
https://github.com/naoya/md2inao/issues?state=open
InDesignテキストとは
何か
正確には

InDesignタグ付きテキスト
• 文字周りのスタイルをひと通り設定できる
• 画像周りは取り扱えない
• Re:VIEWなどが対応しているInDesignのXML
だと、画像なども扱える
• ただXML版でも、2段組のWEB+DB PRESS
のレイアウトまでを行うのは難しそうとのこと
md2inaoで変換したこんな感じの
テキストをInDesignに取り込むと
<ParaStyle:大見出し>GitHub
<ParaStyle:本文> GitHubはもはやお馴染みですね。GitHub
はGitのリモートリポジトリとして利用できるWebサービスで、
ほかのユーザに向けてソースコードを共有・公開できます。ほ
かの開発者とのコミュニケーションにもよく利用されることか
ら、「プログラマのためのソーシャルネットワーク」と呼ばれ
ることもあります(<CharStyle:太字>図1<CharStyle:>)。
── 伊藤直也著「Emerging Web Technology研究室」第8回「GitHubを使った
Pull Requestベース開発プロセス」『WEB+DB PRESS Vol.81』、技術評論社、
2014年、p.144
こんな簡易PDFができます
※前述した@naoyaさんの
原稿をサンプル用に切り
貼りしたため、文章はつ
ながっていません
GitHubをどのように
使っているのか
詳細はこちら
http://d.hatena.ne.jp/naoya/20140127/1390815492
ブランチモデル
• 作業者が、WIP(Work In Progress)な

Pull Requestを送る
• 執筆時は、著者さんがWIP Pull Requestを出す
• 編集時は、編集者がWIP Pull Requestを出す
• これを繰り返していくことで完成させる
• 複数人での執筆、複数章に分かれた執筆、同時進
行の作業などの場合は、Pull Requestからさらな
るPull Requestを派生させることもある
たとえばこんなPull Request
コミット
• コミット数は、特集でだいたい500くらい
• 基本的な校正時には見出し単位でコミット
• <見出し名>を校正した
• 意図を伝えたい変更は、ピンポイントでコミット
• ○○と重複しているので削除した
• 話題が変わったので段落分けを行った
• SourceTreeだと、hunkより細かい行単位で選択
したコミットがやりやすい
• revertする/される可能性がある変更も、その変更のみ
でコミット
フィードバック方法
• Pull Requestの確認時に気がついたものは、
GitHub上でコメント
• テキスト上での校正時に気がついたものは、

テキスト中に直接書き込み
• ★○○などの★ライブラリがあります。
• ★なぜ、☓☓なのかがちょっとわかりませんで
した★
• これらのコメントは簡易PDFでは赤字になる
これくらいの活用状況
プライベートリポジトリなので
みなさんから見るとこんな感じ
GitHubで何が変わったか
• 進 状況が見える化された
• 従来はアウトライン、草稿、完成原稿の3回くらい
• Issue/Pull Requestによりメールを使わなくなった
• 特集だと100を超えるメールをやりとりしていた
• コミットメッセージで変更意図を伝えやすくなった
• メールあるいは原稿テキスト中に書く必要があっ
たので、従来は大きなものしか伝えなかった
• 思い切った変更の提案が行いやすくなった
• Pull Requestの破棄やrevertがあるので
どれくらいGit/GitHub
を使いこなしているか
ごく基本的なことしか

できません
• そのときどきで、著者さんに教えていただきなが
ら習得していっています
• 著者さんの寛容さに助けられています
• 使い方が適当でも許してくださる
• 使い方がわからないときは教えてくださる
Git/GitHubの習得
• Gitの学習(2009年)
• GitメンテナのJunio C Hamanoさんに

「はじめてのGit」を書いていただいて
(「開発ツール徹底攻略」にアップデート版を収録)
• Gitの実戦投入(2009年)
• @tyanoさん、@yoshioriさんの特集原稿で
• GitHubの実戦投入(2013年)
• @amatsudaさん、@idesakuさんの特集原稿、

@naoyaさんの連載原稿で
• Joined on Nov 19, 2008でした
プライベートリポジトリをforkしてPull Request
がきたけど、fork先のプライベートリポジトリ
にはアクセス権がないのでcheckoutできない
急にmasterが
pullできなくなった
まとめとして

背景にある経験・考え
雑誌・書籍作りは、ソフトウェア
開発に近づけたほうがうまくいく
• 著者さんの普段のワークフローに近いから?
• 雑誌や書籍もソフトウェアだから?
おんぶにだっこされながらも
できるだけ取り入れたい
• GitHubによる常時共有、バージョン/課題管理
• Markdownという書き慣れた記法による執筆
• HTMLや簡易PDFの作成による常時結合
• 簡易PDFは常時ではないですけど><
• レビューによるフィードバック
編集者はゼロを1にはできないけど、1を2にする
お手伝いはできるかもなので(とゆうかそれがお
仕事なので)、著者さんが一人で苦闘しないよう、
こまめな成果物やフィードバックを。
ご注意事項
GitHubのプライベートリポジトリ
はご用意いただく必要があります
• 現時点で当社でご用意できるのは、試験運用中
のGitLabのみ(バックアップなし)
• 1媒体1リポジトリとすると、当社全体だと年間
約400のプライベートリポジトリが必要
• 増刷や改定もあるので、1年だけ維持すれば良
いわけではない
• 実際には雑誌は1記事1リポジトリほしいので、
僕一人でも年間50リポジトリ程度必要
ご参考:Vol.81での勢力図
あくまで私の場合のお話です
• 今回の発表内容はあくまで僕の場合のお話です
• WEB+DB PRESS編集部の人は

だいたい同じようなやり方でいけます
最後に
ハブでありたい
GitHubさんにはとうてい及びませんが、

WEB+DB PRESSはエンジニアの方々の

ハブの一つでありたいと願っています。
読者の方同士、著者さん同士、読者の方と著者さん、
さまざまなプログラミング言語や技術、

誌面を通して、これらをつなぐハブになりたいです。
そのためには、、、
書いてください
or
読んでください
ご静聴ありがとう

ございました

More Related Content

What's hot

Apache Arrow - データ処理ツールの次世代プラットフォーム
Apache Arrow - データ処理ツールの次世代プラットフォームApache Arrow - データ処理ツールの次世代プラットフォーム
Apache Arrow - データ処理ツールの次世代プラットフォーム
Kouhei Sutou
 

What's hot (20)

FPGA+SoC+Linux実践勉強会資料
FPGA+SoC+Linux実践勉強会資料FPGA+SoC+Linux実践勉強会資料
FPGA+SoC+Linux実践勉強会資料
 
SSE4.2の文字列処理命令の紹介
SSE4.2の文字列処理命令の紹介SSE4.2の文字列処理命令の紹介
SSE4.2の文字列処理命令の紹介
 
ビッグデータ処理データベースの全体像と使い分け
ビッグデータ処理データベースの全体像と使い分けビッグデータ処理データベースの全体像と使い分け
ビッグデータ処理データベースの全体像と使い分け
 
いまできるデータ分析を Power BI ではじめよう
いまできるデータ分析を Power BI ではじめよういまできるデータ分析を Power BI ではじめよう
いまできるデータ分析を Power BI ではじめよう
 
目grep入門 +解説
目grep入門 +解説目grep入門 +解説
目grep入門 +解説
 
PostgreSQLモニタリング機能の現状とこれから(Open Developers Conference 2020 Online 発表資料)
PostgreSQLモニタリング機能の現状とこれから(Open Developers Conference 2020 Online 発表資料)PostgreSQLモニタリング機能の現状とこれから(Open Developers Conference 2020 Online 発表資料)
PostgreSQLモニタリング機能の現状とこれから(Open Developers Conference 2020 Online 発表資料)
 
私とOSSの25年
私とOSSの25年私とOSSの25年
私とOSSの25年
 
PostgreSQLモニタリングの基本とNTTデータが追加したモニタリング新機能(Open Source Conference 2021 Online F...
PostgreSQLモニタリングの基本とNTTデータが追加したモニタリング新機能(Open Source Conference 2021 Online F...PostgreSQLモニタリングの基本とNTTデータが追加したモニタリング新機能(Open Source Conference 2021 Online F...
PostgreSQLモニタリングの基本とNTTデータが追加したモニタリング新機能(Open Source Conference 2021 Online F...
 
MySQLアーキテクチャ図解講座
MySQLアーキテクチャ図解講座MySQLアーキテクチャ図解講座
MySQLアーキテクチャ図解講座
 
5分でわかるブロックチェーンの基本的な仕組み
5分でわかるブロックチェーンの基本的な仕組み5分でわかるブロックチェーンの基本的な仕組み
5分でわかるブロックチェーンの基本的な仕組み
 
オススメの標準・準標準パッケージ20選
オススメの標準・準標準パッケージ20選オススメの標準・準標準パッケージ20選
オススメの標準・準標準パッケージ20選
 
Apache Arrow - データ処理ツールの次世代プラットフォーム
Apache Arrow - データ処理ツールの次世代プラットフォームApache Arrow - データ処理ツールの次世代プラットフォーム
Apache Arrow - データ処理ツールの次世代プラットフォーム
 
Surveyから始まる研究者への道 - Stand on the shoulders of giants -
Surveyから始まる研究者への道 - Stand on the shoulders of giants -Surveyから始まる研究者への道 - Stand on the shoulders of giants -
Surveyから始まる研究者への道 - Stand on the shoulders of giants -
 
ビジネスパーソンのためのDX入門講座エッセンス版
ビジネスパーソンのためのDX入門講座エッセンス版ビジネスパーソンのためのDX入門講座エッセンス版
ビジネスパーソンのためのDX入門講座エッセンス版
 
Fiberの使いどころ
Fiberの使いどころFiberの使いどころ
Fiberの使いどころ
 
Object as Points
Object as PointsObject as Points
Object as Points
 
Node.js Native ESM への道 〜最終章: Babel / TypeScript Modules との闘い〜
Node.js Native ESM への道  〜最終章: Babel / TypeScript Modules との闘い〜Node.js Native ESM への道  〜最終章: Babel / TypeScript Modules との闘い〜
Node.js Native ESM への道 〜最終章: Babel / TypeScript Modules との闘い〜
 
大規模言語モデル開発を支える分散学習技術 - 東京工業大学横田理央研究室の藤井一喜さん
大規模言語モデル開発を支える分散学習技術 - 東京工業大学横田理央研究室の藤井一喜さん大規模言語モデル開発を支える分散学習技術 - 東京工業大学横田理央研究室の藤井一喜さん
大規模言語モデル開発を支える分散学習技術 - 東京工業大学横田理央研究室の藤井一喜さん
 
近年のHierarchical Vision Transformer
近年のHierarchical Vision Transformer近年のHierarchical Vision Transformer
近年のHierarchical Vision Transformer
 
エンジニアの個人ブランディングと技術組織
エンジニアの個人ブランディングと技術組織エンジニアの個人ブランディングと技術組織
エンジニアの個人ブランディングと技術組織
 

GitHubで雑誌・書籍を作る