目录

博客搭建过程记录

# 1. 准备

如果要搭建博客,先问自己是需要静态网页还是动态网页,用哪个博客框架。

当然我建议用那些生态丰富一些的框架(Hexo 等)。

至于我为什么采用 Vuepress,是因为 Vuepress 文章支持 Vue 语法,可以用 Vue 写一些有趣的程序。

缺点的话,Vuepress 主题有些少,对新手不够友好,构建速度也不是很满意(也许有加速的方法?)。

# 2. 前置知识

JavaScript / NodeJS 的简单语法。(虽说配置文件里只用到了对象、数组、字符串等,但是不敢保证没基础弄得懂)

NPM 的使用方法(install, run, build),知道依赖、构建、本地服务器等概念。

Git 的基本操作。

Vuepress 的基本操作。

# 3. 大致流程

有两种方式使用主题,一个是先初始化 Vuepress 项目,然后安装主题并修改 config;另一个是克隆主题作者已经搞完的 Github 仓库。

个人感觉,后者配置有些复杂,想要简化却不敢删看不懂的代码。

所以我从空的项目出发,一步步增加功能,这样比较顺利。

# 4. 踩坑记录

// 可能换个主题就没这些问题了。

如何调用 js 文件:写在 ./vuepress/components 里,然后 import xx from './xx.js'

图标无法根据深色 / 浅色模式来作出相应变化。

代码块中的行号位置不正确,只好设为不显示。

修改文章的目录结构,需要重新启动项目才会生效。

one-click-copy 插件,复制按钮点击后弹出的消息会被遮挡,解决方法:在 /docs/.vuepress/styles/palette.styl 中添加内容:

#message-container {
  z-index: 2000;
}