Add install document for FreeBSD

pgroonga · Apr 11, 2017 · 78d8778 · 78d8778
1 parent feced3e
commit 78d8778
Show file tree

Hide file tree

Showing 12 changed files with 264 additions and 9 deletions.
diff --git a/_config.yml b/_config.yml
@@ -11,6 +11,7 @@ postgresql_doc_base_url:
 windows_postgresql_versions:
   - 9.5.6-2
   - 9.6.2-3
+freebsd_postgresql_version: 96
 exclude:
   - "Rakefile"
   - "Gemfile"

diff --git a/_po/ja/install/freebsd.po b/_po/ja/install/freebsd.po
@@ -0,0 +1,119 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"PO-Revision-Date: 2017-04-11 10:58+0900\n"
+"Language: ja\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+msgid ""
+"---\n"
+"title: Install on FreeBSD\n"
+"---"
+msgstr ""
+"---\n"
+"title: FreeBSDにインストール\n"
+"---"
+
+msgid "# Install on FreeBSD"
+msgstr "# FreeBSDにインストール"
+
+msgid "This document describes how to install PGroonga on FreeBSD."
+msgstr "このドキュメントはFreeBSDにPGroongaをインストールする方法を説明します。"
+
+msgid "## How to install"
+msgstr "## インストール方法"
+
+msgid "You can use the following instruction to install PGroonga on FreeBSD."
+msgstr "FreeBSDにPGroongaをインストールする方法は次の通りです。"
+
+msgid "Install Groonga, PostgreSQL, pkg-config and GNU Make by `pkg`:"
+msgstr "`pkg`でGroongaとPostgreSQLとpkg-configとGNU Makeをインストールします。"
+
+msgid ""
+"```text\n"
+"% sudo pkg install -f groonga pkgconf postgresql{{ site.freebsd_postgresql_ver"
+"sion }}-server\n"
+"```"
+msgstr ""
+
+msgid ""
+"Create `/etc/rc.conf.d/postgresql` with the following content to enable Postgr"
+"eSQL:"
+msgstr "PostgreSQLを有効にするために次の内容の`/etc/rc.conf.d/postgresql`を作ります。"
+
+msgid "`/etc/rc.conf.d/postgresql`:"
+msgstr ""
+
+msgid ""
+"```text\n"
+"postgresql_enable=\"YES\"\n"
+"```"
+msgstr ""
+
+msgid "Initialize PostgreSQL database:"
+msgstr "PostgreSQLのデータベースを初期化します。"
+
+msgid ""
+"```text\n"
+"% sudo -H /usr/local/etc/rc.d/postgresql initdb\n"
+"```"
+msgstr ""
+
+msgid "Start PostgreSQL:"
+msgstr "PostgreSQLを起動します。"
+
+msgid ""
+"```text\n"
+"% sudo -H service postgresql start\n"
+"```"
+msgstr ""
+
+msgid "Install PGroonga from source:"
+msgstr "ソースからPGroongaをインストールします。"
+
+msgid ""
+"```text\n"
+"% curl -O https://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroon"
+"ga_version }}.tar.gz\n"
+"% tar xvf pgroonga-{{ site.pgroonga_version }}.tar.gz\n"
+"% cd pgroonga-{{ site.pgroonga_version }}\n"
+"% gmake HAVE_MSGPACK=1\n"
+"% sudo -H gmake install\n"
+"```"
+msgstr ""
+
+msgid "Create a database:"
+msgstr "データベースを作成します。"
+
+msgid ""
+"```text\n"
+"% sudo -H -u postgres psql --command 'CREATE DATABASE pgroonga_test'\n"
+"```"
+msgstr ""
+
+msgid ""
+"(Normally, you should create a user for `pgroonga_test` database and use the u"
+"ser. See [`GRANT USAGE ON SCHEMA pgroonga`](../reference/grant-usage-on-schema"
+"-pgroonga.html) for details.)"
+msgstr ""
+"（通常は`pgroonga_test`データベース用のユーザーを作ってそのユーザーを作るべきです。詳細は[`GRANT USAGE ON SCHEMA pg"
+"roonga`](../reference/grant-usage-on-schema-pgroonga.html)を参照してください。）"
+
+msgid "Connect to the created database and execute `CREATE EXTENSION pgroonga`:"
+msgstr "作成したデータベースに接続し、`CREATE EXTENSION pgroonga`を実行します。"
+
+msgid ""
+"```text\n"
+"% sudo -H -u postgres psql -d pgroonga_test --command 'CREATE EXTENSION pgroon"
+"ga;'\n"
+"```"
+msgstr ""
+
+msgid "That's all!"
+msgstr "これで終わりです！"
+
+msgid "Try [tutorial](../tutorial/). You can understand more about PGroonga."
+msgstr "[チュートリアル](../tutorial/)を試してください。PGroongaについてもっと理解できるはずです。"
diff --git a/_po/ja/install/index.po b/_po/ja/install/index.po
@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"PO-Revision-Date: 2016-11-04 01:15+0900\n"
+"PO-Revision-Date: 2017-04-11 10:58+0900\n"
 "Language: ja\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -76,6 +76,9 @@ msgstr ""
 msgid "    * 7"
 msgstr ""
 
