30 秒创建站点
三条命令跑通一个博客:
xfm create my-blog # 创建站点
cd my-blog && xfm dev # 毫秒级热更新的开发服务器
xfm build # 生产构建,产物在 dist/xfm create
xfm create my-blog --template=blog --title=我的博客--template=blog|docs:博客模板或侧栏文档模板,默认 blog--title=:站点名称- 别名
xfm init
生成出来的目录长这样:
my-blog/
├── xfm.config.mjs # 站点配置
├── package.json # devDependencies 里有 xfmpress
├── content/ # 内容目录
│ └── posts/ # 文章
├── scaffolds/ # xfm new 的脚手架模板
│ ├── post.md
│ ├── page.md
│ └── draft.md
└── public/ # 原样拷贝到产物根目录的静态文件xfm dev:开发服务器
xfm dev # 默认 http://127.0.0.1:4173
xfm dev --port=5000 # 换端口特点是毫秒级热更新:改 Markdown、改模板、改配置都是保存即生效,页面通过 SSE 自动刷新并保持滚动位置;CSS 单独热替换,连刷新都省了。404 页会列出当前所有可用路由,拼错地址一眼就能看出来。
xfm build:生产构建
xfm build # 产物在 dist/
xfm build --incremental # 启用增量缓存
xfm build --drafts # 临时把草稿也构建进去dist/ 里是纯静态 HTML + CSS,零 JavaScript 依赖(主题自带的小交互除外),任何静态托管都能直接用。
创建内容
xfm new "你好世界" # 新建文章 → content/posts/你好世界.md
xfm new page about # 新建页面 → content/about.md(不进文章流)
xfm new draft "写一半的想法" # 新建草稿,生产构建会跳过初始内容取自 scaffolds/<布局>.md,占位符是 {{ title }}、{{ date }}、{{ layout }},改一次脚手架以后所有新文章都按它来。
下一篇:命令行完全指南。
评论