i18n(zh-tw): update `install-and-setup.mdx` #12354

yorukot · 2025-09-19T22:55:18Z

Description (required)

Update zh-tw translation for install-and-setup.mdx

Discord username: yoru.kot

netlify · 2025-09-19T22:55:35Z

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`7385d3d`
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/68d5578aa0532c0008060b49
😎 Deploy Preview	https://deploy-preview-12354--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

astrobot-houston · 2025-09-19T22:55:40Z

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
zh-tw/basics/project-structure.mdx	Localization changed, will be marked as complete.
zh-tw/install-and-setup.mdx	Localization added, will be marked as complete.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

astrobot-houston · 2025-09-19T22:55:55Z

Hello! Thank you for opening your first PR to Astro’s Docs! 🎉

Here’s what will happen next:

Our GitHub bots will run to check your changes.
If they spot any broken links you will see some error messages on this PR.
Don’t hesitate to ask any questions if you’re not sure what these mean!
In a few minutes, you’ll be able to see a preview of your changes on Netlify 🥳.
One or more of our maintainers will take a look and may ask you to make changes.
We try to be responsive, but don’t worry if this takes a few days.

vrabe · 2025-09-22T16:40:34Z

首先謝謝你的翻譯

我還沒有仔細看，不過有些是可以先改的：

連結要是中文版的，就算還沒有翻譯。也就是說以 /en/ 開頭的站內連結都要改成 /zh-tw/ 開頭。

anchor 也要是中文版的。它是由標題轉換成的，把標題的空格換成 - 就能得到指向那個標題的連結。這個有點難判斷，所以我會在下面指出來：

src/content/docs/zh-tw/install-and-setup.mdx

Co-authored-by: vrabe <[email protected]>

yorukot · 2025-09-23T09:08:31Z

好的，謝謝你的 review 我已經針對上面的要求進行更改了！
如果還需要更改什麼再跟我說一下，感謝

yorukot · 2025-09-24T03:48:49Z

這個 Error 要改嗎？
看起來是因為：

