この勉強会は、技術同人誌を作ってみたいアソシエイトエンジニアを対象に、技術書を執筆する上で必要そうな事柄を俯瞰的に広く見渡しながら Notion に整理していく社内勉強会です。
※ 参加者の一般公募も行われますので、社内外のメンバーで集う会になります。
目標
技術同人誌を執筆しようにも皆目検討つかない人が、執筆から製本までに知っておくと円滑に進められそうな知識にひととおり触れる、そんな機会になるのを目標にします。
そして隠れた目標として、この勉強会を通して Notion に整理した情報をそのまま使い、最終回に本の体裁に整えた PDF を出力しました。これが同人誌でいう「原稿」になります。この勉強会を通して、執筆を疑似体験してもらえていたとしたら幸いです。
開催について
諸注意
この勉強会は、技術同人誌を執筆する上で必要になりそうな情報を見ていきながら、それを Notion に整理していく集まりになります。
話しながら Notion にまとめていく都合、流暢な感じには進まないと思いますのでご承知おきください。
開催スタイルに無理があったら、途中で大幅に軌道修正するかもしれません。
この勉強会で扱う話題
勉強会で取り扱った話題です。各項目はプルダウンで階層を辿れるようになっていて、そこからその詳細を見ることができます。
ここでは勉強会で話した内容の記録だけでなく、当勉強会をそのまま同人誌執筆に見立てたときの目次案にもなっています。執筆に際して、各項が何ページになりそうかを予想して
想定ページ数
に記載しています。また、その配下を含めた総ページ数を集計して 見込みページ数
に反映、全体で何ページになりそうかを見積もっています。勉強会を通して完成した書籍
この勉強会を通して、原稿を作ってみました。次の PDF は、この勉強会を通して制作した Notion のデータを使って Markdown を生成し、スクリプトでまとめて出力した成果物です。
全 47 ページで、制作期間はこの勉強会の全 7 回の各 1 時間に、それぞれおおよそ 1 時間くらいでの整理を加えたトータルで 14 時間くらいになりました。ただし校正まではしていません。
開催履歴と動画アーカイブ
この勉強会の全 7+1 回の開催記録です。各回のブロックから、その回で取り扱った話題を辿ったり、動画アーカイブをダウンロード可能です。
副産物
こちらは この勉強会で扱う話題 から No access の PDF を作成するときに使用したシェルスクリプトです。最小限の機能だけを実装した簡易ツールです。
ツールの詳細について
各ページにあらかじめ設定した章節項の順番で Markdown を連結し、その際に見出しに章節項の各番号を挿入された単一の Markdown が生成されます。連結の際、見出しのインデント変更も考慮に入れた作りになっています。これをページ番号付きの PDF 出力できるツールで開いて出力したのが No access の PDF です。
シンプルなテキストだけで構成された原稿を最低限の加工で完成形にするのを想定したものになっているため、好みに合わせた出力にしたり、挿絵などを含む原稿を扱う場合には対応していないと思うため、各自実際に本を書く際には役に立たないと思われます。

