【OSSでWiki構築】連載記事一覧
第1回:OSSの選定
第2回:(環境構築編)Docker ComposeでOutlineとDBを連携させる
第3回:環境構築編 トラブルシューティング
第4回(Google OAuth編)Outline認証設定
第5回:Google OAuth編 トラブルシューティング
第6回:アクセス制御編
第7回:アクセス制御編 トラブルシューティング
第8回:日本語対応編 ※本記事
第9回:日本語対応編 トラブルシューティング
第10回:データ保全・バックアップ編
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」(保存)をクリックします。
- 【検証結果】: ワークスペース全体のボタンやアイコンの色が、指定した色に即時変更されることを確認しました。
次回
【OSSでWiki構築】連載記事一覧
第1回:OSSの選定
第2回:(環境構築編)Docker ComposeでOutlineとDBを連携させる
第3回:環境構築編 トラブルシューティング
第4回(Google OAuth編)Outline認証設定
第5回:Google OAuth編 トラブルシューティング
第6回:アクセス制御編
第7回:アクセス制御編 トラブルシューティング
第8回:日本語対応編 ※本記事
第9回:日本語対応編 トラブルシューティング
第10回:データ保全・バックアップ編
J.B.Goode Inc.に所属しています。
良ければ 公式アカウントをフォローお願いします!
弊社ウェブサイトでは、技術記事の他にもデザインナレッジや日々の気づき等を配信しています。
https://www.jbgoode.jp/
カジュアル面談も実施中です。お気軽にお問い合わせください。
https://www.jbgoode.jp/recruit/