使用HEXO和github page建置自己的Blog

前言

为什么要撰写自己的Blog呢?

首先Blog可以记录自己的成长且在缴交履历时也能附上，同时也能证明自己外也能吸引别人来观看以提升知名度。

为什么要用hexo呢?

而选择hexo是因为:

可以部署到自己的github更能证明是自己的，同时github page是免费的hexo有提供100多种模板所以美编不好的工程师也能写出好看的Blog文章皆採用markdown语法可以让你更专注在写文章上，而非抵bug上 (笑hexo有许多中文教学上手很快很多套件可使用ex ga、vtuber、留言板

目录

1.配置环境2.常用指令3.git指令与windos设定4.github page建置5.模板使用

1.配置环境

a.首先要安装node.js 连结在这 (选择自己对应的作业系统即可)
b.安装 hexo CLI(记得先选你要的资料夹在cmd cd过去在打指令 )

npm install -g hexo-cli//可以让hexo使用指令的工具wlshexo init <folder> //创建blog 这里的名字对应资料夹名字<>不用照打cd <folder>npm install //下载缩需套件hexo s //打开hexo server

做完以上几步若有跑出 Hexo is running at http://localhost:4000/
且在浏览器打上http://localhost:4000/ 是有东西的则代表成功!!!
注意:接下来没特别提到代表都是在cd folder的路径位置下打指令且可以用vscode的终端机打指令

2.常用指令

可透过hexo help看有什么功能下面列出较常用的

hexo server   //开启hexo serverhexo generate //产生html档案hexo clean    //清除上一份产生的html file，当有换模板或大改建使用hexo deploy   //push到自定义的地方ex今天type选git就是push到githubhexo version  //查看hexo版本hexo new post filename //创建新的文章且档名叫filename.md

由于hexo的每个指令的英文单字开头都是不一样的所以可直接打开头就好
举例:hexo server --> hexo s

3.git指令与windos设定

首先创建github帐号右上方有个+ 点选new repository他会叫你打你的仓库名字
注意仓库名字必须为 username.github.io username为你自己的github name

点选创建后会跳出一个充满指令的页面请不要关掉!!!
然后在你刚才打过hexo server的路径打上(也就是cd folder的位置)

git initgit add .git commit -m 'first commit'git branch -M maingit remote add origin <你自己的仓库> //<你自己的仓库>请对照充满指令的页面git push -u origin main

若你是windows可能会在git add . 这一步遇到(若没遇到可直接跳过至下一个主题)
warning: LF will be replaced by CRLF in

这是因为 Mac 和 Windows 的换行字元有关:

Windows/Dos 系统，採用CR+LF表示，符号\r\n现今的 Mac 系统，採用LF表示，符号\n

接着在vscode的终端机打上

git config –-global core.autocrlf# 输入该指令查看是 false 还是 truegit config –-global core.autocrlf false# 这里的意思是关闭自动转换成crlf 

接着对vscode进行修改

最后在打上

git ls-files — eol

** 就可以重新git add .并push啦!!!**

4.github page建置

首先要在目录底下的**_config.yml** 找到deploy:并提换成以下code

deploy:  type: git  repo: 你的repo //ex:https://github.com/username/username.github.io.git  branch: gh-pages  //branch:gh-pages

接者安装套件以及push html file

//pushnpm install hexo-deployer-git --save //install hexo自动部署工具hexo ghexo d //push public to branch:gh-pages

再来去以下地方就能找到你的url了

5.模板使用

终于最后一步了 (洒泪
取此地方挑选你要的模板link
点选图片是查看模板demo的样子，点选下方文字则是进到模板的github
进到模板的github后会有详细的操作，统常有以下两种:

download zip档后将他複製到你自己theme的资料夹里然后在**_config.yml**找到theme:landscape，把landscape改成你刚才下载的模板folder name，接着在hexo c 、 hexo s查看有无成功。把zip档解压后直接打npm install也就是扩充作者的(步骤可能不一样请查看作者的说明文件)

状况题:

hexo g 出现的html为空白时

因为你的node.js与hexo版本不相容
方法1:更新hexo方法如下

npm install -g hexo-cli hexo version//如果这里依旧一样npm install -g npm-check npm-check//透过这个查看需更新的套件上面的msg 会告诉你指令照这打

方法2:降低node.js版本
查看对应版本 在最下面

结语:

我还是个blog初新者可能写的还不是很好，若大家有遇到什么问题欢迎在底下留言我看到会尽快回复，又或者有什么想看的文章都可以告诉我喔！