{"repo":"cxro/astro-whono","free":true,"listed":false,"github":"https://github.com/cxro/astro-whono","clone":"git clone https://github.com/cxro/astro-whono.git","description":"一个极简双栏 Astro 主题，用于个人写作与轻量内容发布。","language":"TypeScript","stars":162,"topics":["astro","astro-theme","blog","markdown","minimal","personal-website","static-site","theme","typography"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"astro-whono 中文 English ✨ astro-whono 支持本地后台可视化预览写作 一个极简双栏的 Astro 主题，用于个人写作与轻量内容发布。 链接 - 在线演示： - 仓库地址： 预览 特性 - 双栏布局（侧栏导航 + 内容区） - 移动端适配 - 内容集合：随笔 / 絮语 / 小记 / 关于（归档为目录视图） - 内置本地 Admin Console（/admin）：开发环境下管理站点配置、内容与图片资源 - 絮语草稿生成器：/bits 页面一键生成 Markdown（复制/下载），支持多图与自动读取尺寸 - RSS：默认归档订阅 + 分栏订阅 - 浅色 / 深色模式 + 阅读模式 开始使用 环境要求 - Node.js 22.12+（建议使用 .nvmrc ） 快速开始 Windows（PowerShell）提示 如遇执行策略拦截 npm.ps1 ，可用： - cmd /c npm run ... - 或改用 Git Bash / WSL 常用命令 - npm run dev ：启动本地开发服务 - npm run build ：生成静态站点 - npm run preview ：预览构建产物 - npm run new:bit ：创建一条 bits 草稿 维护者校验 以下命令用于维护主题本身，普通写作与部署通常不需要执行。 部署 一键部署       建议在生产环境设置：SITE URL=https://你的域名 （不要以 / 结尾）。 未设置时会使用占位地址，页面可访问，但分享与收录相关链接可能不完整。 Cloudflare Pages 部署（手动导入仓库） 构建设置 - Framework preset：Astro - Build command： npm run build - Output directory： dist Node.js 版本（通常不用填） - 本项目已提供 .nvmrc ，Cloudflare Pages 会自动读取。 - 如需手动指定，可在 Pages 的环境变量里设置： NODE VERSION=22.22.0 环境变量（生产环境应设置） - 在 Pages 项目 → Settings → Environment variables 添加： SITE URL=https://你的域名 （例如 https://astro.whono.me ，不要以 / 结尾） - SITE URL 用于生成 canonical、Open Graph 的 og:url 、RSS 链接与 sitemap 等绝对链接；未设置时相关链接会退化为占位域名，影响分享预览与搜索收录。 关于 sitemap / robots - 只有设置了 SITE URL ，才会生成 sitemap，并且 /robots.txt 才会输出 Sitemap: 行（避免指向错误域名）。 部署后检查 - 首页 / 列表 / 详情页可访问 - RSS 可访问（ /rss.xml 及分栏 RSS） - 设置 SITE URL 后：canonical / og:url 指向你的域名 - Network 不再请求演示域名资源 配置与入口 项目入口 - 站点配置： site.config.mjs - 内容集合： src/content.config.ts - 样式共享入口： src/styles/global.css - 页面 / 场景样式入口： src/styles/home.css 、 src/styles","default_branch":null,"files":null,"tree":[],"storefront":"/r/cxro","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/cxro/astro-whono/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}