用 Astro 构建的极简博客主题。适合任何想要创建自己的博客的人的快速而简单的入门构建。
查看演示·报告错误·请求功能
动机
主要特点
演示
快速入门
命令
配置您的网站
站点配置、社交媒体链接和导航栏链接
添加帖子和项目
多语言支持
部署
额外功能
信用
尽管已经有很多博客主题,但我想要一个能够散发出终端/开发氛围以及其他主题没有的一些功能的主题。
Astro v4 快速
TailwindCSS 实用工具类
可访问的语义 HTML 标记
响应式且适合 SEO
多语言支持
暗/亮模式,使用 Tailwind 和 CSS 变量
固定的帖子和项目
Astro 资产集成可优化图像
MD 和 MDX 帖子
分页
自动 RSS 提要
自动生成的站点地图
Astro Icon svg 图标组件
返回顶部按钮
在这里查看演示。
从此模板创建一个新的存储库。
# npm 7+ npm create astro@latest -- --template kirontoo/astro-theme-cody # pnpm pnpm dlx create-astro --template kirontoo/astro-theme-cody
(回到顶部)
所有命令都从项目的根目录的终端运行:
命令 | 行动 |
---|---|
pnpm install | 安装依赖项 |
pnpm run dev | 在localhost:4321 启动本地开发服务器 |
pnpm run build | 将您的生产站点构建到./dist/ |
pnpm run preview | 在部署之前在本地预览您的构建 |
pnpm run astro ... | 运行 CLI 命令,例如astro add 、 astro check |
pnpm run astro -- --help | 使用 Astro CLI 获取帮助 |
(回到顶部)
您的站点配置、社交媒体链接和导航栏链接都放置在src/consts.ts
中。您可以在其中配置网站的默认标题、描述、语言、个人资料、社交媒体链接和可见的导航栏链接。
该主题利用 Content Collections 来组织 Markdown 和/或 MDX 文件,并使用 schema -> src/content/config.ts
对 frontmatter 进行类型检查。
您可以在src/content/blog
中找到博客文章的示例,在src/content/project
中找到项目的示例。
属性(* = 必填) | 描述 |
---|---|
标题 * | 您帖子的标题。最多限制 150 个字符 |
描述 * | 您的帖子的简短描述,也将用于搜索引擎优化。最大长度为 250 个字符。 |
发布日期 * | 发表日期 |
更新日期 | 表示帖子更新时间的可选日期。请注意,将使用此日期而不是发布日期来订购帖子(如果有)。 |
英雄形象 | 您发布的可选封面图片。包括src 和alt 属性。检查src/content/blog/first-post.md 的示例。 |
图像 | 用于 SEO 的可选图像。 |
标签 | 使用可选标签将您的帖子组织为类别或主题。所有标签都将显示在yourdomain.com/tags 中。 |
系列 | 使用可选系列将您的帖子组织成一系列帖子。所有系列都将显示在yourdomain.com/series 中。 |
草稿 | 可选布尔值。删除已发布的帖子。 |
命令 | 1 - 5 之间的可选数值,用于将某些帖子固定到顶部。仅限 5 个固定帖子 |
隐藏 | 可选布尔值。隐藏/blog 页面上的帖子。仍会出现在/archive 中 |
属性(* = 必填) | 描述 |
---|---|
标题 * | 您的项目的标题。最多限制 150 个字符 |
描述 * | 您项目的简短描述,也将用于 SEO。 |
发布日期 * | 发表日期 |
英雄形象 | 您项目的可选封面图片。包括src 和alt 属性。检查src/pages/projects/project-1.md 以获取示例。 |
图像 | 用于 SEO 的可选图像。 |
堆 * | 您的项目使用的技术列表将呈现为图标。该主题使用 SVG Logos 库,您可以使用 icones.js.org 找到您需要的图标。 |
平台 | 链接到网站或演示 |
网站 | 链接到网站或演示 |
github | 您的 github 存储库链接 |
草稿 | 可选布尔值。删除已发布的项目。 |
命令 | 1 - 5 之间的可选数值,用于将某些项目固定到顶部。仅限 5 个固定帖子 |
(回到顶部)
请参阅 wiki 为您的博客设置多语言支持。
Astro 提供了在各种平台上部署 Astro 网站的优秀文档。你可以在这里找到它。
查看 Astro Recipes 以添加其他功能,例如 RSS 提要。
该主题基于 Astro Cactus 和 Hugo Risotto 主题。
(回到顶部)