搭建博客的艱辛歷程(hexo+github)

前言

加入實驗室不久就讓我們搭建博客 ,有指導視頻但看了一點感覺完全看不懂就沒看了,自己在網上找,看朋友是怎么弄的,自己嘗試摸索。別人都弄出來了,為啥我用著電腦都出問題弄不好,有一段時間幾乎崩潰。我憑著強大的毅力不放棄一共搭建了有10次左右終于弄出來了。可以說所有的問題都被我遇見過(要哭死......),所以我要在這里整理我的經驗,在最后面分享一下問題經驗,希望能給后來人一些幫助。

一、下載軟件

首先,下載Git官網 2.15.0

node.js官網8.9.0
32位或64位按自己電腦的系統來選擇,如果不清楚,可以直接在官網下載32位的,可以兼容64位系統。
想要知道自己的電腦是多少位操作系統,打開“我的電腦”,在空白處單擊鼠標右鍵,點擊“屬性”即可查看。

注:不同軟件版本的安裝與使用會有差異。曾經就遇到過因為node.js版本太低出錯搭建不成功。

二、安裝軟件

1.安裝git

  • 大部分按默認安裝,一路點擊”Next”
image
  • 這里選擇對應的windows選項,如下圖


    image.png

    image.png
  • 等待安裝完成


    image.png

2.安裝node.js

  • Node安裝更加簡單,還是一路”Next”,最后等待安裝完成即可


    image.png

    image.png

三、驗證軟件是否正確安裝

  • 同時按下Win鍵和R鍵(或者點擊“開始菜單”->點擊“運行”),打開運行窗口,輸入“cmd”
    然后輸入以下命令,結果與下圖相同則說明安裝正確,若不正確可以卸載軟件重新安裝
  1. git --version
  2. node -v
  3. npm -v

四、申請GitHub賬號

  • 點擊GitHub進入官網注冊帳號
  • 按下圖分別輸入用戶名、郵箱、密碼,然后點擊注冊


    image.png

