单独的卡片示例
这是一个独立的卡片组件,用于展示特定的信息。
本页面用于测试Starlight Rapide主题的各种功能和组件是否正常工作。
访问Rapide官方网站
这是一个基本的段落,测试文本渲染是否正常。
这是加粗文本
这是斜体文本
这是引用文本
无序列表:
有序列表:
这里测试不同样式的徽章:
默认徽章 提示徽章 危险徽章 成功徽章 警告徽章以下是不同类型的旁白组件测试:
单独的卡片示例
这是一个独立的卡片组件,用于展示特定的信息。
快速上手
轻松开始使用Starlight构建文档网站。
完全可定制
使用丰富的配置选项自定义网站外观。
Markdown增强
使用MDX和各种组件增强内容表现力。
SEO友好
自动生成元数据,提高搜索引擎排名。
点击跳转到主页
点击这张卡片将跳转到网站主页。鼠标悬停时会有轻微的上浮效果,并且边框会变为主题强调色。
Starlight是Astro的官方文档主题,它提供了一系列内置功能来构建美观、高性能的文档网站。
starlight({ title: '我的文档', social: [ { label: 'GitHub', icon: 'github', href: 'https://github.com/withastro/starlight' }, ],})<!DOCTYPE html><html lang="zh"><head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>HTML示例</title> <link rel="stylesheet" href="styles.css"></head><body> <h1>Hello, World!</h1> <p>这是一个HTML示例。</p></body></html>body { font-family: 'Arial', sans-serif; line-height: 1.6; color: #333; max-width: 800px; margin: 0 auto; padding: 20px;}
h1 { color: #0077cc; border-bottom: 2px solid #eee; padding-bottom: 5px;}// 等待DOM加载完成document.addEventListener('DOMContentLoaded', () => { // 获取元素 const heading = document.querySelector('h1');
// 添加点击事件 heading.addEventListener('click', () => { alert('你点击了标题!'); });
console.log('JavaScript已加载!');});安装依赖
使用你喜欢的包管理器安装依赖。
npm install @astrojs/starlight starlight-theme-rapide配置Astro
在astro.config.mjs文件中添加Starlight集成和Rapide主题。
创建内容
在src/content/docs/目录下创建Markdown或MDX文件。
启动开发服务器
npm run devStarlight支持通过插件显示数学公式:
行内公式:
行间公式:
微分方程:
矩阵:
基本代码块:
// 这是一个JavaScript代码示例function hello() { console.log("Hello, Starlight!");}| 名称 | 描述 |
|---|---|
| Astro | Web框架 |
| Starlight | 文档主题 |
| Rapide | 主题样式 |
这是一个使用自定义CSS样式的容器