分分鐘教你搭建Vuepress漂亮主題博客

前言

想要分分鐘搭建自己博客唉地,可以直接跳到最后枕赵,教你如何分分鐘搭建博客。

速覽

image

主題使用

安裝主題

創(chuàng)建一個(gè)新的項(xiàng)目 my-blog:

mkdir my-blog
cd my-blog

初始化 yarn 或 npm :

yarn init  或 npm init -y

安裝 vuepress 和 vuepress-theme-melodydl:

yarn add vuepress vuepress-theme-melodydl
或
npm install vuepress vuepress-theme-melodydl

創(chuàng)建 src/_posts 文件夾和 Vuepress 配置文件茅撞,項(xiàng)目結(jié)構(gòu)大致為:

my-blog
├── src # Blog 源文件目錄
│   ├── .vuepress # Vuepress 目錄
│   │   └── public # Vuepress 靜態(tài)資源文件
│   │   └── config.js # Vuepress 配置文件
│   └── about # About 頁面 文件夾
│   │   ├── index.md  # about 頁面內(nèi)容文件
│   └── _posts # 博客文件夾
│       ├── xxx.md
│       ...
└── package.json

在 package.json 加入 script 字段:

{
  "scripts": {
    "dev": "vuepress dev src",
    "build": "vuepress build src"
  }
}

配置主題

在 src/.vuepress/config.js 中配置 Vuepress 和主題:

<details>
<summary>點(diǎn)擊展示配置示例</summary>

module.exports = {
    // 網(wǎng)站 Title
      title: 'Top 的博客 | Top Blog',
      
      // 網(wǎng)站描述
      description: '個(gè)人博客',
      
      // 網(wǎng)站 favicon 圖標(biāo)設(shè)置等
      head: [
        ['link', { rel: 'icon', href: '/favicon.ico' }],
        ['meta', { name: 'viewport', content: 'width=device-width,initial-scale=1,user-scalable=no' }]
      ],
      
      // 使用的主題
      theme: 'melodydl',
      
      // 主題配置
      themeConfig: {
        title: 'Top Blog',

    // 個(gè)人信息(沒有或不想設(shè)置的,刪掉對(duì)應(yīng)字段即可)
    personalInfo: {
    
    // 名稱
      name: 'melodydl',
      
      // 頭像 public文件夾下
      avatar: '/avatar-top.jpeg',
      
      // 頭部背景圖
      headerBackgroundImg: '/avatar-bg.jpeg',
      
      // 個(gè)人簡(jiǎn)介 (支持 HTML)
      description: 'In me the tiger sniffs the rose<br/>心有猛虎巨朦,細(xì)嗅薔薇',
      
       // 電子郵箱
      email: 'facecode@foxmail.com',
      
      // 所在地
      location: 'Shanghai, China'
    },
    // 頂部導(dǎo)航欄內(nèi)容
    nav: [ 
      {text: 'HOME', link: '/' },
      {text: 'ABOUT', link: '/about/'},
      {text: 'TAGS', link: '/tags/'}      
    ],
    
    // 首頁頭部標(biāo)題背景圖設(shè)置米丘,圖片直接放在 public 文件夾下
    header: {
      home: {
        title: 'Top Blog', 
        subtitle: '好好生活,慢慢相遇', 
        headerImage: '/home-bg.jpeg'
      },
      
      // tag頁面頭部標(biāo)題背景圖設(shè)置糊啡,圖片直接放在 public 文件夾下
      tags: {
        title: 'Tags', 
        subtitle: '遇見你花光了我所有的運(yùn)氣', 
        headerImage: '/tags-bg.jpg'
      },
      
      // 文章詳情頭部背景圖
      postHeaderImg: '/post-bg.jpeg',
    },
    
    // 社交平臺(tái)帳號(hào)信息 
    sns: {
      csdn: { 
        account: 'csdn', 
        link: 'https://blog.csdn.net/weixin_44002432', 
      },
      weibo: { 
        account: 'weibo', 
        link: 'https://weibo.com/u/5656925978', 
      },
      juejin: { 
        account: 'juejin',
        link: 'https://juejin.im/user/3843548382238791'
      },
      zhihu: { 
        account: 'zhihu',
        link: 'https://www.zhihu.com/people/sheng-tang-de-xing-kong'
      },
      github: { 
        account: 'github',
        link: 'https://github.com/youdeliang'
      }
    },
    // 底部 footer 的相關(guān)設(shè)置 
    footer: {
      // gitbutton  配置
      gitbtn: {
        // 倉庫地址
        repository: "https://ghbtns.com/github-btn.html?user=youdeliang&repo=vuepress-theme-top&type=star&count=true",
        frameborder: 0,
        scrolling: 0,
        width: "80px",
        height: "20px"
      },
      
      // 添加自定義 footer
      custom: `Copyright &copy; Top Blog 2020 <br /> 
        Theme By <a  target="_blank">VuePress</a>
        | <a  target="_blank">youdeliang</a>`
    },
    
    // 分頁配置
    pagination: {
      // 每頁文章數(shù)量
      perPage: 5,
    },
    
    // vssue 評(píng)論配置, 如果不需要拄查,可以設(shè)置 comments: false
    comments: {    
      owner: 'youdeliang',
      repo: 'vuepress-theme-melodydl',
      clientId: 'dfba8ecad544784fec1f',
      clientSecret: '1358ac11bc8face24f598601991083e27372988d',
      autoCreateIssue: false,
    },
  }
}

