GitHub Hexo 搭建教程及踩過的坑

2021-08-28 12:53:39 字數 3657 閱讀 7177

出於對自己搭建部落格的好奇,這兩天就自己親自操作一遍。網路上各種教程,但很多都是有從業經驗的人寫的,對於入門的小白就有各種門檻,一出錯,不知道怎麼解決,網上一頓亂搜,還是沒解決,就擱置了,這個是很多小白半路放棄的原因。自己在搭建過程中也有想放棄的想法,後來想想都搞了這麼久了,半途而廢不好。好了,先扔乙個超級基礎的教程,我也是根據這個教程一步一步來,少走了很多彎路,但還是碰到一點坑,該篇部落格主要是針對這個基礎教程,自己實踐過程中自己遇到的坑。

最適合新手的 github + hexo 「大話」部落格搭建教程

坑1:git shell替換成git bash,直接按照教程安裝

由於自己之前安裝的是git desktop,安裝的對應的命令終端是git shell,雖然bash是一種shell,但自己對於其中的命令運用的不熟悉,兩者的關係也沒有深入了解,覺得自己用git shell和git bash 一樣,到後面根據教程,自己搞得暈頭轉向。自己安裝的git desktop,通過在git shell中命令提示git desktop版本太低,想要更新git desktop,結果顯示不能更新。果斷拋棄git desktop,按照教程來。

坑2:新增ssh key 到github

教程中寫的要找到c盤下面的id_rsa.pub檔案,自己一開始一直沒有生成成功,嚴格按照教程中來。

坑3:執行命令 hexo s

在安裝完hexo使用hexo s 啟動服務本地預覽,先在瀏覽器中輸入localhost:4000,看完了再輸入ctrl+c,自己也是比較糊塗,輸入萬hexo s,直接ctrl+c,結果在瀏覽器中檢視localhost:4000,總顯示網頁無法開啟。

坑4:部落格更換主題

## plugins: 

## themes:

theme: hexo-theme-yilia

注意修改的是theme後面的部分,我使用的是hexo-theme-yilia,之前自己修改錯了,結果一直沒有變過來,預設主題是landscape。

步驟:坑5:自己建立markdown部落格進行上傳

步驟:坑6:自己寫新部落格往上傳的時候一直出錯

新建立markdown檔案的時候開啟之後,游標自動在tags:後面,中間沒有空格,在自己新增tags的時候或者不寫tags的時候,後面一定要加個空格,否則上傳的時候報錯

坑7:_config.yml檔案修改的時候出錯

修改該配置檔案的時候一定要細心,在它預設的「標頭:」後面加內容或者修改內容的時候一定要有乙個空格。

下面分享乙個我修改的完整的_config.yml檔案

# hexo configuration

## docs:

## source:

​# site

title: vampire's blog #我的

subtitle: "sword of damocles" #我的

description: "蝸牛,起碼也是一頭牛" #我的

author: vampire #我的

language: zh-hans

timezone: asia/shanghai #我的

​# url

## if your site is put in a subdirectory, set url as '' and root as '/child/'

url: #我的

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: true

relative_link: false

future: true

highlight:

enable: true

line_number: true

auto_detect: false

tab_replace:

# home page setting

# path: root path for your blogs index page. (default = '')

# per_page: posts displayed per page. (0 = disable pagination)

# order_by: posts order. (order by date descending by default)

index_generator:

path: ''

per_page: 10

order_by: -date

# 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

## 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:

## themes:

theme: hexo-theme-yilia #我的主題

​# deployment

## docs:

deploy:

type: git

repository: [email protected]:vampires1124/vampires1124.github.io.git #我的

branch: master

上面標註「#我的」就是我修改過的地方,其他地方沒有變動。

以上就是我實操過程中遇到的一些問題,總結一下。

Github Hexo部落格搭建教程(三)

github設定好自定義網域名稱後訪問很慢?設定完成後使用網域名稱訪問你會發現,速度非常慢,是因為我們使用網域名稱還是鏈結的github然後進行的跳轉所以國內訪問github還是很慢,其次生成的靜態檔案存在大量空白以及相關資源檔案會因為檔案太大而拖慢網頁載入速度。我主要是做了如下兩方面的優化 一是對...

Github hexo部落格搭建總結

一步乙個腳印,汗與淚水的洗禮 首先感謝 楊睿涵我是看他的教程完成搭建的 github 客戶端,是不需要配置 ssh的,可以在完成基礎配置後直接從 開始。利用hexo搭建部落格需要以下基礎配置 1 擁有乙個github賬號 記住自己的註冊郵箱及使用者名稱 3 建立乙個新庫,庫名為 username.g...

GitHub Hexo搭建個人部落格

看到同學使用github hexo搭建了屬於自己的部落格,眼饞,弄了好久了,感覺有點眼高手低了,一直沒來得及寫一下自己搭建的流程,心血來潮,下邊來簡單介紹下搭建流程,也方便自己以後review,也可以和大家共享交流技術問題。hexo是乙個基於node.js快速,簡介且高效的部落格框架,可以將mark...