readこんにちは、ハイラルに移住したchezouです。最近は、Rから始まりRで終わる言語をよく書いています。明日に迫ってきた技術書典2ですが、お-13で技術書供養寺として頒布を行います。内容は、僕の機械学習の実務におけるtipsとfastFMを使った推薦、@tokorotenさんのKickstarterの分析、@hagino3000さんのスプラトゥーンのデータマイニングということで盛り沢山です。同人誌ですが、140ページを超えた薄くない薄い本になりました。image使ってCIでビルド出来るようにすると共同執筆が捗るよ前回までのあらすじ今回は、メンバーがWindowsの人とmacOSの人の混成チームであったこと、全員がPythonに馴染み深い人だったので、reStructuredTextベースのSphinxで書きました。notebookで下書きを書いて、それをnbconvertを使ってrstとして変換する人もいました(賢い)。notebookをrstまで変換できるなら、良い選択肢かもしれません。imageの作り方等は過去に書いているのでそちらを参考にしてください。imageを用意したか?原稿執筆は余計な障害(環境構築とか)が入ると、その対応で燃え尽きる原稿執筆は往々にして〆切ギリギリから開始するので、最短距離を走れるようにしたほうが成功確率が上がるOSが異なる環境でのLaTeX周りのトラブルシュートをしたくなかったビルドにコケる原稿のpushが防げたこの目論見はすべて当たりました。実際に、共著者の皆様からはすぐに執筆開始できたとの喜びの声をいただきました。執筆自体は、ubuntuのhomeをwin-sshfsでwin側にマウントしてterapadでやってましたが。image関係ないけど)re:viewで書きかけていた原稿をreSTに変換できた奥付については、少しトリッキーなので後述します。Acrobatでやった)納得の行くfontの埋め込み(ヒラギノを使うためにmacOSでフォントを埋め込んだ)Previewのグレースケール化は信用ならないので、グレースケール化には少なくともmacOSだとAcrobatが必須かもしれません。fontの埋め込みは、IPA系のフォントだとライセンス的に問題なくコンテナ内で埋め込めるのですが、日本語の太字が綺麗にでなかったので結局MacでSphinxをビルドしてヒラギノを埋め込みました。*1そのおかげで、tokorotenさんの原稿の画像サイズが少しずれて手直しが入りました。dockerベースでフォント埋め込みまでやっていればいけたのに...。以外とハマったんですが、以下のgistのように一度citationをflashすれば行けます。GitHubRe:VIEWの書きかけの原稿をreSTに変換できた(相互変換出来る時代に)実は書きはじめのときに、shirouさんがRe:VIEWの原稿をSphinxの原稿に変換していただきました。ありがとうございました。href="https://github.com/kmuto/review/pull/733">github.com</a></cite>何故か手元にあった結構ボリュームのあるRe:VIEWの原稿を変換できて、大体の問題は解決されているのではないかなと思います。逆向きのSphinxの原稿からRe:VIEWを出力するプラグインもあります。href="https://github.com/shirou/sphinxcontrib-reviewbuilder">github.com</a></cite>おわりに今回は、shirouさん、shibukawaさん、tk0miyaさんといった#sphinxjpの皆様にお世話になりました。困ったことがあったときに、日本語で聞ける環境があるというのは非常に助かりました。