市面上有不少完善的个人笔记管理方案,但或多或少都不能满足笔者的需求:
- 笔记保存在本地:这样安全且稳定
- 使用markdown语法:兼容性强
- 可以便捷的发布写好的文章:从私有的混乱的笔记中整理出公开的成体系的文章无疑有利于个人对知识了如指掌 所以笔者便萌生了建立hexo+obsidian工具流搭建个人博客的想法,特此分享出来,以供参考。
观前提示:笔者也是边试错边写笔记,疏漏在所难免。如果绕了弯路,还望读者不吝赐教。
我的博客: andy's blog 最终效果图:
安装 node.js 和 Git
windows 下正常安装即可:
- Git 官网
- node.js
输入:
检测是否安装成功
安装 hexo
全局安装:
选择一个文件夹,右键打开 gitbash:
新建完成后,指定文件夹的目录如下:
- : 网站的 配置 信息,您可以在此配置大部分的参数。
- :模版文件夹。当您新建文章时,Hexo 会根据 scaffold 来创建文件。
- Hexo 的模板是指在新建的文章文件中默认填充的内容。例如,如果您修改 scaffold/post.md 中的 Front-matter 内容,那么每次新建一篇文章时都会包含这个修改。
- : 资源文件夹是存放用户资源的地方。除 文件夹之外,开头命名为 (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
- : 主题 文件夹。Hexo 会根据主题来生成静态页面。
- : 应用程序的信息。EJS, Stylus 和 Markdown 渲染引擎 已默认安装,您可以自由移除。
再输入:
打开: 就可以看到成功部署的 hexo 博客啦。
NexT 主题是 hexo 的老牌强势主题。选它能在遇到问题时在网上搜到相当多的解决方案。
git 安装:
npm安装:
这两种安装都可以, git 安装后会在 目录下存放源码,网上有不少直接修改源码进行美化的。 这显然==不利于后续版本升级==,因为会造成版本合并冲突。 更何况也不够优雅,笔者在之后的美化章节里会介绍如何使用官方推荐的方式优雅的调教主题
笔者这里选择npm安装。
再在 里修改以启用 NexT 主题:
将所需的NexT主题选项从默认主题配置文件复制到此配置文件中。通过以下命令复制整个默认主题配置文件:
然后 就是next的主题配置
在 里设置:
- 首先在 blog的根目录输入以下的命令:
- 然后在这个 的menu中把 tags这一项取消注释,然后重新构建即可
首先安装相应模块:
将主题配置文件: ![[Hexo 搭建博客(新版)-20240501-3.png]] 打开
复制一下内容到 :
效果
在 nexT 主题中, 文章默认是全部展示 可以通过两种方式修改
- (Recommended)使用 来手动打破文章
:
网上有不少让直接修改 nexT 主题的源代码以实现效果的 但正如之前所述: 这样==不利于后续版本升级==,会造成版本合并冲突
hexo 官方实际上提供了类似的接口 官方文档
下面是详细步骤:
在 next 的配置文件里打开
在如下文件夹下新增 :
复制以下文件到里面
即可
最后当然是把我们的blog部署到GithubPage
这点官方文档说的很清楚了: 官方文档 照着操作就是了
这是笔者系列笔记 [记录我搭建个人博客的全过程] 的第一篇。 这一篇里我们完成了博客的搭建,美化和部署。
下一篇里我们将改善博客糟糕的编辑体验,对obsidian进行深入个性化设置,敬请期待。