astro ink

Astro Ink 是一个最小主题，旨在满足基于简约 Markdown 的博客需求。它附带了您在创建轻量级、高性能的个人博客时可能需要的几乎所有基本 Astro 组件，这些组件默认情况下专注于交付更少的 Javascript。

它的灵感来自于 Hugo 的 Ink 主题，力求保持轻量，同时为美丽、简约的博客提供基础。

特征

• Minimal、Crisp、Markdown-Blog Ready始终在后台更新到 Astro 的最新版本（当前为2.x版本）。
• Svelte Ready - 为了保持 Astro 的 POV 的轻量级、高性能和更平易近人，Svelte 用于主题切换器等交互式组件
• 模块化——结构高度模块化，组件只做一项工作，而且只做好一项工作。
• Astro 2.0 Content Collection + 动态页面- 它已准备好与 Next.js 一起使用，例如动态页面，支持基于标签的分类系统，具有分页结果，所有可配置
• 深色模式和颜色代码- 它支持深色模式以及使用tailwind.config.js选择的6 种以上颜色模式。您可以通过dev或build脚本/命令传递THEME_KEY例如： THEME_KEY=purpleheart astro build/dev来更改正在使用的颜色主题。所有可用的主题都可以在 tailwind.theme.config.js 中找到。要自定义博客部分，请添加此处提到的任何 Tailwind Typography 的prose-{color}类
• Netlify CMS - 使用您的 Netlify 凭据访问your-site.netlify.com/admin （例如：astro-ink.netlify.app/admin）添加/编辑/更新/blog目录中的所有帖子。它需要 Netlify Identity（https://app.netlify.com/sites/your-site/settings/identity#registration）和 Git Gateway（https://app.netlify.com/sites/your-site/settings/identity） #services) 已启用。
• 未来的帖子（使用 Github Actions）- 在/src/drafts目录中以YYYY-MM-DD格式创建未来date帖子，并让专门设计的 Github Action 负责在您指定的日期自动发布它。您可以在 Github Action 中配置检查间隔。
• 客户端搜索- 让您的用户通过客户端搜索功能快速访问您的博客文章。 Lunr.js
• 查看反击壮举。 Redis/Upstash Redis - 配置您的 Redis 主机，将其连接 URL 放入托管提供商的控制台（Vercel、Netlify 等）或.env文件（本地开发）中，取消注释此处的连接代码并部署。您的网站配备了动态浏览量计数器。请参阅 .env.example 以了解您需要配置的不同环境值。
• 支持 YT 频道的媒体页面- 只需将您的频道 ID 放入配置文件的ytChannelId常量中，即可轻松在媒体页面上显示您的 YT 频道内容。 （可选）通过将USE_MEDIA_THUMBNAIL设置为false从 YT 频道的视频列表中禁用图像缩略图。
• 作者卡- 通过在配置文件中将USE_AUTHOR_CARD设置为true ，轻松添加基于帖子或站点范围的作者卡，其中包括 Twitter 关注按钮。
• 主题图像叠加- 您可以选择启用叠加，通过在配置文件中将USE_POST_IMG_OVERLAY设置为true可以在帖子图像顶部添加漂亮的主题渐变。

如何开始？

只需克隆此模板，然后从您的克隆开始工作。您可以使用所有常见的 NPM 命令，例如dev 、 build等。请参阅 package.json 以查看所有可用命令的列表。

注意：使用npx degit one-aalam/astro-ink克隆模板，无需任何git历史记录

注意：此模板默认生成server （SSR 就绪）输出。如果你想要static构建

• 在 astro.config.js 中将server的output更改为static
• 删除adapter: vercel()
• 删除浏览次数计数器 API
• 在 config.ts 中将USE_VIEW_STATS设置为false

注意：在第一次运行npm run dev之前 -

• 通过运行mv .env.example .env创建.env文件（如果您使用的是 Linux 发行版或 Mac）
• 将SITE_URI变量设置为SITE_URI=http://localhost:4321 （其中 4321 是项目运行的端口）

采用 Astro Ink 打造

• jamesperkins.dev - 开发者、YouTube 讲师 James R Perkins 的个人网站
• highlandcows.github.io Nick Jacob 的个人博客

知道用 Astro Ink 构建的网站吗？在 Twitter 上告诉我

想在构建 Ink 的同时学习 Astro 吗？

该主题最初是使用Astro框架的 alpha 版和 beta 版构建的。如果您刚刚开始使用Astro ，您实际上可以在构建这个主题的同时学习Astro ，方法是遵循我编写的一系列从头开始教您 Astro 的博客！

前往aalam.in/blog并了解

• 如何设置 Astro 并使其使用样式、原型设计和增量部署的基本默认值运行
• 管理演示组件和创建 Astro 页面
• 将本地和远程数据提供给 Astro 页面
• 在 Astro 中将交互性置于您绝对离不开的地方
• 在 Astro 中创建数据驱动的动态页面和分页结果
• 使用基于 Git 的 CMS 创作 Astro 网站的内容