title: how to create blog with hexo
date: 2018-09-20 17:22:55
tags: technology
利用Github和Hexo搭建個人網(wǎng)站教程
概述
hexo是一款基于nodejs的靜態(tài)博客框架，也就是編寫的文章可以編譯成html文件 肉微，不需要額外的管理后臺，結(jié)合github或者coding page即可免費部署上線 摹恰，發(fā)布的內(nèi)容也相對自由一些。語法主要使用markdown钉迷，可以方便與簡書等BPS同步內(nèi)容位衩。
可訪問hexo官網(wǎng)地址了解更多。
搭建步驟
購買個人域名(可選)
github提供github page的域名 分井，不需要備案 ，所以可以直接使用
創(chuàng)建個人倉庫
注冊和登陸 github.com霉猛，
點擊New repository創(chuàng)建一個博客倉庫 尺锚， 假如
用戶名是xiaoming ， 則新建的倉庫名是xiaoming.github.io惜浅，權(quán)限設(shè)置為Public 瘫辩， 其它的不勾選或者選為none
下載安裝軟件
- git---用git -v檢查是否安裝成功
-
Node.js---hexo基礎(chǔ)環(huán)境，用npm -v命令檢查是否安裝成功
假如使用windows系統(tǒng)坛悉，建議下載安裝集成軟件laragon 就好伐厌，其中已經(jīng)整個了上面兩個軟件
安裝完成之后 ， 把本地公鑰上傳到github個人主頁Settings里邊的SSH and GPG keys的SSH keys欄目下面,這一步是使發(fā)布文章時候 裸影，github可以驗證你身份而不用每次輸入密碼
假如沒有公鑰則通過下面命令來生成:
ssh-keygen -t rsa -C "你的GitHub注冊郵箱"
window默認公鑰生成位置是C:\Users\電腦用戶名.ssh\id_rsa.pub , 用記事本打開即可復(fù)制挣轨。
安裝hexo
npm install -g hexo-cli
安裝完成hexo框架之后 ， 輸入:
hexo init blog
安裝完成之后 轩猩，
可以通過以下4條命令進入新建博客文章
cd blog
hexo new test_my_site
hexo g
hexo s
完成之后 卷扮，用瀏覽器打開地址 http://localhost:4000 就可看到博客
繼續(xù)在_config.yml添加上配置
- language: zh-CN #根據(jù)themes\landscape\languages里邊來配置語言，一般是zh-CN
- post_asset_folder: true#設(shè)置為true方便使用本地圖片
- theme: landscape #指定使用的主題 均践，默認是landscape
- deploy：#還有兩個自配置項 一般是使用git配置晤锹，參考文檔 ，以實現(xiàn)關(guān)聯(lián)到github
注意
常遇到的問題
1,配置文件配置值前面需要加一個空格,否則編譯不生效而且報錯彤委，2,一開始未設(shè)置_config.yml里邊language的值的時候 抖甘，生成的文章md文件需要用編輯器convert to utf-8再重新生成才行,3,_post目錄必須要有md文件,4,要設(shè)置githubpage時，創(chuàng)建repo之后 葫慎，還要設(shè)置一下Theme Chooser才生效 ，否則404 薇宠，5,Github page 只能使用master or gh-pages分支 偷办， 而且需要在項目settings里邊GitHub Pages設(shè)置！澄港！
發(fā)布文章
使用hexo new ‘文章名’ 來創(chuàng)建文章之后 椒涯， 再使用markdown編輯器直接編輯對應(yīng)的source_posts里邊的文件保存，
本地預(yù)覽之后可以推送部署上線 回梧，
刪除文章可以直接刪除_post里邊對應(yīng)的md文件 废岂，重新編譯推送即可
- 常用hexo命令
現(xiàn)在來介紹常用的Hexo 命令
npm install hexo -g #安裝Hexo
npm update hexo -g #升級
hexo init #初始化博客
命令簡寫
hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo g == hexo generate #生成
hexo s == hexo server #啟動服務(wù)預(yù)覽
hexo d == hexo deploy #部署
更換主題祖搓，調(diào)整樣式
按照自己需求調(diào)整樣式，發(fā)布文章湖苞，推送即可訪問
一些注意事項和待優(yōu)化之處
1, hexo文章更新到github之后拯欧，md源碼也需要另行保存，一般是保存在博客repo的save分支财骨，一般遷移的話镐作，保存下面幾個文件就可以了
_config.yml
theme/
source/
scaffold/
package.json
.gitignore
2, 目前有在簡書和github page同時發(fā)布文章,發(fā)布到簡書的話需要單獨上傳圖片文件，不能直接復(fù)制文本內(nèi)容隆箩，圖片統(tǒng)一用CDN可能會好點
