Skip to content

i18n(zh-TW): Revise glossary #12693

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
+23 −21
Draft

i18n(zh-TW): Revise glossary #12693

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a0831f2
i18n(zh-TW): Add mistakable terms
lumynou5 Nov 11, 2025
14782cc
i18n(zh-TW): Change term 儲存庫 -> 版本庫
lumynou5 Nov 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion i18n-guides/正體中文.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@
| changelog | 變更日誌 | |
| CLI | 命令列 | |
| codebase | 程式碼庫 | |
| command | 命令 | |
| community | 社群 | |
| component | 元件 | |
| configuration | 組態 | |
Expand All @@ -55,6 +56,7 @@
| escape | 跳脫 | 特指 escape character |
| experimental | 實驗性 | |
| framework | 框架 | |
| function | 函式 | 數學的情況作「函數」 |
| hydration | 水合 | |
| import | 匯入 | |
| integration | 整合 | |
Expand All @@ -67,7 +69,7 @@
| reactive | 反應式 | |
| recipe | 操作指南 | |
| reference | 參考 | |
| repository | 儲存庫 | |
| repository | 版本庫 | |
| responsive | 響應式 | |
| routing | 路由 | |
| server-side rendering | 伺服器端算繪 | |
Expand Down
8 changes: 4 additions & 4 deletions src/content/docs/zh-tw/contribute.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,18 +8,18 @@ import ContributorList from '~/components/ContributorList.astro'
我們歡迎任何規模的貢獻，無論你是初學者或專家。身為開源專案，我們相信應該要回饋貢獻者，因此很樂意對 PR、技術寫作、功能、想法提供指導。

