Debian系统快速搭建vuepress知识库/个人博客

VuePress 是一个以 Markdown 为中心的静态网站生成器。你可以使用 Markdown在新窗口打开 来书写内容（如文档、博客等），然后 VuePress 会帮助你生成一个静态网站来展示它们。

VuePress 诞生的初衷是为了支持 Vue.js 及其子项目的文档需求，但是现在它已经在帮助大量用户构建他们的文档、博客和其他静态网站。

安装Node.js

安装软件包和更新组件

apt --fix-broken install
apt update -y && apt upgrade -y

安装pm
sudo apt-get install npm
安装pnpm
npm install -g pnpm yarn

查看Node版本是否大于v18.16.0

node -v

手动更新Node.js

创建并进入一个新目录

sudo mkdir /usr/local/lib/nodejs

cd /usr/local/lib/nodejs

下载新版文件包

wget https://npmmirror.com/mirrors/node/v20.10.0/node-v20.10.0-linux-x64.tar.xz

解压文件包

sudo tar -xJvf node-v20.10.0-linux-x64.tar.xz

编辑环境变量文件

echo export PATH=/usr/local/lib/nodejs/node-v20.10.0-linux-x64/bin:$PATH >>~/.bash_profile

加载该文件使设置生效

source ~/.bash_profile

查看版本是否v20.10.0

node -v

如果报错，就安装GCC

GLIBCXX_3.4.20 not found 问题解决

安装vuepress

返回根目录

CD

创建并进入一个新目录

mkdir vuepress-starter
cd vuepress-starter

初始化项目

git init
pnpm init
安装 VuePress
pnpm add -D vuepress@next @vuepress/client@next vue

刷新目录，打开文件/root/vuepress-starter/package.json替换下面的代码

{
  "name": "vuepress-starter",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "docs:dev": "vuepress dev docs",
    "docs:build": "vuepress build docs"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@vuepress/client": "2.0.0-rc.0",
    "vue": "^3.3.9",
    "vuepress": "2.0.0-rc.0"
  }
}

将默认的临时目录和缓存目录添加到 .gitignore 文件中

echo 'node_modules' >> .gitignore
echo '.temp' >> .gitignore
echo '.cache' >> .gitignore
创建你的第一篇文档

mkdir docs

echo '# Hello VuePress' > docs/README.md

启动服务

pnpm docs:dev

这时打开http://你的IP地址:8080，会显示VuePress主页

安装增强主题

进入安装目录

cd vuepress-starter

在 [dir] 文件夹内创建 vuepress-theme-hope主题，[dir]为你自定义的名字

pnpm create vuepress-theme-hope [dir]

然后根据每一步提示进行安装

最后使用自己的域名在Nginx里开启反向代理