Vuepress 快速搭建博客--一款你值得拥有的博客主题

速览

  • 这是一款 Vuepress 主题,集成了博客所需的分类、TAG墙、分页、评论等功能。
  • 主题追求极简,配置上手简单,适配移动端。
  • 预览地址
  • GitHub地址
  • 博客效果展示:
image

主题使用

安装主题

创建一个新的项目 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

创建 src/_posts 文件夹和 Vuepress 配置文件,项目结构大致为:

my-blog
├── src # Blog 源文件目录
│   ├── .vuepress # Vuepress 目录
│   │   └── public # Vuepress 静态资源文件
│   │   └── config.js # Vuepress 配置文件
│   └── about # About 页面 文件夹
│   │   ├── index.md  # about 页面内容文件
│   └── _posts # 博客文件夹
│       ├── xxx.md
│       ...
└── package.json

在 package.json 加入 script 字段:

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

配置主题

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


    module.exports = {
        // 网站 Title
          title: 'Top 的博客 | Top Blog',
          
          // 网站描述
          description: '个人博客',
          
          // 网站 favicon 图标设置等
          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',

        // 个人信息(没有或不想设置的,删掉对应字段即可)
        personalInfo: {
        
        // 名称
          name: 'melodydl',
          
          // 头像 public文件夹下
          avatar: '/avatar-top.jpeg',
          
          // 头部背景图
          headerBackgroundImg: '/avatar-bg.jpeg',
          
          // 个人简介 (支持 HTML)
          description: 'In me the tiger sniffs the rose<br/>心有猛虎,细嗅蔷薇',
          
           // 电子邮箱
          email: 'facecode@foxmail.com',
          
          // 所在地
          location: 'Shanghai, China'
        },
        // 顶部导航栏内容
        nav: [ 
          {text: 'HOME', link: '/' },
          {text: 'ABOUT', link: '/about/'},
          {text: 'TAGS', link: '/tags/'}      
        ],
        
        // 首页头部标题背景图设置,图片直接放在 public 文件夹下
        header: {
          home: {
            title: 'Top Blog', 
            subtitle: '好好生活,慢慢相遇', 
            headerImage: '/home-bg.jpeg'
          },
          
          // tag页面头部标题背景图设置,图片直接放在 public 文件夹下
          tags: {
            title: 'Tags', 
            subtitle: '遇见你花光了我所有的运气', 
            headerImage: '/tags-bg.jpg'
          },
          
          // 文章详情头部背景图
          postHeaderImg: '/post-bg.jpeg',
        },
        
        // 社交平台帐号信息 
        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/5ce784a0f265da1b8333673c'
          },
          zhihu: { 
            account: 'zhihu',
            link: 'https://www.zhihu.com/people/sheng-tang-de-xing-kong'
          },
          github: { 
            account: 'github',
            link: 'https://github.com/youdeliang'
          }
        },
        // 底部 footer 的相关设置 
        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 href="https://www.vuepress.cn/" target="_blank">VuePress</a>
            | <a href="https://www.github.com/youdeliang/" target="_blank">youdeliang</a>`
        },
        
        // 分页配置
        pagination: {
          // 每页文章数量
          perPage: 5,
        },
        
        // vssue 评论配置, 如果不需要,可以设置 comments: false
        comments: {    
          owner: 'youdeliang',
          repo: 'vuepress-theme-melodydl',
          clientId: 'dfba8ecad544784fec1f',
          clientSecret: '1358ac11bc8face24f598601991083e27372988d',
          autoCreateIssue: false,
        },
      }
    }

Vssue 评论插件

如果你知道 Gitment 和 Gitalk,那么 Vssue 其实和它们实现的功能没什么区别 —— 在 Github 的 Issue 系统中存储评论,在你的页面上发表和展示评论,还可以编辑和删除评论,提供了 Vuepress 的插件(最初的动力就是给自己的 Vuepress 博客开启评论)。

Vssue 评论插件使用可以查看文档手册。传送门

about页面配置

---
layout: about 
title: About
subtitle: 你可以很好,但你无需完美
headerImage: /about-bg.jpg # public 文件夹下的图片
---

下面为个人信息等内容...

创建博文

在 src/_posts 下创建 md 文件

<!-- _posts/2019-04-01-JS异步编程方案总结.md -->
---
title: "JS异步编程方案总结"
date: 2019-04-01
tags:
  - Promise
  - JavaScript
---

本篇博客主要是对 Javcscript 异步编程方案总结

more 上面的内容是摘要,将显示在目录中。

<!-- more -->

more 下面的内容只有浏览这篇文章时才会完全展示,不会显示在目录中。

运行相应 script 生成你的博客网站

# 开发
npm run dev
# 构建
npm run build

使用 GitHub pages 部署

部署具体步骤可以参考 Vuepress 官方文档。 传送门

最后

如果觉得主题好用的话,欢迎点赞和 Star,你的鼓励是对我莫大的支持,谢谢🙏。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335