若需要為你專案建立一個新的 `package.json` 檔案，可以看看[手動安裝](/zh-tw/install-and-setup/#manual-setup)教學來取得協助。

目前 install-and-setup 已經翻譯了，所以出現這個錯誤。

vrabe · 2025-09-24T07:43:33Z

@yorukot 要的，也請把它改一下。

yorukot · 2025-09-26T04:21:05Z

@vrabe 已更改

vrabe

大概是這樣，你再看看。

vrabe · 2025-09-24T12:55:36Z

src/content/docs/zh-tw/install-and-setup.mdx

+i18nReady: true
+banner:
+  content: |
+    Astro v5 已經到來! <a href="/zh-tw/guides/upgrade-to/v5/">了解如何升級您的網站</a>


Suggested change

Astro v5 已經到來! <a href="/zh-tw/guides/upgrade-to/v5/">了解如何升級您的網站</a>

Astro v5 已經到來！<a href="/zh-tw/guides/upgrade-to/v5/">了解如何升級你的網站</a>

用你不用您

vrabe · 2025-09-25T16:28:22Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+[`create astro` CLI 指令](#從-cli-精靈安裝)是從零開始一個新 Astro 專案最快的方法。它會引導你完成設定新 Astro 專案的每個步驟，並讓你從幾個不同的官方起始模板中選擇。
+
+你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！


第一句很怪。

應該是

Suggested change

你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！

你也可以加上 `template` 選項來執行 CLI 指令，以使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！

之類的。

vrabe · 2025-09-25T16:44:26Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+2. 現在你的專案已經建立，你可以 `cd` 進入新的專案目錄來開始使用 Astro。
+
+3. 如果你在 CLI 精靈過程中跳過了 「Install dependencies?」 的步驟，請務必在繼續之前安裝相依套件。


Suggested change

3. 如果你在 CLI 精靈過程中跳過了「Install dependencies?」的步驟，請務必在繼續之前安裝相依套件。

3. 如果你在 CLI 精靈過程中跳過了「Install dependencies?」的步驟，請務必在繼續之前安裝相依套件。

vrabe · 2025-09-25T16:50:06Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+## CLI 安裝選項
+
+你可以使用透過額外選項執行 `create astro` 指令，自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。


使用透過額外選項也是很怪。類似這樣會好一點：

Suggested change

你可以使用透過額外選項執行 `create astro` 指令，自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。

你可以在執行 `create astro` 指令時加上額外選項以自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。

vrabe · 2025-09-25T16:55:19Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+### 新增整合
+
+你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。


Suggested change

你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。

你可以在啟動新 Astro 專案的同時，在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。

或許不需要透過。

vrabe · 2025-09-28T19:33:01Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+    你也會想要建立 `public/` 目錄來存放靜態資源。Astro 總是會在最終建構中包含這些資源，所以你可以安全地從元件模板內部參照它們。
+
+    在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。


Suggested change

在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。

在文字編輯器中，於 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。

刪掉也不會改變意思。

vrabe · 2025-09-28T19:41:49Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+- **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) 來使用的。


Suggested change

- **終端機** - Astro 是透過命令列介面 (CLI) 來使用的。

- **終端機** - Astro 是透過命令列介面（CLI）來使用的。

vrabe · 2025-09-28T19:43:06Z

src/content/docs/zh-tw/install-and-setup.mdx

+你可以在電腦的任何地方執行 `create astro`，所以在開始之前不需要為你的專案建立新的空目錄。如果你還沒有為新專案準備空目錄，CLI 精靈會自動幫你建立一個。
+
+<Steps>
+1. 在你的終端機中執行以下指令來啟動安裝精靈：


Suggested change

1. 在你的終端機中執行以下指令來啟動安裝精靈：

1. 在終端機中執行以下指令來啟動安裝精靈：

這個你的可以去掉。

vrabe · 2025-09-28T20:17:02Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+    在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。
+
+    在本指南中，複製並貼上以下程式碼片段到新檔案中：


Suggested change

在本指南中，複製並貼上以下程式碼片段到新檔案中：

在本指南，複製並貼上以下程式碼片段到新檔案中：

這樣感覺比較好。

vrabe · 2025-09-28T20:21:09Z

src/content/docs/zh-tw/install-and-setup.mdx

+
+    如果你確實打算撰寫 TypeScript 程式碼，建議使用 Astro 的 `strict` 或 `strictest` 模板。你可以在 [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/) 查看和比較三種模板配置。
+
+    在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以為 TypeScript 模板使用 `base`、`strict` 或 `strictest`）：


括弧裡面這樣直接翻有點怪，還是這樣？

Suggested change

在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以為 TypeScript 模板使用 `base`、`strict` 或 `strictest`）：

在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以使用 `base`、`strict` 或 `strictest` 做為 TypeScript 模板）：

vrabe · 2025-09-28T20:39:54Z

還有你把標題的手動設定改手動安裝後，連結也要跟著改，所以等到大概 OK 的時候記得要把連結的錯誤修正。

i18n(zh-tw): update install-and-setup.mdx

bd8a677

github-actions bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Sep 19, 2025

vrabe reviewed Sep 22, 2025

View reviewed changes

src/content/docs/zh-tw/install-and-setup.mdx Outdated Show resolved Hide resolved

src/content/docs/zh-tw/install-and-setup.mdx Outdated Show resolved Hide resolved

yorukot and others added 3 commits September 23, 2025 17:00

Update src/content/docs/zh-tw/install-and-setup.mdx

77f19af

Co-authored-by: vrabe <[email protected]>

Update src/content/docs/zh-tw/install-and-setup.mdx

8906576

Co-authored-by: vrabe <[email protected]>

fix: change url from /en to /zh-tw

ac4b97c

yorukot requested a review from vrabe September 23, 2025 09:07

yorukot and others added 2 commits September 25, 2025 00:54

i18n(zh-tw): fix anchor link consistency in install and setup docs

cf2cd00

Merge branch 'main' into i18n/zh-tw/install-and-setup

7385d3d

vrabe suggested changes Sep 28, 2025

View reviewed changes

	Astro v5 已經到來! <a href="/zh-tw/guides/upgrade-to/v5/">了解如何升級您的網站</a>
	Astro v5 已經到來！<a href="/zh-tw/guides/upgrade-to/v5/">了解如何升級你的網站</a>


		[`create astro` CLI 指令](#從-cli-精靈安裝)是從零開始一個新 Astro 專案最快的方法。它會引導你完成設定新 Astro 專案的每個步驟，並讓你從幾個不同的官方起始模板中選擇。

		你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！

	你也可以使用 `template` 選項來執行 CLI 指令，以達到使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！
	你也可以加上 `template` 選項來執行 CLI 指令，以使用任何現有的主題或起始模板來開始你的專案。探索我們的[主題和起始模板展示](https://astro.build/themes/)，你可以在那裡瀏覽部落格、作品集、文件網站、登陸頁面等主題！


		2. 現在你的專案已經建立，你可以 `cd` 進入新的專案目錄來開始使用 Astro。

		3. 如果你在 CLI 精靈過程中跳過了「Install dependencies?」的步驟，請務必在繼續之前安裝相依套件。


		## CLI 安裝選項

		你可以使用透過額外選項執行 `create astro` 指令，自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。

	你可以使用透過額外選項執行 `create astro` 指令，自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。
	你可以在執行 `create astro` 指令時加上額外選項以自訂設定過程（例如對所有問題回答「是」、跳過 Houston 動畫）或你的新專案（例如是否安裝 git、新增整合）。


		### 新增整合

		你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。

	你可以在啟動新 Astro 專案的同時，透過在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。
	你可以在啟動新 Astro 專案的同時，在 `create astro` 指令中傳遞 `--add` 參數來安裝任何[官方整合](/zh-tw/guides/integrations-guide/)或支援 `astro add` 指令的社群整合。


		你也會想要建立 `public/` 目錄來存放靜態資源。Astro 總是會在最終建構中包含這些資源，所以你可以安全地從元件模板內部參照它們。

		在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。

	在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。
	在文字編輯器中，於 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。

	- 終端機 - Astro 是透過命令列介面 (CLI) 來使用的。
	- 終端機 - Astro 是透過命令列介面（CLI）來使用的。

	1. 在你的終端機中執行以下指令來啟動安裝精靈：
	1. 在終端機中執行以下指令來啟動安裝精靈：


		在文字編輯器中，於目錄的 `public/robots.txt` 建立新檔案。`robots.txt` 是一個簡單的檔案，大多數網站都會包含它來告訴搜尋機器人（如 Google）如何處理你的網站。

		在本指南中，複製並貼上以下程式碼片段到新檔案中：

	在本指南中，複製並貼上以下程式碼片段到新檔案中：
	在本指南，複製並貼上以下程式碼片段到新檔案中：


		如果你確實打算撰寫 TypeScript 程式碼，建議使用 Astro 的 `strict` 或 `strictest` 模板。你可以在 [astro/tsconfigs/](https://github.com/withastro/astro/blob/main/packages/astro/tsconfigs/) 查看和比較三種模板配置。

		在專案根目錄建立 `tsconfig.json`，並將下面的程式碼複製到其中。（你可以為 TypeScript 模板使用 `base`、`strict` 或 `strictest`）：

Uh oh!

i18n(zh-tw): update install-and-setup.mdx #12354

Are you sure you want to change the base?

i18n(zh-tw): update install-and-setup.mdx #12354

Uh oh!

Conversation

yorukot commented Sep 19, 2025

Description (required)

Uh oh!

netlify bot commented Sep 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for astro-docs-2 ready!

Uh oh!

astrobot-houston commented Sep 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Lunaria Status Overview

Tracked Files

Uh oh!

astrobot-houston commented Sep 19, 2025

Uh oh!

vrabe commented Sep 22, 2025

Uh oh!

Uh oh!

Uh oh!

yorukot commented Sep 23, 2025

Uh oh!

yorukot commented Sep 24, 2025

Uh oh!

vrabe commented Sep 24, 2025

Uh oh!

yorukot commented Sep 26, 2025

Uh oh!

vrabe left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vrabe commented Sep 28, 2025

Uh oh!

Uh oh!

i18n(zh-tw): update `install-and-setup.mdx` #12354

i18n(zh-tw): update `install-and-setup.mdx` #12354

netlify bot commented Sep 19, 2025 •

edited

Loading

astrobot-houston commented Sep 19, 2025 •

edited

Loading