4.3K Views
May 20, 24
スライド概要
2024/05/20(月) 19:00かに開催された技術同人誌を紹介LT会の資料になります。
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作!! 技術書典16で頒布する新刊を紹介いたします 虎の穴ラボ 古賀 広隆 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
自己紹介 所属 虎の穴ラボ株式会社 アーキテクトチーム 主な担当 プロダクトのセキュリティ対応、アーキテクト検討。 フロントエンド設計や実装など Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
表紙紹介 初心者から始める、効率的かつ魅力的なカスタム制作のすべて!!! VivlioStyleとRehype/Remarkではじめる CSS組版による同人誌制作!! げぐはつ書房 著 Handlebarsによるカスタムタグの制作 Rehype / Remarkプラグインの制作 プロジェクト構成の実践例を紹介 VivlioStyleとCSS組版の基本的な解説
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 1. はじめに Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 なぜこのテーマなのか? 同人誌制作をする際、ツール選び(Re:View、Vivlio Styleなど)やレイアウトやデザインに困ったり迷った経験がある人がいらっしゃると思います。 従来の方法では、カスタマイズに手間や時間がかかることがあります。 (実際に、私もそうでした) Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
トークの目的と概要など 今まで技術書典などで、げつはつ書房として3冊ほど本を頒布させていただきました。 その際に利用していた執筆環境をブラッシュアップし、 ぎゅっと詰め込んだ本になります。 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 アジェンダ Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
あじぇんだ 1. はじめに 2. この本で解決できること 3. 本の内容を紹介 4. 実例紹介 5. まとめ あじぇんだ VivlioStyleとRehype/Remarkではじめる CSS組版による同人誌制作!! げぐはつ書房 著 Handlebarsによるカスタムタグの制作 Rehype / Remarkプラグインの制作 プロジェクト構成の実践例を紹介
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 2. この本で解決できること この本は筆者がRe:ViewからVivlioStyleへ移行し、その後カスタマイズを進めた際に得た知見をもとに作成しています。 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 2-1. Re:ViewからVivlioStyleへの移行を検討しました Re:Viewによる同人誌制作を行う場合の課題感 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 課題感 • Rubyの環境構築が手間 • LaTeXの学習コストが高い • 特殊な設定をしないと好きなフォントが使えない • VS Codeでのプレビューやコード補完ができない (Atomエディターの開発は終了) Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 2-2. VivlioStyleへ移行しました (Tailwind CSSまとめの第2版から移行してます) Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 課題感の改善! • Node.jsのみで動作する • LaTeXより低い学習コストでカスタマイズができる (HTMLと特殊なCSS) • OSのフォントがCSSでそのまま使える • VS Codeでコード補完やLinterの利用ができる Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 😭😭日本語の文献もRe:Viewより多いし、かなりよい😭😭 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 Markdownベースで組版に使える構文が少ない、、、 ※ とくに図やテーブルへのキャプションとリンク、Appendixの構文はRe:Viewにあって、VivlioStyleのMarkdownにはない Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 このときは、それを補うためにMarkdownにHTMLを埋め込んで書く、 またはHTMLで書くという方法を取りました。 → これが執筆に手間がかかる原因となりました Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 2-3. Markdownにカスタムタグを実装する VivlioStyleのViewerはそのまま使いつつ、Markdownにカスタムタグを実装する Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 Handlebarsを使ったMarkdownのカスタムタグの実装 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 Footnoteの実装例 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作
Markdown+HTML
Handlebars.js<span class="footnote">注釈を書く</span>はJavaScriptで動くテンプレートエンジンです。
Markdown+Handlbar
Handlebars.js{{footnote '注釈を書く'}}はJavaScriptで動くテンプレートエンジンです。
Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 __________________________________________________ [7] 注釈を書く Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 Appendixの実装例 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作
Markdown+HTML
<span id="appendix-sample" class="appendix">
Appendixタグの利用例
</span>
Markdown+Handlbar
{{appendix filePath 'appendix-sample' 'Appendixタグの利用例'}}
→ Handlebarのカスタムタグ内で保存
Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 最後にAppendixページを生成! Appendix @media print .......................................................................................................................................................................... 25 @page .......................................................................................................................................................................................... 21 appendix ....................................................................................................................................................................................... 45 Appendix Sample ....................................................................................................................................................................... 86 Appendix with Hiddenタグの利用例 ..................................................................................................................................... 46 appendix-hidden ........................................................................................................................................................................ 45 Appendix タグの利用例 ............................................................................................................................................................. 46 AST(抽象構文木) ................................................................................................................................................................... 50 break-bf-page .............................................................................................................................................................................. 34 chapref ........................................................................................................................................................................................... 37 chat ................................................................................................................................................................................................. 41 chat-header .................................................................................................................................................................................. 41 chat-left .......................................................................................................................................................................................... 41 chat-right ....................................................................................................................................................................................... 41 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 ふきだしの実装例 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
Markdown+HTML <ul class="chat"> <li class="chat-left"> <div class="chat-faceicon"> <img src="../images/chat-left-icon.png" /> <span class="chat-faceicon-name">キャラ名L</span> </div> <div class="chat-contents"> <div class="balloon-indigo-200"> <div class="trianle-left"></div> <div class="balloon-contents"> (Leftメッセージ) </div> </div> </div> </li> </ul> Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 Markdown+Handlbar {{chat (chat-left ' (Leftメッセージ) ' 'キャラ名L' 'balloon-indigo-200' 'chat-left-icon.png') }} Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 (Left メッセージ) キャラ名L Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 2-4. Remark/Rehypeのプラグインを使ったMarkdownの拡張 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 画像の属性を指定するプラグイン  Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 テーブルにキャプションを追加するプラグイン <!-- title: テーブルのキャプション --> | 自動 | 左揃え | 右揃え | 中央揃え | | - | :- | -: | :-: | | 1 | 2 | 3 | 4 | | 5 | 6 | 7 | 8 | Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作
マーメイドの図にキャプションを追加するプラグイン
<!-- title: フローチャートのサンプル -->
```mermaid
flowchart LR
A[Start] --> B{Decision?}
B -->|Yes| C[Process 1]
B -->|No| D[Process 2]
```
Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 他のサンプルコードはこちら https://github.com/kght6123/techbook-template/blob/main/docs/99-1_samples.md?plain=1 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 3. 本の内容を紹介 実際の同人誌の目次を紹介します。 (プレビューを起動するまで、少々、お待ちください) Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 4. 実例紹介 同人誌の中身をかんたんに紹介します。 Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 まとめ Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
まとめ 公開したテンプレートリポジトリは、これからの執筆活動に伴って 徐々に更新していく予定です。 まだまだ、アルファ版的な位置です。 よろしければ使っていただいてIssueやDiscussionなどでご感想をお聞かせいただけると幸いです。 https://github.com/kght6123/techbook-template/ Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 技術書典だけでもVivliostyle関連の本はたくさんあり、 また、最近では商業誌でもVivliostyleが監修した本が発刊されていますが、カスタムによった少し趣向の違う本になっているかと思います。 本書の内容がみなさまのお役に立つものか、心配ではありますが よろしければお手にとっていただけると幸いです! Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
VivlioStyleとRehype/Remarkではじめる、CSS組版による同人誌制作 ご清聴いただき、ありがとうございました! Copyright (C) 2023 Toranoana Inc. All Rights Reserved.
表紙紹介 初心者から始める、効率的かつ魅力的なカスタム制作のすべて!!! VivlioStyleとRehype/Remarkではじめる CSS組版による同人誌制作!! げぐはつ書房 著 Handlebarsによるカスタムタグの制作 Rehype / Remarkプラグインの制作 プロジェクト構成の実践例を紹介 VivlioStyleとCSS組版の基本的な解説