基础教程 | 用VuePress搭建一个简单的个人博客(附源码)

先附上自己个人博客页面:https://illusionno.github.io/
源码也在这里:https://github.com/illusionno/my-blog (如果觉得有帮助,可以点颗star✨)
使用的主题是vuepress-theme-reco@2.x,并在上面进行了一些调整。

💬注:美化版博客在blog目录下,基础版博客在simple-blog目录下!!
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述
这里先介绍VuePress的基础使用,也就是目前大多数文档的那种简约风主题。

1. 基础版博客

使用VuePress简单搭建,原生主题:
在这里插入图片描述

在这里插入图片描述

1.1 VuePress初步搭建

1.创建并进入一个新目录

mkdir my-blogs
cd my-blogs

2.使用你喜欢的包管理器进行初始化

npm init -y

3.将 VuePress 安装为本地依赖

 npm install -D vuepress

4.创建文档,并先随便写些内容

mkdir docs
echo '# Hello VuePress' > docs/README.md

注意:使用命令行写入内容时,README.md的编码格式如下,不然页面会乱码显示
在这里插入图片描述

5.在 package.json 中添加一些 scripts指令

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

6.启动本地服务器

npm run docs:dev

1.2 基本配置

先在docs目录下创建一个 .vuepress 目录,所有 VuePress 相关的文件都将会被放在这里。
再在 .vuepress 文件夹下添加 config.js文件,它用于配置网站的标题和描述。
现在的项目结构如下:
在这里插入图片描述

config.js中添加顶部导航栏和侧边栏配置:

module.exports = {
  // 添加标题和描述
  title: "MY BLOG",
  description: "description of my blog",
  themeConfig: {
    // 顶部导航栏
    nav: [
      { text: "首页", link: "/" },
      { text: "CSDN", link: "" },
      { text: "Github", link: "" },
    ],
    // 侧边栏
    sidebar: [
      {
        title: '分类1',   // 必要的
        path: '/categroy1/',      // 可选的, 标题的跳转链接,应为绝对路径且必须存在
        collapsable: false,// 是否可折叠,默认为true
        sidebarDepth: 1,    // 可选的, 默认值是 1
        children: [
         {
          title: '分类1-1',   // 必要的
          path: '/categroy1/one',      // 可选的, 标题的跳转链接,应为绝对路径且必须存在
        
         },
         {
          title: '分类1-2',   // 必要的
          path: '/categroy1/two',      // 可选的, 标题的跳转链接,应为绝对路径且必须存在
        
         }
        ]
      },
      {
        title: '分类2',  
        path: '/categroy2/',    
        collapsable: true, 
        children: [
         {
          title: '分类2-1',  
          path: '/categroy2/one',     
        
         },
         {
          title: '分类2-2',  
          path: '/categroy2/two',   
         }
        ]
      }
    ]
  },
}; 

文档结构如下:
在这里插入图片描述
在这里插入图片描述

1.3 主页配置

在这里插入图片描述

VuePress 遵循 “约定优于配置” 的原则,静态资源图片存放在 .vuepress 文件夹下的 public 文件夹中。

在这里插入图片描述

主页README,md配置如下:

---
home: true
heroImage: /avatar.jpg
heroText: Hero 标题
tagline: Hero 副标题
actionText: 快速上手 →
actionLink: /category1/
features:
- title: 简洁至上 
  details: 以 Markdown 为中心的项目结构,以最少的配置帮助你专注于写作。
- title: Vue驱动
  details: 享受 Vue + webpack 的开发体验,在 Markdown 中使用 Vue 组件,同时可以使用 Vue 来开发自定义主题。
- title: 高性能
  details: VuePress 为每个页面预渲染生成静态的 HTML,同时在页面被加载的时候,将作为 SPA 运行。
footer: Copyright © 2018-present baitao
---

1.4 favicon图标自定义

在这里插入图片描述
将图片先转成favicon.ico格式:🔍在线制作ico图标

