0%

建站注意事项

初衷

建立这个网站的初衷是为了记录自己大学生活中的一些想法、踩过的一些坑,并可以做一个树洞抒发一下情感。在这里记录一下建立这个网站的注意事项与一些资源路径。

该文章整体框架基于以下博客:

主要步骤均在上述博客中,以下只记录一些注意事项与想法。

1. 安装node.js Hexo NexT

  • windows下直接到官网下载node.jsgit即可。
  • npm一定要改源(taobao)。
  • git clone时不时抽风,clone不下来。不妨试试ladder。但ladder有时候也不好使。这时候就需要给电脑烧三根香,碰碰运气。运气好了就能clone也能push;运气不好clone一个小时也不行,push一晚也push不上去。

2. Hexo

  • hexo init操作必须在空文件夹中进行。里面有无关文件也不行。

  • node_modules是真的nt。搞一个小网站需要这么多插件吗?

  • 可以修改scaffolds文件夹中的模板。

    例如建站中不想要tags但是想要categories,那模板中就可以增加categories,删去tags。

  • source文件夹中只有**_post**是文章文件夹。所有在首页出现的博客文章均位于_post中。不在_post中的文件夹以及其中的文件将不会在主页中显示,只能通过特定链接访问,因此可以放一些隐藏文件。此外about、categories、tags等捷径也在单独的文件夹中。

  • hexo new [] ""有点烦人。想要新建文章,直接在文件夹里面新建还不行,需要单独开命令行,建完了再开typora。不知道有没有解决办法。

  • categories的标签方法为yaml语法。

    1
    2
    3
    categories:
    - [Study, math]
    # - [new category]
  • hexo deploy --debug中注意debug前面是两个横线。

  • 插入图片:使用hexo-asset-image插件。可参考hexo博客中插入图片失败——解决思路及个人最终解决办法

  • 部署至Github、源代码上传至Github是两个事。部署是把自己生成的静态文件(如index.html、css配置文件、js脚本)上传到Github上;源代码上传就是源代码(source文件夹以及md文件、themes文件夹、config.yml等)上传。

  • 数学公式:使用mathjax配置。参考:如何在 hexo 中支持 Mathjax?

    基本步骤:

    1. 修改渲染引擎至kramed(kram <- mark倒序)
    2. mathjax cdn刷新
    3. 更改转义规则
    4. config.yaml开启mathjax
  • ftpsync至home.ustc.edu.cn失败,卡在commiting处mkdirs后。解决办法:Hexo ftpsync错误分析

3. NexT

4. 总结

以上基本是重点注意事项了。建这个站,还是希望自己能多写写东西,多多记录一下生活。愿我能达到吧。

------------- Thanks for watching -------------