搭建我的博客 github+hexo

其實相關的教程網上有不少不少，不過就是不少不少，並且技術大神們每一個人都寫得不同啊喂，爲何我明明就是一步一步按照教程來的仍是有那麼多亂七八糟的錯？...因此我決定寫此篇記錄一下我搭建博客的過程以及我踩過的一些坑...但願給和我同樣的技術小白提供一些幫助。而後，感謝給我提供幫助的各位大神（後面會貼出 參考資料）

不作過多介紹了，快速開始

準備安裝軟件

依次安裝

一、Node.js

二、Git

註冊github

訪問https://github.com/ 右上角signup

uername 最好都用小寫，由於最後創建的博客地址是：http://username.github.io；郵箱十分重要，GitHub 上不少通知都是經過郵箱的。

建立Repository

Repository 名字應該是http://username.github.io。好比個人username 就是kkl1210

其餘的能夠選擇添加一些描述也能夠選擇默認什麼也不添加 ，點擊creat repository

配置和使用Github

開始--全部應用--找到git bash

配置SSH keys

ssh keys就是用來使本地git 項目與github聯繫

1. 檢查SSH keys的設置

首先要檢查本身電腦上現有的 SSH key：

$ cd ~/. ssh

若是顯示「No such file or directory」，說明這是你第一次使用 git

二、生成新的 SSH Key：

$ ssh-keygen -t rsa -C "郵件地址@youremail.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回車就好>

【提示1】這裏的郵箱地址，輸入註冊 Github 的郵箱地址；

【提示2】「-C」的是大寫的「C」

而後系統會要你輸入密碼：

Enter passphrase (empty for no passphrase):<設置密碼>
Enter same passphrase again:<再次輸入密碼>

在回車中會提示你輸入一個密碼，這個密碼會在你提交項目時使用，若是爲空的話提交項目時則不用輸入。這個設置是防止別人往你的項目裏提交內容。

注意：輸入密碼的時候沒有輸入痕跡的，不要覺得什麼也沒有輸入。

最後看到這樣的界面，就成功設置ssh key了：

三、添加SSH Key到GitHub

在本地文件夾找到id_rsa.pub文件，看上面的圖片第四行的位置告訴你存在哪裏了

沒找到的勾選一下文件擴展名 隱藏的項目

.ssh文件夾裏記事本打開這個文件複製所有內容到

github相應位置。不要着急...（記得期末考試複習機率論看湯家鳳老師的視頻時老師的口頭禪...）

你的github主頁

點擊頭像後邊的箭頭（爲何我每次想要上傳頭像都沒反應呢？但願有知道的小夥伴能看到告訴我一下）

Title最好寫，隨便寫。網上有說不寫title也有可能後期出現亂七八糟的錯誤

Key部分就是放剛纔複製的內容啦 點擊Add SSH key

測試

git bash 裏

輸入如下代碼 不要改任何一個字 我就是自做聰明覺得表明的是本身註冊時候的郵箱而後...

$ ssh -T git@github.com

若是獲得如下反饋

The authenticity of host 'GitHub.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)

輸入yes回車

Enter passphrase for key '/c/Users/lenovo/.ssh/id_rsa':

輸入剛纔設置的密碼回車

設置用戶信息

如今已經能夠經過 SSH 連接到 GitHub 啦!固然還須要完善一些我的信息:

$ git config --global user.name "wuyalan"//輸入註冊時的username
$ git config --global user.email  "alan.wyl@foxmail.com"//填寫註冊郵箱

GitHub 也是用這些信息來作權限的處理，輸入下面的代碼進行我的信息的設置，把名稱和郵箱替換成你本身的，名字必須是你的真名，而不是GitHub的暱稱。

SSH Key配置成功

本機已成功鏈接到 github。

若有問題，請從新設置。常見錯誤請參考：

Connecting to GitHub with SSH​help.github.comError: Permission denied (publickey)​help.github.com

搭建hexo博客

利用npm命令安裝hexo

$ cd
$ npm install -g hexo

1. 建立獨立博客項目文件夾

安裝完成後，關掉前面那個 Git Bash 窗口。在本地建立一個與 Repository 中博客項目同名的文件夾（如E:\http://username.github.io）在文件夾上點擊鼠標右鍵，選擇 Git bash here；

【提示】在進行博客搭建工做時，每次使用命令都要在 H:\http://username.github.io 目錄下。

執行下面的指令，Hexo 就會自動在 H:\http://username.github.io 文件夾創建獨立博客所須要的全部文件啦！

$ hexo init

2. 安裝依賴包

$ npm install

3. 確保git部署

$ npm install hexo-deployer-git --save

4.本地查看

如今已經搭建好本地的 Hexo 博客了，執行完下面的命令就能夠到瀏覽器輸入 localhost:4000 查看到啦

$ hexo g
$ hexo s

hexo g 每次進行相應改動都要hexo g 生成一下

hexo s 啓動服務預覽

5. 用Hexo克隆主題

執行完 hexo init 命令後會給一個默認的主題：landscape

你能夠到官網找你喜歡的主題進行下載 hexo themes 知乎：有哪些好看的 Hexo 主題？

找到它所在的 Github Repository （怎麼找，我喜歡的那個，剛好博主放了他的github地址，emmm）

找到以後經過git命令下載

在主題的repository點擊clone 複製一下那個地址

$ git clone +複製的地址+themes/archer

