【OSSでWiki構築】連載記事一覧
第1回
第2回(環境構築編)
第3回(環境構築編 トラブルシューティング)
第4回(Google OAuth編)
第5回(Google OAuth編 トラブルシューティング)
第6回(アクセス制御編)
第7回:アクセス制御編 トラブルシューティング
第8回:日本語対応編 ※本記事
1. はじめに
この記事は、構築したOutline Wikiの環境を、日本で快適に利用できるように調整(ローカライズ)する手順をまとめたものです。タイムゾーンの設定から、UIの日本語化、簡単なデザイン変更までをカバーします。
ステップ1: タイムゾーンを日本標準時(JST)に設定
ドキュメントの「最終更新日時」などが正しく表示されるよう、サーバーのタイムゾーンをAsia/Tokyo(日本標準時)に設定します。
docker-compose.ymlファイルをテキストエディタで開きます。outlineサービスのenvironment:セクションに、以下の環境変数を追記します。# ... (outline > environment: の中) # タイムゾーンを日本標準時(JST)に設定する TZ: 'Asia/Tokyo'docker compose downとdocker compose up -dでコンテナを再起動します。- これにより、UI上での設定有無に関わらず、サーバー内部の時刻がJST基準で処理されるようになります。
ステップ2: UIの日本語化とフォントの確認
OutlineのUI(メニューやボタン)を日本語化し、日本語入力が正しく表示されることを確認します。
2-1. 【管理者】ワークスペースの「標準言語」を設定
新しく参加したユーザーが、最初から日本語UIで利用できるように、ワークスペースの標準言語を設定します。
docker-compose.ymlのoutlineサービスのenvironment:セクションに、以下の環境変数を追記します。(TZ変数の下などが分かりやすいです)# ... (TZ: 'Asia/Tokyo' の下など) # ワークスペースのデフォルト言語を日本語に設定する DEFAULT_LANGUAGE: 'ja_JP'- コンテナを再起動します(
docker compose down/docker compose up -d)。 - 【検証結果】: この設定後、新しく招待・ログインしたユーザーは、最初からUIが日本語で表示されることを確認しました。
2-2. 【個人】既存ユーザーが言語を手動で変更する方法
DEFAULT_LANGUAGE設定前にログインした既存ユーザーは、個人設定がEnglishのままになっているため、手動での切り替えが必要です。
- Outlineにログインし、左下の「設定(Settings)」をクリックします。
- 「アカウント(Account)」カテゴリの「Preferences」(設定)を開きます。
- 「Language」(言語)のドロップダウンメニューから「Japanese (日本語)」を選択します。UIが即座に日本語に切り替わります。
2-3. 日本語フォントの検証
- 新しいドキュメントを作成します。
- タイトルと本文に、漢字・ひらがな・カタカナ・英数字が混在する文章を入力します。
- 【検証結果】: 文字化けや、不自然な中華フォントなどになることなく、正常に表示されることを確認しました。
ステップ3: UI(デザイン)のカスタマイズ
Wikiをより「自分たちのもの」にするために、テーマカラーとロゴを変更します。
- 管理者アカウントで「設定」 > 「ワークスペース」カテゴリの「詳細(Details)」を開きます。
3-1. アクセントカラーの変更
- 「Theme」(テーマ)セクションの「Accent color」(アクセントカラー)をクリックし、好きな色を選択します。
- 「Save」(保存)をクリックします。
- 【検証結果】: ワークスペース全体のボタンやアイコンの色が、指定した色に即時変更されることを確認しました。
前の記事:第7回:アクセス制御編 トラブルシューティング
次の記事:準備中
【OSSでWiki構築】連載記事一覧
第1回
第2回(環境構築編)
第3回(環境構築編 トラブルシューティング)
第4回(Google OAuth編)
第5回(Google OAuth編 トラブルシューティング)
第6回(アクセス制御編)
第7回:アクセス制御編 トラブルシューティング
第8回:日本語対応編 ※本記事