将图片放在 public 目录下:
在这里插入图片描述

config.js中添加以下配置,设置favicon.ico的路径。

  head: [
    [
      'link',{ rel: 'icon', href: '/favicon.ico' }
    ]
  ],

更多其他设置,可以查看VuePress官网:https://vuepress.vuejs.org/zh/

2. 美化版博客

目前VuePress的热门主题有如下几个:
在这里插入图片描述
可以选择一个自己喜欢的风格:https://ecosystem.vuejs.press/zh/
我这里使用的是 vuepress-theme-reco@2.x 主题风格,
🔍vuepress-theme-reco@2.x文档

在使用该主题时,需要注意不可参照方默认主题文档来配置,必须按照该文档进行配置。
在这里插入图片描述
使用 vuepress-reco模板快速开始:

npx @vuepress-reco/theme-cli init

根据提示进行选择,哪一个模板其实都可以,不过主页会有些区别。可以直接选择2.x,风格会好看些。
在这里插入图片描述

在这里插入图片描述
运行:npm run dev
在这里插入图片描述

再在上面进行魔改一顿:
在这里插入图片描述

在这里插入图片描述
(光标可以悬浮在头像上看看👀)

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/891425.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

软考——计算机网络概论

🕐计算机网络分类 1️⃣通信子网和资源子网 通信子网:通信节点(集线器、交换机、路由器等)和通信链路(电话线、同轴电缆、无线电线路、卫星线路、微博中继线路和光纤缆线)。用户资源子网:PC、…

快速理解http的get和post

在网络通信中,HTTP 协议扮演着非常重要的角色,而不同的 HTTP 方法决定了客户端与服务器之间的交互方式。 这里讲一下最常用的两种方法——GET 和 POST。 一、GET 方法 GET 方法用于从服务器获取资源。 这就像去图书馆借书——你向图书馆请求一本特定的…

理解智能合约:区块链在Web3中的运作机制

随着区块链技术的不断发展,“智能合约”这一概念变得越来越重要。智能合约是区块链应用的核心之一,正在推动Web3的发展,为数字世界带来了前所未有的自动化和信任机制。本文将深入探讨智能合约的基本原理、运作机制,以及它在Web3生…

如何破解 AI 聊天机器人让它们吐露秘密!窥探 AI 系统指令的 10 种技巧

​ 有时,为了确保 AI 的安全性和透明性,用户需要自己动手,揭开系统指令的面纱。 如果人工智能现在已经成为生活中的事实,并影响着我们的福祉,人们理应知道它的运作原理。 对一些人来说,科幻电影中的经典…

docker (desktopcompose) download

docker docker-compose download 百度网盘获取离线包链接release-notes 参考dockerdocker-composewlspowershell

live2d 实时虚拟数字人形象页面显示,对接大模型

live2dSpeek 测试不用gpu可以正常运行 https://github.com/lyz1810/live2dSpeek 运行的话还需要额外下载https://github.com/lyz1810/edge-tts支持语音 ## 运行live2dSpeek >npm install -g http-server >http-server . ## 运行edge-tts python edge-tts.py

WordPress+Nginx 安装教程

WordPress 是一个开源的网站建设工具,可以用它来“快速”搭建个人博客,官网等等。它本身是用 php 开发的,本身部署不复杂,主要是需要一些配套的东西才能跑起来,网上的一些教程也是写的不清不楚,本文针对非 …

达梦DM数据库insert into语句成功执行但查看时没有数据

在达梦DM数据库insert into语句成功执行后,查看数据时发现该数据没有新增成功。是因为没有提交事物,需要点击✔按钮提交事物。

服务器虚拟化的好处有哪些

1.什么是服务器虚拟化? 在计算服务中,有7种虚拟化包括硬件虚拟化(即服务器虚拟化)、软件虚拟化、内存虚拟化、存储虚拟化、数据虚拟化、网络虚拟化和桌面虚拟化。 其中,服务器虚拟化的初衷是让Windows和Linux操作系统…

