hexo建站经验

一、Hexo 建站完整步骤

1. 安装

  • 安装node.js 我装过,做大一年度项目的时候装的,前后端分离,当时不知道Java和Javaicript不是同一个东西,第一版做的稀烂,用过node.js。那时候该记下来环境怎么配置的。
  • 安装git 也装过,git bash不好使,我git用的就不熟练,得练,记不住,别再每次使ai查了。
  • 安装hexo $ npm install -g hexo-cli

2. 初始化

  • hexo init blog npm install

3. 配置文件

  • _config.yml:整体的配置文件,可以在这里选择模板
  • package.json:应用程序的信息
  • source:资源文件夹。可以用img存放图片,_posts文件夹放所有文章,可以在里面自己建文件夹,比如tech、essays。 除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。 Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。确实,比如我在source里建的common.css就被拷贝到了public下的css文件夹里面。
  • theme: 我用的fluid,但是我忘了我当时怎么操作的,里面啥也没有,我还是可以用fluid主题。很多配置文件我不知道去哪里改,只能在source里面新建,不过一次也没有生效。
  • node_modules:放插件吧,我找不到fluid相关配置文件的时候从这里看到过hexo_theme_fluid,不过ai不建议我修改这里,因为一旦重新下载npm,这里也就重新配置了。
  • 我经常修改的是_config.fluid.yml,我怀疑是当时跟着某个博客教程把fluid里的配置文件放到根目录里,然后把theme里的文件删掉了。忘了,太久了。

4. 美化

  • 在_config.fluid.yml顺着改就可以了,遇到的主要问题是,我想让导航栏显示我自定义的页面,但是效果不理想。想学学前端。
  • 做了个小垃圾,不想说话。
  • 做不下去开始玩手机,发现破罐子破摔非常舒服,逃避有利于心理健康。
  • 不是不能放下手机,是不愿意打破这种惯性。然后终于把这篇博客写出来了。按照我的尿性,这种东西我会继续找个理由逃避,今天还是做了个垃圾,可喜可贺,再接再厉!
  • 还是写出来舒服,脏东西吐出来心里就干净了。

8.1 文章管理

  • 新建文章

    1
    2
    3
    4
    5
    6
    7
    8
    9

    # 示例:创建一篇新文章
    hexo new post "我的第一篇博客"

    # 创建草稿
    hexo new draft "未完成的文章"

    # 发布草稿
    hexo publish draft "未完成的文章"
  • 文章模板

    1
    2
    3
    4
    5
    6
    7
    8
    9
    ---
    title: 文章标题
    date: 2024-04-02 00:00:00
    category: 技术
    tags: [标签1, 标签2]
    cover: /img/cover.jpg
    toc: true
    mathjax: false
    ---

8.2 本地开发

  • 启动本地服务器

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    # 启动服务器
    hexo server
    hexo s

    # 指定端口
    hexo server -p 4000
    hexo s -p 4000

    # 启动调试模式
    hexo server --debug
  • 生成静态文件

    1
    2
    3
    4
    5
    6
    7
    8
    9
    # 生成静态文件
    hexo generate
    hexo g

    # 强制重新生成
    hexo generate --force

    # 生成时监视文件变动
    hexo generate --watch

部署到GitHub

  • 安装部署插件

    1
    npm install hexo-deployer-git --save
  • 配置部署信息(在_config.yml中)

    1
    2
    3
    4
    5
    deploy:
    type: git
    repo: git@github.com:用户名/用户名.github.io.git
    branch: main
    message: "更新博客"
  • 部署命令

    1
    2
    3
    4
    5
    6
    7
    8
    9
    # 部署到GitHub
    hexo deploy
    hexo d

    # 生成并部署
    hexo deploy --generate

    # 强制部署
    hexo deploy --force

其他实用命令

  • 清理缓存

    1
    hexo clean
  • 显示帮助信息

    1
    hexo help
  • 显示版本信息

    1
    hexo version

常用工作流程

  1. 新建文章

    1
    hexo new post "新文章"
  2. 本地预览

    1
    hexo server
  3. 生成静态文件

    1
    hexo generate
  4. 部署到GitHub

    1
    hexo deploy
  5. 问题解决

    1
    hexo clean && hexo g && hexo d

图片存储

存储位置

  • 推荐在 source/img 目录下创建子目录管理图片
    1
    2
    3
    # 创建图片目录
    mkdir -p source/img/posts
    mkdir -p source/img/cover

插入方法

  • 方法1:使用Markdown语法
1
![图片描述](/img/posts/图片名称.jpg)
  • 方法2:使用HTML标签(可控制大小)
1
<img src="/img/posts/图片名称.jpg" width="50%" height="50%" alt="图片描述">
  • 方法3:使用Fluid主题的图片标签
1
{% image /img/posts/图片名称.jpg, width=50%, alt=图片描述 %}

二、后记

  • 怎么在不想做的时候做下去,什么也别想,先做,做个垃圾。
  • 不理想,给它点时间成长。
  • 这些碎碎念为什么不写到日记里面,跑到这里撒泼打滚,想写别管,能写是福。
  • 博客可以精美,图片可以丰富,内容可以高质量,个人介绍可以有趣,我看了很多别人的博客,各有各的优点。我的奇怪又简陋,那……这也可以吧。
  • 写点技术博客?写点随笔?这两个自定义页面需要完善。自定义页面的编辑在哪里进行,怎么样实现文章根据分类自动拷贝到tech和essays文件夹,就像public文件夹一样。
  • about页怎么设计,我也整点有意思的,emm……,文学、运动、音乐,我喜欢的这些放上。技术,我不喜欢但是得学的也要放上。怎么排版好看,还是学学前端吧,看着还挺有意思。
  • 想做一个侧边栏,每次刷新都会更新语录。放我喜欢的诗句、文字,或者自己颠。
  • 每次都用的命令能不能写成脚本自动上传
  • 文章中可以有一点醒目的标识

算是建站完成,一月份就尝试过,那时候搭建完成但是很嫌弃,所以什么都没发,现在依然嫌弃,还是捏着鼻子发了。昨天下午大概从四点开始折腾到十二点半,今天早上一个小时左右,折腾的原因是不满意,觉着还有可以优化的地方,但是代码不听我指挥。可以看出我信息检索的能力差,很容易陷入ai的牛角尖,过于依赖ai这种检索方式。决断与规划能力差,有的问题可以先不管,那就果断抛弃不再周旋,先来个“hello world”就好。丢掉完美主义,垃圾就垃圾吧。



hexo建站经验
https://guoxiyao.github.io/2025/04/02/建站/
作者
归潇
发布于
2025年4月2日
许可协议