+msgid "  * [FreeBSD](freebsd.html)"
+msgstr ""
+
 msgid "  * [OS X](os-x.html)"
 msgstr ""
 

diff --git a/_po/ja/install/source.po b/_po/ja/install/source.po
@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"PO-Revision-Date: 2016-12-21 13:35+0900\n"
+"PO-Revision-Date: 2016-11-30 16:59+0900\n"
 "Language: ja\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -60,8 +60,8 @@ msgstr "PGroongaのソースを展開します。"
 
 msgid ""
 "```text\n"
-"% wget http://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_v"
-"ersion }}.tar.gz\n"
+"% wget https://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_"
+"version }}.tar.gz\n"
 "% tar xvf pgroonga-{{ site.pgroonga_version }}.tar.gz\n"
 "% cd pgroonga-{{ site.pgroonga_version }}\n"
 "```"

diff --git a/_po/ja/tutorial/index.po b/_po/ja/tutorial/index.po
@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"PO-Revision-Date: 2016-11-11 23:13+0900\n"
+"PO-Revision-Date: 2017-04-11 10:51+0900\n"
 "Language: ja\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -269,7 +269,6 @@ msgid ""
 msgstr ""
 "```sql\n"
 "SELECT * FROM memos WHERE content LIKE '%全文検索%';\n"
-"\n"
 "--  id |                      content\n"
 "-- ----+---------------------------------------------------\n"
 "--   2 | Groongaは日本語対応の高速な全文検索エンジンです。\n"

diff --git a/install/freebsd.md b/install/freebsd.md
@@ -0,0 +1,65 @@
+---
+title: Install on FreeBSD
+---
+
+# Install on FreeBSD
+
+This document describes how to install PGroonga on FreeBSD.
+
+## How to install
+
+You can use the following instruction to install PGroonga on FreeBSD.
+
+Install Groonga, PostgreSQL, pkg-config and GNU Make by `pkg`:
+
+```text
+% sudo pkg install -f groonga pkgconf postgresql{{ site.freebsd_postgresql_version }}-server
+```
+
+Create `/etc/rc.conf.d/postgresql` with the following content to enable PostgreSQL:
+
+`/etc/rc.conf.d/postgresql`:
+
+```text
+postgresql_enable="YES"
+```
+
+Initialize PostgreSQL database:
+
+```text
+% sudo -H /usr/local/etc/rc.d/postgresql initdb
+```
+
+Start PostgreSQL:
+
+```text
+% sudo -H service postgresql start
+```
+
+Install PGroonga from source:
+
+```text
+% curl -O https://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_version }}.tar.gz
+% tar xvf pgroonga-{{ site.pgroonga_version }}.tar.gz
+% cd pgroonga-{{ site.pgroonga_version }}
+% gmake HAVE_MSGPACK=1
+% sudo -H gmake install
+```
+
+Create a database:
+
+```text
+% sudo -H -u postgres psql --command 'CREATE DATABASE pgroonga_test'
+```
+
+(Normally, you should create a user for `pgroonga_test` database and use the user. See [`GRANT USAGE ON SCHEMA pgroonga`](../reference/grant-usage-on-schema-pgroonga.html) for details.)
+
+Connect to the created database and execute `CREATE EXTENSION pgroonga`:
+
+```text
+% sudo -H -u postgres psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga;'
+```
+
+That's all!
+
+Try [tutorial](../tutorial/). You can understand more about PGroonga.
diff --git a/install/index.md b/install/index.md
@@ -39,6 +39,8 @@ See a document for your platform in the followings:
 
     * 7
 
