macOS10.14.14
node.js@6.14.4 git@1.9.2 hexo@6.4.0
node -v
查看git是否安装成功
git --version
新建一个名为你的用户名.github.io的仓库,这里,我的github用户名是Wasabi1234,那么就新建Wasabi1234.github.io的仓库,必须是你的用户名,其它名称无效,将来你的网站访问地址就是 http://Wasabi1234.github.io
每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。
不绑定域名也是可以的,就用默认的 xxx.github.io 来访问; 但你肯定想更个性一点,就得拥有一个属于自己的域名
首先你要注册一个域名,推荐阿里云,暖暖的很贴心~
你提交代码肯定要拥有你的github权限才可以,但是直接使用用户名和密码太不安全了,所以我们使用ssh key来解决本地和服务器的连接问题。
$ cd ~/. ssh
如果提示:No such file or directory 说明你是第一次使用git
ssh-keygen -t rsa -C "邮件地址"
.ssh\id_rsa.pub
文件
$ ssh -T git@github.com
看到这个信息说明SSH已配置成功!
在博客blog目录下,其中的name和email替换成你自己的用户名和邮箱
是你的github用户名,非昵称! 填写你的github注册邮箱
$ git config --global user.name "Wasabi1234"
$ git config --global user.email ""sss2855845850@gmail.com"
设置全局的签名,每次提交的时候都会有对应签名
Hexo是一个简单、快速、强大的基于 Github Pages 的博客发布工具,支持Markdown格式,有众多优秀插件和主题。
由于github pages存放的都是静态文件,博客存放的不只是文章内容,还有文章列表、分类、标签、翻页等动态内容,假如每次写完一篇文章都要手动更新博文目录和相关链接信息,相信谁都会疯掉,所以hexo所做的就是将这些md文件都放在本地,每次写完文章后调用写好的命令来批量完成相关页面的生成,然后再将有改动的页面提交到github。
Hexo不同版本差别比较大,网上很多文章的配置信息都是基于2.x的,所以注意不要被误导; hexo有2种_config.yml文件,一个是根目录下的全局的_config.yml,一个是各个theme下的;
在你认为合适的地方创个文件夹,我是在D盘建了一个blog文件夹。然后通过命令行进入到该文件夹里面
$ npm install -g hexo-cli
安装位置
soft ▸ usr ▸ local ▸ lib ▸ node_modules
在电脑的某个地方新建一个名为hexo的文件夹(名字可以随便取),比如我的是/Volumes/doc/hexo,由于这个文件夹将来就作为你存放代码的地方,所以最好不要随便放。
$ cd /f/Workspaces/hexo/
$ hexo init
hexo会自动下载一些文件到这个目录,包括node_modules
$ hexo g # 生成
$ hexo s
执行以上命令之后,hexo就会在public文件夹生成相关html文件,这些文件将来都是要提交到github去的
hexo s是开启本地预览服务
默认主题丑到反人类,替换一个好看点的主题
首先下载这个主题:
$ git clone https://github.com/wizardforcel/hexo-theme-landfarz.git themes/landfarz
_config.yml
中的theme
landscape改为theme: landfarz
在上传代码到github之前,一定要记得先把你以前所有代码下载下来(虽然github有版本管理,但备份一下总是好的),因为从hexo提交代码时会把你以前的所有代码都删掉。
如果你一切都配置好了,发布上传很容易,一句hexo d就搞定,当然关键还是你要把所有东西配置好。
正确写法:
deploy:
type: git
repository: git@github.com:liuxianan/liuxianan.github.io.git
branch: master
错误写法:
deploy:
type: github
repository: https://github.com/liuxianan/liuxianan.github.io.git
branch: master
后面一种写法是hexo2.x的写法,现在已经不行了
sudo npm install hexo-deployer-git --save
根据警告再安装即可
发现又有警告,MD!
好了,终于没有警告了!
输入hexo d就会将本次有改动的代码全部提交,没有改动的不会
提交之后网页上一看,发现以前其它代码都没了,此时不要慌,一些非md文件可以把他们放到source文件夹下,这里的所有文件都会原样复制(除了md文件)到public目录的:
由于hexo默认会把所有md文件都转换成html,包括README.md,所有需要每次生成之后、上传之前,手动将README.md复制到public目录,并删除README.html。
常见命令
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本
缩写:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
组合命令:
hexo s -g #生成并本地预览
hexo d -g #生成并上传
这里面都是一些全局配置,每个参数的意思都比较简单明了,所以就不作详细介绍了。
需要特别注意的地方是,冒号后面必须有一个空格,否则可能会出问题。
定位到我们的hexo根目录,执行命令:
hexo会帮我们在_posts下生成相关md文件:
我们只需要打开这个文件就可以开始写博客了,默认生成如下内容:
当然你也可以直接自己新建md文件,用这个命令的好处是帮我们自动生成了时间。
一般完整格式如下:
---
title: postName #文章页面上的显示名称,一般是中文
date: 2019-07-11 19:11:33 #文章生成时间,一般不改,当然也可以任意修改
categories: 默认分类 #分类
tags: [tag1,tag2,tag3] #文章标签,可空,多标签请用格式,注意:后面有个空格
description: 附加一段文章摘要,字数最好在140字以内,会出现在meta的description里面
---
正文
那么hexo new page 'postName'
命令和hexo new 'postName'
有什么区别呢?
最终部署时生成一个index.html,但是它不会作为文章出现在博文目录
可以用typora来进行博客的编写或者用CSDN的编辑器也是很不错的选择,用VScode的Markdown-toc插件来为我们的文章自动生成目录。
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
与所有 Hexo 主题启用的模式一样。 当 克隆/下载 完成后,打开站点配置文件, 找到 theme 字段,并将其值更改为 next。
首先启动 Hexo 本地站点,并开启调试模式(即加上 --debug)
hexo s --debug
在服务启动的过程,注意观察命令行输出是否有任何异常信息,如果你碰到问题,这些信息将帮助他人更好的定位错误。 当命令行输出中提示出:
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop. 此时即可使用浏览器访问 http://localhost:4000,检查站点是否正确运行。
在 Hexo 中有两份主要的配置文件,其名称都是 _config.yml。 其中,一份位于站点根目录下,主要包含 Hexo 本身的配置;另一份位于主题目录下,这份配置由主题作者提供,主要用于配置主题相关的选项。
为了描述方便,在以下说明中,将前者称为 站点配置文件, 后者称为 主题配置文件。 你可以访问 Hexo 的文档 了解如何安装 Hexo病进行 站点配置文件的配置 简单的设置可以参考: NEXT中文文档 NEXT主题详细配置