はじめに

皆さんはOfficeツールを使用しているとき、思うようにならずにストレスを感じる事はありませんか？あるいは、印刷用の資料を見ているとき、Webブラウザで閲覧したいと思ったりはしませんか？

Sphinx（スフィンクス）は、テキストファイル形式で原稿を作成し、作成した原稿をHTMLやPDF、EPUBなど、さまざまなフォーマットに変換するドキュメント変換ツールです。

Sphinxは以下のような特長を持っています。

  • 原稿がテキストファイルなので扱いやすく、バージョン管理ツールや差分比較ツール等とも相性が良い

  • 変換先のフォーマットの知識がなくても、簡単に見栄えの良いドキュメントを作成できる

  • 構造化された見通しの良いドキュメントを簡単に作成できる

本書では議事録や手順書を題材に、HTMLやPDF、EPUBといったメジャーなフォーマットのドキュメントを作成していきます。本書を読み終える頃には、今まで面倒に感じていたドキュメント作成が楽しくなることうけ合いです！

  • Sphinxとは では、Sphinxをいつ、どのようなドキュメントの作成に使うのか、Sphinxとはどのようなソフトウェアなのか、その特徴と概要を紹介します。また、Sphinxと比較される他のツールとの違いについてもいくつか紹介します。

  • Sphinxのインストール では、Sphinxをインストールする手順を説明します。SphinxはWindows、macOS、Linuxという主要なOSで動作しますので、それぞれについて説明します。

  • HTMLに変換してみよう では、Sphinxのプロジェクト作成方法について説明した後、HTMLへの変換方法を説明します。そして、議事録を例にしてreStructuredText記法の基礎を説明し、HTMLテーマの変更を例にプロジェクトの設定方法を紹介します。 ...