AQSONG’S BLOG

Hexo-Next建站实践

世界那么大,我在这里安个家。

本文持续更新,updated:2017.3.29。

引子

  一直以来都希望在网络上找到一个小窝,搭建属于自己的点点滴滴,折腾了N年,多夭折,或者网站倒闭,或者功能繁杂,或者可塑性不强,总是差那么点意思。直到好友llArcher向我安利了github,静态网页式的发布维护、轻量级、简单方便,这不正是我要的么,简直就是个天然的博客系统,于是才算安定了下来。
  而之所以选择hexo-next的组合则纯粹是偶然,闲逛时看到个站点儿比较喜欢,追查下去,一路知道了“Hexo”,知道了“Next主题”,便也顺手拿了过来,本文就总结一下自己在折腾Hexo+next过程中的实践经历,教程也好,经验也罢,我只当它是个对我自己建站过程的简单小结,如果能帮到你,那也不错。


关于Hexo

  Hexo是一个快速、简洁、高效的博客框架,网上关于利用Hexo建站的教程很多,私以为教程再多不如看官方文档,把这篇文档搞懂,分分钟便可以利用Hexo搭建起自己的博客了。


关于Next

  Hexo框架下有很多主题可以使用,带来各种各样的风格,Next就是其中之一,关于Next的安装及基本使用技巧,同样的道理,参见官方文档,顺便安利一下主题作者的博客iissnan’s note


我的建站实践

  以下内容都是我的实践经历,基本上博客做过的修改&值得关注的点都列在上面了,而非对于配置文件的全面详细解读。

站点url

  url:一定修改成自己博客的URL,例如url: http://aqsong.github.io不要使用默认的yoursite.com,避免后期使用各种插件、第三方应用时出现链接问题。(根目录下名为_config.yml的文件)

新文章文件名

  new_post_name:每一篇文章对应于一个markdown文件,文件名的样式在这里设置,默认以文章标题即title命名,为了便于管理,可在文件名中增加文件建立日期,例如new_post_name: :year-:month-:day-:title.md。(根目录下名为_config.yml的文件)

添加搜索

  search:可以为博客添加站内搜索功能,通过安装插件实现。在站点根目录中执行以下命令:

1
$ npm install hexo-generator-searchdb --save

  之后更改配置文件的search选项为:

1
2
3
search:
path: search.xml
field: post,page

  添加page是为了让搜索不仅仅支持文章,还支持页面。(根目录下名为_config.yml的文件)    

菜单栏

  menu:该选项用来确定菜单栏上所要展示的项目,当新建一个页面并希望其在菜单栏上展示时,除了在该选项下添加页面地址与图标,同时还要修改languages文件夹下相对应的语言文件,最常用的为en.ymlzh-Hans.yml两个文件,修改前者以确定该菜单项英文名称,修改后者确定其简体中文名称。(next目录下名为_config.yml的文件。)

code样式
链接样式post&page
一些莫名其妙的问题
  • python代码无法高亮:站点配置文件中的highlight的auto_detect: true已经设置,代码语言已经设置```python,仍然无法高亮,也许可以试试调整代码格式,比如print()语句,如果print后加1空格即可高亮,不加即无法高亮,也是醉了。
AQSONG wechat
扫一扫,用手机访问本站
坚持原创分享,您的支持将鼓励我继续创作!