本篇带你完成从零到发布第一篇博客的完整流程。

返回 使用指南总览

一、添加站点

首次启动 HexoDeck,会看到欢迎页。点击「添加站点」,在文件选择器里选中你的 Hexo 博客根目录 —— 也就是包含 _config.yml 的那个文件夹。

选中后应用会校验这个目录:

  • 找不到 _config.yml → 会明确提示”所选目录不是 Hexo 站点”
  • 校验通过 → 站点信息(标题、副标题、文章数)立刻显示在界面里

添加过的站点会记住。下次启动会自动打开上次使用的站点。

二、认识界面

界面分为三个区域:

区域 位置 作用
侧边导航 最左 切换功能页:站点 / 文章 / 页面 / 自定义文集 / 统计 / 预览 / 发布 / 设置
主工作区 中间 当前页面的内容,随导航切换
信息栏 最右 站点信息、统计概览、快捷操作、最近文章

侧边栏底部有两个按钮:主题切换(亮色 / 暗色 / 跟随系统三态循环)和收起侧边栏。

窗口顶部是自绘的标题栏,会显示当前站点的图标与名称。按住它拖动可以移动窗口,双击可最大化。

三、写第一篇文章

  1. 左侧导航点「文章」
  2. 点右上角「新建文章」,输入标题,回车
  3. 自动进入编辑器,开始写作

编辑器右侧可以随时开启:

  • 预览面板(顶部「◨ 预览已开」)—— 分栏看渲染效果
  • 参数侧栏(顶部「▥ 参数已关」)—— 填分类、标签、自定义参数

写作内容会自动保存(默认停止输入 1.5 秒后),也可以随时按 Ctrl+S 手动保存。

四、看效果

左侧导航点「预览」,点「启动预览」:

  • 整屏显示主题渲染后的真实博客页面
  • 你在编辑器里的改动一保存,预览自动刷新
  • 想看得更大,点「浏览器打开」用系统浏览器查看

如果文章还没写完,勾上「包含草稿」也能预览(切换后预览会自动重启使其生效)。

五、发布上线

左侧导航点「发布」:

  1. 先确认顶部显示的部署目标是否正确(仓库地址 + 分支)
  2. 如果显示「未配置部署目标」,去「设置 → 部署」填写仓库地址与分支
  3. 点「部署上线」,确认后开始

部署流程会自动先生成静态页面,再推送到远端 —— 所以不用担心推上去的是旧内容。

首次使用 Git 部署如果提示缺少 hexo-deployer-git 插件,在「设置 → 部署」页点「一键安装」即可。

六、下次打开

再次启动 HexoDeck 会自动打开上次的站点,直接继续写作即可。想切换博客,点右栏站点卡片的「切换站点」,在列表里点另一个站点。


下一步:了解完整的写作功能 → 写作功能