:::tip[未解決的 Issue]
請瀏覽 [Astro 所有標記為 `help wanted` 及 `good first issues`，且未解決的 GitHub issue](https://github.com/search?q=org%3Awithastro+label%3A%22good+first+issue%22%2C%22help+wanted%22%2C+state%3Aopen&type=issues)，這些程式碼儲存庫包含：Astro 程式碼、文件、Starlight、Astro 網站、語言工具、GitHub Action、機器人、編譯工具……有很多地方可以貢獻！
請瀏覽 [Astro 所有標記為 `help wanted` 及 `good first issues`，且未解決的 GitHub issue](https://github.com/search?q=org%3Awithastro+label%3A%22good+first+issue%22%2C%22help+wanted%22%2C+state%3Aopen&type=issues)，這些程式碼版本庫包含：Astro 程式碼、文件、Starlight、Astro 網站、語言工具、GitHub Action、機器人、編譯工具……有很多地方可以貢獻！
:::

想要更深入參與嗎？請參閱我們的[治理文件](https://github.com/withastro/.github/blob/main/GOVERNANCE.md)，其中詳細描述了不同角色、維護者提名流程、程式碼審查流程，以及行為準則。

## 貢獻的方法

### 專案儲存庫
### 專案版本庫

為 Astro 專案貢獻的方法很多！每個 Astro 儲存庫都有說明文件，連結到專案根目錄的 `CONTRIBUTING.md` 檔案。
為 Astro 專案貢獻的方法很多！每個 Astro 版本庫都有說明文件，連結到專案根目錄的 `CONTRIBUTING.md` 檔案。

[Astro 的 GitHub 簡介](https://github.com/withastro)包含下列儲存庫：
[Astro 的 GitHub 簡介](https://github.com/withastro)包含下列版本庫：

- [Astro 主要 codebase](https://github.com/withastro/astro)，包含官方整合和起始模板。

Expand Down
20 changes: 10 additions & 10 deletions src/content/docs/zh-tw/guides/deploy/github.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ i18nReady: true
---
import { Steps } from '@astrojs/starlight/components';

你可以透過 [GitHub Pages](https://pages.github.com/) 直接從 [GitHub](https://github.com/) 的儲存庫中部署你的 Astro 網站。
你可以透過 [GitHub Pages](https://pages.github.com/) 直接從 [GitHub](https://github.com/) 的版本庫中部署你的 Astro 網站。

## 如何部署

Expand Down Expand Up @@ -40,16 +40,16 @@ export default defineConfig({

#### `base`

你可能需要設定 `base`，這樣 Astro 才會將儲存庫名稱（例如 `/my-repo`）視為網站的根目錄。
你可能需要設定 `base`，這樣 Astro 才會將版本庫名稱（例如 `/my-repo`）視為網站的根目錄。

:::note
如果你的情況符合以下其中之一，請不要設定 `base` 參數：

- 如果你的頁面由根資料夾所提供。
- 如果你的原始碼儲存庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`。
- 如果你的原始碼版本庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`。
:::

`base` 的內容應該是你的儲存庫名稱，並以正斜線開頭，例如 `/my-blog`。這樣做是為了讓 Astro 理解你的網站根目錄是 `/my-repo`，而不是預設的 `/`。
`base` 的內容應該是你的版本庫名稱，並以正斜線開頭，例如 `/my-blog`。這樣做是為了讓 Astro 理解你的網站根目錄是 `/my-repo`，而不是預設的 `/`。

:::caution
當設定了這個值後，你所有的內部頁面連結都必須以所設定的 `base` 值作為前綴：
Expand Down Expand Up @@ -99,7 +99,7 @@ export default defineConfig({
# 允許你在 GitHub 上的 Actions 分頁中手動觸發此部署
workflow_dispatch:

# 允許這個工作複製儲存庫並建立頁面部署
# 允許這個工作複製版本庫並建立頁面部署
permissions:
contents: read
pages: write
Expand All @@ -114,9 +114,9 @@ export default defineConfig({
- name: Install, build, and upload your site
uses: withastro/action@v3
# with:
# path: . # 儲存庫中 Astro 專案的根位置。（可選）
# path: . # 版本庫中 Astro 專案的根位置。（可選）
# node-version: 20 # 用於建置網站的特定 Node.js 版本，預設為 20。（可選）
# package-manager: pnpm@latest # 應該使用哪個 Node.js 套件管理器來安裝相依套件和建置網站，會根據儲存庫中的 lockfile 自動檢測。（可選）
# package-manager: pnpm@latest # 應該使用哪個 Node.js 套件管理器來安裝相依套件和建置網站，會根據版本庫中的 lockfile 自動檢測。（可選）

deploy:
needs: build
Expand All @@ -135,7 +135,7 @@ export default defineConfig({
:::

:::caution
官方提供的 Astro [GitHub Action](https://github.com/withastro/action) 會透過掃描根目錄下的 lockfile 來檢查你所使用的套件管理器（如 `npm`、`yarn`、`pnpm` 或 `bun`）。正因如此，你應該將套件管理器自動產生的 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml` 或是 `bun.lockb` 檔案一起提交至你的儲存庫中。
官方提供的 Astro [GitHub Action](https://github.com/withastro/action) 會透過掃描根目錄下的 lockfile 來檢查你所使用的套件管理器（如 `npm`、`yarn`、`pnpm` 或 `bun`）。正因如此，你應該將套件管理器自動產生的 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml` 或是 `bun.lockb` 檔案一起提交至你的版本庫中。
:::

2. （可選）如果你要在本地開發或預覽建置時傳遞環境變數到 Astro 專案，你需要在 `deploy.yml` 檔案定義所有公開的變數，這樣它們才會在部署至 GitHub Pages 時被處理。（要新增不公開的環境變數，請參閱 [GitHub 文件中關於設定秘密的部分](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/store-information-in-variables#creating-configuration-variables-for-a-repository)。）
Expand All @@ -155,14 +155,14 @@ export default defineConfig({
```


3. 在 GitHub 網站上，請切換到儲存庫中的 **Settings** 分頁，並找到 **Pages** 部分。
3. 在 GitHub 網站上，請切換到版本庫中的 **Settings** 分頁，並找到 **Pages** 部分。

4. 選擇 **GitHub Actions** 作為設定中的 **Source**。

5. 將先前設定好的 workflow file 提交（Commit）並推送（Push）到 GitHub。
</Steps>

恭喜你！如此一來，你的 Astro 網站就會自動部署到 GitHub Pages 上了。如果你更改了你的網站原始碼並推送到前述的儲存庫，GitHub Actions 也會自動重新構建並部署你的網站，你不需要手動構建和部署。
恭喜你！如此一來，你的 Astro 網站就會自動部署到 GitHub Pages 上了。如果你更改了你的網站原始碼並推送到前述的版本庫，GitHub Actions 也會自動重新構建並部署你的網站，你不需要手動構建和部署。

## 範例

Expand Down
12 changes: 6 additions & 6 deletions src/content/docs/zh-tw/install-and-setup.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -119,17 +119,17 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的

### 使用主題或起始模板

使用 `create astro` 命令時，你可以加上 `--template` 參數來基於[官方範例](https://github.com/withastro/astro/tree/main/examples)或任何 GitHub 儲存庫的 `main` 分支建立新的 Astro 專案。
使用 `create astro` 命令時，你可以加上 `--template` 參數來基於[官方範例](https://github.com/withastro/astro/tree/main/examples)或任何 GitHub 版本庫的 `main` 分支建立新的 Astro 專案。

在你的終端機中執行以下指令，將官方的 Astro 模板名稱或你想使用的主題的 GitHub 使用者名稱和儲存庫名稱替換進去：
在你的終端機中執行以下指令，將官方的 Astro 模板名稱或你想使用的主題的 GitHub 使用者名稱和版本庫名稱替換進去：

<PackageManagerTabs>
<Fragment slot="npm">
```shell
# 使用官方範例建立新專案
npm create astro@latest -- --template <example-name>

# 基於 GitHub 儲存庫的 main 分支建立新專案
# 基於 GitHub 版本庫的 main 分支建立新專案
npm create astro@latest -- --template <github-username>/<github-repo>
```
</Fragment>
Expand All @@ -138,7 +138,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的
# 使用官方範例建立新專案
pnpm create astro@latest --template <example-name>

# 基於 GitHub 儲存庫的 main 分支建立新專案
# 基於 GitHub 版本庫的 main 分支建立新專案
pnpm create astro@latest --template <github-username>/<github-repo>
```
</Fragment>
Expand All @@ -147,13 +147,13 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的
# 使用官方範例建立新專案
yarn create astro --template <example-name>

# 基於 GitHub 儲存庫的 main 分支建立新專案
# 基於 GitHub 版本庫的 main 分支建立新專案
yarn create astro --template <github-username>/<github-repo>
```
</Fragment>
</PackageManagerTabs>

預設情況下，此指令會使用模板儲存庫的 `main` 分支。若要使用不同的分支名稱，請將其作為 `--template` 參數的一部分傳遞：`<github-username>/<github-repo>#<branch>`。
預設情況下，此指令會使用模板版本庫的 `main` 分支。若要使用不同的分支名稱，請將其作為 `--template` 參數的一部分傳遞：`<github-username>/<github-repo>#<branch>`。

## 手動安裝

Expand Down