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

12.2.1. Introduction

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

12.2.1.1. Install depended softwares

Groonga uses Sphinx as documentation tool. Groonga requires newer Sphinx. So Groonga clones the latest Sphinx from Sphinx repository automatically. You need only Mercurial, Docutils and Jinja.

Here are command lines to install needed softwares.

Debian GNU/Linux, Ubuntu:

% sudo apt-get install -V -y mercurial python-docutils python-jinja2

CentOS, Fedora:

% sudo yum install -y mercurial python-docutils python-jinja2

OS X:

% brew install mercurial
% pip install docutils
% pip install jinja

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.

目次

前のトピックへ

12.2. ドキュメント関連のコントリビュート方法

次のトピックへ

12.2.2. 国際化

このページ