博客搭建过程记录
# 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;
}