Vuepress建站详细教程
环境:Ubuntu,注意,如果是全新的没有安装过奇奇怪怪环境的系统,按照下面的步骤肯定一点问题都没有。
详细步骤
环境准备
nodejs安装配置
这里是一个踩坑点
首先正常的更新一些,sudo apt update
,sudo apt upgrade
。
安装npm,sudo apt install npm
,这里安装的肯定是旧版。
截至2022年一月,最新的nodejs稳定版是16,但是我下载过程中16一直下载失败,所以选择下载14。
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt install nodejs
可能速度会慢,甚至看上去像是卡住了,但是实测可以安装14版本的nodejs。
安装yarn
只要前面的没问题,安装yarn就很简单了:sudo npm install --global yarn
安装配置vuepress
创建一个文件夹用于存放文件sudo mkdir new
,cd new/
。
初始化yarn:sudo yarn init
,这时候会要求输入很多信息,你可以一直按enter以设置默认信息,也可以自定义。
安装vuepress:
sudo yarn add -D vuepress
尝试使用vuepress
在new/
下面新建文件夹docs
,这个文件夹名字不要自定义。
进入cd docs/
,新建sudo vim README.md
,写入任意内容,保存退出。(默认会使用vim,如果不会的话用任何编辑器,反正新建个这个文件,写点东西进去)
退回/new/
,对文件夹内的package.json
添加内容,按照下面的实例:
{
"name": "press",
"version": "1.0.0",
"description": "test",
"main": "index.js",
"repository": "",
"author": "test",
"license": "MIT",
"devDependencies": {
"vuepress": "^2.0.0-beta.26"
},
"scripts": {
"docs:dev": "vuepress dev docs",
"docs:build": "vuepress build docs"
}
}
第十行的逗号不要丢!
第十行前面不需要修改,是你yarn init自定义的内容。
预览
sudo yarn docs:dev
即可开启预览,默认端口8080,如果你是在本地运行,直接浏览器输入localhost:8080
,如果是在云服务器,注意先去控制台的防火墙,打开8080端口,然后在执行预览。这时候你可以在浏览器输入服务器IP地址:8080,例如xxx.xxx.xxx.xxx:8080