# 將 Laravel Project 轉換成繁體中文

## 1. 下載繁體中文語言套件

繁體中文語言套件：
https://github.com/Laravel-Lang/lang/blob/main/locales/zh_TW/json.json

下載`json.json`後，把檔案名稱改成`zh_TW.json`。

## 2. 複製套件到 Laravel Project 的資料夾
把`zh_TW.json` 複製到 Laravel Project 裡的 `/resources/lang`，完成如下圖：


:::success
注意：不要把 `zh_TW.json` 檔案放到 `/zh_TW` 資料夾裡。`zh_TW.json` 的父層資料夾應該是 `/resources/lang`。
:::

## 3. 更改 `locale`
打開 `/config/app.php` 檔案，搜尋

'locale' => 'en',

更改為

'locale' => 'zh_TW',

然後搜尋

'faker_locale' => 'en_US',

更改為

'faker_locale' => 'zh_TW',

:::success
注意：如果你也想更換後備語言，可以修改 `/config/app.php` 裡的 `'fallback_locale' => 'en',`。
:::

## 4. 如何修改和新增中文繁譯

### 4.1 修改

你可以打開語言套件裡每一個檔案，直接修改中文翻譯的部份。修改完，記得要存檔。

/zh_TW
- auth.php
- pagination.php
- passwords.php
- validation.php

/
zh_TW.json

### 4.2 新增

其實不止一個新增翻譯方法，我這裡只找了一個必較簡單直接的方法來跟大家說明。打開 `zh_TW.json` 檔案：

舉例：把`Frontpage` 翻譯成 `首頁`

我們可以把要翻譯的英文 `Frontpage` 作為鍵，翻譯後的中文 `首頁` 作為值，寫成 JSON 格式，如下：

"Frontpage": "首頁",

把以上程式碼複製到 `zh_TW.json` 檔案裡。建議依英文字母排序複製貼上。如下圖：


#### 4.2.1 如何引用剛新增的中文翻譯？

舉例我想要把翻譯後的中文 `首頁` 加到 `app.blade.php` 裡面，可以直接用 Laravel Blade 的語法 `{{ __('這裡輸入 JSON 的鍵') }}`


效果：

:::success
注意：`{{ __('這裡輸入 JSON 的鍵') }}` 裡的 `__` 是雙底線。
:::

###### tags: `Laravel` `translation` `Traditional Chinese` `zh_TW`