後書きPOSTDEF:エラーが起こった際に原因となりやすいのでChatGPTにエラーの対処を問い合わせたくなるが、書式が決まっているので公式を参照されたし。(バージョンの違いもある?ので、公式以外は参照してはならない)なお、ファイルパスを変更したい場合は以下を確認する。.よくあるエラーとしてやりがちなものが、CHAPSに指定する内容は「ファイルパス」ではなく「ファイル名」である事に留意する。mybook.recontentdirで指定したディレクトリを作成し以下に配置。本項のタイトルは「mybook.re」としているが、当然変更は可能。config.ymlのCHAPS欄をもう一度見てみよう。mybook2.reCHAPSに必要なのは順番であって、ファイル名は任意である。以下コマンド等はMacOSでの実施を想定しているが、Windows(WSLは非対象)でもできるはず。本稿で取り扱わないRuby-gem関連のインストール周りが一番の障害になると考えられる。Sonoma)を使用。gemなお、brewは以下。--version1.12.1これでmd2reviewコマンドが使えるようになる。version5.8.0(任意)VSCodeにRe:View環境を作るそもそも、md2reviewを使う場合は使わないReViewのビューアーの見え方とPDF出力が一致しないため、結局PDFで確認する必要があるとはいえ、記法ミスなどは確認できるのでmd2reviewの意味がないわけではないこれを踏まえて、環境を作っていく。(atsushieno氏)Re:VIEWの別タブビューアーの拡張機能を入れる。概要だけ言えば「review-init」を実行した場所で以下コマンドを実行する。作成されたbook.pdfを入稿すれば完了。reファイルpandoc2reviewはダメなのか?公式ではmd2reviewではなくpandoc2reviewを推しているので、特に理由がなければ公式に準ずるべきである。VSCode拡張機能が対応できていないのでmd2reviewを採用した。pandoc2reviewは手動改行(後述)に弱いので、改行を使うならまだまだ採用は難しいか。md2reviewの変換で失敗する場所を対応するマークダウンの改行は<br>で行うが、Re:VIEWだと@<br>{}となる。config.yml電子版PDFを作る場合はconfig.ymlのmedia=◯◯を変更する必要がある。本項はまさに執筆しながら追記しているため、リアルタイム性が少しでも伝わるように項目に日付を入れる事にした。申し込み完了とともに着手。執筆環境の選定から真剣に環境構築にかけた時間はおそらく3日ほどで、Re:VIEWとStarterを比較に時間をかけていた。理由は後述するが、情報が多い分バージョンの違いを意識しなければならない点に苦労した。※執筆時点ではRe:VIEW最新版が5.8、StarterがRe:VIEW2.5に対応している事に留意されたい。Starterがある。Re:VIEWの最新版に対応していないため、md2reviewを使う場合はこちらも意識する必要がある。今回はマークダウンで記事を書き、書いた記事を製本するという目的があったためデザイン性(Starter)より利便性(md2review)を優先している。本項は最も参考にならない情報になる可能性が高いため、最初に少し筆者について認識しておいてほしい。公式リファレンスの情報だけで書けるのはつよつよプログラマー・つよつよエンジニアだけだと割り切った。エンジニア能力としてはその程度のスキル感である。残念ながら当然というか、チュートリアルの内容だけで何をやっているか理解していない。VIEW」を入れている。ここで重要なのは「ReVIEW」ではなく「Re:View」とコロンを入れている事だ。上記の対応でもmd2reviewで変換できないので別の変換方法を使う提案をしているが、そもそも改行を入れなければならないような書き方を避けている。本章の公開先は以下の通り。製本(技術書典)PDF(技術書典ほか)公開情報の運用については本項では触れないが、Webメディアで表示させるレイアウトと本誌に印刷するレイアウトは異なる。PDFの場合も考えると悩みは尽きない。今回は製本を第一に考えて書く事にしたため、結果は当日になるまで私にも分からない。リンクの扱い普段Web媒体でしか書いていないのであまり気にならなかったが、書籍だとリンク表記をされてもリンク先が不明のため、参考記事を置いても困るケースが多い。そこで、本書では各項目の最後にURLを置く事にしている。これはQiitaやZennに投稿すると自動的にカード化してくれるので全くの無駄にはならない事を利用している。ZennとRe:VIEWを連動させる以下手順に則る必要がある。上記作業をCIで実現する事で解決は可能と考える。画像に外部ファイルなどは使えないため、後述に従う必要がある。画像パスは結論「![キャプションはRe:VIEWで必須](/images/ファイル名)」のルールで書く必要がある。Zennから見ると、「/images以下に置く」というルールがある。外部ファイルを参照することもできる。Re:VIEWから見ると「画像のファイルパスはconfig.ymlのimagedir(初期値はimages)で指定した場所を参照する」というルールがある。指定はファイル名のみであるため、別パスや外部ファイルを参照できないこの2つのルールを満たす必要があるため、結論の通りになる。スクリプトで自動制御を検討した上で運用コストも考えると、手作業で書き換えた方が圧倒的に早く安全である。自動化を考える場合は、何行目に追加するとか、ファイル名が変わった場合は更新が必要だとか制御を考える必要がありそうだ。VueとGASとPythonでWebアプリ作る人。現場ではPM業務多め。日中は開発、定時後は(勉強会などの登壇含め)講師業、休日はコード多めにアウトプット頑張ってます。経歴がかなり異端(CTO経験があるとか元営業だとか講師やってるとか)なので、キャリコンも取っちゃおうかと検討中...バッジを贈って著者を応援しようバッジを受け取った著者にはZennから現金やAmazonギフトカードが還元されます。VueとGASとPythonでWebアプリ作る人。現場ではPM業務多め。日中は開発、定時後は(勉強会などの登壇含め)講師業、休日はコード多めにアウトプット頑張ってます。Proよくある質問LinksX(Twitter)GitHubメディアキットLegal利用規約プライバシーポリシ。