==================== ドキュメント編集メモ ==================== このドキュメントは Sphyinx を使って作成しています。 ReST 記法が利用できるので、お手軽、かつ多様な表現が可能です。 格納場所 ======== ドキュメントのソースは、linuxjm プロジェクトの git repository の ``guide`` ディレクトリに あります。以下のコマンドでダウンロードしてください。 .. code-block:: console git clone https://scm.osdn.net/gitroot/linuxjm/jm.git このコマンドを実行すると、たとえば以下のようにダウンロードに関する情報が表示され、カレントディレクトリに jm というディレクトリが作成され、その中にドキュメントのソースを含むファイルがダウンロードされます。 .. code-block:: console Cloning into 'jm'... remote: Counting objects: 55547, done. remote: Compressing objects: 100% (10601/10601), done. remote: Total 55547 (delta 40455), reused 55442 (delta 40410) Receiving objects: 100% (55547/55547), 45.31 MiB | 2.38 MiB/s, done. Resolving deltas: 100% (40455/40455), done. Updating files: 100% (10822/10822), done. ドキュメントの build 方法 ========================= build 環境の準備 ---------------- 自分の環境でドキュメントの build を確認するには sphinx をインストールする 必要があります。 python の pip コマンドを使う場合は .. code-block:: console $ pip install -r requirements.txt としてください。上記のコマンドを使用した場合は、 ``sphinx`` と ``sphinx-bootstrap-theme`` がインストールされます。 あるいは、 各ディストリビューションの手順に従ってインストールしてください。たとえば openSUSE の場合は、zypper コマンドで sphinx と python3-sphinx-bootstrap-theme をインストールしてください。 build 方法 ---------- カレントディレクトリに、先にダウンロードしたファイルが含まれるディレクトリ jm があるとします。まず、ドキュメントが含まれるサブディレクトリまで移動します。次に、 make を実行し、表示用のファイルを作成します。 .. code-block:: console $ cd jm/guide $ make html 出来上がった html ファイルは _build/html に格納されます。 作成されたドキュメントを破棄して作り直すには以下のようにします。 .. code-block:: console $ make clean $ make html 参考情報 ======== * `reStructuredText入門 <http://docs.sphinx-users.jp/rest.html#lists-and-quote-like-blocks>`_ * `インラインマークアップ <http://docs.sphinx-users.jp/markup/inline.html>`_ * `Sphinxドキュメント <http://docs.sphinx-users.jp/contents.html>`_ ]]]