Mac本地配置hexo + Atom Markdown,连接GitHub Pages

本篇主要内容如下:

  • hexo
  • Atom markdown环境配置和使用
  • 本地配置hexo环境
  • 选择并配置hexo theme
  • about、tags和categories的使用
  • hexo配置git deploy

提示:一切都在更新,胡乱看本篇这种配置文章不如看官网。中途遇到的一些小问题不太记得了。

hexo

原理:

  • input:source目录下的markdown文件;theme;
  • output:public目录下的html文件;

版本:

  • hexo: 3.2.2
  • hexo-cli: 1.0.2

Atom markdown环境配置和使用

本来我使用Macdown这个app写markdown的,但是这个app不能进行文件夹管理,不方便我这种整天写一堆草稿的人,所以转移到atom。atom需要几个插件完成markdown环境配置,一切尽在cmd+,。

  • markdown-preview-plus: 比自带的markdown-preview添加了实时preview功能,其实仍然很难看,不如Macdown。
  • markdown-Writer: 配合hexo、jekyll等管理markdown的drafts和posts很方便。
  • markdown-scroll-sync: 源码和preview同步滚动,滚得不是很好,可以不用。

整套环境用起来还可以,但是不设快捷键的话,新建file什么的还是不够方便。

markdown-writer

settings下可以对扩展名、draft文件夹、post文件夹、生成engine等进行定制化。这里配合hexo把它们分别修改为.md、source/_drafts、source/_posts/和hexo。注意posts如果设置了year等子文件夹,则注意不要和hexo的config文件里的permalink: :year/:month/:title/冲突。
主要有如下功能:

  • Add draft
  • Add post
  • Publish draft
  • Insert Link
  • Insert Image
  • Manage tags & categories,配合定制化的hexo-generator-atom-markdown-writer-meta生成的tags.json等文件,但是这个2年没更新了,新的hexo不能用了。

问题解决

运行时出现如下问题。

The contents of atom-text-editor elements are no longer encapsulated within a shadow DOM boundary. Please, stop using shadowRoot and access the editor contents directly instead.

  • deprecated calls --> markdown-scroll-sync
  • deprecated selectors --> markdown-preview-plus

markdown-preview-plus已经有了fix方案

本地配置hexo环境

跟随官网步骤。
首先安装node.js和hexo。

npm install hexo-cli -g

到想要创建site的文件夹下,执行以下命令。

hexo init site
cd site
npm install
hexo g
hexo s

之后便可以在localhost:4000下看到blog了。遇见问题,一般是端口占用或者没有运行npm install。按需求和错误提示安装插件,安装时要位于site文件夹下,会安装到当前目录的node_modules里。按照个人情况修改_config.yml,不知道怎么改可以找别人的传了完整hexo文件夹的site对照着改。

选择并配置hexo theme

选了Ahonne的even,因为简明、清晰、中英文支持。最方便的套用模板的方法其实是把Ahonne的blog整个下载下来再照着改,而且他目前把整个hexo文件夹都放在GitHub上了,真是好人。这个模板里,需要到themes/even/_config.yml修改的地方如下:

  • since字段,决定了footer里的since 2015-2017的起始年份
  • email的图标链接的mail信息,也可以注释掉social,则不显示图标
  • 根据自己的需要反注释menu里的tags、categories、about。

有时候不知道某个显示项读取的是什么字段,可以到themes/even/layout/_partial里找,比如footer的设置在footer.swig。想自己写主题的话,可以去看看从零开始制作 Hexo 主题(用别人的主题,就要为别人安利)。

about、tags和categories的使用

我的source文件夹下的文件夹列表如下:

  • _drafts,草稿
  • _posts,要发布的文章
  • about,自我介绍,一个index.md
  • categories,分类页,一个index.md
  • tags,标签页,一个index.md

在写posts的时候设置tags和categories,生成时会自动生成相应页面。具体格式见链接

hexo配置git deploy

npm install hexo-deployer-git --save
在_config.yml里:

deploy:
  type: git
  repository: https://github.com/yourname/yourname.github.io.git
  branch: master

运行hexo d。

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

推荐阅读更多精彩内容