From bd8a677b0db919ff72bc1c356e10676d4cd592de Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 20 Sep 2025 06:47:34 +0800 Subject: [PATCH 01/21] i18n(zh-tw): update `install-and-setup.mdx` --- src/content/docs/zh-tw/install-and-setup.mdx | 331 +++++++++++++++++++ 1 file changed, 331 insertions(+) create mode 100644 src/content/docs/zh-tw/install-and-setup.mdx diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx new file mode 100644 index 0000000000000..1a50b0ed35251 --- /dev/null +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -0,0 +1,331 @@ +--- +title: 安裝 Astro +sidebar: + label: 安裝 +description: '如何安裝 Astro 並開始一個新專案' +i18nReady: true +banner: + content: | + Astro v5 已經到來! 了解如何升級您的網站 +--- +import { Tabs, TabItem, FileTree, CardGrid, LinkCard, Steps } from '@astrojs/starlight/components'; +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; +import ReadMore from '~/components/ReadMore.astro'; + +[`create astro` CLI 指令](#install-from-the-cli-wizard)是從零開始一個新 Astro 專案最快的方法。它會引導你完成設定新 Astro 專案的每個步驟，並讓你從幾個不同的官方起始模板中選擇。 + +你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！ + +如果你想手動安裝 Astro，請參閱我們的[手動安裝指南](#manual-setup)。 + +:::tip[線上預覽] +想在瀏覽器中試用 Astro 嗎？前往 [astro.new](https://astro.new/) 瀏覽我們的起始模板，並在不離開瀏覽器的情況下建立新的 Astro 專案。 +::: + +## 環境要求 + +- **Node.js** - `v18.20.8` 或 `v20.3.0`、`v22.0.0` 或更高版本。（不支援 `v19` 和 `v21`。） +- **文字編輯器** - 我們推薦使用 [VS Code](https://code.visualstudio.com/) 搭配我們的[官方 Astro 擴充功能](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)。 +- **終端機** - Astro 是透過命令列介面 (CLI) 來使用的。 + +## 瀏覽器相容性 + +Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的瀏覽器。完整的參考資料，請參閱 [Vite 目前支援的瀏覽器版本清單](https://vite.dev/guide/build.html#browser-compatibility)。 + +## 從 CLI 精靈安裝 + +你可以在電腦的任何地方執行 `create astro`，所以在開始之前不需要為你的專案建立新的空目錄。如果你還沒有為新專案準備空目錄，CLI 精靈會自動幫你建立一個。 + + +1. 在你的終端機中執行以下指令來啟動安裝精靈： + + + + ```shell + # 使用 npm 建立新專案 + npm create astro@latest + ``` + + + ```shell + # 使用 pnpm 建立新專案 + pnpm create astro@latest + ``` + + + ```shell + # 使用 yarn 建立新專案 + yarn create astro + ``` + + + + 如果一切順利，你會看到成功訊息，然後是一些建議的後續步驟。 + +2. 現在你的專案已經建立，你可以 `cd` 進入新的專案目錄來開始使用 Astro。 + +3. 如果你在 CLI 精靈過程中跳過了 「Install dependencies?」 的步驟，請務必在繼續之前安裝相依套件。 + + + + ```shell + npm install + ``` + + + ```shell + pnpm install + ``` + + + ```shell + yarn install + ``` + + + +4. 你現在可以[啟動 Astro 開發伺服器](/en/develop-and-build/#start-the-astro-dev-server)並在建構時看到專案的即時預覽！ + + +## CLI 安裝選項 + +你可以使用透過額外選項執行 `create astro` 指令，自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。 + +查看[所有可用的 `create astro` 指令選項](https://github.com/withastro/astro/blob/main/packages/create-astro/README.md) + +### 新增整合 + +你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/en/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。 + +在你的終端機中執行以下指令，替換為任何支援 `astro add` 指令的整合： + + + + ```shell + # 建立具有 React 和 Partytown 的新專案 + npm create astro@latest -- --add react --add partytown + ``` + + + ```shell + # 建立具有 React 和 Partytown 的新專案 + pnpm create astro@latest --add react --add partytown + ``` + + + ```shell + # 建立具有 React 和 Partytown 的新專案 + yarn create astro --add react --add partytown + ``` + + + +### 使用主題或起始模板 + +你可以透過在 `create astro` 指令中傳遞 `--template` 參數，基於[官方範例](https://github.com/withastro/astro/tree/main/examples)或任何 GitHub 存放庫的 `main` 分支來開始新的 Astro 專案。 + +在你的終端機中執行以下指令，將官方的 Astro 模板名稱或你想使用的主題的 GitHub 使用者名稱和儲存庫名稱替換進去： + + + + ```shell + # 使用官方範例建立新專案 + npm create astro@latest -- --template + + # 基於 GitHub 存放庫的 main 分支建立新專案 + npm create astro@latest -- --template / + ``` + + + ```shell + # 使用官方範例建立新專案 + pnpm create astro@latest --template + + # 基於 GitHub 存放庫的 main 分支建立新專案 + pnpm create astro@latest --template / + ``` + + + ```shell + # 使用官方範例建立新專案 + yarn create astro --template + + # 基於 GitHub 存放庫的 main 分支建立新專案 + yarn create astro --template / + ``` + + + +預設情況下，此指令會使用模板存放庫的 `main` 分支。若要使用不同的分支名稱，請將其作為 `--template` 參數的一部分傳遞：`/#`。 + +## 手動設定 + +本指南將帶你逐步手動安裝和配置新的 Astro 專案。 + +如果你不想使用我們的自動化 `create astro` CLI 工具，可以按照以下指南自行設定專案。 + + +1. 建立你的目錄 + + 建立一個以你的專案名稱命名的空目錄，然後進入該目錄。 + + ```bash + mkdir my-astro-project + cd my-astro-project + ``` + + 進入新目錄後，建立專案的 `package.json` 檔案。這是你管理專案相依套件（包括 Astro）的方式。如果你不熟悉這個檔案格式，請執行以下指令來建立一個。 + + + + ```shell + npm init --yes + ``` + + + ```shell + pnpm init + ``` + + + ```shell + yarn init --yes + ``` + + + +2. 安裝 Astro + + 首先，在專案內安裝 Astro 專案相依套件。 + + :::note[重要] + Astro 必須在本地安裝，而非全域安裝。請確保你「沒有」執行 `npm install -g astro`、`pnpm add -g astro` 或 `yarn add global astro`。 + ::: + + + + ```shell + npm install astro + ``` + + + ```shell + pnpm add astro + ``` + + + ```shell + yarn add astro + ``` + + + + 然後，將 `package.json` 中任何佔位符的 "scripts" 區段替換為以下內容： + + ```json title="package.json" del={3} ins={4-6} + { + "scripts": { + "test": "echo \"Error: no test specified\" && exit 1", + "dev": "astro dev", + "build": "astro build", + "preview": "astro preview" + }, + } + ``` + + 你將在本指南後續步驟中使用這些腳本來啟動 Astro 並執行其不同的指令。 + +3. 建立你的第一個頁面 + + 在文字編輯器中，於目錄的 `src/pages/index.astro` 建立新檔案。這將是專案中你的第一個 Astro 頁面。 + + 在本指南中，複製並貼上以下程式碼片段（包括 `---` 虛線）到新檔案中： + + ```astro title="src/pages/index.astro" + --- + // 歡迎來到 Astro！三重虛線程式碼圍欄之間的所有內容 + // 都是你的「元件 frontmatter」。它永遠不會在瀏覽器中執行。 + console.log('這會在你的終端機中執行，而不是瀏覽器！'); + --- + + + +

Hello, World!

+ + + + ``` + +4. 建立你的第一個靜態資源 + + 你也會想要建立 `public/` 目錄來存放靜態資源。Astro 總是會在最終建構中包含這些資源，所以你可以安全地從元件模板內部參照它們。 + + 在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。 + + 在本指南中，複製並貼上以下程式碼片段到新檔案中： + + ```diff title="public/robots.txt" + # 範例：允許所有機器人掃描和索引你的網站。 + # 完整語法：https://developers.google.com/search/docs/advanced/robots/create-robots-txt + User-agent: * + Allow: / + ``` + +5. 建立 `astro.config.mjs` + + Astro 是使用 `astro.config.mjs` 來配置的。如果你不需要配置 Astro，這個檔案是可選的，但你可能希望現在就建立它。 + + 在專案根目錄建立 `astro.config.mjs`，並將下面的程式碼複製到其中： + + ```js title="astro.config.mjs" + import { defineConfig } from "astro/config"; + + // https://astro.build/config + export default defineConfig({}); + ``` + + 如果你想在專案中包含 [UI 框架元件](/en/guides/framework-components/)（如 React、Svelte 等）或使用其他工具（如 MDX 或 Partytown），這裡就是你要[手動匯入和配置整合](/en/guides/integrations-guide/)的地方。 + + 閱讀 Astro 的 [API 配置參考](/en/reference/configuration-reference/)以獲取更多資訊。 + +6. 新增 TypeScript 支援 + + TypeScript 是使用 `tsconfig.json` 來配置的。即使你不撰寫 TypeScript 程式碼，這個檔案也很重要，這樣 Astro 和 VS Code 等工具才知道如何理解你的專案。沒有 `tsconfig.json` 檔案，編輯器不會完全支援某些功能（如 npm 套件匯入）。 + + 如果你確實打算撰寫 TypeScript 程式碼，建議使用 Astro 的 `strict` 或 `strictest` 模板。你可以在 [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/) 查看和比較三種模板配置。 + + 在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以為 TypeScript 模板使用 `base`、`strict` 或 `strictest`）： + + ```json title="tsconfig.json" "base" + { + "extends": "astro/tsconfigs/base" + } + ``` + + 閱讀 Astro 的 [TypeScript 設定指南](/en/guides/typescript/#setup)以獲取更多資訊。 + +7. 後續步驟 + + 如果你已按照上述步驟操作，你的專案目錄現在應該看起來像這樣： + + + - node_modules/ + - public/ + - robots.txt + - src/ + - pages/ + - index.astro + - astro.config.mjs + - package-lock.json 或 `yarn.lock`、`pnpm-lock.yaml` 等 + - package.json + - tsconfig.json + + +8. 你現在可以[啟動 Astro 開發伺服器](/en/develop-and-build/#start-the-astro-dev-server)，並在建構時看到專案的即時預覽！ + + From 77f19af4a2ee0292f1fd2dee7df83b6ad12b3d50 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Tue, 23 Sep 2025 17:00:46 +0800 Subject: [PATCH 02/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 1a50b0ed35251..fabce9b083e4a 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -12,7 +12,7 @@ import { Tabs, TabItem, FileTree, CardGrid, LinkCard, Steps } from '@astrojs/sta import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; import ReadMore from '~/components/ReadMore.astro'; -[`create astro` CLI 指令](#install-from-the-cli-wizard)是從零開始一個新 Astro 專案最快的方法。它會引導你完成設定新 Astro 專案的每個步驟，並讓你從幾個不同的官方起始模板中選擇。 +[`create astro` CLI 指令](#從-cli-精靈安裝)是從零開始一個新 Astro 專案最快的方法。它會引導你完成設定新 Astro 專案的每個步驟，並讓你從幾個不同的官方起始模板中選擇。 你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！ From 8906576f913de1c4fa9f9b99e5af3513677ab050 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Tue, 23 Sep 2025 17:03:04 +0800 Subject: [PATCH 03/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index fabce9b083e4a..9793378b374b2 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -16,7 +16,7 @@ import ReadMore from '~/components/ReadMore.astro'; 你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！ -如果你想手動安裝 Astro，請參閱我們的[手動安裝指南](#manual-setup)。 +如果你想手動安裝 Astro，請參閱我們的[手動安裝指南](#手動設定)。 :::tip[線上預覽] 想在瀏覽器中試用 Astro 嗎？前往 [astro.new](https://astro.new/) 瀏覽我們的起始模板，並在不離開瀏覽器的情況下建立新的 Astro 專案。 From ac4b97c9f8d7d3b605c728fb08385c7f325f75bf Mon Sep 17 00:00:00 2001 From: Yorukot Date: Tue, 23 Sep 2025 17:06:28 +0800 Subject: [PATCH 04/21] fix: change url from /en to /zh-tw --- src/content/docs/zh-tw/install-and-setup.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 9793378b374b2..64d76c2716a00 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -6,7 +6,7 @@ description: '如何安裝 Astro 並開始一個新專案' i18nReady: true banner: content: | - Astro v5 已經到來! 了解如何升級您的網站 + Astro v5 已經到來! 了解如何升級您的網站 --- import { Tabs, TabItem, FileTree, CardGrid, LinkCard, Steps } from '@astrojs/starlight/components'; import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; @@ -84,7 +84,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 -4. 你現在可以[啟動 Astro 開發伺服器](/en/develop-and-build/#start-the-astro-dev-server)並在建構時看到專案的即時預覽！ +4. 你現在可以[啟動 Astro 開發伺服器](/zh-tw/develop-and-build/#start-the-astro-dev-server)並在建構時看到專案的即時預覽！ ## CLI 安裝選項 @@ -95,7 +95,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 ### 新增整合 -你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/en/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。 +你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。 在你的終端機中執行以下指令，替換為任何支援 `astro add` 指令的整合： @@ -289,9 +289,9 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 export default defineConfig({}); ``` - 如果你想在專案中包含 [UI 框架元件](/en/guides/framework-components/)（如 React、Svelte 等）或使用其他工具（如 MDX 或 Partytown），這裡就是你要[手動匯入和配置整合](/en/guides/integrations-guide/)的地方。 + 如果你想在專案中包含 [UI 框架元件](/zh-tw/guides/framework-components/)（如 React、Svelte 等）或使用其他工具（如 MDX 或 Partytown），這裡就是你要[手動匯入和配置整合](/zh-tw/guides/integrations-guide/)的地方。 - 閱讀 Astro 的 [API 配置參考](/en/reference/configuration-reference/)以獲取更多資訊。 + 閱讀 Astro 的 [API 配置參考](/zh-tw/reference/configuration-reference/)以獲取更多資訊。 6. 新增 TypeScript 支援 @@ -307,7 +307,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 } ``` - 閱讀 Astro 的 [TypeScript 設定指南](/en/guides/typescript/#setup)以獲取更多資訊。 + 閱讀 Astro 的 [TypeScript 設定指南](/zh-tw/guides/typescript/#setup)以獲取更多資訊。 7. 後續步驟 @@ -326,6 +326,6 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 - tsconfig.json -8. 你現在可以[啟動 Astro 開發伺服器](/en/develop-and-build/#start-the-astro-dev-server)，並在建構時看到專案的即時預覽！ +8. 你現在可以[啟動 Astro 開發伺服器](/zh-tw/develop-and-build/#start-the-astro-dev-server)，並在建構時看到專案的即時預覽！ From cf2cd0056695511b0aeb63e3985fa138596bb8dd Mon Sep 17 00:00:00 2001 From: Yorukot Date: Thu, 25 Sep 2025 00:54:04 +0800 Subject: [PATCH 05/21] i18n(zh-tw): fix anchor link consistency in install and setup docs --- src/content/docs/zh-tw/basics/project-structure.mdx | 2 +- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/zh-tw/basics/project-structure.mdx b/src/content/docs/zh-tw/basics/project-structure.mdx index 0af3a16c9a4e3..1ac177d606ef9 100644 --- a/src/content/docs/zh-tw/basics/project-structure.mdx +++ b/src/content/docs/zh-tw/basics/project-structure.mdx @@ -118,7 +118,7 @@ Astro 會處理、最佳化並將你的 `src/` 捆起來建立最後瀏覽器會 這裡有[兩種相依性](https://docs.npmjs.com/specifying-dependencies-and-devdependencies-in-a-package-json-file)你可以在 `package.json` 中指定： `dependencies` 和 `devDependencies` 。在大多情況下運作起來相同：Astro 在建立時會需要所有的相依性，而你的套件管理器會下載這兩個。我們推薦將你所有的依賴模組放在 `dependencies` 來開始，並只在你特別需要的時候才使用 `devDependencies` 。 -若需要為你專案建立一個新的 `package.json` 檔案，可以看看[手動安裝](/zh-tw/install-and-setup/#manual-setup)教學來取得協助。 +若需要為你專案建立一個新的 `package.json` 檔案，可以看看[手動安裝](/zh-tw/install-and-setup/#手動安裝)教學來取得協助。 ### `astro.config.mjs` diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 64d76c2716a00..d4aa31004398b 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -158,7 +158,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 預設情況下，此指令會使用模板存放庫的 `main` 分支。若要使用不同的分支名稱，請將其作為 `--template` 參數的一部分傳遞：`/#`。 -## 手動設定 +## 手動安裝 本指南將帶你逐步手動安裝和配置新的 Astro 專案。 From beb1ef9c4359d0399d831560d729453520e714cf Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:40:37 +0800 Subject: [PATCH 06/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index d4aa31004398b..f72a873e9ccf5 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -6,7 +6,7 @@ description: '如何安裝 Astro 並開始一個新專案' i18nReady: true banner: content: | - Astro v5 已經到來! 了解如何升級您的網站 + Astro v5 已經到來！了解如何升級你的網站 --- import { Tabs, TabItem, FileTree, CardGrid, LinkCard, Steps } from '@astrojs/starlight/components'; import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'; From 67729a9754390cecf654ab0b1f62b2ef3ca4abf3 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:40:50 +0800 Subject: [PATCH 07/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index f72a873e9ccf5..03c4cf8db85a8 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -14,7 +14,7 @@ import ReadMore from '~/components/ReadMore.astro'; [`create astro` CLI 指令](#從-cli-精靈安裝)是從零開始一個新 Astro 專案最快的方法。它會引導你完成設定新 Astro 專案的每個步驟，並讓你從幾個不同的官方起始模板中選擇。 -你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！ +你也可以加上 `template` 選項來執行 CLI 指令，以使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！ 如果你想手動安裝 Astro，請參閱我們的[手動安裝指南](#手動設定)。 From e83d61f54b6e1781b0e3e96e2ab6d7931cce9824 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:42:18 +0800 Subject: [PATCH 08/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 03c4cf8db85a8..8938a61b691a8 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -64,7 +64,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 2. 現在你的專案已經建立，你可以 `cd` 進入新的專案目錄來開始使用 Astro。 -3. 如果你在 CLI 精靈過程中跳過了 「Install dependencies?」 的步驟，請務必在繼續之前安裝相依套件。 +3. 如果你在 CLI 精靈過程中跳過了「Install dependencies?」的步驟，請務必在繼續之前安裝相依套件。 From 94440d866974fb3f4a7ff8e18866b46b4c8455b8 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:42:33 +0800 Subject: [PATCH 09/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 8938a61b691a8..af0e3033d11a3 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -89,7 +89,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 ## CLI 安裝選項 -你可以使用透過額外選項執行 `create astro` 指令，自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。 +你可以在執行 `create astro` 指令時加上額外選項以自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。 查看[所有可用的 `create astro` 指令選項](https://github.com/withastro/astro/blob/main/packages/create-astro/README.md) From 939f3c5ba06b75f478894890d137de77cbca033c Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:42:51 +0800 Subject: [PATCH 10/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index af0e3033d11a3..113ce1366598a 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -95,7 +95,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 ### 新增整合 -你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。 +你可以在啟動新 Astro 專案的同時，在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。 在你的終端機中執行以下指令，替換為任何支援 `astro add` 指令的整合： From f9a9a41dfe344d829794b3eeb6f908080b17c69d Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:43:08 +0800 Subject: [PATCH 11/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 113ce1366598a..53dccf2c28d9f 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -265,7 +265,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 你也會想要建立 `public/` 目錄來存放靜態資源。Astro 總是會在最終建構中包含這些資源，所以你可以安全地從元件模板內部參照它們。 - 在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。 + 在文字編輯器中，於 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。 在本指南中，複製並貼上以下程式碼片段到新檔案中： From 4b4e5a592a2689d1987123b59c148067f2c21d5c Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:43:17 +0800 Subject: [PATCH 12/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 53dccf2c28d9f..eb6dfbea0c35e 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -26,7 +26,7 @@ import ReadMore from '~/components/ReadMore.astro'; - **Node.js** - `v18.20.8` 或 `v20.3.0`、`v22.0.0` 或更高版本。（不支援 `v19` 和 `v21`。） - **文字編輯器** - 我們推薦使用 [VS Code](https://code.visualstudio.com/) 搭配我們的[官方 Astro 擴充功能](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode)。 -- **終端機** - Astro 是透過命令列介面 (CLI) 來使用的。 +- **終端機** - Astro 是透過命令列介面（CLI）來使用的。 ## 瀏覽器相容性 From e57ba7cc5320f316d39ffc98bc2e8ed968e19674 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:43:31 +0800 Subject: [PATCH 13/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index eb6dfbea0c35e..cf76c640d84db 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -37,7 +37,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 你可以在電腦的任何地方執行 `create astro`，所以在開始之前不需要為你的專案建立新的空目錄。如果你還沒有為新專案準備空目錄，CLI 精靈會自動幫你建立一個。 -1. 在你的終端機中執行以下指令來啟動安裝精靈： +1. 在終端機中執行以下指令來啟動安裝精靈： From f07a70f736dc12cf7f7e967d153f2ae26a843615 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:43:41 +0800 Subject: [PATCH 14/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index cf76c640d84db..3829c76e9ec63 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -267,7 +267,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 在文字編輯器中，於 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。 - 在本指南中，複製並貼上以下程式碼片段到新檔案中： + 在本指南，複製並貼上以下程式碼片段到新檔案中： ```diff title="public/robots.txt" # 範例：允許所有機器人掃描和索引你的網站。 From bc983f66bf092847ac6733d6ef98f55ef1440bbf Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:44:10 +0800 Subject: [PATCH 15/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 3829c76e9ec63..52ba4e97093a5 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -299,7 +299,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 如果你確實打算撰寫 TypeScript 程式碼，建議使用 Astro 的 `strict` 或 `strictest` 模板。你可以在 [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/) 查看和比較三種模板配置。 - 在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以為 TypeScript 模板使用 `base`、`strict` 或 `strictest`）： + 在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以使用 `base`、`strict` 或 `strictest` 做為 TypeScript 模板）： ```json title="tsconfig.json" "base" { From 51c55778639dfef9db760ca7debd9db7533c57b1 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 14:44:37 +0800 Subject: [PATCH 16/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 52ba4e97093a5..8a3057250ba3b 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -199,7 +199,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 首先，在專案內安裝 Astro 專案相依套件。 :::note[重要] - Astro 必須在本地安裝，而非全域安裝。請確保你「沒有」執行 `npm install -g astro`、`pnpm add -g astro` 或 `yarn add global astro`。 + Astro 必須在本地安裝，而非全域安裝。請確保你**沒有**執行 `npm install -g astro`、`pnpm add -g astro` 或 `yarn add global astro`。 ::: From d35cd133ad6aed9b3c8a56cdbb6152eed8436ea3 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 15:24:21 +0800 Subject: [PATCH 17/21] Refine wording for clarity in template usage instructions --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 8a3057250ba3b..e90abbbc8a3d8 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -122,7 +122,7 @@ 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 使用者名稱和儲存庫名稱替換進去： From bea300407ae19259b30f4afe4a8a37f49b3c8966 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 15:25:35 +0800 Subject: [PATCH 18/21] =?UTF-8?q?Fix=20wording=20from=20"=E5=AD=98?= =?UTF-8?q?=E6=94=BE=E5=BA=AB"=20to=20"=E5=84=B2=E5=AD=98=E5=BA=AB"=20for?= =?UTF-8?q?=20consistency=20in=20installation=20instructions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/content/docs/zh-tw/install-and-setup.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index e90abbbc8a3d8..8c55535dec9fa 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -132,7 +132,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 # 使用官方範例建立新專案 npm create astro@latest -- --template - # 基於 GitHub 存放庫的 main 分支建立新專案 + # 基於 GitHub 儲存庫的 main 分支建立新專案 npm create astro@latest -- --template / ``` @@ -141,7 +141,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 # 使用官方範例建立新專案 pnpm create astro@latest --template - # 基於 GitHub 存放庫的 main 分支建立新專案 + # 基於 GitHub 儲存庫的 main 分支建立新專案 pnpm create astro@latest --template / ``` @@ -150,13 +150,13 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 # 使用官方範例建立新專案 yarn create astro --template - # 基於 GitHub 存放庫的 main 分支建立新專案 + # 基於 GitHub 儲存庫的 main 分支建立新專案 yarn create astro --template / ``` -預設情況下，此指令會使用模板存放庫的 `main` 分支。若要使用不同的分支名稱，請將其作為 `--template` 參數的一部分傳遞：`/#`。 +預設情況下，此指令會使用模板儲存庫的 `main` 分支。若要使用不同的分支名稱，請將其作為 `--template` 參數的一部分傳遞：`/#`。 ## 手動安裝 From ddfd7ae3100ee82d6f60121b3ebb95fa6705fc3e Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 15:26:26 +0800 Subject: [PATCH 19/21] Refine wording for consistency in manual installation instructions --- src/content/docs/zh-tw/install-and-setup.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 8c55535dec9fa..142771a1ea834 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -160,7 +160,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 ## 手動安裝 -本指南將帶你逐步手動安裝和配置新的 Astro 專案。 +本指南將帶你逐步手動安裝和設定新的 Astro 專案。 如果你不想使用我們的自動化 `create astro` CLI 工具，可以按照以下指南自行設定專案。 @@ -278,7 +278,7 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 5. 建立 `astro.config.mjs` - Astro 是使用 `astro.config.mjs` 來配置的。如果你不需要配置 Astro，這個檔案是可選的，但你可能希望現在就建立它。 + Astro 是使用 `astro.config.mjs` 來設定的。如果你不需要設定 Astro，這個檔案是可選的，但你可能希望現在就建立它。 在專案根目錄建立 `astro.config.mjs`，並將下面的程式碼複製到其中： @@ -289,15 +289,15 @@ Astro 是使用 Vite 建構的，預設支援具有現代 JavaScript 功能的 export default defineConfig({}); ``` - 如果你想在專案中包含 [UI 框架元件](/zh-tw/guides/framework-components/)（如 React、Svelte 等）或使用其他工具（如 MDX 或 Partytown），這裡就是你要[手動匯入和配置整合](/zh-tw/guides/integrations-guide/)的地方。 + 如果你想在專案中包含 [UI 框架元件](/zh-tw/guides/framework-components/)（如 React、Svelte 等）或使用其他工具（如 MDX 或 Partytown），這裡就是你要[手動匯入和設定整合](/zh-tw/guides/integrations-guide/)的地方。 - 閱讀 Astro 的 [API 配置參考](/zh-tw/reference/configuration-reference/)以獲取更多資訊。 + 閱讀 Astro 的 [API 設定參考](/zh-tw/reference/configuration-reference/)以獲取更多資訊。 6. 新增 TypeScript 支援 - TypeScript 是使用 `tsconfig.json` 來配置的。即使你不撰寫 TypeScript 程式碼，這個檔案也很重要，這樣 Astro 和 VS Code 等工具才知道如何理解你的專案。沒有 `tsconfig.json` 檔案，編輯器不會完全支援某些功能（如 npm 套件匯入）。 + TypeScript 是使用 `tsconfig.json` 來設定的。即使你不撰寫 TypeScript 程式碼，這個檔案也很重要，這樣 Astro 和 VS Code 等工具才知道如何理解你的專案。沒有 `tsconfig.json` 檔案，編輯器不會完全支援某些功能（如 npm 套件匯入）。 - 如果你確實打算撰寫 TypeScript 程式碼，建議使用 Astro 的 `strict` 或 `strictest` 模板。你可以在 [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/) 查看和比較三種模板配置。 + 如果你確實打算撰寫 TypeScript 程式碼，建議使用 Astro 的 `strict` 或 `strictest` 模板。你可以在 [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/) 查看和比較三種模板設定。 在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以使用 `base`、`strict` 或 `strictest` 做為 TypeScript 模板）： From e907d3d3bd833e19a033cadff8135919921a13bd Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 4 Oct 2025 15:28:56 +0800 Subject: [PATCH 20/21] Fix link reference in manual installation instructions --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index 142771a1ea834..a88009266f046 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -16,7 +16,7 @@ import ReadMore from '~/components/ReadMore.astro'; 你也可以加上 `template` 選項來執行 CLI 指令，以使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！ -如果你想手動安裝 Astro，請參閱我們的[手動安裝指南](#手動設定)。 +如果你想手動安裝 Astro，請參閱我們的[手動安裝指南](#手動安裝)。 :::tip[線上預覽] 想在瀏覽器中試用 Astro 嗎？前往 [astro.new](https://astro.new/) 瀏覽我們的起始模板，並在不離開瀏覽器的情況下建立新的 Astro 專案。 From 6b0923f45e66b4d4f73e8efd5fa10d3c458d808f Mon Sep 17 00:00:00 2001 From: Yorukot Date: Wed, 8 Oct 2025 22:03:56 +0800 Subject: [PATCH 21/21] Update src/content/docs/zh-tw/install-and-setup.mdx Co-authored-by: vrabe --- src/content/docs/zh-tw/install-and-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/zh-tw/install-and-setup.mdx b/src/content/docs/zh-tw/install-and-setup.mdx index a88009266f046..9def481a85000 100644 --- a/src/content/docs/zh-tw/install-and-setup.mdx +++ b/src/content/docs/zh-tw/install-and-setup.mdx @@ -6,7 +6,7 @@ description: '如何安裝 Astro 並開始一個新專案' i18nReady: true banner: content: | - Astro v5 已經到來！了解如何升級你的網站 + Astro v5 已經到來！了解如何升級你的網站。 --- import { Tabs, TabItem, FileTree, CardGrid, LinkCard, Steps } from '@astrojs/starlight/components'; import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';