</details>

Vssue 評(píng)論插件

如果你知道 Gitment 和 Gitalk,那么 Vssue 其實(shí)和它們實(shí)現(xiàn)的功能沒什么區(qū)別 —— 在 Github 的 Issue 系統(tǒng)中存儲(chǔ)評(píng)論棚蓄,在你的頁面上發(fā)表和展示評(píng)論堕扶,還可以編輯和刪除評(píng)論,提供了 Vuepress 的插件(最初的動(dòng)力就是給自己的 Vuepress 博客開啟評(píng)論)癣疟。

Vssue 評(píng)論插件使用可以查看文檔手冊(cè)挣柬。傳送門

about頁面配置

---
layout: about 
title: About
subtitle: 你可以很好睛挚,但你無需完美
headerImage: /about-bg.jpg # public 文件夾下的圖片
---

下面為個(gè)人信息等內(nèi)容...

創(chuàng)建博文

在 src/_posts 下創(chuàng)建 md 文件

<!-- _posts/2019-04-01-JS異步編程方案總結(jié).md -->
---
title: JS異步編程方案總結(jié)
date: 2019-04-01
tags:
  - Promise
  - JavaScript
---

本篇博客主要是對(duì) Javcscript 異步編程方案總結(jié)

more 上面的內(nèi)容是摘要邪蛔,將顯示在目錄中。

<!-- more -->

more 下面的內(nèi)容只有瀏覽這篇文章時(shí)才會(huì)完全展示扎狱,不會(huì)顯示在目錄中侧到。

運(yùn)行相應(yīng) script 生成你的博客網(wǎng)站

# 開發(fā)
npm run dev
# 構(gòu)建
npm run build

Github Action 免費(fèi)自動(dòng)部署博客

添加.github/workflows/deploy.yml 文件

name: Build and Deploy
on: [push] // 推送代碼觸發(fā)腳本
jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout
      uses: actions/checkout@master

    - name: vuepress-deploy
      uses: jenkey2011/vuepress-deploy@master
      env:
        ACCESS_TOKEN: ${{ secrets._TOKEN }} // github Token
        TARGET_REPO: youdeliang/youdeliang.github.io  // 倉庫

        TARGET_BRANCH: gh-pages    // build 之后推到的分支名
        BUILD_SCRIPT: yarn && yarn build
        BUILD_DIR: src/.vuepress/dist/     //build 之后的目錄
        CNAME: www.ydlcq.cn

secrets Token 生成步驟:

首先

[圖片上傳失敗...(image-f25e6f-1639035242615)]

下一步

[圖片上傳失敗...(image-6c29d5-1639035242615)]

[圖片上傳失敗...(image-2cf99-1639035242615)]

修改github配置

