注冊Github賬號

這里我們就不多講了，小伙伴們可以點擊這里，進入官網進行注冊。

創建倉庫

圖片來自Github

登錄賬號后，在Github頁面的右上方選擇New repository進行倉庫的創建。

圖片來自Github

在倉庫名字輸入框中輸入：

Github昵稱.github.io

然后點擊Create repository即可。

生成添加秘鑰

在終端（Terminal）輸入：

ssh-keygen -t rsa -C "Github的注冊郵箱地址"

一路Enter過來就好，待秘鑰生成完畢，會得到兩個文件id_rsa和id_rsa.pub，用帶格式的記事本打開id_rsa.pub，Ctrl + a復制里面的所有內容，然后進入https://github.com/settings/ssh：

圖片來自Github

將復制的內容粘貼到Key的輸入框，隨便寫好Title里面的內容，點擊Add SSH key按鈕即可。

安裝node.js

點擊進入node.js官網

圖片來自node.js官網

目前node.js有兩個推薦版本，分為通用版和最新版，點擊可直接進行下載。下載好后，按照既定的套路安裝即可。

安裝git

這里說的git實則是為了使用git指令，我們的git使用一般有兩種方式，一種是圖形化界面（GUI），另一種是通過命令行，我們這里要使用的是后者，點擊這里進入git的下載網站下載git的安裝包。

圖片來自git

有人說，Mac自帶git指令；也有人說安裝xcode就可以使用git指令。因本人已經忘記當初自己是如何安裝git的，所以大家根據自己的實際情況做決定吧。

安裝配置hexo

強調一下，這一步使我們搭建博客的核心，是重中之重。

圖片來自hexo

有能力的同學可以選擇進入官網自行查看hexo官方文檔，愿意聽我叨叨的同學可以繼續往下看。

接下來我們的操作都將在Terminal終端進行：

• 定位博客本地放置的路徑

$ cd 文件夾
定位博客所在目錄

強調：強烈建議不要 選擇需要管理員權限才能創建文件（夾）的文件夾。

• 下載安裝hexo

$ npm install -g hexo-cli

安裝好hexo以后，在終端輸入：

$ hexo

若出現下圖，說明hexo安裝成功：

hexo安裝成功

• 初始化博客

// 建立一個博客文件夾，并初始化博客，<folder>為文件夾的名稱，可以隨便起名字 $ hexo init <folder> // 進入博客文件夾，<folder>為文件夾的名稱 $ cd <folder> // node.js的命令，根據博客既定的dependencies配置安裝所有的依賴包 $ npm install

初始化博客以后，我們可以看到博客文件夾里的文件是這樣的：

hexo博客文件夾

• 配置博客

基于上一步，我們對博客修改相應的配置，我們用到_config.yml文件，下面是該文件的默認參數信息：

# Hexo Configuration ## Docs: https://hexo.io/docs/configuration.html ## Source: https://github.com/hexojs/hexo/# Site title: # The title of your website subtitle: # The subtitle of your website description: # The description of your website author: # Your name language: # The language of your website 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: landscape # Deployment ## Docs: https://hexo.io/docs/deployment.html deploy: type:

看到這里，大家千萬別被一長串英文給嚇到了，我們實際上要修改的配置只有幾項，拿我自己的配置，我們繼續往下看：

1. 修改網站相關信息

title: inerdstack subtitle: the stack of it nerds description: start from zero author: inerdstack language: zh-CN timezone: Asia/Shanghai

language和timezone都是有輸入規范的，詳細可參考語言規范和時區規范。

注意：每一項的填寫，其:后面都要保留一個空格，下同。

2. 配置統一資源定位符（個人域名）

url: https://xxx.github.io/

對于root（根目錄）、permalink（永久鏈接）、permalink_defaults（默認永久鏈接）等其他信息保持默認。

3. 配置部署

deploy:type: gitrepo: https://github.com/iNerdStack/inerdstack.github.io.git branch: master

其中repo項是之前Github上創建好的倉庫的地址，可以通過如下圖所示的方式得到：

圖片來自Github

branch是項目的分支，我們默認用主分支master。

發表一篇文章

在終端輸入：

// 新建一篇文章 hexo new "文章標題"

我們可以在本地博客文件夾source->_post文件夾下看到我們新建的markdown文件。

md文件

用Markdown編輯器打開文件，我們可以看到這樣的內容：

md文件自動生成內容

我們寫下：

你好，歡迎來到我的個人技術博客。
輸入文章內容

保存后，我們進行本地發布：

$ hexo server

如下圖：

本地發布博客

打開瀏覽器，輸入：

http://localhost:4000/

我們可以在瀏覽器端看到我們搭建好的博客和發布的文章：

本地博客發布

當然，我們也可以手動添加Markdown文件在source->_deploy文件夾下：

手動添加markdown文件

其效果同樣可以媲美hexo new <article>：

本地發布效果圖

但是畢竟我們目前發布的只有本機看得到，怎么讓其他人看到我們寫的博客呢？這時候我們來看看博客的部署。

我們只要在終端執行這樣的命令即可：

$ hexo generate $ hexo deploy
如果出現 error deployer not found:github 的錯誤，執行npm install hexo-deployer-git --save，再執行hexo deploy ?

這時候我們的博客已經部署到網上了，我們可以在瀏覽器地址輸入欄輸入我們的網址即可，如我的博客是：inerdstack.github.io。(我轉的就不改了。)

---

更新20170310

• 密鑰生成文件的位置為：

  windows: C:/Users/用戶名/.ssh/ mac: ~/.ssh/

• .ssh文件為隱藏文件，需要先設置隱藏文件可見才可以看到

• npm install時，出現npm error: RPC failed錯誤
  將npm鏡像修改為淘寶鏡像，詳細修改方式詳見：http://blog.csdn.net/zhy421202048/article/details/53490247

---

更新20170312

• Deployer not found: git
  在終端執行命令： npm install hexo-deployer-git --save 然后繼續執行hexo deploye指令進行部署。

轉自：http://www.jianshu.com/p/e99ed60390a8

轉載于:https://www.cnblogs.com/ziqian9206/p/7241928.html

總結

以上是生活随笔為你收集整理的转：20分钟教你使用hexo搭建github博客的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。