+  * [FreeBSD](freebsd.html)
+
   * [OS X](os-x.html)
 
     * Homebrew

diff --git a/install/source.md b/install/source.md
@@ -24,7 +24,7 @@ Install PostgreSQL.
 Extract PGroonga source:
 
 ```text
-% wget http://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_version }}.tar.gz
+% wget https://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_version }}.tar.gz
 % tar xvf pgroonga-{{ site.pgroonga_version }}.tar.gz
 % cd pgroonga-{{ site.pgroonga_version }}
 ```

diff --git a/ja/install/freebsd.md b/ja/install/freebsd.md
@@ -0,0 +1,65 @@
+---
+title: FreeBSDにインストール
+---
+
+# FreeBSDにインストール
+
+このドキュメントはFreeBSDにPGroongaをインストールする方法を説明します。
+
+## インストール方法
+
+FreeBSDにPGroongaをインストールする方法は次の通りです。
+
+`pkg`でGroongaとPostgreSQLとpkg-configとGNU Makeをインストールします。
+
+```text
+% sudo pkg install -f groonga pkgconf postgresql{{ site.freebsd_postgresql_version }}-server
+```
+
+PostgreSQLを有効にするために次の内容の`/etc/rc.conf.d/postgresql`を作ります。
+
+`/etc/rc.conf.d/postgresql`:
+
+```text
+postgresql_enable="YES"
+```
+
+PostgreSQLのデータベースを初期化します。
+
+```text
+% sudo -H /usr/local/etc/rc.d/postgresql initdb
+```
+
+PostgreSQLを起動します。
+
+```text
+% sudo -H service postgresql start
+```
+
+ソースからPGroongaをインストールします。
+
+```text
+% curl -O https://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_version }}.tar.gz
+% tar xvf pgroonga-{{ site.pgroonga_version }}.tar.gz
+% cd pgroonga-{{ site.pgroonga_version }}
+% gmake HAVE_MSGPACK=1
+% sudo -H gmake install
+```
+
+データベースを作成します。
+
+```text
+% sudo -H -u postgres psql --command 'CREATE DATABASE pgroonga_test'
+```
+
+（通常は`pgroonga_test`データベース用のユーザーを作ってそのユーザーを作るべきです。詳細は[`GRANT USAGE ON SCHEMA pgroonga`](../reference/grant-usage-on-schema-pgroonga.html)を参照してください。）
+
+作成したデータベースに接続し、`CREATE EXTENSION pgroonga`を実行します。
+
+```text
+% sudo -H -u postgres psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga;'
+```
+
+これで終わりです！
+
+[チュートリアル](../tutorial/)を試してください。PGroongaについてもっと理解できるはずです。
diff --git a/ja/install/index.md b/ja/install/index.md
@@ -39,6 +39,8 @@ title: インストール
 
     * 7
 
+  * [FreeBSD](freebsd.html)
+
   * [OS X](os-x.html)
 
     * Homebrew

diff --git a/ja/install/source.md b/ja/install/source.md
@@ -24,7 +24,7 @@ PostgreSQLをインストールします。
 PGroongaのソースを展開します。
 
 ```text
-% wget http://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_version }}.tar.gz
+% wget https://packages.groonga.org/source/pgroonga/pgroonga-{{ site.pgroonga_version }}.tar.gz
 % tar xvf pgroonga-{{ site.pgroonga_version }}.tar.gz
 % cd pgroonga-{{ site.pgroonga_version }}
 ```

diff --git a/ja/tutorial/index.md b/ja/tutorial/index.md
@@ -123,7 +123,6 @@ PGroongaは`LIKE`演算子をサポートしています。既存のSQLを変更
 
 ```sql
 SELECT * FROM memos WHERE content LIKE '%全文検索%';
-
 --  id |                      content
 -- ----+---------------------------------------------------
 --   2 | Groongaは日本語対応の高速な全文検索エンジンです。