hexo建站

发表于 更新于 分类于

hexo+github pages 生成个人网站。

prework

  1. nodejs安装以及相关安装配置
  2. git本地登录

hexo

安装

  1. npm i hexo-cli -g
  2. 将D:\conf\nodejs\node-v20.17.0-win-x64\node-global加入环境变量Path
  3. hexo -v验证

使用

  1. 空文件夹里执行hexo init
  2. hexo g 生成
  3. hexo s 预览网页
  4. 还有个hexo d，但是需要先托管到github再执行。

托管到github

  1. 新建一个名为用户名.github.io的仓库
  2. 在刚刚建好的文件夹里修改_config.yml最后的deploy 
    1
    2
    3
    4
    deploy:
      type: git
      repository: git@github.com:用户名/用户名.github.io
      branch: main
  3. 安装git插件npm install hexo-deployer-git --save
  4. 确认git账号登陆了，执行hexo d

域名配置（可选）

  1. 不设置的话可以在https://用户名.github.io/看到整个网站
  2. 仓库-settings-pages，Custom domain填入自己的域名
  3. 域名另外设置一下
  4. /source文件夹里要新建一个CNAME的文件，填上域名

使用

文稿

使用

  1. hexo new draft xxx 生成草稿
  2. 修改后再hexo p xxx转换成post可见
  3. 也可以直接hexo n xxx

模板

对/scaffolds中的md文件修改

主题

默认的landscape

next

  1. 参考主题仓库
  2. 参考主题配置文件
  3. 下载git clone https://github.com/next-theme/hexo-theme-next themes/next
  4. 修改_config.yml文件中更改theme:theme: next

其它配置

显示

  1. 首页里面放的正文太多了：使用<!--more-->，可以直接放在模板里面。
  2. 修改_config.yml：修改author、语言、标题等
  3. 按更新顺序排：修改源目录下，_modules-generator-index.js，改成 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    'use strict';
    var pagination = require('hexo-pagination');
    module.exports = function(locals){
    var config = this.config;
    var posts = locals.posts.sort('-updated'); //修改这里！ 原代码为var posts = locals.posts.sort('-date');
    var paginationDir = config.pagination_dir || 'page';

    return pagination('', posts, {
       perPage: config.index_generator.per_page,
       layout: ['index', 'archive'],
       format: paginationDir + '/%d/',
       data: {
          __index: true
       }
    });
    };

bug及解决方案

  1. fatal: Could not read from remote repository.
    1. 挂了梯子
    2. git账号没有配置好
      1. 执行ssh-keygen –t rsa –C "git仓库邮箱"，重新生成密钥；
      2. 执行git config --global user.name "git用户名"，重新配置本地用户名；
      3. 执行git config --global user.email "git登录邮箱"，重新配置本地邮箱；
      4. 之后将生成在C:.ssh文件夹下的id_rsa.pub文件打开后复制到Git仓库设置—SSH配置—Key配置的地方粘贴即可
  2. 尝试hexo d出现ERROR Deployer not found: git：npm install hexo-deployer-git --save

多平台同步source

  1. 新建一个仓库
  2. 把theme.git文件删了，代码推上去（不然非要submodule，有点麻烦，我暂时也不想更新next，先不搞）
  3. 其它设备上写之前先git pull。