6.1 GitHub Oriented Writing 当選通知 ネタ出し企画会議 リホジトリ作成 目次案作成 執筆 & 修正 レピュー PR 「「e 「 ge 執筆終了 編集作業 印刷所入稿 よく分かる図解 △図 6.1 大まかな流れは次のとおりです。 1. 企画会議に先立って 1 つの lssue に知りたいネタを書き込む 2. オフラインで集合し、ネタの分配や争奪戦を行う 3. 1 冊 = 1 リポジトリでプライベートリポジトリを作成する 4. 1 ネタ = llssue = 1 章という単位で目次案を書く 5. ひたすら書く。 master に直 push で OK 6. レビューを受ける 7. レビュー指摘の修正作業を行う 8. 編集者が校正 & 調整作業に人る ( 直 push の禁止。変更は pull request を送る ) 9. 印刷所への人稿作業。このフェーズから GitHub は利用されなくなる 51

第 1 章技術書を書くための要求 れ 4 同人誌向けの Re : Ⅵ EW 構成を使用する Re:VIEW は優れた書籍制作ツールですが、そのままでは入稿できません。印刷所ごと に紙面レイアウトに人稿条件があり、それらを満たす必要があるからです。 たとえば多くの印刷所ではノンプル ( ページの通し番号 ) が必須です。乱丁を防ぐ目的 で導人されていますが、これは同人誌独特のルールで、標準の Re : VIEW では対応してい ません。 それら人稿データを作成するはじめの一歩として、 TechBooster ではリポジトリを公開 しています。ノンプルもサポートしつつ、見やすいレイアウトに変更しています ( 本書も 全ページに通し番号がついています ) 。 https://github.com/TechBooster/C89-FirstStepReVIEW-v2 同人誌制作が初めてという場合は上記リポジトリからの Clone を強く推奨します。 このリポジトリでは、 B5 (JIS) サイズでノンプルを追加した専用レイアウトを使用し ています。後述の方法で日光企画さんに人稿経験のあるサンプルプロジェクトです。はじ めての執筆で利用するにはうってつけです。 しかしながらすべての印刷所で大丈夫とは限りません。印刷所ごとに人稿ルールは異な ります。人稿に先立ってサンプルを用意し、印刷所の指示にしたがって人稿データを作成 してください。印刷所が変わる場合は、きっとカスタマイズが必要です。そのための雛形 として活用してください。本書のリポジトリは一番手間がかかるノンプルの間題を解消し ているので、すべてを自分で解決するよりは楽なはずです。

第 2 章環境を整える Docker を使ってどこでもビルド Ruby 人れたり TeX 人れたりめんどくさすぎる ! イメージを用意。してあります。 という人のために Docker の $ docker run —i —t vvakame/review —v $ (pwd) : /book /bin/bash 18 https : //hub. docker . com/r/vvakame/review/ master/build—in—docker . sh ・ https : //github . com/TechBooster/C89—FirstStepReVIEW-v2/b10b/ してください。 実用的な例を知りたい場合は、この本のリポジトリの build-in-docker. sh を参照 適宜コンパイル用のコマンドを実行してください。 す。コマンド実行後のディレクトリは /book ディレクトリにマウントされます。 コマンドを実行すると、 review と latex の実行環境が整った環境が直ちに使えま

