玩转hexo - 4 - 主题

标签: hexo 原创

由于部分段落的排版无法实现,请查看原文。

地址:http://blog.lujingtao.com/2017/11/20/hexo-theme/


什么是主题?

我们都知道,一个正常的静态网站的基本组成部分有三部分:html文件群,css资源群和javascript文件群。html组成网站的骨架,css规定页面的样式风格,javascript构建页面的各种交互效果与逻辑。他们就像三个兄弟,桃园三结义,方能成就一番大业,此为恒常。

而我们的博客,你的国,也属于网站。但是我们写的文章都是markdown格式的文件,仅仅只是国中的老百姓,本身没什么战斗力,必须要在一个安逸的环境下才能安居乐业。所以没有三兄弟的国是完全招架不住的,更经不起群雄以及他国使者的挑剔眼光。毕竟谁心底里都有一颗壮志雄心,对吧。

于是,三兄弟,构成了主题。

如何使用 or 更换主题

在hexo的官网上,有一个专门的主题页,hexo theme,里面的主题不可谓不琳琅满目。大家可以根据自己的爱好,选择一个对味的。

下面就以个人制作的本主题mello为例。

安装步骤

  1. 复制主题的仓库地址。进入它的github仓库页mellow,复制https://github.com/codefine/hexo-theme-mellow.git
  2. 下载主题到本地博客目录。在命令行中,进入本地博客目录,然后下载主题。 git clone https://github.com/codefine/hexo-theme-mellow.git themes/mellow 。这条命令的尾部的 themes/mellow 表示主题文件存放的目录。成功之后,就能在 blog/themes 找到下载的主题了。
  3. 更换使用的主题。目前我们使用的还是默认的landscape主题,要换成新下载的mellow主题。打开站点配置文件 blog/_config.yml ,找到 theme: landscape ,把landscape换成mellow
  4. 安装依赖。npm install --save hexo-generator-search hexo-generator-topindex hexo-helper-qrcode hexo-renderer-less
  5. 至此,更换主题基本结束。然后运行 hexo clean -> hexo g -> hexo s 就可以预览主题了。

可能会出现的坑

Q : 运行命令的时候报错,或者不报错,但是打开主题后没有样式文件?
A : 出现这个问题大部分情况是因为缺少该主题必要的依赖。这个依赖囊括各种css预处理器以及主题内部某些功能需要的组件,不同主题开发者由于开发习惯以及理念的不同,可能会衍生出各种五花八门的依赖。所以这就需要我们仔细阅读主题文档,把这些依赖都安装好,还有可能需要设置一些东西,才能正常使用。

Q : 主题能正常显示,但是里面的某些功能失效或者报错?
A : 这些主题都是开发者从零开始一点一点写出来的代码集合,出现某些bug再正常不过了,可能开发者并没有发现,这就需要我们使用者来主动联系开发者,帮助完善主题功能,让更多的人更安心的使用。所以遇到这种问题,不要慌,尽情的打小报告就行,哈哈哈。

Q : 主题好是好,但是某些功能我觉得不需要,某些功能我觉得很有必要但是没有?
A : 关于现有功能的增删问题,一般一个结构良好的主题都会在主题配置文件 themes/主题文件包/_config.yml 中留有相应的功能接口,我们只需要改变相应接口的布尔值就能实现功能开启与关闭了,一般true表示开启,而false表示关闭。但是如果咱们需要的功能现有主题并没有,或者主题并没有留下功能开启关闭的接口,这就需要咱们自己看着办了。动手能力强的,可以直接修改源文件,不想自己亲自上阵的那就只能联系开发者了。

Q : 换了主题之后,在部署的时候粗现了Error: ENOENT的错误,并且博客仓库中的主题目录为空,没有部署上去?
A : 这是因为这个主题是从github上直接clone下来的,在主题文件内会默认带有一个 .git 的隐藏目录,这个目录和deploy插件冲突。解决方法也很简单,就是删掉 .git 。用 cd themes/cafe 进入cafe主题中,然后用 rm -rf .git 删除,再用 cd .. 返回到博客目录,重新生成并部署。这样做之后的缺点就是断开了与主题仓库之间的链接,无法使用 git pull 来更新主题,需要手动更新。出现这个错误多半是因为目录中有 .git,全部找到并且删除就行了。

主题推荐

折腾主题的这个阶段几乎是每个人都要经历的,所以上述的很多主题我也都试过,不乏一些空有颜值内在空虚的,要么就是bug层出不穷影响使用了,要么就是作者afk联系不上了。真是没想到你们竟然是这样的主题?!

经过本人海量实践,在此只推荐两个主题:

  1. NexT
    • 优点:从作者专门为文档开发了一整套网站来看,可以说是功能非常健全的主题了,几乎能满足任何hexo使用者的所有需求。
    • 缺点:有点笨重。也不利于二次开发及边缘开发。
  2. Mello
    • 优点:作者是博主本人!
    • 缺点:过于完美主题还很年轻,还有很长的路要走。

本人制作的主题已经被官方收录,正在完善文档中,也会持续更新,欢迎大家使用,如果能在使用过程中提出一些宝贵的意见那绝对是极好的。如果觉得这小伙子做的主题还不错,请在仓库右上角star一下,以示鼓励。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,539评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,911评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,337评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,723评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,795评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,762评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,742评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,508评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,954评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,247评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,404评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,104评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,736评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,352评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,557评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,371评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,292评论 2 352

推荐阅读更多精彩内容