hexo低成本搭建静态网页博客(部分内容待更新)

引言

好多同学有写博客的习惯，也有各大例如csd*、简*等博客平台。
但是这些平台毕竟是盈利平台，无法做到对自己的博客完全掌控，有一丝丝的不爽快。想要DIY一下几乎不可能。在这里推荐同学们自己动手丰衣足食。

准备知识

1. github最基本的使用（拥有账号，会建立仓库，与本地电脑进行远程代码推送）。
2. git最基本的使用（推送代码到远程例如github这种托管平台）。
3. linux最基本的常用的命令（推荐linux平台）。

解析

• 托管与访问
  github为每一个用户提供了免费的500M（貌似是）的空间，建立名称为username.github.io的仓库，可以把我们做好的博客静态网页放到该仓库中，然后使用username.github.io就可以访问我们的博客了。
• 博客代码生成
  使用hexo可以一行命令轻松生成可以高度定制的现成的博客代码，hexo官网还提供了大量的插件和主题供使用者DIY。
• hexo项目文件说明

  待更新

搭建步骤

此处忽略本地git与github绑定相关知识以及代码推送相关知识。
这里使用的环境为linux

1. 在github平台上登录账号，新建名称为username.github.io的仓库备用。例如sunowsir.github.io（username是github用户名）
2. 安装nodejs与npm环境（自行百度），确保npm -v正常显示。
3. 安装hexo：sudo npm install -g hexo-cli。
4. 新建一个hexo项目：hexo init 项目名称。例如hexo init MyClub。
5. 进入项目目录：cd MyClub，在下文中称该目录为项目目录。
6. 执行npm install，安装缺少的模块
7. 创建新文章：hexo new 文章标题，生成一个markdown文件，在source/_posts/下。
8. 配置文件：_config.yml
9. 生成博客代码：hexo g，生成的博客代码在项目目录下的public目录中。
10. 部署到github：hexo d，这里需要按照如下方式进行配置才能使用，另外将public中的内容拷贝出去推送到github上也是一样的。
    _config.yml文件中，找到如下内容，替换yourname为你的github的名字

		deploy:
		type: git
		repo: https://github.com/yourname/yourname.github.io.git
		branch: master
		message: 推送原因（例如：update some page ）

11. 打开浏览器访问username.github.io或自己二次映射的域名看看。

Other And DIY

• 安装markdown渲染器

  待更新

• 更换网页logo

  待更新

• 更换主题
  到hexo官网的主题页找到合适的主题，到主题的github将其拷贝到项目目录的themes/下，修改项目主目录的_config.yml文件中的主题配置。
• 主题配置

  待更新

• 清理缓存: 执行npm clean

经验

仅供参考

• Npm报错

  • 错误提示

  npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@2.0.7: 		wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"})
  

  • 解决方案

  # 在博客根目录下
  npm i -f
  

• 无法使用hexo d部署

  1. _config.yml文件中，找到如下内容，替换yourname为你的github的名字，

     deploy:
     type: git
     repo: https://github.com/yourname/yourname.github.io.git
     branch: master
     message: 推送原因（例如：update some page ）
     

2. 执行npm install，安装缺少的模块
3. 执行npm clean，清理缓存
4. 执行hexo g，重新构建
5. 执行hexo d，部署

• Markdown无序列表渲染异常
  　https://github.com/viosey/hexo-theme-material/issues/588

---

部分内容来源于网络