Tech

【OSSでWiki構築】第8回:日本語対応編

最終更新 公開

【OSSでWiki構築】連載記事一覧
第1回
第2回(環境構築編)
第3回(環境構築編 トラブルシューティング)
第4回(Google OAuth編)
第5回(Google OAuth編 トラブルシューティング)
第6回(アクセス制御編)
第7回:アクセス制御編 トラブルシューティング
第8回:日本語対応編 ※本記事


1. はじめに

この記事は、構築したOutline Wikiの環境を、日本で快適に利用できるように調整(ローカライズ)する手順をまとめたものです。タイムゾーンの設定から、UIの日本語化、簡単なデザイン変更までをカバーします。

ステップ1: タイムゾーンを日本標準時(JST)に設定

ドキュメントの「最終更新日時」などが正しく表示されるよう、サーバーのタイムゾーンをAsia/Tokyo(日本標準時)に設定します。

  1. docker-compose.ymlファイルをテキストエディタで開きます。
  2. outlineサービスのenvironment:セクションに、以下の環境変数を追記します。 # ... (outline > environment: の中) # タイムゾーンを日本標準時(JST)に設定する TZ: 'Asia/Tokyo'
  3. docker compose downdocker compose up -dでコンテナを再起動します。
  4. これにより、UI上での設定有無に関わらず、サーバー内部の時刻がJST基準で処理されるようになります。

ステップ2: UIの日本語化とフォントの確認

OutlineのUI(メニューやボタン)を日本語化し、日本語入力が正しく表示されることを確認します。

2-1. 【管理者】ワークスペースの「標準言語」を設定

新しく参加したユーザーが、最初から日本語UIで利用できるように、ワークスペースの標準言語を設定します。

  1. docker-compose.ymloutlineサービスのenvironment:セクションに、以下の環境変数を追記します。(TZ変数の下などが分かりやすいです) # ... (TZ: 'Asia/Tokyo' の下など) # ワークスペースのデフォルト言語を日本語に設定する DEFAULT_LANGUAGE: 'ja_JP'
  2. コンテナを再起動します(docker compose down / docker compose up -d)。
  3. 【検証結果】: この設定後、新しく招待・ログインしたユーザーは、最初からUIが日本語で表示されることを確認しました。

2-2. 【個人】既存ユーザーが言語を手動で変更する方法

DEFAULT_LANGUAGE設定前にログインした既存ユーザーは、個人設定がEnglishのままになっているため、手動での切り替えが必要です。

  1. Outlineにログインし、左下の「設定(Settings)」をクリックします。
  2. 「アカウント(Account)」カテゴリの「Preferences」(設定)を開きます。
  3. 「Language」(言語)のドロップダウンメニューから「Japanese (日本語)」を選択します。UIが即座に日本語に切り替わります。

2-3. 日本語フォントの検証

  1. 新しいドキュメントを作成します。
  2. タイトルと本文に、漢字・ひらがな・カタカナ・英数字が混在する文章を入力します。
  3. 【検証結果】: 文字化けや、不自然な中華フォントなどになることなく、正常に表示されることを確認しました。

ステップ3: UI(デザイン)のカスタマイズ

Wikiをより「自分たちのもの」にするために、テーマカラーとロゴを変更します。

  1. 管理者アカウントで「設定」 > 「ワークスペース」カテゴリの「詳細(Details)」を開きます。

3-1. アクセントカラーの変更

  1. 「Theme」(テーマ)セクションの「Accent color」(アクセントカラー)をクリックし、好きな色を選択します。
  2. 「Save」(保存)をクリックします。
  3. 【検証結果】: ワークスペース全体のボタンやアイコンの色が、指定した色に即時変更されることを確認しました。

前の記事:第7回:アクセス制御編 トラブルシューティング
次の記事:準備中

【OSSでWiki構築】連載記事一覧
第1回
第2回(環境構築編)
第3回(環境構築編 トラブルシューティング)
第4回(Google OAuth編)
第5回(Google OAuth編 トラブルシューティング)
第6回(アクセス制御編)
第7回:アクセス制御編 トラブルシューティング
第8回:日本語対応編 ※本記事