intra-mart Accel Platform intra-mart Sphinxドキュメント ビルド手順書 第3版 2023-10-01

4. 全文検索エンジンの利用

  • ドキュメント内の全文検索を利用する場合次のセットアップが必要です。

4.1. node セットアップ

  1. インストーラをダウンロードします。

    https://nodejs.org/download/

    Sphinxをビルドする実行環境に合わせたインストーラをダウンロードします。
  2. インストーラを起動しセットアップを行います。

4.2. oktavia セットアップ

  1. インストーラをダウンロードします。

    oktavia.zip

  2. 任意のディレクトリに展開します。

    コラム

    例:C:\oktavia

4.3. Sphinx ドキュメントへの適用

  1. ビルドを実行するSphinxドキュメントの実行ファイルを編集します。

    • 任意のディレクトリに配置したSphinxソースのプロジェクト直下にある、 make.bat ファイルをテキストエディタで開きます。

      コラム

      例:intra-mart Accel Platform 一般ユーザガイド
      C:\user_guide\make.bat
    • L.51とL.52の間(下図の点線)に次のコマンドを追加します。
      node %oktaviaを展開したディレクトリパス%/bin/oktavia-mkindex-cli -i build/html -r build/html -m html -u file -f .content -c 5 -t web -o build/html/searchindex.js -I

      コラム

      例:C:\oktavia ディレクトリに展開した場合
      node C:/oktavia/bin/oktavia-mkindex-cli -i build/html -r build/html -m html -u file -f .content -c 5 -t web -o build/html/searchindex.js -I
      ../../_images/makefile_1.png ../../_images/makefile_2.png

4.4. 動作確認

  1. ビルドを行います。

コラム

ビルド方法は、「 動作確認 」を参照してください。
  1. html版のドキュメントをブラウザ上で確認します。

注意

ブラウザ上に表示した際、ブラウザによっては Worker のローカル実行に関するセキュリティエラーが発生します。この場合、全文検索が利用できません。
回避方法として、Webサーバにコンテンツの設定をして確認を行ってください。
../../_images/browser_2.png

4.5. 全文検索エンジンを利用しない場合

  • 全文検索(クリック検索)の部品を外す事ができます。
  1. レイアウトファイルを編集します。

    • %Sphinxドキュメントディレクトリ%/source/common_all/amy/layout.html をテキストエディタで開きます。

      コラム

      例:intra-mart Accel Platform 一般ユーザガイド
      C:\user_guide\source\common_all\amy\layout.html
    • L.96-L.98の3行をコメントアウトします。

      ../../_images/layoutfile_1.png
    • ビルドを行います。

      コラム

      ビルド方法は、「 動作確認 」を参照してください。
      html版のドキュメントをブラウザ上で確認できます。
      ../../_images/browser_3.png