i18n(zh-tw): Update `guides/deploy/github.mdx` #11011

510208 · 2025-02-20T13:17:41Z

Description (required)

Update github.mdx (The file which help users deploy there's Astro website to GitHub Pages)

Note

This PR adds a Traditional Chinese guide for deploying an Astro website to GitHub Pages.

Related issues & labels (optional)

Closes #
Suggested label: i18n

First-time contributor to Astro Docs?

Yes, I love this project very much. But since I am not familiar with Javascript, I cannot provide any useful code.

My Discord username: @samhacker

netlify · 2025-02-20T13:17:58Z

✅ Deploy Preview for astro-docs-2 ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`b3f86f9`
🔍 Latest deploy log	https://app.netlify.com/sites/astro-docs-2/deploys/67bafa0eb738900008b00b2f
😎 Deploy Preview	https://deploy-preview-11011--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 site configuration.

astrobot-houston · 2025-02-20T13:18:11Z

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/guides/deploy/github.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-02-20T13:18:13Z

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-02-20T17:44:32Z

@510208 你好，感謝你的翻譯，我試著檢查看看。

510208 · 2025-02-21T12:40:27Z

@510208你好，感謝你的翻譯，我試著檢查看看。

OK，等囉~~

liruifengv

感谢你的翻译，不知道我说中文简体你有没有障碍。

对于一些新增的部分，我认为不应该在翻译中添加，如果你认为添加这部分有必要的话，请单独提交一个英文原文修改的PR

liruifengv · 2025-02-22T03:00:37Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+
+你可以透過 [GitHub Actions](https://github.com/features/actions) 將你的 Astro 網站自動搭建並部署到 GitHub Pages 網站上。為了這麼做，你應該將你的網站原始碼託管至 GitHub。
+
+Astro 維護了一個官方的 `withastro/action` 幫助你部署你的專案。按照下方的說明即可讓你快速將 Astro 網站部署進 GitHub pages，並請在需要更多資訊時，可以檢視[這個讀我檔案](https://github.com/withastro/action)。


这里的 ‘README’ 在我看来是不需要翻译的，但我不清楚在zh-tw 的语境中如何。

另外这里似乎缺少了 with very little configuration 的翻译

是有這個翻譯，我不會用，但不反對別人用

我是都會翻譯成讀我檔案啦，所以不需要嗎？

如果不用的話我就刪掉，沒關係

liruifengv · 2025-02-22T03:02:18Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+
+## 為 GitHub Pages 配置 Astro 專案
+
+為了將 Astro 網站部署至 GitHub Pages，我們需要先對原本的 Astro 配置文件做些許變更。按照下方的說明即可，如果你不知道自己該怎麼做的話。


这一部分是所说的新加的部分？
我认为这里是不需要的。

可以看一下这里的写作指南部分，https://contribute.docs.astro.build/guides/writing-style/

liruifengv · 2025-02-22T03:07:06Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+
+請確保你的 `site` 值應為以下的其中之一：
+
+- 以你的使用者名稱產生的 GitHub.io 網址，如：`https://<username>.github.io`


这个 Github.io 我认为也是多余的

liruifengv · 2025-02-22T03:07:42Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  site: 'https://astronaut.github.io',        // 你的 GitHub Pages 網址


这里注释也是多余的，因为下面有具体的说明

liruifengv · 2025-02-22T03:11:17Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+sub.mydomain.com
+```
+
+這會將你的網站部署在你所指定的自訂網域名稱下，而非 `<YOUR_USERNAME>.github.io`。另外，絕對不要忘記在你的網域名稱供應商（如：GoDaddy、Namecheap 等）中設定一個 CNAME 記錄，如果需要詳細的資訊可以檢視 [為你的域名提供商設定 GitHub Pages](https://docs.github.com/cn/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)。


这里我认为也是不需要的，不要在翻译上为原文增加补充说明，如果你认为是有必要的话，可以再单独提交一个 PR 对英文原文进行修改

liruifengv · 2025-02-22T03:12:05Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  site: 'https://example.com',      // 你的自訂網域名稱


这里也不需要注释

src/content/docs/zh-tw/guides/deploy/github.mdx

liruifengv · 2025-02-22T03:15:32Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+    官方提供的 Astro [GitHub Action](https://github.com/withastro/action) 會透過掃描根目錄下的 lockfile 來檢查你所使用的 Package Manager（如`npm`, `yarn`, `pnpm`, or `bun`）。正因如此，你應該將包管理器自動產生的 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml` 或是 `bun.lockb` 檔案一起提交至你的儲存庫中，不要加入 `.gitignore` 或用其他方式遺漏這些檔案。
+    :::
+
+2. 在 GitHub 網站上，請切換到儲存庫中的 **Settings** 分頁，並切換進左邊的 **Code and automation** 分類中的 **Pages** 部分。


+1，如认为有必要，请提交英文PR

我上次發PR是被建議不要寫太細，不然如果GitHub改介面這邊就要跟著改

liruifengv · 2025-02-22T03:15:40Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+
+2. 在 GitHub 網站上，請切換到儲存庫中的 **Settings** 分頁，並切換進左邊的 **Code and automation** 分類中的 **Pages** 部分。
+
+3. 選擇 **GitHub Actions** 作為設定中的 **Source** ，並單按 **Save**儲存設定。


liruifengv · 2025-02-22T03:17:04Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+4. 將先前設定好的 workflow file 提交（Commit）並推送（Push）到 GitHub。 
+</Steps>
+
+恭喜你！如此一來，你的 Astro 網站就會自動部署到 GitHub Pages 上了。並且如果你更改了你的網站原始碼並推送到前述的儲存庫，GitHub Actions 會自動重新構建並部署你的網站，你不需要手動構建和部署。


Suggested change

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

恭喜你！如此一來，你的 Astro 網站就會自動部署到 GitHub Pages 上了。並且如果你更改了你的網站原始碼並推送到前述的儲存庫，GitHub Action 會自動重新構建並部署你的網站。

發佈（publish）那邊好像是被第一個自動部署那邊取代了，但也不能說是錯的。

vrabe

大概是這樣，請不要被數量嚇到

vrabe · 2025-02-20T17:47:27Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+title: 將您的Astro網站部署到GitHub Pages
+description: 如何透過GitHub Pages將您的Astro網站部署到網際網路上


Suggested change

title: 將您的Astro網站部署到GitHub Pages

description: 如何透過GitHub Pages將您的Astro網站部署到網際網路上

title: 將 Astro 網站部署到 GitHub Pages

description: 如何透過 GitHub Pages 將 Astro 網站部署到網際網路上

這邊中文與英文之間要加空格。然後絕大多數 your 即使去掉也不會更改原意，如果要加您的話，翻譯指南寫說應該用你而不是您。

vrabe · 2025-02-20T17:58:21Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+
+### 部署至一個 `github.io` 的網址
+
+請在`astro.config.mjs` 的配置文件中設定 [`site`](/en/reference/configuration-reference/#site) 與 [`base`](/en/reference/configuration-reference/#base) 兩個選項。


Suggested change

請在`astro.config.mjs` 的配置文件中設定 [`site`](/en/reference/configuration-reference/#site) 與 [`base`](/en/reference/configuration-reference/#base) 兩個選項。

請在 `astro.config.mjs` 的設定檔中設定 [`site`](/zh-tw/reference/configuration-reference/#site) 與 [`base`](/zh-tw/reference/configuration-reference/#base) 兩個選項。

空格

雖然這個連結指向的頁面還沒有翻譯，但還是要留中文版連結

配置文件應該改成設定檔比較好

vrabe · 2025-02-20T18:02:00Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+  如果你的情況符合以下其中之一，請不要為 `base` 參數設定值：
+
+- 如果你的頁面由根資料夾所提供。
+- 如果你的原始碼儲存庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`.


Suggested change

- 如果你的原始碼儲存庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`.

- 如果你的原始碼儲存庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`。

vrabe · 2025-02-20T18:05:47Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+<a href="/my-repo/about">關於本站</a>
+```
+
+你可以在 [設定 `base` 值](/en/reference/configuration-reference/#base) 中找到更多相關資訊。


Suggested change

你可以在 [設定 `base` 值](/en/reference/configuration-reference/#base) 中找到更多相關資訊。

你可以在[設定 `base` 值](/zh-tw/reference/configuration-reference/#base)中找到更多相關資訊。

連結外面不用刻意空格

vrabe · 2025-02-20T18:06:25Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+### 使用自定義網域名稱的 GitHub Pages
+
+:::tip[設定一個自訂網域]
+你可以透過在專案裝建立一個 `./public/CNAME` 檔案來設定自訂網域名稱：


Suggested change

你可以透過在專案裝建立一個 `./public/CNAME` 檔案來設定自訂網域名稱：

你可以透過在專案建立 `./public/CNAME` 檔案來設定自訂網域名稱：

不用加一個

vrabe · 2025-02-22T12:22:40Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+    官方提供的 Astro [GitHub Action](https://github.com/withastro/action) 會透過掃描根目錄下的 lockfile 來檢查你所使用的 Package Manager（如`npm`, `yarn`, `pnpm`, or `bun`）。正因如此，你應該將包管理器自動產生的 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml` 或是 `bun.lockb` 檔案一起提交至你的儲存庫中，不要加入 `.gitignore` 或用其他方式遺漏這些檔案。
+    :::
+
+2. 在 GitHub 網站上，請切換到儲存庫中的 **Settings** 分頁，並切換進左邊的 **Code and automation** 分類中的 **Pages** 部分。


我上次發PR是被建議不要寫太細，不然如果GitHub改介面這邊就要跟著改

vrabe · 2025-02-22T13:00:43Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+4. 將先前設定好的 workflow file 提交（Commit）並推送（Push）到 GitHub。 
+</Steps>
+
+恭喜你！如此一來，你的 Astro 網站就會自動部署到 GitHub Pages 上了。並且如果你更改了你的網站原始碼並推送到前述的儲存庫，GitHub Actions 會自動重新構建並部署你的網站，你不需要手動構建和部署。


發佈（publish）那邊好像是被第一個自動部署那邊取代了，但也不能說是錯的。

vrabe · 2025-02-22T13:22:09Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+可能需要為 `base` 設定一個值，以便 Astro 將你的儲存庫名稱（例如 `/my-repo`）視為你網站的根目錄。
+
+:::note
+  如果你的情況符合以下其中之一，請不要為 `base` 參數設定值：


Suggested change

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

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

我覺得為 base 參數設定值這說法有點怪怪的，因為這樣好像說設定有一個 base，但是不要設定值，不要設定 base 就不要加 base: "..." 就好了嘛。應該直接說「不要設定 base 參數」就好了？後面 L78 也一樣。

看起來果然不能逐字逐句的翻呢...

vrabe · 2025-02-22T13:34:45Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+
+你可以透過 [GitHub Actions](https://github.com/features/actions) 將你的 Astro 網站自動搭建並部署到 GitHub Pages 網站上。為了這麼做，你應該將你的網站原始碼託管至 GitHub。
+
+Astro 維護了一個官方的 `withastro/action` 幫助你部署你的專案。按照下方的說明即可讓你快速將 Astro 網站部署進 GitHub pages，並請在需要更多資訊時，可以檢視[這個讀我檔案](https://github.com/withastro/action)。


是有這個翻譯，我不會用，但不反對別人用

vrabe · 2025-02-22T13:41:09Z

src/content/docs/zh-tw/guides/deploy/github.mdx

+      # 允許你在 GitHub 上的 Actions 標籤中手動觸發此部署
+      workflow_dispatch:
+
+    # 允許這個工作流程訪問你的儲存庫


翻譯不精確，應為允許這個工作複製儲存庫並建立頁面部署

510208 · 2025-02-23T10:38:41Z

修改完成，請再看看還有沒要改的。

太習慣逐字逐句地翻了，結果有些地方翻譯的不好。因為稍微有參考簡體版本，應該是因為這樣有些用詞才不符合我國的用法吧？

510208 added 2 commits February 20, 2025 20:45

i18n(zh-tw): Update Deploy to GitHub Pages translation.

69f6c85

i18n(zh-tw): Update Deploy to GitHub Pages translation, finish it.

040ee01

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

Merge branch 'main' into main

1d33307

510208 closed this Feb 21, 2025

510208 reopened this Feb 21, 2025

510208 and others added 2 commits February 22, 2025 01:24

i18n(zh-tw): update links of github.mdx

eeba682

Merge branch 'main' into main

60b16ea

liruifengv requested changes Feb 22, 2025

View reviewed changes

vrabe suggested changes Feb 22, 2025

View reviewed changes

510208 added 2 commits February 23, 2025 18:18

i18n(zh-tw): Remove redundant descriptions in guides/deploy/github.mdx

65822e7

i18n(zh-tw): Update github.mdx

b3f86f9

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

i18n(zh-tw): Update `guides/deploy/github.mdx` #11011

i18n(zh-tw): Update `guides/deploy/github.mdx` #11011

510208 commented Feb 20, 2025

netlify bot commented Feb 20, 2025 •

edited

Loading

astrobot-houston commented Feb 20, 2025 •

edited

Loading

astrobot-houston commented Feb 20, 2025

vrabe commented Feb 20, 2025

510208 commented Feb 21, 2025

liruifengv left a comment

liruifengv Feb 22, 2025

vrabe Feb 22, 2025

510208 Feb 23, 2025

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

vrabe Feb 22, 2025 •

edited

Loading

liruifengv Feb 22, 2025

liruifengv Feb 22, 2025

vrabe Feb 22, 2025

vrabe left a comment

vrabe Feb 20, 2025

vrabe Feb 20, 2025

vrabe Feb 20, 2025

vrabe Feb 20, 2025

vrabe Feb 20, 2025

vrabe Feb 22, 2025 •

edited

Loading

vrabe Feb 22, 2025

vrabe Feb 22, 2025

510208 Feb 23, 2025

vrabe Feb 22, 2025

vrabe Feb 22, 2025

510208 commented Feb 23, 2025


		你可以透過 [GitHub Actions](https://github.com/features/actions) 將你的 Astro 網站自動搭建並部署到 GitHub Pages 網站上。為了這麼做，你應該將你的網站原始碼託管至 GitHub。

		Astro 維護了一個官方的 `withastro/action` 幫助你部署你的專案。按照下方的說明即可讓你快速將 Astro 網站部署進 GitHub pages，並請在需要更多資訊時，可以檢視[這個讀我檔案](https://github.com/withastro/action)。


		## 為 GitHub Pages 配置 Astro 專案

		為了將 Astro 網站部署至 GitHub Pages，我們需要先對原本的 Astro 配置文件做些許變更。按照下方的說明即可，如果你不知道自己該怎麼做的話。


		請確保你的 `site` 值應為以下的其中之一：

		- 以你的使用者名稱產生的 GitHub.io 網址，如：`https://<username>.github.io`


		2. 在 GitHub 網站上，請切換到儲存庫中的 Settings 分頁，並切換進左邊的 Code and automation 分類中的 Pages 部分。

		3. 選擇 GitHub Actions 作為設定中的 Source ，並單按 Save儲存設定。

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

		title: 將您的Astro網站部署到GitHub Pages
		description: 如何透過GitHub Pages將您的Astro網站部署到網際網路上


		### 部署至一個 `github.io` 的網址

		請在`astro.config.mjs` 的配置文件中設定 [`site`](/en/reference/configuration-reference/#site) 與 [`base`](/en/reference/configuration-reference/#base) 兩個選項。

	請在`astro.config.mjs` 的配置文件中設定 [`site`](/en/reference/configuration-reference/#site) 與 [`base`](/en/reference/configuration-reference/#base) 兩個選項。
	請在 `astro.config.mjs` 的設定檔中設定 [`site`](/zh-tw/reference/configuration-reference/#site) 與 [`base`](/zh-tw/reference/configuration-reference/#base) 兩個選項。

	- 如果你的原始碼儲存庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`.
	- 如果你的原始碼儲存庫在 `https://github.com/<USERNAME>/<USERNAME>.github.io`。

	你可以在 [設定 `base` 值](/en/reference/configuration-reference/#base) 中找到更多相關資訊。
	你可以在[設定 `base` 值](/zh-tw/reference/configuration-reference/#base)中找到更多相關資訊。

	你可以透過在專案裝建立一個 `./public/CNAME` 檔案來設定自訂網域名稱：
	你可以透過在專案建立 `./public/CNAME` 檔案來設定自訂網域名稱：

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

i18n(zh-tw): Update guides/deploy/github.mdx #11011

Are you sure you want to change the base?

i18n(zh-tw): Update guides/deploy/github.mdx #11011

Conversation

510208 commented Feb 20, 2025

Description (required)

Related issues & labels (optional)

First-time contributor to Astro Docs?

netlify bot commented Feb 20, 2025 • edited Loading

✅ Deploy Preview for astro-docs-2 ready!

astrobot-houston commented Feb 20, 2025 • edited Loading

Lunaria Status Overview

Tracked Files

astrobot-houston commented Feb 20, 2025

vrabe commented Feb 20, 2025

510208 commented Feb 21, 2025

liruifengv left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

vrabe Feb 22, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

vrabe left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

vrabe Feb 22, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

510208 commented Feb 23, 2025

i18n(zh-tw): Update `guides/deploy/github.mdx` #11011

i18n(zh-tw): Update `guides/deploy/github.mdx` #11011

netlify bot commented Feb 20, 2025 •

edited

Loading

astrobot-houston commented Feb 20, 2025 •

edited

Loading

vrabe Feb 22, 2025 •

edited

Loading

vrabe Feb 22, 2025 •

edited

Loading