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

时间 2020-05-03

标签 vuepress 快速搭建博客一款值得拥有主题繁體版

原文原文链接

速览

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

主题使用

安装主题

建立一个新的项目 my-blog：html

mkdir my-blog
cd my-blog

初始化 yarn 或 npm ：vue

yarn init  或 npm init -y

安装 vuepress 和 vuepress-theme-melodydl：git

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

建立 src/_posts 文件夹和 Vuepress 配置文件，项目结构大体为：github

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

在 package.json 加入 script 字段：npm

{
  "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: {
          // 简书帐号和连接
          "jianshu": { 
            account: "jianshu", 
            link: "https://www.jianshu.com/u/5dddaee8f351", 
          },
          
          // 新浪 帐号和连接
          "weibo": { 
            account: "",
            link: ""
          },
          
          // 知乎 账号和连接
          "zhihu": { 
            account: "zhihu",
            link: "https://www.zhihu.com/people/sheng-tang-de-xing-kong"
          },
          
          // Github 账号和连接
          "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 博客开启评论）。json

Vssue 评论插件使用能够查看文档手册。传送门。异步

about页面配置

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

下面为我的信息等内容...

建立博文

在 src/_posts 下建立 md 文件ide

<!-- _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，你的鼓励是对我莫大的支持，谢谢🙏。