弊社では最近、PDF形式のドキュメントを作成するためにSphinxを使っています。1
例えば、弊社では先日AWS Marketplaceにてintdash LE All-in-Oneをリリースしましたが、そのドキュメントはSphinxで作成しました。
Sphinxは非常に使いやすいツールですが、本格的に使うようになってから気づいた、使いこなしのコツやノウハウがいくつかあります。
その1つとして今回は、表紙タイトルの折り返しについてご紹介したいと思います。テクニカルライターの篠崎がお届けします。
- 長い文書タイトルで発生する折り返し
- 表紙テンプレートをカスタマイズする
- (準備)表紙のテンプレートを確認する
- 表紙テンプレートを再定義し、改行コマンドの入ったテキストを挿入する
- まとめ―Sphinxの柔軟性
長い文書タイトルで発生する折り返し
文書のレイアウトを自動化するとき、表紙も自動で作るか、または、別途手作業で作った表紙をあとで結合するか(例えばAdobe Illustratorで1枚のグラフィックとして作るというのがよくある手法でしょうか)は、判断の分かれるところだと思います。
- Sphinxを採用した背景や、LuaLaTeXによる日本語PDFの作成方法については、以前のエントリーSphinxとLuaLaTeXで、日本語PDFマニュアルを作る - aptpod Tech Blogにて公開しています。↩