カテゴリー: Fess

FessのMicrosoft365データストアでプロキシを利用する

FessのMicrosoft 365データストア（fess-ds-microsoft365）で、プロキシサーバー経由での接続がサポートされました。企業ネットワーク内からMicrosoft 365にアクセスする際に、プロキシサーバーの経由が必須な環境でも、FessでOneDriveやSharePoint、Teamsのコンテンツをクロールできるようになります。

設定パラメータ

データストアの設定画面で、以下のパラメータを追加できます。

パラメータ名説明
proxy_hostプロキシサーバーのホスト名またはIPアドレス
proxy_portプロキシサーバーのポート番号
proxy_usernameプロキシ認証のユーザー名（認証が必要な場合）
proxy_passwordプロキシ認証のパスワード（認証が必要な場合）

設定例

プロキシサーバーを利用する場合、データストアのパラメータに以下のように設定します。

認証なしプロキシの場合

proxy_host=proxy.example.com
proxy_port=8080

認証ありプロキシの場合

proxy_host=proxy.example.com
proxy_port=8080
proxy_username=proxyuser
proxy_password=proxypassword

補足

このプロキシ設定は、Azure ADへのOAuth認証時とMicrosoft Graph API呼び出し時の両方で利用されます。プロキシを設定しない場合は、従来通り直接接続でMicrosoft 365にアクセスします。

この機能は、PR #31で追加されました。

Fessのドキュメントの多言語対応

Fessのドキュメントは、これまで英語と日本語だけを提供していましたが、新たに以下の言語にも対応しました。

これらの多言語ドキュメントの生成には、Claude Codeを活用しています。

ドキュメント生成の流れ

まず、日本語のドキュメントを作成し、それを各言語に展開するという流れで進めています。日本語のドキュメント自体も、プルリクエストなどの情報をClaude Codeに渡して、できるだけ自動的に作成するようにしています。

つまり、PRの変更内容を渡すと、Claude Codeがその内容を理解して、適切な日本語ドキュメントを生成し、さらにそれを各言語に翻訳して展開するという流れになっています。

Claude Codeでの多言語対応

Claude Codeを使うことで、単なる機械翻訳ではなく、技術的なコンテキストを理解した上での翻訳が可能になっています。Fessのような検索エンジンの専門用語も適切に翻訳されるので、各言語のユーザーにとっても理解しやすいドキュメントになっているのではないかと思います。

これまで手作業で翻訳していたら、とても対応できなかった言語数ですが、Claude Codeを活用することで、比較的少ない労力で多言語対応を実現できました。今後も必要に応じて対応言語を増やしていければと考えています。

YUI Compressorをフォークした

FessではJavaScriptやCSSの最小化にYUI Compressorを利用しています。しかし、オリジナルのYUI Compressorは長らくメンテナンスされておらず、ES6（ECMAScript 2015）以降の構文に対応していませんでした。そこで、YUI Compressorをフォークして、ES6対応版を作成しました。

背景

YUI Compressorは、Yahoo!が開発したJavaScript/CSS圧縮ツールです。長年にわたり広く使われてきましたが、オリジナルのリポジトリはメンテナンスが停止しており、ES6で導入されたアロー関数やテンプレートリテラルなどの新しい構文に対応していませんでした。

コミュニティによるフォーク版（hazendaz版など）も存在しますが、ES6対応が十分ではなかったため、CodeLibsとして独自にフォークして対応することにしました。

codelibs/yuicompressor

codelibs/yuicompressorとして、ES6対応版のYUI Compressorを公開しました。主な変更点は以下の通りです。

  • ES6構文（アロー関数、テンプレートリテラル、const/letなど）のサポート
  • JavaScriptパーサーの更新

codelibs/yuicompressor-maven-plugin

YUI CompressorをMavenビルドで利用するためのプラグインとして、codelibs/yuicompressor-maven-pluginを作成しました。これにより、Mavenプロジェクトで簡単にES6対応の圧縮を行うことができます。

pom.xmlでの設定例：

<plugin>
    <groupId>org.codelibs.maven</groupId>
    <artifactId>yuicompressor-maven-plugin</artifactId>
    <version>2.0.0</version>
    <executions>
        <execution>
            <phase>compile</phase>
            <goals>
                <goal>compress</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Fessでの適用

Fess 15.4では、yuicompressor-maven-pluginのgroupIdをcom.github.hazendaz.mavenからorg.codelibs.mavenに変更し、バージョン2.0.0を使用するようにしました。

これにより、FessのJavaScript最小化処理がES6構文に対応し、モダンなJavaScriptコードも正しく圧縮できるようになりました。