个人感觉hexo已经严重落伍了,但也还不至于完全不能用。今年诸如https://gridea.dev/等静态博客平台也非常用,比hexo也方便太多。
准备工作需要安装Node.js、Git客户端。同时准备一个github账号。
Node.js的下载地址为https://nodejs.org/en/download/ Git客户端选择较多,比如https://git-scm.com/downloads/ github账号登录网站 https://github.com申请,然后新建个仓库,名称是固定的:用户名.github.io,比如我的用户名是fymod,那么仓库名称就是fymod.github.io,格式是固定的。
【注意】如果是windows环境,软件安装完成后,需要配置Git_HOME,指向Node.js的安装目录,同时在环境变量的Path中添加Git_HOME/bin;Git_HOME/usr/bin
配置基础配置,不多说了
git config --global user.email "your_email@xx.com"
git config --global user.name "your_name"
生成秘钥,用来提交的时候,不用每次输入github账号密码。
ssh-keygen -t rsa -C "your_email@xx.com"
回车之后让选择文件保存路径,如果使用默认路径,直接回车即可(默认路径在控制台有显示),然后输入密码等信息,可以为空,直接两次回车,就会在指定或者默认路径下找到id_rsa和id_rsa.pub。 打开id_rsa.pub,复制里面的全部内容。
登录github账号,选择Setting——SSH and GPG keys——New SSH key——输入名称和刚刚复制出来的Key——点击Add SSH key。此时会收到github发送的邮件。 此时可以使用下面的命令判断是否公钥配置成功。
ssh -T git@github.com
如果打印出诸如Hi xxx! You’ve successfully authenticated, but GitHub does not provide shell access.表示公钥配置成功。
Hexo安装执行下面的命令,安装好hexo
npm install -g hexo
如果出现异常(mac下较为常见),可以尝试以下命令后再操作
sudo npm cache clean --force
sudo npm update
新建一个hexo目录,cd进入到目录当中。以下命令均需要在hexo目录中执行。 使用init命令初始化到指定目录
hexo init
因为后续的deploy操作的需要,执行以下命令
npm install hexo-deployer-git --save
预览和部署
执行到上面的步骤,在hexo下已经有了目录结构,下面生成静态页面。
hexo generate
上面的命令也可以简写为 hexo g 这时候静态页面就生成好了,要想在本地预览效果,只需要执行
hexo server
默认情况下有一篇叫做hello world的文章,md文件存放目录为source_posts 。
打开hexo根目录下的_config.yml,找到#Site 部分,修改为自己博客的内容。
# Site
title: 这里放标题
subtitle: 这里放子标题
description: 这里放描述
author: 这个放作者
language: zh-CN
找到#Deployment部分,此处是提交github的配置。
deploy:
type: git
repo: git@github.com:your_name/your_name.github.io.git
branch: master
其中your_name需要替换为你github的账号。 需要说明的是,repo我选择了ssh方式的,如果失败可以尝试https方式https://github.com/your_name/your_name.github.io.git。 【注意】如果是windows,文件不能直接保存,一定要另存为,把编码格式从ANSI改为UTF-8,否则会出现乱码,然后替换掉当前的_config.yml。
至此,仅需要执行以下命令,就能发布自己的博客了。每次自己新建完文章之后部署,也是相同命令。
hexo clean #可忽略此命令,必要时再执行
hexo generate
hexo deploy
打开浏览器,输入your_name.github.io,比如我的是fymod.github.io,即可访问到刚刚部署好的博客。
主题hexo有很多漂亮的主题,默认的landscape也很不错。之前用过jacman,但是已经好多年不更新了,可以自行搜索自己喜欢的。 一般步骤为 1 cd到hexo目录下载主体 git clone xxx 2 配置主题的_config.yml,这个主题的github一般都有说明 3 配置根目录的_config.yml,只需要修改对应主题名称即可
发布文章新建文章
hexo new "文章名称,可以汉字"
此时,在source_posts中就能找到新建的文件。在scaffolds目录下有三个文件,如果不指定,默认使用的是post,上面的命令其实等价于
hexo new post "文章名称,可以汉字"
打开新生成的文件,title就是设置的标题,date是发布时间,可以修改,tags是标签。 编辑新建的文件,mac下没有找到非常中意的,windows下个人觉得MakedownPad2还行。语法比较简单,可以参考http://lutaf.com/markdown-simple-usage.htm 文章写好之后,和之前步骤一样,执行命令即可发布到自己的博客平台
hexo clean
hexo generate
hexo deploy