沈阳化工大学第十一届程序设计沈阳区竞赛:凿冰 Action(博弈论,思维)

链接:登录—专业IT笔试面试备考平台_牛客网 来源:牛客网 题目描述 北极探险队有新收获了!!! 北极探险队发现了NNN条长度不一的冰柱,由于冰柱里封存有价值的生物,现在需要两名生物学家小A和小…

JAVA就业笔记4——第二阶段(1)

课程须知 A类知识:工作和面试常用,代码必须要手敲,需要掌握。 B类知识:面试会问道,工作不常用,代码不需要手敲,理解能正确表达即可。 C类知识:工作和面试不常用,代码不…

力扣第1题:两数之和(图解版)

Golang版本 func twoSum(nums []int, target int) []int {m : make(map[int]int)for i : range nums {if _, ok : m[target - nums[i]]; ok {return []int{i, m[target - nums[i]]}} m[nums[i]] i}return nil }

Apache Doris介绍

Apache Doris 的发展 Apache Doris 是一款基于 MPP 架构的高性能、实时的分析型数据库,以高效、简单、统一的特点被人们所熟知,仅需亚秒级响应时间即可返回海量数据下的查询结果,不仅可以支持高并发的点查询场景,也能支持高吞吐的…

【Docker系列】Docker查看镜像架构

💝💝💝欢迎来到我的博客,很高兴能够在这里和您见面!希望您在这里可以感受到一份轻松愉快的氛围,不仅可以获得有趣的内容和知识,也可以畅所欲言、分享您的想法和见解。 推荐:kwan 的首页,持续学…

MeterSphere接口自动化平台调试

1。后置脚本节目 //导入json包 import org.json.*; import com.decode.DecodeMain; String responseprev.getResponseDataAsString(); String result DecodeMain.DecodeUtil(response); log.info(“获取批次账单id result:”result); //转换为Object对象类型 JSONObject data_…

Spring Boot在医疗信息交互系统中的应用

第1章绪论 计算机已经从科研院所,大中型企业,走进了平常百姓家,Internet遍及世界各地,在网上能够用计算机进行文字草拟、修改、打印清样、文件登陆、检索、综合统计、分类、数据库管理等,用科学的方法将无序的信息进行…

“云计算+高职”:VR虚拟仿真实训室的发展前景

随着科技的飞速进步,云计算与虚拟现实(VR)技术的结合正在深刻改变着教育领域,尤其是在高等职业教育中,这一融合为实训教学带来了革命性的变革。VR虚拟仿真实训室作为这一变革的前沿阵地,正展现出广阔的发展…

Linux下如何将代码提交至Gitee

首先在gitee中创建自己的仓库. 下面是已经创建好的仓库 然后复制仓库的链接(点击上图克隆/下载) 接下来打开linux, 1.在命令行输入git clone 链接 2. 输入ll,即可看到linux-course项目仓库 3.cd linux-courses(进入项目仓库) 4.在仓库中可以随意增加文件 例如增加test.c文件…

vue使用js-xlsx导入本地excle表格数据,回显在页面上

效果图 解释放在代码的注释中 页面代码&#xff0c;导入本地文件我用的是element的上传工具 // 我是根据js文件直接引入的 <script src"/js/xlsx.full.min.js"></script>// 导入excelreadWorkbookFromLocalFile(fileData) {// 文件信息const file f…

【优选算法】——双指针(上篇)!

&#x1f308;个人主页&#xff1a;秋风起&#xff0c;再归来~&#x1f525;系列专栏&#xff1a;C刷题算法总结&#x1f516;克心守己&#xff0c;律己则安 目录 前言&#xff1a;双指针 1. 移动零&#xff08;easy&#xff09; 2. 复写零&#xff08;easy&#xff09; 3…