Hexo搭自己的笔记空间

作者分享了自己使用Hexo6.3.0和Shoka主题0.2.5搭建个人笔记空间的过程,并展示了实现效果,如loading页和首页等。笔记空间已上线,地址为dubulingbo.github.io,作者计划未来将博客后台项目开源,邀请读者关注和交流。

前序

一直以来都想搭建一个属于自己的笔记空间(迫使自己做笔记),最近终于初见端倪了,写这篇文章的主要目的就是与大家交流改进一下,也是本着资源共享的原则,希望大家多来踩踩我的笔记,品评品评!

博客环境

  • hexo:6.3.0
  • Shoka主题:0.2.5

至于如何搭建这里就不详谈了,网上很多大佬都写过很多教程,当然我的笔记空间也有(访问地址在文末,但我主要侧重于在shoka上定制自己的东西)

实现效果

  • loading页
    在这里插入图片描述
  • 首页
    在这里插入图片描述
    等等…

资源介绍

  • 空间地址:dubulingbo.github.io

后续考虑将整个博客后台项目开源。不过请允许我有一个完善的时间,欢迎大家持续关注!

最后,感谢开源,欢迎交流!

<think>好的,我现在需要帮助用户了解如何使用Hexo发布笔记。首先,我要回忆一下Hexo的基本使用流程,确保步骤正确。根据用户提供的引用内容,有几个关键点需要注意,比如安装Hexo、配置、部署到GitHub以及处理插件冲突的问题。 首先,用户可能需要从零开始Hexo博客。根据引用[1],需要安装Node.js和Git,然后全局安装Hexo CLI,接着在项目目录下初始化Hexo并安装依赖。这部分是基础,必须正确无误,否则后续步骤无法进行。然后,用户需要创建新笔记,使用hexo new命令生成Markdown文件,编辑内容后,通过hexo generate和hexo deploy来发布。这里可能需要提醒用户注意配置文件_config.yml中的部署设置,尤其是GitHub仓库的链接,如引用[2]提到的clean和deploy命令。 接下来,用户可能会遇到插件冲突的问题,比如代码高亮和MathJax的兼容性。根据引用[3],如果同时使用hexo-prism-plugin和MathJax,并且修改了kramed插件,可能导致代码高亮失效。解决方法建议继续使用marked插件并调整正则表达式,而不是改用kramed。这里需要解释清楚如何修改正则表达式,避免冲突,可能需要具体指导用户找到相关文件并进行更改,如引用[4]提到的路径示例。 另外,用户可能需要了解如何配置主题和修改布局。引用[4]提到了修改主题的layout_macro目录下的文件,可能需要指导用户如何自定义主题,比如Next主题的配置方式,但具体步骤可能需要参考主题文档,这里可以建议用户查阅相关主题的官方指南。 在整理步骤时,需要确保逻辑清晰,每一步都给出相应的命令和注意事项,比如在部署前清理旧文件,处理插件冲突时的具体操作。同时,要提醒用户常见问题,比如部署失败可能的原因(配置错误、依赖未安装等),以及如何通过全局搜索(引用[2])来定位问题。 最后,生成的相关问题需要覆盖用户可能进一步想知道的内容,比如优化部署速度、主题自定义、插件管理和处理构建错误,这些都是Hexo使用中的常见需求,能够帮助用户深入学习和解决问题。</think>### Hexo发布笔记教程 #### 一、环境准备 1. 安装Node.js(版本建议v14+)和Git - 官网下载地址:Node.js[^1], Git[^1] 2. 安装Hexo命令行工具 ```bash npm install -g hexo-cli ``` #### 二、初始化Hexo项目 1. 新建项目文件夹并初始化 ```bash hexo init myblog cd myblog npm install ``` 2. 目录结构说明 - `source/_posts`: 存放Markdown笔记文件 - `themes`: 存放主题文件 - `_config.yml`: 全局配置文件[^4] #### 三、创建与编辑笔记 1. 生成新笔记模板 ```bash hexo new "笔记标题" ``` 生成的Markdown文件路径:`source/_posts/笔记标题.md` 2. 编辑内容 - 使用Typora/VSCode等工具编辑Markdown - 支持MathJax公式(需配置,见第五部分) #### 四、部署到GitHub Pages 1. 修改`_config.yml`配置 ```yaml deploy: type: git repo: https://github.com/用户名/仓库名.git branch: gh-pages ``` 2. 安装部署插件 ```bash npm install hexo-deployer-git --save ``` 3. 生成静态文件并部署 ```bash hexo clean && hexo deploy ``` 完成后访问 `https://用户名.github.io/仓库名` 查看效果[^2] #### 五、插件冲突解决方案(代码高亮+数学公式) 1. **禁用kramed插件** 保持默认使用`marked`解析器 2. 修改正则表达式解决冲突 找到文件: ```text node_modules/marked/lib/marked.js ``` 修改以下两处正则: ```javascript // 转义符冲突 escape: /^\\([!"#$%&'()*+,\-./:;<=>?@\[\]\\^_`{|}~])/g, // 行内公式冲突 em: /\$(([^\$]+?))\$/ ``` 参考[^3]
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值