季銮西的博客

坚强是说给别人听的谎言 提交于 2019-12-16 01:09:40

准备工作

  1. Git
  2. Node.js
  3. Github

Git 和 Node.js 是安装 Hexo的必备程序。请下载安装包后自行安装。使用 Github Pages 功能,完成静态网站发布。

笔者的软件环境:

  1. 操作系统:Windows 10 专业版 version 17134.590
  2. Git:version 2.20.1.windows.1
  3. Node.js:version 10.15.1

创建Repo

  1. Repo的名称,按照 username.github.io 进行命名。把 username 换成你的 GitHub 账号的 username 。

安装Hexo

123
$ npm install -g hexo-cli$ hexo -v 

在命令提示符,直接运行指令,即可进入安装流程。此处安装的,是 Hexo 运行环境。

建站

123
$ hexo init <folder> #须在空目录下执行$ cd <folder>$ npm install

执行后,生成如下目录:

其中,_config.yml 是配置文件。在部署时需要修改部分参数。

部署

1
$ npm install hexo-deployer-git --save

先安装 hexo-deployer-git,之后修改目录下的配置文件deployment模块。

12345
deploy:  type: git  repo: https://github.com/JiLuanxi/jiluanxi.github.io.git  branch: master  message:

参数说明:

  • repo:直接复制 Repo 的URL即可
  • branch:默认 push 到哪个分支。如果为空,则默认 push 到 master 分支
  • message:默认提交信息。如果为空,则默认为提交时间
1
$ hexo deploy

运行后,即可将网站部署到服务器上。

在浏览器中输入 username.github.io 就可以正常访问了。

如果需要自定义域名,需要:

  1. 在域名服务提供商处,做好域名解析。
  2. 在Repo的 master 分支下,创建 CNAME 文件,内容是自己注册的域名。CNAME文件,需要在 Hexo 目录下的 public 文件夹里创建。这样,才不会被每一次 deploy 覆盖掉。

注意点

  1. 千万 不要使用记事本打开配置文件_config.yml。记事本 大专栏  季銮西的博客不会保存为UTF-8的编码。如果你的博客名称是中文,会在网站上显示成乱码。建议使用Atom或者Sublime Text 打开。
  2. 在执行hexo deploy命令时,可能会遇到警告提示:
12
warning: LF will be replaced by CRLF in lib/pjax/jquery.pjax.min.js.The file will have its original line endings in your working directory

在文件入库前,js文件中的 LF 将会被 CRLF 替换,并提交到仓库。工作目录下的文件中,换行符依然时 LF。

这个提示是由于Windows和Unix的换行符差异,导致执行命令时需要进行换行符转换。这也是Git确保跨平台协作进行的操作。

我使用Atom进行文本编辑,版本是 v1.34.0 x64。在编辑器的右下角,可以进行LF和CRLF的切换。

部署到Coding

由于GitHub在国内的访问速度较慢,可以考虑使用Coding Pages进行静态页面托管。Coding Pages 是由国内的代码托管服务商Coding提供的。按照 Coding Pages 网页上的流程走,即可完成部署。其实,提交到GitHub的同时,也提交到Coding,也算是备份了。

如果要把Hexo提交到Coding上,需要修改Hexo的配置文件的url参数和deploy参数。

12345678910111213141516
# URL## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'url: https://jiluanxi.coding.me/    # 开启Pages服务后,由Coding自动生成root: /# Deploymentdeploy:- type: git  repo: https://github.com/JiLuanxi/jiluanxi.github.io.git  branch: master  message:- type: git  repo: https://git.coding.net/jeluomsy/jiluanxi.coding.me.git    # Coding提供的仓库url  branch: master  message:

最后,别忘了自定义域名的解析设置。此处需要注意,自定义域名要么解析到 username.github.io ,要么解析要 username.coding.me。


本文仅简单介绍安装、部署流程,不涉及配置文件、主题修改、Markdown语法等内容。

参考文档

  1. Hexo官方文档
  2. Github Pages
标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!