2018年4月頃に行うSphinxをCentOS7/Dockerにインストール

はじめに

Docker知ってる人的には察しが付くと思うけど、
残念ですがCentOS7要素は無いです。
ただ単に基底OSがCentOS7なだけです。

前提

• CentOS7
• Docker導入済
• Debian系のCUIコマンド(apt-getとか)

DockerにSphinxを閉じ込める

空のコンテナという名の檻

1. 公式のDebianベースイメージを取得し
2. イメージを元にコンテナHogeSphinxを作成&起動
3. 起動したコンテナにレッツ入場

shell>

docker run -it --name HogeSphinx debian:stretch-slim /bin/bash

スフィンクスを入れる

1. パッケージマネージャーを更新
2. pythonを入れる
3. pythonのツール入れる
4. 文書作成パッケージ入れる(sphinxが依存)
5. sphinxを入れる

コンテナ内のshell>

apt-get update
apt-get -y install python-pip
apt-get -y install python-setuptools
apt-get -y install pandoc
apt-get install python-sphinx

すふぃんくする準備をする

1. ドキュメント用のディレクトリ作成
2. 中に入る
3. 高速ですふぃんくする宣言
4. 基本Enter連打。たまに質問に答える
   5. プロジェクト名
   6. バージョン
   7. 著作者

コンテナ内のshell>

mkdir Hoge
cd Hoge
sphinx-quickstart

sphinx-quickstart中のshell>

> Project name: Hoge
> Author name(s): Hoge
> Project version: 1

早速すふぃんくする

なにごともこの世界へようこそが大事。
とゆーわけですふぃんくす流を見る。
まずはhtml。

コンテナ内のshell>

make html

_buildにできますが、コンテナ内だから見れねーな！
いったんコンテナ外に出ます。

コンテナ内のshell>

exit

コンテナ外に出るとコンテナが停止するので～

1. コンテナ起動
2. コンテナ内にある_buildをお外に持ってくる。

shell>

docker start [コンテナID]
docker cp [コンテナID]:/Hoge/_build/ /Sphinx/

あとはWebブラウザに_buildの中にあるindex.htmlを投げればOK。
こんな感じにでるよ。