# groonga - オープンソースのカラムストア機能付き全文検索エンジン

- English

# 12.2.1. Introduction

This documentation describes about how to write, generate and manage Groonga documentation.

## 12.2.1.1. 必要なソフトウェアのインストール

Groongaはドキュメントツールとして Sphinx を使います。

以下はSphinxをインストールするコマンドラインです。

Debian GNU/Linux, Ubuntu:

    % sudo apt-get install -V -y python-sphinx

CentOS, Fedora:

    % sudo yum install -y python-pip
    % sudo pip install sphinx

OS X:

    % brew install python
    % brew install gettext
    % export PATH=`brew --prefix gettext`/bin:$PATH
    % pip install sphinx

プラットフォームに存在するPythonのバージョンが古すぎる場合は、Python 2.7のより新しいバージョンを手動でインストールする必要があります。例えば、 pyenv を使ったインストール手順は以下の通りです:

    % pyenv install 2.7.11
    % pyenv global 2.7.11
    % pip install sphinx

## 12.2.1.2. Run `configure` with `--enable-document`

Groonga disables documentation generation by default. You need to enable it explicitly by adding `--enable-document` option to `configure`:

    % ./configure --enable-document

Now, your Groonga build is documentation ready.

## 12.2.1.3. HTMLファイルを生成

You can generate HTML by the following command:

    % make -C doc html

You can find generated HTML documentation at `doc/locale/en/html/`.

## 12.2.1.4. Update

You can find sources of documentation at `doc/source/`. The sources should be written in English. See 国際化 about how to translate documentation.

You can update the target file when you update the existing documentation file.

You need to update file list after you add a new file, change file path and delete existing file. You can update file list by the following command:

    % make -C doc update-files

The command updates `doc/files.am`.