1. 程式人生 > >vuepress搭建個人部落格或則書寫文件

vuepress搭建個人部落格或則書寫文件

vuepress是尤大大4月12日釋出的一個全新的基於vue的靜態網站生成器,實際上就是一個vue的spa應用,內建webpack,可以用來寫文件。這篇文章給大家介紹了VuePress搭建個人部落格的過程,感興趣的朋友一起看看吧。

VuePress

vuepress是尤大大4月12日釋出的一個全新的基於vue的靜態網站生成器,實際上就是一個vue的spa應用,內建webpack,可以用來寫文件。

一個基於 Vue SSR 的靜態站生成器,本來的目的是爽爽的寫文件,但是我發現用來擼一個人部落格也非常不錯。

上手搭建

你可以跟著文件上的例子自己玩一玩,不過由於VuePress的文件也是用VuePress來實現的,所以我取巧直接拿

VuePress倉庫中的docs目錄拿來玩耍。

1.首先安裝VuePress到全域性

npm install -g vuepress

2.然後把VuePress倉庫克隆到你的電腦

在docs檔案中執行(請確保你的 Node.js 版本 >= 8)

?

1

2

3

cd vuepress

cd docs

vuepress dev

當你看到這一行就說明已經成功了:

?

1

VuePress dev server listening at http://localhost:8080/

發現真的打開了vuepress文件:

下面的工作就是資料的替換了,但我們應該先看一下docs的目錄結構:

?

1

2

3

4

5

6

7

8

9

10

11

12

13

├─.vuepress

│ ├─components

│ └─public

│ └─icons

│ └─config.js // 配置檔案

├─config // Vuepress文件的配置參考內容

├─default-theme-config

// Vuepress文件的預設主題配置內容

├─guide // Vuepress文件的指南內容

└─zh // 中文文件目錄

├─config

├─default-theme-config

└─guide

└─README.md // 首頁配置檔案

文件分成了兩部分,中文文件在/zh/目錄下,英文文件在根目錄下。

其實目錄裡面的東西都挺好看懂的,首先guide 、default-theme-config、config 這三個目錄中的都是Vuepress文件的主要內容,從中文文件裡也可以看到只有這三個目錄被替換了。

首頁配置

預設主題提供了一個主頁佈局,要使用它,需要在你的根目錄 README.md 的 YAML front matter 中指定 home:true,並加上一些其他的元資料。

我們先看看根目錄下的README,md:

?

1

2

3

4

5

6

7

8

9

10

11

12

home: true // 是否使用Vuepress預設主題

heroImage: /hero.png // 首頁的圖片

actionText: Get Started → // 按鈕的文字

actionLink: /guide/ // 按鈕跳轉的目錄

features: // 首頁三個特性

- title: Simplicity First

details: Minimal setup with markdown-centered project structure helps you focus on writing.

- title: Vue-Powered

details: Enjoy the dev experience of Vue + webpack, use Vue components in markdown, and develop custom themes with Vue.

- title: Performant

details: VuePress generates pre-rendered static HTML for each page, and runs as an SPA once a page is loaded.

footer: MIT Licensed | Copyright © 2018-present Evan You // 頁尾

實在看不懂,官網有比我更詳細的配置說明。

導航配置

導航配置檔案在.vuepress/config.js中

在導航配置檔案中nav是控制導航欄連結的,你可以把它改成自己的部落格目錄。

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

nav: [

{

text: 'Guide',

link: '/guide/',

},

{

text: 'Config Reference',

link: '/config/'

},

{

text: 'Default Theme Config',

link: '/default-theme-config/'

}

]

剩下的預設主題配置官方文件都有很詳細的文件說明這裡就不在囉嗦了。

更改預設主題色

你可以在.vuepress/目錄下建立一個override.styl檔案。

vuepress提供四個可更改的顏色:

1

2

3

4

$accentColor = #3eaf7c // 主題色

$textColor = #2c3e50 // 文字顏色

$borderColor = #eaecef // 邊框顏色

$codeBgColor = #282c34 // 程式碼背景顏色

我把它改成了這樣:

側邊欄的實現

由於評論區裡問的人較多,所以在這裡更新一下,其實我就算在這裡寫的再詳細也不如大家去看官方文件。

側邊欄的配置也在.vuepress/config.js中:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

sidebar: [

{

title: 'JavaScript', // 側邊欄名稱

collapsable: true, // 可摺疊

children: [

'/blog/JavaScript/學會了ES6,就不會寫出那樣的程式碼', // 你的md檔案地址

]

},

{

title: 'CSS',

collapsable: true,

children: [

'/blog/CSS/搞懂Z-index的所有細節',

]

},

{

title: 'HTTP',

collapsable: true,

children: [

'/blog/HTTP/認識HTTP-Cookie和Session篇',

]

},

]

對應的文件結構:

1

2

3

4

├─blog // docs目錄下新建一個部落格目錄

│ ├─CSS

│ ├─HTTP

│ └─JavaScript

部署

在配置好你部落格之後,命令列執行:

Vuepress build

當你看到這一行就說明成功了:

Success! Generated static files in vuepress.

將打包好的vuepress目錄上傳到你的github倉庫,和github page配合,就可以配置好你的部落格網站了。

原文連結:https://juejin.im/post/5addb90af265da0b7f442935