本片博文講詳細(xì)講解搭建過(guò)程,經(jīng)歷鑒于我搭建托管博客所遇到的錯(cuò)誤!為了避免讀者重蹈覆轍。我將盡量詳細(xì),和一些遇到的錯(cuò)誤與大家分享。
====
-------
# 第一步
1 首先我們先去準(zhǔn)備[github](https://github.com/)(點(diǎn)擊文字進(jìn)行跳轉(zhuǎn))。
2 首先在主界面注冊(cè)github進(jìn)行!按照步驟進(jìn)行注冊(cè)。
3 注冊(cè)成功先不要急!此時(shí)我們還需要驗(yàn)證郵箱地址。
4 接下來(lái)我們需要建立一個(gè)倉(cāng)庫(kù)!記住建立倉(cāng)庫(kù)時(shí)所填寫(xiě)的內(nèi)容!是你的帳號(hào).github.io? (這是因?yàn)間ithub規(guī)定的格式這樣才會(huì)直接講當(dāng)前倉(cāng)庫(kù)作為托管站點(diǎn))
5 到這里,你現(xiàn)在就成功了百分之25了!加油 ?是不是很容易。別著急 ?接下來(lái)就需要細(xì)心和仔細(xì)了,因?yàn)閔exo對(duì)格式要求很?chē)?yán)格(我在格式上錯(cuò)誤了很多次,當(dāng)時(shí)都有放棄的念頭了,所以希望大家遇到困難別氣餒,人家都能搞出來(lái)!我們?yōu)楹尾恍心兀?/p>
# hexo配置篇
1 再次提醒讀者朋友 一定要注意格式,我會(huì)在必要的地方提示。
2 首先大家需要在如下地址下載最新版hexo。[node.js](http://nodejs.cn/)(盡量下載最新版本!博文發(fā)出時(shí)間為16年6月!當(dāng)前鏈接只是這段時(shí)間最新版)。
3 大家下載好!可以開(kāi)始安裝了(如果你和我一樣是處女座不想安裝到期C盤(pán),那么請(qǐng)一路next)
4 鼠標(biāo)右鍵任意地方,選擇Git Bash ,使用以下命令安裝hexo(ps:以下命令中的$符號(hào)只為了讓教程和實(shí)際看起來(lái)一致,實(shí)際輸入命令只需輸入$ 后面的命令即可) ```$ npm install hexo-cli -g```
如果之后在使用的過(guò)程中,遇到以下的錯(cuò)誤
```ERROR Deployer not found : github```
則運(yùn)行以下命令,或者你直接先運(yùn)行這個(gè)命令更好。
```$ npm install hexo-deployer-git --save
$ hexo g
$ hexo d
```
接下來(lái)創(chuàng)建放置博客文件的文件夾:hexo文件夾。在自己想要的位置創(chuàng)建文件夾,如我hexo文件夾的位置為E:\hexo,名字和地方可以自由選擇,當(dāng)然最好不要放在中文路徑下,至于原因,我想很多人懂得。之后進(jìn)入文件夾,即E:\hexo內(nèi),點(diǎn)擊鼠標(biāo)右鍵,選擇Git Bash,執(zhí)行以下命令,Hexo會(huì)自動(dòng)在該文件夾下下載搭建網(wǎng)站所需的所有文件。
```$ hexo init```
安裝依賴包
```$ npm install```
讓我們看看剛剛下載的hexo文件帶來(lái)了什么,在E:\hexo內(nèi)執(zhí)行以下命令,
```$ hexo g
$ hexo s```
然后用瀏覽器訪問(wèn)http://localhost:4000/,此時(shí),你應(yīng)該看到了一個(gè)漂亮的博客了,當(dāng)然這個(gè)博客只是在本地的,別人是看不到的,hexo3.0使用的默認(rèn)主題是landscape。輕輕松松就看到了一點(diǎn)成果,是不是很激動(dòng),這就是hexo的強(qiáng)大之處,這個(gè)本地預(yù)覽的功能,我真是愛(ài)不釋手
# 讓我們開(kāi)始部署本地文件到github
既然Repository已經(jīng)創(chuàng)建了,當(dāng)然是先把博客放到Github上去看看效果。編輯E:\hexo下的_config.yml文件,建議使用Notepad++。
在_config.yml最下方,添加如下配置(命令中的第一個(gè)huangjunhui為Github的用戶名,第二個(gè)huangjunhui為之前New的Repository的名字,記得改成自己的。另外記得一點(diǎn),hexo的配置文件中任何’:’后面都是帶一個(gè)空格的),如果配置以下命令出現(xiàn)ERROR Deployer not found : github,則參考上文的解決方法。
這里要注意格式了(注意間隔,按照?qǐng)D片上的來(lái),:后面有內(nèi)容一定要加個(gè)空格)
配置好_config.yml并保存后,執(zhí)行以下命令部署到Github上。如果你是第一次使用Github或者是已經(jīng)使用過(guò),但沒(méi)有配置過(guò)SSH,則可能需要配置一下,具體方法史上最全github使用方法:github入門(mén)到精通里面有介紹到。
```
$ hexo g
$ hexo d
```
執(zhí)行上面的第二個(gè)命令,可能會(huì)要你輸入用戶名和密碼,皆為注冊(cè)Github時(shí)的數(shù)據(jù),輸入密碼是不顯示任何東西的,輸入完畢回車(chē)即可。
此時(shí),我們的博客已經(jīng)搭建起來(lái),并發(fā)布到Github上了,在瀏覽器訪問(wèn)huangjunhui.github.io就能看到自己的博客了。第一次訪問(wèn)剛地址,可能訪問(wèn)不了,您可以在幾分鐘后進(jìn)行訪問(wèn),一般不超過(guò)10分鐘。
#hexo的配置文件
hexo里面有兩個(gè)常用到的配置文件,分別是整個(gè)博客的配置文件E:\hexo\_config.yml和主題的配置文件E:\hexo\themes\light\_config.yml,此地址是對(duì)于我來(lái)說(shuō),hexo3.0使用的默認(rèn)主題是landscape,因此你們的地址應(yīng)該是E:\hexo\themes\landscape\_config.yml,下文所有講到light的地方,你們將之換為自己的主題名即可。本博客使用的主題是基于light改善的主題,目前還在完善中,如果完成的比較好,以后可能發(fā)布在github上。如果你想自己挑選喜歡的主題,hexo官方提供了12個(gè)主題供你自己選擇,使用方法很簡(jiǎn)單,點(diǎn)擊自己想要的主題,進(jìn)入該主題的Repository,使用Git將主題clone到本地,然后將整個(gè)文件夾復(fù)制到E:\hexo\themes文件夾下,將E"\hexo\_config.yml里的theme名字改為自己下載的主題的文件夾名即可。
接下來(lái)介紹整個(gè)博客的配置文件。
E:\hexo_config.yml
```# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site
title: 喜歡雨天的我
subtitle:
description: 生活一半記憶,一半繼續(xù)
author: Hou Shuai
language: zh-Hans
timezone:
# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com/child
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:
# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
# Writing
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
enable: true
line_number: true
auto_detect: false
tab_replace:
# Category & Tag
default_category: uncategorized
category_map:
tag_map:
# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss
# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: yelee
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repository: http://github.com/houshuai0816/houshuai0816.github.io.git
branch: master
```
按照自己的意愿修改完后,執(zhí)行hexo g,hexo s,打開(kāi)localhost:4000看看效果。
E:\hexo\themes\light\_config.yml,此處針對(duì)Concise主題,如果使用其他主題,請(qǐng)查看自己主題的幫助文檔
作者現(xiàn)在使用的樣式為[我的博客](http://houshuai0816.github.io/)
樣式出處[點(diǎn)擊跳轉(zhuǎn)](https://github.com/MOxFIVE/hexo-theme-yelee)
# 發(fā)布新的文章
1.在Git Bash執(zhí)行命令:$ hexo new "my new post"
2.在E:\hexo\source\_post中打開(kāi)my-new-post.md,打開(kāi)方式使用記事本或notepad++。
hexo中寫(xiě)文章使用的是Markdown,沒(méi)接觸過(guò)的可以看下Markdown語(yǔ)法說(shuō)明,一分鐘學(xué)會(huì)Markdown
```title: my new post#可以改成中文的,如“新文章”
date:2015-04-0822:56:29#發(fā)表日期,一般不改動(dòng)
categories: blog#文章文類
tags: [博客,文章]#文章標(biāo)簽,多于一項(xiàng)時(shí)用這種格式,只有一項(xiàng)時(shí)使用tags: blog
---
#這里是正文,用markdown寫(xiě),你可以選擇寫(xiě)一段顯示在首頁(yè)的簡(jiǎn)介后,加上
#在之前的內(nèi)容會(huì)顯示在首頁(yè),之后的內(nèi)容會(huì)被隱藏,當(dāng)游客點(diǎn)擊Read more才能看到。```
寫(xiě)完文章后,你可以使用1.$ hexo g生成靜態(tài)文件。2.$ hexo s在本地預(yù)覽效果。3.hexo d同步到github,然后使用http://huangjunhui.github.io進(jìn)行訪問(wèn)
# 自定義樣式布局系列
1 如果覺(jué)得hexo自帶的樣式不好的話,可以在[github](https://github.com/search? utf8=%E2%9C%93&q=hexo)下搜索自己感興趣的主題,需要先
```cd 到你存儲(chǔ)博客的文件下的themes文件夾下
git clone github上對(duì)應(yīng)的網(wǎng)址
```

2 配置樣式的內(nèi)容同樣是在樣式目錄下的全局配置文件中更改 ```_config.yml```.根據(jù)樣式提示更改
3 對(duì)樣式進(jìn)行覆蓋并部署到github上。需要在當(dāng)前博客目錄下?
```
hexo clean
hexo g
hexo d
```
這樣就可以輸入自己在github上托管的網(wǎng)址查看效果了,是不是很簡(jiǎn)單呢。如果想和自己在萬(wàn)維網(wǎng)上的網(wǎng)址鏈接在一起,可以查看[鴻洋_博客](http://blog.csdn.net/lmj623565791/article/details/51319147)