vuepress安装时遇到的问题

首先需要安装nodejs,然后打开dos窗口,转换到nodejs路径下

npm install -g vuepress

运行上边的命令后报了一大串npm WARN deprecated ***,然后运行vuepress -v提示vuepress不是内部命令之类的,说明没安装成功

看了很多文章没有找到适合的解决方案

就根据log里看到的路径C:\Users\Administrator\AppData\Roaming,把这个路径下的npm文件,和npm_cache文件全部删掉

重新执行

npm install -g vuepress

这次只报了四个deprecated和其他一大堆warn,然后执行vuepress -v就打印出了当前vuepress的版本信息,安装成功!

vuepress中文文档

根据文档开启vuepress探索之路吧

vuepress使用时遇到的问题

# 开始写作
vuepress dev .

# 构建静态文件
vuepress build .

vuepress dev . 类似于启动命令,完成之后如下

vuepress api文档_前端

在浏览器里输入打印出的路径,就可以展示README.md的信息啦,当然还有其他的一些效果,比如config.js中配置的主题

如果想要继续使用命令操作需要重新打开一个git-bash窗口,我很傻很天真(chun)的以为就在这页面开始编辑了,然而怎么也退不出去,实际上是告诉你可以编辑你的README.md了

如果在新的窗口重新运行vuepress dev . 命令,会在新的端口启动一个新的服务,需要关掉服务就要把窗口关闭(目前我还不知道其他方式)

对README.md文件的修改会立刻反应到网页中,但是对config.js的修改需要重启,使用vuepress build . 命令也没有起作用

vuepress发布代码到github遇到的坑

需要安装git,然后运行git-bash.exe,在这个窗口中使用linux命令

运行发布到github的shell脚本出现以下错误

vuepress api文档_vuepress api文档_02

需要把deploy.sh移到了package.json同级目录

然后再次运行出现了加载的过程,当时一阵激动以为要成功了,结果加载完还是报了错

vuepress api文档_git_03

原因是这是我第一次使用git

第一次使用git时需要和github建立信任关系

上边引用文章中容易引起误会的地方:

  1. user.email 是你github的邮箱,user.name是github的用户名,不是密码,
  2. 生产秘钥对的时候有好几个enter,那里不用输入字符,直接回车就可以

除此之外在github的settings里需要设置github pages的source,把None修改成其他的

vuepress api文档_github_04

如果有不正确的地方,欢迎指正,感谢!