笔者在学习使用Slidev的过程中,遇到了各种各样奇怪的问题,遗憾的是Slidev总的来说还算是个小众的工具,在网上能搜到的解决方案并不多。因此,我打算将我遇到的问题做个总结并给出解决方案,算是自己淋过雨,给别人带把伞吧。如果帮到了你,记得点个赞哦!

安装/使用

0. 根本不知道如何开始使用

emm…官方文档确实太简洁了。

终端切换到想做成幻灯片的md文件目录下。使用

slidev xxx.md

命令即可

1.slidev不是可执行命令

笔者之前没有node.js经验,因此在跟着b站某视频学习使用yarn全局安装后,Powershell没有识别到slidev命令。

解决方案:为yarn配置全局安装的环境变量,自行搜索即可。

2.yarn安装后有各种问题

建议还是用npm全局安装吧…也不知道是什么玄学。

3.安装主题出错

大部分人在使用slidev时碰到此问题。

如果不使用官方建议的快速初始化命令,而使用全局安装等方法用来打开自己的md文件时,首先会提示你安装@slidev/theme-default主题,当你按下y后,主题下是下好了,但是报一堆error。

解决方案:使用yarn全局安装:

yarn global add @slidev/theme-default

注意,只有官方主题才是@slidev/theme-开头,其他社区主题请复制主题的GitHub仓库名。

再打开如果还不能使用,把包卸载了装0.29.2版本。

npm i -g @slidev/cli@0.29.2

静态部署

静态部署之前,先装好Vite包。并且需要在项目根目录下自行创建`\dist`文件夹。

完成以上步骤后,使用以下命令导出文件包:

slidev build [xxx.md]

slidev官网推荐了几种方法,个人推荐初学者使用Netlify,真的很方便。

在Netlify创建好账号后,来到个人主页,下拉找到Sites,点击Add new site,点击Deploy manually

把dist文件夹丢过去就可以啦!

官方文档建议创建netlify.toml文件,不过我试了一下,好像加不加没啥问题……

丢过去之后,等一会儿就会为你生成一个网站,默认为你分配它的二级域名xxx.netlify.app,当然你也可以把你自己的域名分配给它。

点击site settings,就可以更改网址名了。当然只能改`xxx`里的内容。

 

 

 

精彩文章

评论可见,请评论后查看内容,谢谢!!!评论后请刷新页面。