部署文档网站
· 阅读需 2 分钟
.png)
2023 Para team number
Ubuntu配置docusaurus环境
安装nodejs
curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install -y nodejs
安装Yarn
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update
sudo apt install yarn
安装
npx create-docusaurus@latest my-website classic
Rocky linux配置docusaurus环境
安装nodejs
curl -fsSL https://rpm.nodesource.com/setup_20.x | bash -
yum install -y nodejs
安装Yarn
curl --silent --location https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo dnf install yarn
安装
npx create-docusaurus@latest my-website classic
运行
cd my-website
npm start -- --port 5000
导出部署
导出静态文件,导出到build文件夹中
npm run build
部署测试
npm run serve
项目结构
my-website
├── blog
│ ├── 2019-05-28-hola.md
│ ├── 2019-05-29-hello-world.md
│ └── 2020-05-30-welcome.md
├── docs
│ ├── doc1.md
│ ├── doc2.md
│ ├── doc3.md
│ └── mdx.md
├── src
│ ├── css
│ │ └── custom.css
│ └── pages
│ ├── styles.module.css
│ └── index.js
├── static
│ └── img
├── docusaurus.config.js
├── package.json
├── README.md
├── sidebars.js
└── yarn.lock
添加对Latex公式的支持
参考官方的教程官方Latex插件教程
记得看官方的示例
插件的KaTeX CSS添加错位置会导致公式渲染错误！！！！
（也可以参考这个站的配置文件）
经验
下面这种单独出现的大写字母要放在``里，不然会报错
h t ml添加的图片不要加zoom，不然会报错
