Upgrade to Pro — share decks privately, control downloads, hide ads and more …

はじめての執筆!〜技術書のつくりかた〜 / how_to_write_a_techbook

42a6a049ac8f5265f31858a9509217fb?s=47 uhooi
October 25, 2019

はじめての執筆!〜技術書のつくりかた〜 / how_to_write_a_techbook

Tech Book Conference for iOS
https://techbookconference.connpass.com/event/148487/

## 参考リンク

### 技術書典公式イベント

- 技術書典7 はじめてのサークル参加meetup(平日6/28版) - connpass
https://techbookfest.connpass.com/event/135394/

- 【勉強会】「技術書典7 はじめてのサークル参加meetup(平日6/28版)」まとめ | by ウホーイ | Medium
https://uhooi.medium.com/techbookfest7-meetup-0628-f129b17affe8

### 技術書製作に関する本

- 技術書をかこう! ~はじめてのRe:VIEW~ 改訂版【C92新刊】
https://techbooster.booth.pm/items/586727

- 『技術書をかこう! ~はじめてのRe:VIEW~ 改訂版』のリポジトリ
https://github.com/TechBooster/C89-FirstStepReVIEW-v2

- 【読書】読みやすい技術書を書く技術. 技術書典7で事前にチェックしており、実際に表紙と目次を見て、私の知りたい内容が書… | by ウホーイ | Medium
https://uhooi.medium.com/readable-books-378cdedde170

- 【書籍版】技術をつたえるテクニック ~分かりやすい書き方・話し方~ - mochikoAsTech - BOOTH
https://mochikoastech.booth.pm/items/1316755

- 【読書】技術をつたえるテクニック. 技術書典6にて、表紙のデザインが可愛かったのでおもわず買ってしまいました。 | by ウホーイ | Medium
https://uhooi.medium.com/teach-technique-6bb6db80a978

- 数学文章作法
https://www.hyuki.com/mw/

- 理科系の作文技術
https://www.chuko.co.jp/shinsho/1981/09/100624.html

### Re:VIEW

- Re:VIEW
https://reviewml.org/ja/

- TechBoosterさんで利用しているRe:VIEWのテンプレート
https://github.com/TechBooster/ReVIEW-Template

- Re:VIEWをかんたんにビルドできるDockerイメージ
https://github.com/vvakame/docker-review

### おまけ

- 【勉強会】「Tech Book Conference for iOS」まとめ | by ウホーイ | Medium
https://uhooi.medium.com/勉強会-tech-book-conference-for-ios-まとめ-5e64b8a4d54c

- Re:VIEWをかんたんにビルドできるMakefile
https://gist.github.com/uhooi/febe61b04690dd74fff96373bbb6f4bf

42a6a049ac8f5265f31858a9509217fb?s=128

uhooi

October 25, 2019
Tweet