後面就是clone以後放到你本地的博客文件夾themes文件夾下 名字紋archer的文件 我下載的是archer主題~（有喜歡一樣的小夥伴在個性化本身主題的時候歡迎來交流一下呀~真的是技術小白~還沒研究清楚要怎麼改，不過主題做者也會在readme說明的，細心看就是）

6. 修改整站配置文件

本身把 http://blog.io 中文件都點開看一遍，主要配置文件是 _config.yml ，能夠用記事本打開，推薦使用 sublime 或者nodepad++打開。

修訂清單以下，文檔內有詳細註釋，可按註釋逐個修訂

 

• 博客名字及做者信息：_config.yml
• 我的介紹頁面：about.md
• 表明做頁面：milestone.md

blog.io/_posts/2015-03-02-how-to-write.md​blog.io

這裏貼一份網上看到的  能夠複製替換原來的  可是替換以前最好備份 可能會出錯
那要麼你就對照着看一下改就好


# Hexo Configuration
## Docs: http://zespia.tw/hexo/docs/configure.html
## Source: https://github.com/tommy351/hexo/

# Site 這裏的配置，哪項配置反映在哪裏，能夠參考個人博客
title: My Blog #博客名
subtitle: to be continued... #副標題
description: My blog #給搜索引擎看的，對網站的描述，能夠自定義
author: Yourname #做者，在博客底部能夠看到
email: yourname@yourmail.com #你的聯繫郵箱
language: zh-CN #中文。若是不填則默認英文

# URL #這項暫不配置，綁定域名後，欲建立sitemap.xml須要配置該項
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com
root: /
permalink: :year/:month/:day/:title/
tag_dir: tags
archive_dir: archives
category_dir: categories

# Writing 文章佈局、寫做格式的定義，不修改
new_post_name: :title.md # File name of new posts
default_layout: post
auto_spacing: false # Add spaces between asian characters and western characters
titlecase: false # Transform title into titlecase
max_open_file: 100
filename_case: 0
highlight:
  enable: true
  backtick_code_block: true
  line_number: true
  tab_replace:

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Archives 默認值爲2，這裏都修改成1，相應頁面就只會列出標題，而非全文
## 2: Enable pagination
## 1: Disable pagination
## 0: Fully Disable
archive: 1
category: 1
tag: 1

# Server 不修改
## Hexo uses Connect as a server
## You can customize the logger format as defined in
## http://www.senchalabs.org/connect/logger.html
port: 4000
logger: false
logger_format:

# 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-M-D
time_format: H:mm:ss

# Pagination 每頁顯示文章數，能夠自定義，貼主設置的是10
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Disqus Disqus插件，咱們會替換成「多說」，不修改
disqus_shortname:

# Extensions 這裏配置站點所用主題和插件，暫時默認
## Plugins: https://github.com/tommy351/hexo/wiki/Plugins
## Themes: https://github.com/tommy351/hexo/wiki/Themes
theme: landscape
exclude_generator:
plugins:
- hexo-generator-feed
- hexo-generator-sitemap

# Deployment 站點部署到github要配置
## Docs: http://zespia.tw/hexo/docs/deploy.html
deploy:
  type: git
  repository: 
  branch: master

7. 啓用新下載的主題

在剛打開的的_config.yml 文件中，找到「# Extensions」，把默認主題 landscape 修改成剛剛下載下來的主題名：

【提示】http://username.github.io 裏有兩個 config.yml 文件，一個在根目錄，一個在 theme 下，如今修改的是在根目錄下的。

8. 更新主題

git bash 裏執行

$ cd themes/主題名
$ git pull

9. 本地查看調試

每次修改都要hexo g 生成一下

$ hexo g #生成
$ hexo s #啓動本地服務，進行文章預覽調試，退出服務用Ctrl+c

瀏覽器輸入

localhost：4000 預覽效果

將博客部署到http://username.github.io

1. 複製SSH碼

進入 Github 我的主頁中的 Repository，複製新建的獨立博客項目:http://username.github.io 的 SSH 碼

2. 編輯整站配置文件

打開 H:\username.github.io_config.yml,把剛剛複製的 SSH 碼粘貼到「repository：」後面，別忘了冒號後要空一格。

deploy:
  type: git
  repository: git@github.com:username/username.github.io.git
  branch: master

3. 執行下列指令便可完成部署。

  再次確保安裝好 hexo-deployer-git，不然會報 ERROR Deployer not found: git 的錯誤。

npm install hexo-deployer-git --save

【提示】每次修改本地文件後，須要 hexo g 才能保存。每次使用命令時，都要在你的博客文件夾目錄下

$ hexo g
$ hexo d

（ps：我在第一次hexo d 的時候出現了錯誤，具體錯誤提示忘了，緣由是我沒有deploy 的權限

在repository的setting

（這裏我有一點小疑惑 爲何delete不了這個公鑰呢，我想要delete是由於第一次設置時沒有勾選 ..以下

emm裏面的內容就是重複配置SSH key的步驟，記得勾選這個小框框，我就是沒有勾選設置以後仍是沒有deploy成功

）

由於我看到的教程裏大多數沒有講這一部分，因此我也不肯定這一步是否必須，若是有遇到相同問題的小夥伴能夠參考

）

【提示】若是在配置 SSH key 時設置了密碼，執行 hexo d 命令上傳文件時須要輸入密碼進行確認，會出現一個小框框。

輸入密碼以後提示INFO Deploy done: git表示成功

在瀏覽器輸入：

username.github.io

若是獲得你想要的效果，那麼恭喜你，博客已經搭建好啦！

容許你偷偷激動一下...哈哈哈