首先必須將倉庫名稱改成youdeliang.github.io,用戶名加.github.io格式,點(diǎn)擊項(xiàng)目 setting淤击。

[圖片上傳失敗...(image-3b9f2c-1639035242615)]

然后匠抗,找到GitHub Pages點(diǎn)擊Check it out here!
找到source選擇打包上傳的分支和文件夾目錄,點(diǎn)擊save污抬。

[圖片上傳失敗...(image-b9a3a-1639035242615)]

最后生成鏈接就是你博客的鏈接汞贸。

[圖片上傳失敗...(image-3db0be-1639035242615)]

其他部署具體步驟可以參考 Vuepress 官方文檔绳军。 傳送門

分分鐘搭建博客

部署博客示范項(xiàng)目
Top Blog,可以把項(xiàng)目直接拷過去矢腻,需要在項(xiàng)目中找到config.jspackage.json將里面的git地址或重要信息修改成自己的门驾,不懂如何修改可以查看上面詳細(xì)教程(git地址要改成自己的,其他的后面修改也可以)多柑。運(yùn)行yarn install, yarn dev 快速訪問奶是。部署方式參照上面免費(fèi)部署流程,分分鐘搭建漂亮的博客竣灌。

最后

如果覺得主題好用的話或者需要改進(jìn)的地方聂沙,歡迎點(diǎn)贊Star和提issue,你的鼓勵(lì)是對(duì)我莫大的支持初嘹,謝謝??及汉。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市屯烦,隨后出現(xiàn)的幾起案子豁生,更是在濱河造成了極大的恐慌,老刑警劉巖漫贞,帶你破解...
    沈念sama閱讀 206,723評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異育叁,居然都是意外死亡迅脐,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,485評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門豪嗽,熙熙樓的掌柜王于貴愁眉苦臉地迎上來谴蔑,“玉大人,你說我怎么就攤上這事龟梦∫В” “怎么了?”我有些...
    開封第一講書人閱讀 152,998評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵计贰,是天一觀的道長(zhǎng)钦睡。 經(jīng)常有香客問我,道長(zhǎng)躁倒,這世上最難降的妖魔是什么荞怒? 我笑而不...
    開封第一講書人閱讀 55,323評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮秧秉,結(jié)果婚禮上褐桌,老公的妹妹穿的比我還像新娘。我一直安慰自己象迎,他們只是感情好荧嵌,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,355評(píng)論 5 374
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般啦撮。 火紅的嫁衣襯著肌膚如雪谭网。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,079評(píng)論 1 285
  • 那天逻族,我揣著相機(jī)與錄音蜻底,去河邊找鬼。 笑死聘鳞,一個(gè)胖子當(dāng)著我的面吹牛薄辅,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播抠璃,決...
    沈念sama閱讀 38,389評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼站楚,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了搏嗡?” 一聲冷哼從身側(cè)響起窿春,我...
    開封第一講書人閱讀 37,019評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎采盒,沒想到半個(gè)月后旧乞,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,519評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡磅氨,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,971評(píng)論 2 325
  • 正文 我和宋清朗相戀三年尺栖,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片烦租。...
    茶點(diǎn)故事閱讀 38,100評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡延赌,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出叉橱,到底是詐尸還是另有隱情挫以,我是刑警寧澤,帶...
    沈念sama閱讀 33,738評(píng)論 4 324
  • 正文 年R本政府宣布窃祝,位于F島的核電站掐松,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏粪小。R本人自食惡果不足惜甩栈,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,293評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望糕再。 院中可真熱鬧量没,春花似錦、人聲如沸突想。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,289評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至袭灯,卻和暖如春刺下,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背稽荧。 一陣腳步聲響...
    開封第一講書人閱讀 31,517評(píng)論 1 262
  • 我被黑心中介騙來泰國(guó)打工橘茉, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人姨丈。 一個(gè)月前我還...
    沈念sama閱讀 45,547評(píng)論 2 354
  • 正文 我出身青樓畅卓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親蟋恬。 傳聞我的和親對(duì)象是個(gè)殘疾皇子翁潘,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,834評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容