Hexo用户手册
发表于|更新于
|总字数:267|阅读时长:1分钟|浏览量:
¶关于指南
TIP
致主题的新用户:
本指南经过数个版本打磨,绝大部分的功能都有详细说明,请仔细阅读,节约自己和他人的时间;
本指南中提到的:“站点配置” 指的 Hexo 博客目录下的 _config.yml,“主题配置” 指的是 theme/fluid/_config.yml 或者 _config.fluid.yml ,注意区分;
本指南中提到的 source 目录都指的是博客目录下的 source 文件夹,不推荐修改主题内 source 目录;
每次无论 hexo g 或 hexo s,都最好先使用 hexo clean 清除本地缓存;
页面结果以本地 hexo s 为准,部署后的异常大部分是线上缓存原因,在确认没有报错的情况下,等待若干时间后即可正常;
由于主题的不同版本会存在配置差异,本指南以最新版本为准。
¶hexo 常用指令
#清空生成文件 |
先清空在生成在部署
文章作者: 人间客
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 人间客的Blog!
相关推荐
2025-03-24
Hexo-fluid主题美化
¶Hexo + Fluid 美化 注意 本文中的 “博客配置” 指的 Hexo 博客目录下的 _config.yml。 “主题配置” 指的是 theme/fluid/_config.yml 或者 _config.fluid.yml 。 注意区别 ¶添加网站运行时间 页脚添加网站运行时间,只需要在主题配置中的 footer: content >添加: footer: content: ' <div> <span id="timeDate">载入天数...</span> <span id="times">载入时分秒...</span> <script src="/js/duration.js"></script> </div> ' 之后在主题目录下创建 source/js/duration.js,内容如下: var now = new...
2025-03-24
Hexo-fluid主题美化2
¶Hexo-fluid 主题美化2 注意 本文中的 “博客配置” 指的 Hexo 博客目录下的 _config.yml。 “主题配置” 指的是 theme/fluid/_config.yml 或者 _config.fluid.yml 。 注意区别 使用npm安装的,主题文件在node_modules\hexo-theme-fluid ¶Fluid 注入代码 Fluid 主题也提供了一套注入代码功能,相较于 Hexo 注入功能更细致更丰富,并且支持注入 ejs 代码。 如果你想充分修改主题,又不想直接修改源码影响日后更新,本主题提供了代码注入功能,可以将代码无侵入式加入到主题里。 你可以直接注入 HTML 片段,不过建议你了解一下 EJS 模板引擎 (opens new window),这样你就可以像主题里的 ejs 文件一样编写自己的组件再注入进去。 进入博客目录下 scripts 文件夹(如不存在则创建),在里面创建任意名称的 js 文件,在文件中写入如下内容: hexo.extend.filter.register('theme_inject',...
2025-03-27
Hexo-Butterfly主题添加自定义css和js文件
¶创建文件 为了实现魔改和美化网站,添加自定义文件是一个不可或缺的步骤。接下来,我将详细说明如何创建和引入 CSS 和 JS 文件,其他类型的文件处理方式类似。 首先,我们需要定位到博客的根目录下,找到 source 文件夹。虽然主题的 source 文件夹也可以进行操作,但不推荐这样做。接下来,请按照以下步骤进行: 创建文件夹: 在 source 文件夹内,我们可以创建 js 和 css 文件夹,以便于管理和存放我们的自定义样式和脚本。此外,你还可以根据需要创建其他文件夹,比如: img 文件夹:用于存放图片资源。 font 文件夹:用于存放字体文件。 添加自定义 CSS 和 JS 文件: 在 css 文件夹中创建自定义的 CSS 文件,例如 custom.css;在 js 文件夹中创建自定义的 JS 文件,例如 custom.js。这些文件将用于覆盖或增强现有的样式和功能。 引入 CSS 和 JS 文件: 要使浏览器加载我们新创建的 CSS 和 JS 文件,需要在主题的模板文件中进行引入。一般来说,这些引入代码应该放在 <head> 标签内(对于...
2025-03-24
Hexo迁移
¶1.在新电脑上安装git和Node.js ¶2.安装Hexo ¶3. 复制原电脑上的数据 ¶3.1需要复制的 _config.yml:站点配置/对应的主题配置 package.json:说明使用那些包 scaffolds:文章的模板 source:自己写的博客文件 themes:主题 .gitignore:限定在提交的时候哪些文件可以忽略 ¶4.新建一个博客文件,将复制的文件粘贴进去 在git bash中切换目录到新拷贝的文件夹里,使用npm install 命令,进行模块安装。很明显我们这里没用hexo init初始化,因为有的文件我们已经拷贝生成过来了,所以不必用hexo init去整体初始化,如果不慎在此时用了hexo init,则站点的配置文件_config.yml里面内容会被清空使用默认值,所以这一步一定要慎重,不要用hexo init。 ¶5.安装其他插件 npm install hexo-deployer-git --save # 为了使用hexo d来部署到git上 #下面可以省略npm install...
2025-03-24
hexo+git分支实现多终端工作
问题来了,如果你现在在自己的笔记本上写的博客,部署在了网站上,那么你在家里用台式机,或者实验室的台式机,发现你电脑里面没有博客的文件,或者要换电脑了,最后不知道怎么移动文件,怎么办? 在这里我们就可以利用git的分支系统进行多终端工作了,这样每次打开不一样的电脑,只需要进行简单的配置和在github上把文件同步下来,就可以无缝操作了。 ¶机制 机制是这样的,由于hexo d上传部署到github的其实是hexo编译后的文件,是用来生成网页的,不包含源文件。 也就是上传的是在本地目录里自动生成的.deploy_git里面。其他文件 ,包括我们写在source 里面的,和配置文件,主题文件,都没有上传到github。所以可以利用git的分支管理,将源文件上传到github的另一个分支即可。 ¶上传分支 首先,先在github上新建一个hexo分支,如图: 然后在这个仓库的settings中,选择默认分支为hexo分支(这样每次同步的时候就不用指定分支,比较方便)。 然后在本地的任意目录下,打开git bash,将分支克隆下来 git clone...
2025-04-18
hexo-Butterfly主题添加Twikoo评论系统
¶Twikoo Twikoo 是一个简洁、安全、免费的静态网站评论系统。 ¶特色 ¶简单 免费搭建(使用云开发 / Vercel / 私有部署评论后台) 简单部署(支持云开发 / Vercel 一键部署) ¶易用 支持回复、点赞 无需额外适配,支持搭配浅色主题与深色主题使用 支持 API 调用,批量获取文章评论数、最新评论 访客在昵称栏输入 QQ 号,会自动补全 QQ 昵称和 QQ 邮箱 访客填写数字 QQ 邮箱,会使用 QQ 头像作为评论头像 支持评论框粘贴图片(可禁用) 支持插入图片(可禁用) 支持去不图床、云开发图床 支持插入表情(可禁用) 支持 Ctrl + Enter 快捷回复 评论框内容实时保存草稿,刷新不会丢失 支持 Katex 公式 支持按语言的代码高亮 ¶安全 隐私信息安全(通过云函数控制敏感字段(邮箱、IP、环境配置等)不会泄露) 支持 Akismet 垃圾评论检测(需自行注册 akismet.com) 支持腾讯云内容安全垃圾评论检测(需自行注册 腾讯云内容安全) 支持人工审核模式 防 XSS 注入 支持限制每个 IP 每 10...
评论
公告
建站不久, 很多功能尚未完善, 正在努力开发中~