第 6 章ワークフロー 54 ・表紙データ : 表紙は本文と別の形式で人稿する 書のリポジトリ十日光企画さんを使うとトラブルなく人稿できる可能性が高くなります ) 。 TechBooster が過去に遭遇した事例では次のとおりです ( 印刷所選びに不安があれば本 じてくれるでしよう。 とよいでしよう。だれもが最初から熟練者ではありません。初めての人の相談にも快く応 腕の見せ所といえます。紙の種類も多数あるため詳細を知りたい場合は印刷所に相談する マンド印刷でも十分な品質を得られるケースがあります。とくに品質については印刷所の 一般的にオフセット印刷のほうが品質がよいですが、近年の印刷技術向上によりオンデ ります。 100 部 ~ の印刷に適しています。版を作る手法で、ロット数に応じて単価が安くな オフセット印刷 方、単価は高めです。 ~ 100 部の小口ット印刷に適しています。印刷に使う版を作らないので手軽な一 オンテマンド印刷 人稿に先立って知っておく知識として、部数に応じて適した印刷手法が異なります。 予定の印刷所が指定するフォーマット、注意点を熟読して人稿に挑みましよう。 すので日光企画さんの事例に限って人稿に必要な知識をみていきましよう。実際には人稿 かといって、すべてを説明すると流れを理解するまえに頭がパンクしてしまいます。で 定があったり、さまざまです。 裁位置の目印 ) がないと受け付けてもらえなかったり、利用ソフトウェアのバージョン指 たとえば表紙データは印刷所ごとテンプレートが異なったり、人稿用本文にトンポ ( 断 というものはありません。 ます。実のところ、印刷所ごとに印刷工程が違い、すべてで通用するスタンダードな方法 こから先は TechBooster が日光企画さんへ人稿した場合の手順として解説していき https://github.com/TechBooster/C89-FirstStepReVIEW-v2 な同人誌特有の間題を回避できます。 用する前提です。本書のリポジトリを CIone している場合、ノンプル ( 通し番号 ) のよう 第 1 章「技術書を書くための要求」で述べたとおり、同人誌向けの Re : VIEW 構成を使 際の事例をベースに解説します。 印刷所へ最終的な印刷用データを渡すことを人稿と呼びます。本節では人稿について実 6.3 入稿のための最終出力を作る

第 7 章 役に立つ豆知識 技術書を作る際に詰まる部分をまとめました。知らなければたどり着かない知識や、 ちょっとした工夫など便利なテクニックを紹介します。 7-1 推奨するディレクトリ構成 TechBooster が推奨するディレクトリ構成を述べておきます。要点は次のとおりです。 具体的にはリスト 7.1 です。 リポジトリのトップレベルにはファイルをあまり散らかさない ・複数人で執筆した時にそれぞれのファイルが混ざったり邪魔になったりしないよう ビルド手順を統一するために何らかのタスクランナーを使う (TechBooster の場 著者全員で利用する review のバージョンを固定する にする 合、 Node. js 十 grunt) ティレクトリ構成 README . md circle . yml setup. sh Gemfi1e Gemfi1e . lock トーーーー package ・ j son npm—shrinkwrap ・ j son トーーー Gruntfi1e. js articles トーーー catalog ・ yml config ・ yml prh リスト 7.1 ( CI サービスである Circ1e CI の設定ファイル ) ( 執筆前に gem やⅡ pm のインストールを行うスクリプト ) (bundler 経由で Re:VIEW を利用するための設定ファイル ) ( ライブラリのバージョンをロックする ) (grunt を利用するための npm 用設定ファイル ) ( ライブラリのバージョンをロックする ) (grunt の動作設定ファイル ) (Re:VIEW 用章立ての設定ファイル ) (Re:VIEW 用本を生成する時のメタデータ記述ファイル ) (language-review 用校正設定ファイル ) 64

6.3 入稿のための最終出力を作る 本文テータの作成方法 本文データは PDF 形式で人稿します。また Adobe Acrobat pro が必要 * 3 です。 ページ数は基本的に 4 の倍数になるように揃えて人稿します。ならない場合は無理やり 白いページを挟むこともあります。またページごとにノンプル ( ページの通し番号 ) が必 要です。たとえ白であっても、番号をいれます。同人誌以外では見ない制約ですが、乱丁 を防ぐためにつけています。レイアウトは指がかかるのと本のノド ( 綴じている側の余 白 ) があるので余裕を持った設定をしています。読みやすさに直結するので注意して設定 してください。最初のうちは本書リポジトリのレイアウト設定での利用を推奨します。 こでも印刷所によっては、 PDF 形式での人稿が行えない ( 画像として出力する必要 がある ) 、トンポが必要である、隠しノンプルに対応できる、など条件が異なります。 review—pdfmaker config. yml フォントの埋め込み を PDF / X に変換、原稿のモノクロ化をして初めて印刷所で扱うことができます。 しかし、これだけでは人稿に使えません。フォントの埋め込みと PDF のフォーマット 次のコマンドで PDF を出力します ()5 JIS サイズを指定しています ) 。 TechBooster が日光企画さんに人稿する事例では次のように進めています。 cd /usr/local/texlive/texmf—local/fonts/opentype/public/hiragino/ sud0 mkdir —p /usr/local/texlive/texmf—local/fonts/opentype/public/hiragino/ ントの埋め込み」サイト * 4 が参考になります。次のコマンドはサイトからの引用です。 す。埋め込み方は「教授でもできる、 TeXShop 十 MacTeX /UpTeX でのヒラギノフォ フォントの埋め込みをおこない、フォントがない環境で文字化けが起きないようにしま sudO sudo sudo sudo sudo sudo sudo 1 Ⅱ 1 Ⅱ 1 Ⅱ 1 Ⅱ 1 Ⅱ 1 Ⅱ -s "/Library/Fonts/ ヒラギノ明朝 pro W3. "/Library/Fonts/ ヒラギノ明朝 p て 0 W6. "/Library/Fonts/ ヒラギノ角ゴ pro W3. "/Library/Fonts/ ヒラギノ角ゴ pro W6 "/Library/Fonts/ ヒラギノ角ゴ std W8. "/Library/Fonts/ ヒラギノ丸ゴ pro W4. "/System/Library/Fonts/ ヒラギノ明朝 otf" otf't otf" . otf" otf" otf" HiraMinPro—W3. otf HiraMinPro—W6. otf HiraKakuPro—W3. otf HiraKakuPro—W6. otf HiraKakuStd—W8. otf HiraMaruPro—W4. otf ProN W3. otf " HiraMinProN—W3. otf 、 3 表紙データの作成にも Photoshop を使うので潔く Creative Cloud のコンプリート月々プランでの契約 57 、 4 http://osksn2.hep.sci.osaka-u.ac.jp/—taku/osx/embed hiragino. html がオススメです