Re:VIEWじゃなくて、CSSで本を書こう！

Re:VIEWではなく、CSSで本を書くときに必要になるデータをひとまとめにしました。

Vivliostyleという技術で作成されています。GitHub Actionsを使ってビルドできます。

ファイル構成

• .github : GitHub Actionsを使って、コミットするとPDFをビルドします。
• build : markdownをHTMLに変換するコードが含まれています。拡張構文を作れます。
• content : 本文のデータ
• scss : 本のデザインが含まれます。fontやデザインの変更を行えます。

作成フロー

1. このレポジトリを手元にクローンし、npm iをします。
2. 本を作成するため、npm run buildをします。
3. book.pdfというファイルが生成されます。

コマンド紹介

npm run ○○といった形で指定します。

• start : ファイルに変更があると自動的にマークダウンからHTMLとCSSのビルドを行い、プレビュー画面を表示します。 （ファイル更新時要リロード）（内部的にwatchとpreviewを呼び出しています）
• build : PDFファイルのビルドを行います。
• lint : 文字構成に問題がないかlintを行います。
• watch : ファイルに変更があると自動的にマークダウンからHTMLとCSSのビルドを行います。
• preview : HTMLとCSSのビルドを行い、プレビューを表示します。

開発環境

• Node.js 12.14.1

注意事項

buildに時間がかかりすぎる

なんらかのファイルに問題がある可能性が高いです。

GitHub Actionsのビルドに失敗する

手元では問題なくbuildできるのに、ActionsのPDF生成部分で失敗する場合、何度か時間をおいてリトライすると問題なく生成される現象を確認しています。 （特に初回）