crystal-jp / techbookfest

技術書典にcrystal-jpの席はあるらしいです

Home Page:https://gum.co/SlTpy

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ファイル構成

masak1yu opened this issue · comments

とりあえずmarkdownで行くか、re:viewで行くかは暫定的にmarkdownでと考えていますが、ファイル構成は以下の形を仮のものとしたいと思います。

  • crystal-techbook-cover.md 表紙
  • crystal-techbook-index.md 目次
  • crystal-techbook-maintext.md 本文

各章のテキストは書きあがるごとにcrystal-techbook-maintext.mdへPRを行い、レビュー後にマージを行いながらにしましょうか。

maintextにみんなでコミットしていくのはマージしていくのが面倒すぎるので、テキストの一つにまとめるのはビルドシステムに任せて、

techbookfest/
  pine/
    main.md
  ucmsky/
    main.md
  <各ユーザー名>/
    main.md

みたいに、<各ユーザー名>/ ディレクトリの中にMarkdownを置いていく方がいいと思います。(そのつもりでずっと考えていたのですけど伝えていなくてごめんなさい)

了解しました。印刷やPDF化する場合は、最終的に1個のファイルに纏まるのはシステム的にやってくれる感じですか?
(編集しやすいのがあればその形にしようかな、と思って1個ファイルを考えていたもので)