たまたんのぶろぐ

たまたんが時たま言いたいことを書いてます。ジャンルはめっちゃええ加減ですwソフトやプログラムのことが多いかもしれませんが。。。。。

Sphinx

MarkDownをSphinx + Pandocでマニュアル化しよう(その6)

スクリプトの作成 コンパイル用のスクリプトを作成します。 スクリプトの内容は以下の通りです。 このスクリプトは、「source」ディレクトリ内の「.md」拡張子のついているMarkDownをすべて「reStructuredText(rst)」に置き換えます。そして、Sphinxの目次の…

MarkDownをSphinx + Pandocでマニュアル化しよう(その5)

4. ドキュメントの作成 ここから、実際のドキュメントを作成していきます。 今回は、ドキュメンテーションビルダーを使用してプロジェクトを作成します。 4.1 プロジェクトを作成 ドキュメント用のプロジェクトフォルダを作成します。 mkdir sample ドキュメ…

MarkDownをSphinx + Pandocでマニュアル化しよう(その4)

3.各種ツールのコンパイル・インストール さてここから、本番です。 3.1. Python3のインストール 今回は、Python3をインストールします。 Python2とPython3では、基本的な文法が違うところが多いので、ご注意ください。 参考:Python 2.7.x と 3.x の決定的…

MarkDownをSphinx + Pandocでマニュアル化しよう(その3)

2. CentOS6の構築 2.1. パッケージの更新 とりあえず、いろいろバグが出るのが面倒なので、モジュールのアップデート yum -y update 2.2. パッケージのインストール 2.2.1. Developer Toolsのインストール yum -y groupinstall "Development tools" 2.2.2. D…

MarkDownをSphinx + Pandocでマニュアル化しよう(その2)

1. Vagrant環境設定 Vagrantは、あらかじめインストールしておいてください。また、仮想化ソフトウェアは、VirtualBoxをインストールするとすぐ使えます。 また、「Guest Additions」のアップデートが必要なときがありますが、「vagrant-vbguest」 というプ…

MarkDownをSphinx + Pandocでマニュアル化しよう(その1)

みなさんドキュメント作成に困ったことありませんか? 私はここ数年いろいろ探していたのですが、なかなかいいものが見つかりませんでした。 最近は、GitHubが使われるようになってからかは知りませんが、MarkDownが主流になってきました。しかし、ローカル…