在這里就不多說如何注冊GitHub賬號了,有看不懂的英文復制粘貼翻譯就好。

  • 點擊”New repository”,新建一個版本庫


    image.png
  • 輸入Repository name:yourname.github.io(yourname與你的注冊用戶名一致


    image.png

    image.png

    *最后點擊”Publish page”,發布github默認生成的一個靜態站點


    image.png
  • 驗證郵箱,點擊個人設置


    image.png
  • 點擊”Send verification Email”發送驗證郵件


    image.png
  • 進入你的郵箱,查收驗證郵件進行驗證


    image.png

五、安裝Hexo

hexo是基于node.js的靜態博客,官網也是搭建在GitHub上

  • 在電腦上新建一個blog文件夾,該文件夾用于存放你的博客文件,然后右鍵單擊選擇“Git Bash”


    image.png

有的是Git Bash here,是一樣的,沒影響。

安裝hexo為了避免出現被“墻”的情況,使用淘寶NPM鏡像,輸入以下命令等待安裝完成:

$ npm iall -g cnpm --registry=https://registry.npm.taobao.org

注意復制時不要復制"$",因為git上面已經有了
如果是第一次安裝則和下圖差不多,如果已安裝或不確定,可以輸入命令$ hexo -v看是否安裝。

注意:全程都要看英文的意思,看不懂復制粘貼翻譯.

image.png
  • 使用淘寶NPM安裝Hexo

$ cnpm install -g hexo-cli

與原先的npm完全一樣,只是命令改為cnpm,一樣等待hexo安裝完成

image.png
  • 出現的WARN可以不用理會,繼續輸入以下命令

$ cnpm install hexo --save

  • 安裝完成后,在輸入命令,驗證是否安裝正確

$ hexo -v

image.png

六、本地運行Hexo

  • 初始化hexo


    image.png
  • 安裝生成器

$ cnpm install

*運行hexo,以后要在本地運行博客只要輸入該命令即可

$ hexo s -g

image.png

*停止運行,按住Ctrl+C鍵即可停止

七、管理博客

配置信息

使用

Sublime_Text

編輯器(綠色軟件無需安裝,解壓即可使用)打開blog/_config.yml文件,進行配置

image.png
#博客名稱
title: 我的博客
#副標題
subtitle: 一天進步一點
#簡介
description: 記錄生活點滴
#博客作者
author: John Doe
#博客語言
language: zh-CN
#時區
timezone:
#博客地址,與申請的GitHub一致
url: http://elfwalk.github.io
root: /
#博客鏈接格式
permalink: :year/:month/:day/:title/
permalink_defaults:
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:
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: true
  tab_replace:
default_category: uncategorized
category_map:
tag_map:
#日期格式
date_format: YYYY-MM-DD
time_format: HH:mm:ss
#分頁,每頁文章數量
per_page: 10
pagination_dir: page
#博客主題
theme: landscape
#發布設置
deploy: 
  type: git
  #elfwalk改為你的github用戶名
  repository: https://github.com/elfwalk/elfwalk.github.io.git
  branch: master
  • 寫一篇文章
    輸入創建文章命令,生成一個md文件(/blog/source/_posts/)

$ hexo new "hello"


image.png
  • 用編輯器打開hello.md文件,編寫完后保存
title: hello
date: 2015-07-01 22:37:23
categories:
  - 日志
  - 二級目錄
tags:
  - hello
---
摘要:
<!--more-->
正文:

八、發布博客

配置SSH keys

我們如何讓本地git項目與遠程的github建立聯系呢?用SSH keys。

  • 生成新的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: 此處的郵箱地址,你可以輸入自己的郵箱地址;
注意2: 此處的「-C」的是大寫的「C」
然后系統會要你輸入密碼:

···
Enter passphrase (empty for no passphrase):<輸入加密串>
Enter same passphrase again:<再次輸入加密串>
···
在回車中會提示你輸入一個密碼,這個密碼會在你提交項目時使用,如果為空的話提交項目時則不用輸入。這個設置是防止別人往你的項目里提交內容。(我當時就沒輸密碼,直接回車)
注意:輸入密碼的時候沒有*字樣的,你直接輸入就可以了。
最后看到這樣的界面,就成功設置ssh key了:


image.png
  • 添加SSH Key到GitHub
    在本機設置SSH Key之后,需要添加到GitHub上,以完成SSH鏈接的設置。
    1、打開本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面內容為剛才生成人密鑰。如果看不到這個文件,你需要設置顯示隱藏文件。準確的復制這個文件的內容,才能保證設置的成功。
    2、登陸github系統。點擊右上角的 Account Settings—>SSH Public keys —> add another public keys
    3、把你本地生成的密鑰復制到里面(key文本框中), 點擊 add key 就ok了

設置git身份信息

···
$ git config --global user.name "你的用戶名"
$ git config --global user.email "你的郵箱"
···
(新建一個文本文檔,復制粘貼修改成你的用戶名和郵箱)

  • 發布更新博客
    ···
    $ hexo d -g
    ···


    image.png

    如果看到上面的圖 Deploy done :git 說明搭建成功了
    發布時會彈出一個窗口,需要輸入github的帳號和密碼。輸入完之后過一會去瀏覽器查找你的網頁又可以看到你的博客了。(訪問yourname.github.io看下成果)

最后,也是最重要的,我在搭建過程中遇到了很多錯誤,在這分享一下錯誤以及解決方法。

1.node.js版本太低出錯,英文顯示要大于4.0版本

2.搭錯了,刪除文件后重搭建時,有的程序已走過,相應的步驟不用再弄了,不然會出現文件夾不是空的,又出錯。

3在config。yml中改寫時,一定要注意用戶名,網站與GitHub要一樣,冒號后要有一個空格,不然又會出錯。

4.記得helo.md文件也要改,復制粘貼即可

5.記得要添加SSH密鑰,曾經出現過not found git的情況,應該是沒有添加密鑰,沒連接github。

6.還出現過error: Permission to userA.git denied to userB。
出現這個的原因是電腦上的SHH公鑰已經被另一個賬戶使用,你沒有權限。或者是你改用戶名了。處理方法是打開電腦Control Panel(控制面板)——>User Account and family Safety(用戶賬號和家庭安全)——>Manage Windows Credential(憑證管理)——>將跟Git有關的賬號刪除
然后重新發布。

我搭建博客的過程大致就這樣吧,寫在這里回頭看時又是一番感慨,佩服自己,唉。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容