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閱讀 227,702評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,143評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,553評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,620評論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,416評論 6 405
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,940評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,024評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,170評論 0 287
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,709評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,597評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,784評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,291評論 5 357
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,029評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,407評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,663評論 1 280
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,403評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,746評論 2 370

推薦閱讀更多精彩內容