diff --git a/src/content/docs/zh-tw/basics/astro-pages.mdx b/src/content/docs/zh-tw/basics/astro-pages.mdx index b4a7738a3e15f..7ad909e35205b 100644 --- a/src/content/docs/zh-tw/basics/astro-pages.mdx +++ b/src/content/docs/zh-tw/basics/astro-pages.mdx @@ -1,6 +1,6 @@ --- title: 頁面 -description: Astro 頁面簡介 +description: Astro 頁面簡介。 i18nReady: true --- @@ -71,11 +71,13 @@ import MySiteLayout from '../layouts/MySiteLayout.astro'; ## Markdown/MDX 頁面 -Astro 也會將任何 `src/pages/` 內的 Markdown(`.md`)檔作為你最後網站的頁面。如果你有[安裝 MDX 整合](/zh-tw/guides/integrations-guide/mdx/#installation)的話,它也會對 MDX(`.mdx`)檔做同樣的事。這普遍用於以文字為主的頁面,像是部落格文章和文件。 +Astro 也會將任何 `src/pages/` 內的 Markdown(`.md`)檔作為你最後網站的頁面。如果你有[安裝 MDX 整合](/zh-tw/guides/integrations-guide/mdx/#installation)的話,它也會對 MDX(`.mdx`)檔做同樣的事。 -此外,`src/content/` 的 [Markdown 或 MDX 頁面內容合集](/zh-tw/guides/content-collections/)可以[動態產生頁面](/zh-tw/guides/routing/#dynamic-routes)。 +:::tip +對於包含結構相似且相關的 Markdown 檔(如部落格文章或商品項目)的資料夾,請考慮建立[內容合集](/zh-tw/guides/content-collections/),而不是頁面。 +::: -頁面版面在 [Markdown 檔](#markdownmdx-頁面)特別地有用。Markdown 檔可以使用特殊的 `layout` frontmatter 屬性指定 [版面元件](/zh-tw/basics/layouts/),進而將 Markdown 內容包進完整的 `...` 頁面檔案裡。 +Markdown 檔可以使用特殊的 `layout` frontmatter 屬性指定 [版面元件](/zh-tw/basics/layouts/),進而將 Markdown 內容包進完整的 `...` 頁面檔案裡。 ```md {3} --- @@ -96,10 +98,42 @@ title: '我的 Markdown 頁面' ## 自訂 404 錯誤頁面 -如要自訂 404 錯誤頁面,可以在 `/src/pages` 新增 `404.astro` 或 `404.md`。 +如要自訂 404 錯誤頁面,可以在 `src/pages` 新增 `404.astro` 或 `404.md`。 建構時會產生 `404.html` 頁面,大多數的[部署服務](/zh-tw/guides/deploy/)會找到並使用該檔案。 +## 自訂 500 錯誤頁面 + +要給[隨需算繪](/zh-tw/guides/on-demand-rendering/)的頁面顯示的自訂 500 錯誤頁面,請建立 `src/pages/500.astro` 檔案。這個自訂頁面不適用於預算繪的頁面,也不能被預算繪。 + +如果算繪這個頁面時發生錯誤,會顯示主機預設的 500 錯誤頁面給訪客。 + +