gitHub博客第一章

发表于   |  

说明

趁着清明假期搭建了这个个人博客，使用了比较火的hexo，然后随便用next主题配了下样式，详细的留待以后折腾。主要目的是整理下自己感兴趣的技术方面知识，也算是强迫自己停下来去思考、总结（最近一段时间都在赶项目进度，心累），也不排除会写写感想。

搭建博客的相关资料

  • 小白独立搭建博客
  • hexo官网文档

    友情提示：

    在搭建博客过程中遇到不少坑，在此记一记警示后来人：

    server模块

    安装网上的教程搭建博客时一定要注意文章提及的hexo版本，因为在2.x后hexo有了比较大的更新，网上教程很多针对的是老版本，而我们现在基本上在用的是3.x版本，这样就掉坑里了。
    比如在这里，hexo 3.0后将server功能独立为单独模块，我们之前使用 npm install -g hexo-cli
    安装hexo时并没有包括本功能，那么当我们进行本地调试时就需要手动安装server模块：
    npm install hexo-server –save
    避免这类问题的关键还是要以官方文档为准。

    端口冲突

    hexo的默认本地端口为4000，我在本地调试时一直不能打开博客主页，但又不是404，说明本地的这个端口是可以访问的，重新安装了多次hexo问题仍没解决，这时我想会不会有本地其他软件已经使用了4000端口，一看果然是！我的是福昕阅读器的自动更新进程占用了，有安装福昕或者也出现这样问题小伙伴可以看看是否存在端口冲突问题。若有，要么关掉第三方软件，或者增加参数指定其他端口：hexo server -p xxxx。（其实本地启动博客没多大用，也就是偶尔自己写完博客想先看看效果的时候会启一下本地，而且查看效果也可以用其他工具插件，比本地的要方便。但是我们第一次配置hexo，想看看配置是否有问题时却跑不起来，就产生误解了）

    发布至gitHub

    在填写deploy信息时要指定type为git，这里也不要受网上过时文章的误导，之前版本这里填写的是gitHub，但在最新hexo版本里这里都要填git，否则会报找不到发布模块的错误。另外某些情况下因为网络限制等原因，以HTTPS协议连接gitHub时会提示访问你的gitHub地址受限从而部署失败，这里可以改为用SSH协议（前提是你已经验证过自己的gitHub公钥），如此：
    1
    2
    3
    4
    deploy:
    type: git
    repository: git@github.com:xx/xx.github.io.git 
    branch: master