博客开通指南(二)

正式建立

环境工具

  • 系统:Windows10专业版
  • 分布式版本控制系统:Git
  • 远程仓库:Github
  • Javascript运行环境:node.js
  • 静态博客框架:Hexo

参考

hexo 官方参考文档

全面讲解了结合hexo建立博客的方法,未提到github pages。

Git教程 - 廖雪峰的官方网站

讲了GIt(分布式版本控制系统)的基本常用内容。

史上最详细“截图”搭建Hexo博客并部署到Github

以截图的方式,讲解了hexo结合github建立博客,发布博文的主要步骤,比较直观。

知乎 windows下如何安装hexo 叶阳栩宁的回答

详细讲解了结合hexo与github建立博客的步骤,并提出了部分问题的解决。

hexo主题Next 官方参考文档

全面讲解了使用hexo搭建好博客后,基于Next主题对博客进行细化设置。

建立过程

首先,我先按照以上参考按部就班地算是搭好了博客,然后由于出现了许多小问题我只能回到起点,重新搭建。

为了测试,我试着开始上传博文,但需要对GIt命令有所了解,我花了大概两个小时学了一点GIt的基本知识。

最后,我开始安装Next主题,并按照它的教程对其进行了细化设置。

搭建过程中遇到的问题

  • 博文上传失败

    上传博客中,我直接使用了命令$ hexo new "文件名",但$ hexo g -d后,博客中仍然只有一个建立博客默认生成的博文“hello world”。我试着将该博文本地文件/source/_posts/hello word.md复制一份上传,这次终于成功了。我又对该博文的内容进行修改,上传后博文对应改变。

    对比“hello world”与我创建博文文档的本地文件,我发现了其中的区别:相比于“hello world”,我创建的文档中多出了date属性,我试着删掉了它,该博文终于上传成功。虽然不知道为何会出现这样的问题,但我将博文的模板/scaffolds/post.md中的date删除后,新建的每个博文都能成功上传了。当然,删除掉date后,博文上的发布日期正常显示。

  • 分类和标签页面无法显示

    当我在博文中加入categories和tags后,分类和标签页面无法显示,但Next主题的浮动栏上出现了标签分类个数。

    我是使用命令$ hexo new page "分页名"创建的categories与tags页面,查看了/source/tags/index.md,我又发现了date属性,删除以后,标签页面果然正常显示了。我索性将/scaffolds下的所有文档都删掉了date,这样我创建所有文档都没有了date,能够正常显示了。

    不过不要忘记在tag.md和categories.md中加上type属性,不然也是无法显示的。

  • 修改博客内容后博客未被修改

    一般来说我刷新一下网页,或者在本地修改前$ hexo clean一下,博客就能正常显示了。

搭建后存在的问题

  • 未找到增加菜单和外部链接图标的方法
  • 搜索栏不能用
  • 在删除热评博文后,该博文仍然出现在热评栏中(热评栏已舍弃)
  • 不蒜子统计(阅读量、人数)次数无法显示

未来更新

  • 解决以上问题
  • 增加“关于”页面
  • 博客页面个性化
  • 博文增加图片视频
  • 为博客申请域名