如何5分钟上手EmDash:从创建项目到发布第一篇文章的终极快速入门指南
如何5分钟上手EmDash:从创建项目到发布第一篇文章的终极快速入门指南【免费下载链接】emdashEmDash is a full-stack TypeScript CMS based on Astro; the spiritual successor to WordPress项目地址: https://gitcode.com/gh_mirrors/emdas/emdashEmDash 是一款基于 Astro 的全栈 TypeScript CMS也是 WordPress 的精神继任者它保留了你熟悉的管理后台、插件生态和内容模型但完全构建在现代、类型安全的 serverless 技术之上。本指南将带你用 5 分钟完成三件事创建 EmDash 项目、启动本地站点、发布你的第一篇文章无需任何云账号。为什么选择 EmDash如果你正在寻找一个现代 CMS 解决方案EmDash 值得优先考虑插件沙箱每个插件运行在隔离的 Worker 沙箱中只拥有它声明的权限一个漏洞插件不会拖垮整站结构化内容正文采用 Portable Text结构化 JSON存储内容与展示彻底解耦随处运行支持 CloudflareD1 R2 Workers或任意 Node.js 服务器 SQLite没有 PHP也没有额外的托管层Passkey 优先认证WebAuthn 通行密钥登录支持管理员/编辑/作者/贡献者四级角色核心关键词一览EmDash CMS、Astro 建站、WordPress 替代方案、TypeScript 内容管理系统。上手前检查1 分钟准备EmDash 快速入门只需一个前置条件项目要求Node.js22.16 或更高版本包管理器npm / pnpm / yarn / bun 均可云账号本地体验不需要部署时才需要在终端确认版本node --version输出版本号 ≥v22.16.0即可继续。第一步一条命令创建 EmDash 项目运行官方脚手架命令交互式向导会引导你完成所有选择npm create emdashlatest按提示依次选择Project name项目名例如my-emdash-siteWhere will you deploy?选Node.js本地体验无需云账号Which template?四选一各有侧重Blog—— 带侧边栏、分类标签、全文搜索、RSS 的经典博客Starter—— 通用起步模板含 Posts 和 Pages 两个集合Marketing—— 转化导向的落地页含价格表与联系表单Portfolio—— 作品集项目网格 标签筛选Install dependencies?选Yes脚手架会基于 templates/blog/、templates/starter/ 等模板生成一个标准 Astro 项目并在 gitignore 的.env文件中写入生成的EMDASH_ENCRYPTION_KEY。⚠️ 这个密钥请勿提交到版本库——丢失它EmDash 将无法解密存储的插件密钥。第二步启动本地站点完成 30 秒初始化向导进入项目目录并启动开发服务器cd my-emdash-site npm run dev终端会打印本地地址默认是http://localhost:4321/。现在打开http://localhost:4321/_emdash/admin/新站点会自动进入设置向导setup wizard只需 3 步填写Site Title和可选的Tagline保持勾选Include sample content导入示例文章和页面方便体验填写你的邮箱和名字在浏览器弹出提示时注册一个Passkey通行密钥然后点击Open the dashboard完成后你会看到内容仪表盘左侧是 Pages、Posts、Media 等内容入口右侧显示草稿数、媒体文件数和最近活动。第三步发布你的第一篇文章现在见证 CMS 的核心工作流——从新建到发布只需 5 次点击在侧边栏点击Posts再点Add New输入标题EmDash 会自动生成 slug即文章 URL可直接编辑在富文本编辑器中写正文——支持加粗、引用、代码块、列表输入/可唤起块级命令可选拖入封面图、指派作者byline、分类和标签点击Save保存为草稿 → 点Publish正式发布发布后打开http://localhost:4321/新文章就出现在首页列表中了。再进入文章页看看正文渲染效果草稿与发布让在线文章安全更新EmDash 对 WordPress 用户最友好的设计之一保存 ≠ 发布。发布之后你的每次编辑都会自动存为新草稿线上版本保持不动确认无误后再点Publish changes新版才替换线上内容。这种存草稿—预览—再发布的机制配合版本历史和编辑锁让多人协作时误操作也不会直接暴露给读者。顺手管理媒体库点击侧边栏的Media即可打开媒体库支持拖拽上传、建文件夹、按文件名搜索选中图片后还能直接回填到文章的封面图字段。快速回顾5 分钟通关清单步骤命令 / 操作结果1npm create emdashlatest生成带 CMS 的 Astro 项目2npm run dev本地站点运行在 4321 端口3打开/_emdash/admin/完成向导站点初始化 管理员账号4Posts → Add New → Save → Publish第一篇文章上线 下一步探索 官方文档docs/src/content/docs/getting-started.mdx创建首个站点的完整教程 建博客进阶docs/src/content/docs/guides/create-a-blog.mdx分类、标签、RSS 全解️ 内容模型定义templates/blog/seed/seed.json——posts/pages 集合、字段与示例数据都在这里️ 脚手架源码packages/create-emdash/️ 核心 CMS 实现packages/core/想从 WordPress 搬过来EmDash 自带WordPress 导入向导可导入文章、页面、媒体和分类——迁移路线见 docs/src/content/docs/migration/from-wordpress.mdx。准备好部署上线了吗将站点部署到 Cloudflare Workers 或任意 Node.js 服务器EmDash 即可进入生产环境。Happy blogging! ✍️【免费下载链接】emdashEmDash is a full-stack TypeScript CMS based on Astro; the spiritual successor to WordPress项目地址: https://gitcode.com/gh_mirrors/emdas/emdash创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考