建站日志(未完结)
前言
Q:为什么我要搭建一个笔记网站
A:因为我在做软件开发学习时发现我需要将某些重要的代码逻辑功能记录下来,以便我日后要修改代码时可以快速理解代码功能,vitepress是一个可以快速上手创建一个文档网站的静态站点生成器, 而文档的编写语言采用的是markdown语法, markdown是一个对程序员记笔记很友好的语言,于是我选择使用markdown做笔记
一、vitepress搭建
- 准备工作
- 安装node.js
版本:v18.20.4
- 安装npm
安装好node.js后npm也会一并安装
- 搭建过程
- 我是通过视频学习vitepress搭建的,非常感谢AZ_Channel的视频经验分享
- 搭建好网站后,为了更好的做笔记,开始学习markdown语法
- markdown语法和插件设置,我是参考了毛怪的学习日记的视频讲解
- 因为vitepress原生的markdown不支持数学公式渲染和mermaid,所以需要自行安装配置。
- 参考安装方法TeX和vitepress-plugin-mermaid
- 我是通过视频学习vitepress搭建的,非常感谢AZ_Channel的视频经验分享
bug解决
1. mathjax3滚动条
非常恶心人啊,这个滚动条,手机游览的时候,不小心一划,公式就给划没了,电脑也是,滚轮一滚就没了。
解决方案:
可以在style.css中添加一段禁用滚动条指令
css
/* 禁用mjx的滚动条 */
mjx-container {
overflow-y: hidden;
}