Transcript

  1. はじめての執筆︕ 〜技術書のつくりかた〜 2019/10/25(⾦) Tech Book Conference for iOS @the_uhooi @the_uhooi

    1
  2. ⾃⼰紹介 @the_uhooi uhooi ウホーイ iOSアプリの開発が好き 今は基本設計と ちょっとインフラ @the_uhooi 2

  3. @the_uhooi 3 技術書典7に出展しました モバイルアプリ開発に ついて執筆しました 頒布数︓70部弱

  4. @the_uhooi 4

  5. @the_uhooi 5 私が実際にどうやって 技術書を作ったか話します 主⼈公ウホーイ

  6. @the_uhooi 6 技術書典7の申込前

  7. @the_uhooi 7 「本を書いたことのある⼈」 になりたい︕ ウホーイ

  8. @the_uhooi 8 執筆 編集 ⼊稿 すべて未経験

  9. @the_uhooi 9 何もわからない 本向けの⽂章が書けない レイアウトはどうすれば︖ 印刷⽅法は︖

  10. @the_uhooi 10 公式イベントに参加

  11. @the_uhooi 11

  12. @the_uhooi 12 \レベルアップ︕/ ウホーイLv.2

  13. @the_uhooi 13 まとめ記事だけでも読んでほしいです https://medium.com /@theuhoooi /techbookfest7-meetup-0628- f129b17affe8

  14. @the_uhooi 14 技術書典7の申込後

  15. @the_uhooi 15 技術書製作に関する本を読む

  16. @the_uhooi 16 https://techbooster.booth.pm /ite ms /586727 https://github.com /TechBooster/C 89-FirstStepReVIEW-v2 l

    Re:VIEWを使って 執筆から印刷するまで 書かれている本 l Re:VIEWを使うなら 拝読必須 l 執筆環境の普及を⽬的に GitHubで公開されて いる
  17. @the_uhooi 17 https://booth.pm /ja /items /1311 748 https://medium.com /@theuhoooi /readable-books-378cdedde170

    l prhやRedPenをCIで 回す⽅法について 書かれている本 l Re:VIEWを使うなら 拝読すべき l 詳細は読書感想を参照
  18. @the_uhooi 18 https://mochikoastech.booth.pm /i tems /1316755 https://medium.com /@theuhoooi / teach-technique-6bb6db80a978

    l 技術の伝え⽅と教わり⽅ についてまとめられた本 l 技術の伝え⽅を知りたい なら拝読すべき l 詳細は読書感想を参照
  19. @the_uhooi 19 \レベルアップ︕/ ウホーイLv.3

  20. @the_uhooi 20 私が気になっている本

  21. @the_uhooi 21 執筆ツールの選定 Re:VIEW Markdown+CSS組版 Microsoft Word Adobe InDesign

  22. @the_uhooi 22 執筆ツールの選定 Markdown+CSS組版 Microsoft Word Adobe InDesign Re:VIEW

  23. l OSSの執筆ツール l Markdownに似た記法で書く l ビルドすると本のPDFになる @the_uhooi 23 「Re:VIEW」とは︖

  24. l みんなが使っているから l TechBoosterさんが使っているから l 最も簡単にそれっぽい本が作れそう だから @the_uhooi 24 なぜRe:VIEW︖

  25. @the_uhooi 25 ビルド

  26. @the_uhooi 26 \めっちゃそれっぽい/ ウホーイLv.4

  27. l TechBooster/ReVIEW-Template TechBoosterさんで使われているRe:VIEWの テンプレート l vvakame/docker-review Re:VIEWを簡単にビルドできるDockerイメージ ⼀瞬で環境構築が終わる ローカルにTeXをインストールしなくて済む @the_uhooi

    27 周辺ツールも併せて使おう
  28. @the_uhooi 28 技術書典7の当選後

  29. @the_uhooi 29 テーマを決めて執筆するのみ︕

  30. @the_uhooi 30 反省点

  31. l PDFを⼿動でビルドして配布するのが ⼿間だった l prhやRedPenなどの⽂書校正ツールを 回せなかった l ビルドエラーに気づかず、原因の追求に 時間がかかった @the_uhooi

    31 ①CI/CD環境を構築すべきだった
  32. @the_uhooi 32 ②Slackのアイコンがみんなくまモン

  33. l 技術書典公式の勉強会に参加するといい l 本を読んで執筆の勉強をしよう l 迷ったらTechBoosterさんに従う 執筆ツールはRe:VIEWがおすすめ @the_uhooi 33 まとめ

  34. l 技術書典7 はじめてのサークル参加meetup(平⽇6/28版) - connpass https://techbookfest.connpass.com /event /135394/ l TechBooster/ReVIEW-Template:

    TechBoosterで利⽤して いるRe:VIEWのテンプレート(B5/A5/電⼦書籍)を公開してい ます https://github.com /TechBooster/ReVIEW-Template l vvakame /docker-review: Re:VIEW build container by docker https://github.com /vvakame /docker-review @the_uhooi 34 参考資料