- 起步
- 核心概念
- 教程
- 基础内容
- 内置功能
- 集成
- 操作指南
- 使用指南
- 配置
- 参考
- 社区资源
- 其他
- 为文档做出贡献
- 手动安装 Astro
- 升级到 Astro v4
- 升级到 Astro v3
- 升级到 Astro v2
- Legacy v0.x Upgrade Guide
- 从 Create React App(CRA)迁移
- 关于本教程
- 第一单元:前期准备
- 准备开发环境
- 创建你的第一个 Astro 项目
- 你的第一行 Astro 代码
- 创建在线代码仓库
- 将你的网站部署到网络
- 第二单元:页面
- 创建你的第一个 Astro 页面
- 编写你的第一篇 Markdown 博客文章
- 添加「关于你」的动态内容
- 给你的「关于」页面添加样式
- 应用全局样式
- 第三单元:组件
- 创建一个可重复使用的导航组件
- 创建社交媒体 footer
- 自己动手搭建导航 Header
- 编写你的第一个浏览器脚本
- 第四单元:布局
- 编写你的第一个布局
- 创建并传递数据到博客布局
- 布局结合,两全其美
- 第五单元 - Astro API
- 创建文章存档页
- 生成标签页面
- 编写标签索引页面
- 添加 RSS 订阅源
- 第六单元 - Astro 群岛
- 搭建你的第一个 Astro 岛屿
- 回到干燥的陆地。让你的博客从白天到黑夜,无需岛屿!
- 恭喜你!
- @astrojs/mdx
- 添加阅读时间
- 创建开发者工具栏应用
- @astrojs/alpinejs
- @astrojs/lit
- @astrojs/preact
- @astrojs/react
- @astrojs/solid-js
- @astrojs/svelte
- @astrojs/vue
- @astrojs/cloudflare
- @astrojs/netlify
- @astrojs/node
- @astrojs/vercel
- @astrojs/db
- @astrojs/markdoc
- @astrojs/partytown
- @astrojs/sitemap
- @astrojs/tailwind
- 使用流式处理来提升页面性能
- 从 Gatsby 迁移
- 从 Next.js 迁移
- 从 NuxtJS 迁移
- 从 Docusaurus 迁移到 Astro
- 从 Eleventy 迁移到 Astro
- 从 GitBook 迁移到 Astro
- 从Gridsome迁移到Astro
- 从 Hugo 迁移
- 从 Jekyll 迁移
- 从 Pelican 迁移
- 从 SvelteKit 迁移
- 从VuePress迁移
- 从 WordPress 迁移
- 状态共享
- Storyblok 与 Astro
- Contentful 与 Astro
- ButterCMS & Astro
- Builder.io & Astro
- Cosmic 与 Astro
- DatoCMS 与 Astro
- Front Matter CMS 与 Astro
- Ghost & Astro
- Hashnode & Astro
- Hygraph 与 Astro
- Keystatic & Astro
- Kontent.ai 与 Astro
- 无头模式的 Statamic 与 Astro
- Strapi 与 Astro
- Tina CMS 与 Astro
- Umbraco & Astro
- 无头(headless)模式的 WordPress 与 Astro
- ApostropheCMS 与 Astro
- Caisy & Astro
- CloudCannon与Astro
- Crystallize 与 Astro
- Decap CMS 与 Astro
- Directus 与 Astro
- KeystoneJS 与 Astro
- microCMS & Astro
- Payload CMS 与 Astro
- Prepr CMS & Astro
- Prismic & Astro
- Sanity & Astro
- Sitecore 体验管理器 & Astro
- Spinal & Astro
- 创作内容
- Firebase 与 Astro
- Supabase 与 Astro
- Turso 和 Astro
- Xata 与 Astro
- Appwrite & Astro
- 部署你的 Astro 站点至 Netlify
- 部署你的 Astro 站点至 Vercel
- 如何将你的 Astro 网站部署到 Deno
- 部署你的 Astro 站点至 GitHub Pages
- 部署你的 Astro 站点至 GitLab Pages
- 部署你的 Astro 站点至 Cloudflare Pages
- 将你的 Astro 网站部署到 AWS
- 将你的 Astro 网站通过 Flightcontrol 部署到 AWS
- 将你的 Astro 网站通过 SST 部署到 AWS
- 将你的 Astro 网站部署至 Google Cloud
- 部署你的 Astro 站点至 Google Firebase 托管
- 将你的 Astro 网站部署到 Heroku
- 将你的 Astro 网站部署到 Microsoft Azure
- 部署你的 Astro 站点至 Buddy
- 将你的 Astro 网站部署到 Edgio
- 将你的 Astro 站点部署到 Fly.io
- 将你的 Astro 网站部署到 Render
- 将你的 Astro 网站部署到 Stormkit
- 将你的 Astro 网站部署到 Surge
- 通过 Cleavr 部署你的 Astro 网站
- 将你的 Astro 站点部署到 Kinsta 应用托管
- 将你的 Astro 网站部署到 Space
- 将你的 Astro 站点部署到 Zeabur
- 将你的 Astro 网站部署到 Zerops
- 添加 RSS 摘要
- 安装一个 Vite 或 Rollup 插件
- 构建自定义图像组件
- 使用 API 路由构建表单
- 在 Astro 页面中构建 HTML 表单
- 在 Astro 中使用 Bun
- 调用服务器端点
- 校验验证码
- 用 Docker 来构建你的 Astro 网站
- 动态导入图片
- 为链接添加图标
- 添加 i18n 功能
- 添加最后修改时间
- 在 Astro 组件中共享状态
- 使用 Tailwind Typography 美化渲染后的 Markdown
- Unknown compiler error.
- Astro.redirect is not available in static mode.
- Astro.clientAddress is not available in current adapter.
- Astro.clientAddress cannot be used inside prerendered routes.
- Astro.clientAddress is not available in static mode.
- No static path found for requested path.
- Invalid type returned by Astro page.
- Missing value for client:media directive.
- No matching renderer found.
- No client entrypoint specified in renderer.
- Missing hint on client:only directive.
- Invalid value returned by a getStaticPaths path.
- Invalid entry inside getStaticPath's return value
- Invalid value returned by getStaticPaths.
- getStaticPaths RSS helper is not available anymore.
- Missing params property on getStaticPaths route.
- Invalid value for getStaticPaths route parameter.
- getStaticPaths() function required for dynamic routes.
- Invalid slot name.
- Cannot use Server-side Rendering without an adapter.
- No import found for component.
- Invalid prerender export.
- Invalid component arguments.
- Page number param not found.
- Image missing required "alt" property.
- Error while loading image service.
- Missing image dimensions
- Failed to retrieve remote image dimensions
- Unsupported image format
- Unsupported image conversion
- Prerendered dynamic endpoint has path collision.
- Expected src to be an image.
- Expected image options.
- Cannot set both densities and widths
- Image not found.
- Could not process image metadata.
- Image not found.
- Could not transform image.
- Unable to set response.
- The middleware didn't return a Response.
- The middleware returned something that is not a Response object.
- The endpoint did not return a Response.
- Value assigned to locals is not accepted.
- Astro.response.headers must not be reassigned.
- Can't load the middleware.
- Local images must be imported.
- Astro.glob() used outside of an Astro file.
- Astro.glob() did not match any files.
- A redirect must be given a location with the Location header.
- Invalid dynamic route.
- Could not find Sharp.
- Unknown Vite Error.
- Could not import file.
- Invalid glob pattern.
- Astro couldn't find the correct page to render
- The provided locale does not exist.
- Index page not found.
- You can't use the current function with the current strategy
- Prerendered routes aren't supported when internationalization domains are enabled.
- 启用了手动国际化路由但没有提供中间件。
- Astro can't render the route.
- Unhandled rejection
- i18n Not Enabled
- Route not found.
- Unknown CSS Error
- CSS Syntax Error
- Unknown Markdown Error.
- Failed to parse Markdown frontmatter.
- Invalid frontmatter injection.
- MDX integration missing.
- Unknown configuration error.
- Specified configuration file not found.
- Legacy configuration detected.
- Unknown CLI Error.
- Failed to generate content types.
- Unknown Content Collection Error.
- Content entry frontmatter does not match schema.
- Invalid content entry slug.
- Content Schema should not contain slug.
- Collection does not exist
- Content and data cannot be in same collection.
- Collection contains entries of a different type.
- Data collection entry failed to parse.
- Duplicate content entry slug.
- Actions must be used with server output.
- Unsupported transform in content config.
添加「关于你」的动态内容
现在你有了一个带有 HTML 内容的多页面网站,是时候来添加一些动态的 HTML 了!
准备好…
- 在 frontmatter 中定义你的页面标题,并在你的 HTML 中使用它
- 条件渲染 HTML 元素
- 添加一些关于你的内容
任何 HTML 文件都是有效的 Astro 语言。但是,你可以用 Astro 做更多的事情,而不仅仅是普通的 HTML!
定义和使用变量
打开 about.astro
,它应该看起来像这样:
---
---
<html lang="zh">
<head>
<meta charset ="utf-8" />
<meta name="viewport" content="width=device-width" />
<title>Astro</title>
</head>
<body>
<a href="/">首页</a>
<a href="/about/">关于</a>
<a href="/blog/">博客</a>
<h1>关于我</h1>
<h2>……和我的新 Astro 网站!</h2>
<p>我正在学习 Astro 的入门教程。这是我网站上的第二个页面,也是我自己建立的第一页面!</p>
<p>随着我完成更多教程,该站点将更新,所以请继续查看我的旅程将如何进行吧!</p>
</body>
</html>
在 frontmatter 中的代码栅栏之间添加以下一行 JavaScript:
src/pages/about.astro---const pageTitle = "关于我"; ---
用动态变量
src/pages/about.astro{pageTitle}
替换 HTML 中静态的“Astro”标题和“关于我”标题。<html lang="zh"> <head> <meta charset ="utf-8" /> <meta name="viewport" content="width=device-width" /> <title>Astro</title> <title>{pageTitle}</title> </head> <body> <a href="/">首页</a> <a href="/about/">关于</a> <a href="/blog/">博客</a> <h1>关于我</h1> <h1>{pageTitle}</h1> <h2>……和我的新 Astro 网站!</h2> <p>我正在学习 Astro 的入门教程。这是我网站上的第二个页面,也是我自己建立的第一页面!</p> <p>随着我完成更多教程,该站点将更新,所以请继续查看我的旅程将如何进行吧!</p> </body> </html>
刷新你的
/about
页面的实时预览。你的页面文本应该看起来是一样的,而你在浏览器标签中显示的页面标题现在应该是“关于我”,而不是“Astro”。
你只是在你的
.astro
文件的两个部分分别定义然后使用了一个变量,而不是直接在 HTML 标签中输入文本。使用同样的模式在
index.astro
(主页)和blog.astro
(我的 Astro 学习博客)创建一个pageTitle
变量。在这两个地方更新这些页面的 HTML,使你的页面标题与每个页面上显示的标题一致。
在 Astro 中编写 JavaScript 表达式
把下面的 JavaScript 添加到你的 frontmatter 的代码栅栏之间:
(你可以为自己写一些代码,但本教程将使用以下例子)。
src/pages/about.astro--- const pageTitle = "关于我"; const identity = { firstName: "莎拉", country: "加拿大", occupation: "技术撰稿人", hobbies: ["摄影", "观鸟", "棒球"],}; const skills = ["HTML", "CSS", "JavaScript", "React", "Astro", "Writing Docs"]; ---
然后,在你的 HTML 模板现有的内容下面添加以下代码:
src/pages/about.astro<p>以下是关于我的几个事实:</p> <ul> <li>我的名字是{identity.firstName}.</li> <li>我住在{identity.country}。我的职业是{identity.occupation}。</li> {identity.hobbies.length >= 2 && <li>我的两个习惯:{identity.hobbies[0]}和{identity.hobbies[1]}</li> } </ul> <p>我的技能是:</p> <ul> {skills.map((skill) => <li>{skill}</li>)} </ul>
小测试
.astro
文件的 frontmatter 是以下列方式书写的:除了 HTML 之外,Astro 语法还允许你写:
什么时候你需要把 JavaScript 写在大括号里?
条件渲染元素
你也可以使用脚本变量来选择是否渲染你的 HTML <body>
内容中的个别元素。
在你的 frontmatter 脚本中添加以下几行来定义变量:
src/pages/about.astro--- const pageTitle = "关于我"; const identity = { firstName: "莎拉", country: "加拿大", occupation: "技术撰稿人", hobbies: ["摄影", "观鸟", "棒球"], }; const skills = ["HTML", "CSS", "JavaScript", "React", "Astro", "Writing Docs"]; const happy = true;const finished = false;const goal = 3; ---
在你现有的段落下面添加以下几行。
然后,在你的浏览器标签中检查实时预览,看看页面上显示的内容:
src/pages/about.astro{happy && <p>我非常乐意学习 Astro!</p>} {finished && <p>我完成了这节教程!</p>} {goal === 3 ? <p>我的目标是在三天内完成。</p> : <p>我的目标不是 3 天。</p>}
在进行下一步之前,将你的修改提交到 GitHub。如果你想保存你的工作进度并更新你的实时网站,请随时这样做。
代码分析
以下 .astro
代码:
---
const operatingSystem = "Linux";
const quantity = 3;
const footwear = "靴子";
const student = false;
---
对于以下 Astro 模板表达式,你可以预测一下对应 HTML 在浏览器中的显示什么?点击显示正确答案!
<p>{operatingSystem}</p>
{student && <p>我仍然在学校。</p>}
<p>我有 {quantity + 8} 双{footwear}</p>
{operatingSystem === "MacOS" ? <p>我在使用 Mac。</p> : <p>我没有使用 Mac。</p>}
任务清单
相关资源
Tutorials如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论