利用Docusaurus搭建个人网站
node.js(包含npm、npx)的安装
不推荐使用sudo apt install node.js
的方式安装,这种方式会安装老版本的node。
1、到https://nodejs.org/en/download/
找到相应操作系统的下载链接
2、wget https://nodejs.org/dist/v14.17.6/node-v14.17.6-linux-x64.tar.xz
下载node.js
3、tar -xvf node-v14.17.6-linux-x64.tar.xz
解压,解压后得到/node-v14.17.6-linux-x64
的目录
4、cd /node-v14.17.6-linux-x64/bin
找到可执行文件所在路径。注意将文件夹名改为自己的,下同。
5、将可执行文件所在路径添加至PATH变量:在~/.bashrc
文件中添加export PATH=$PATH:/home/ksm/node-v14.17.6-linux-x64/bin
。
6、分别为node、npm、npx在/usr/bin下建立软链接(这样才可以用sudo npm或sudo npx来赋予管理员权限):
sudo ln -s /home/data/node-v14.17.6-linux-x64/bin/node /usr/bin/node
sudo ln -s /home/data/node-v14.17.6-linux-x64/bin/npm /usr/bin/npm
sudo ln -s /home/data/node-v14.17.6-linux-x64/bin/pm2 /usr/bin/npx
Docusaurus搭建
1、任意切换到一个目录,如~/
。
2、运行指令sudo npx @docusaurus/init@latest init [name] [template]
该指令将在当前目录下创建name文件夹,并自动下载template模板。
如:
sudo npx @docusaurus/init@latest init my-website classic
将新建my-website文件夹
2.1、测试Docusaurus搭建的效果:首先进入项目的文件夹cd my-website
。然后运行指令sudo npm run start
进行试运行,该指令会将网站架设在本地计算机的3000端口上。此时只需要在浏览器输入http://localhost:3000
即可会网站进行访问。
3、生成静态网站。Docusaurus 是一个的静态网站生成器,首先需要进入项目目录cd my-website
。然后运行sudo npm run build
,编译生成静态网站(会在my-website目录下生成build目录,该目录下包含了网站的所有信息)。
生成静态网页后,最好修改其权限
sudo chmod 777 build
4、将生成的build文件夹移动到apache2指定的网站根目录,即可通过浏览器访问网站。
参考文献: Docusaurus 中文网 官方github仓库
将模板修改为博客网站
docusaurus.config.js
1、将{to: '/blog', label: blog', position: 'left'}
,修改为{to: '/', label: '博客', position: 'left'},
2、将
{
type: 'doc',
docId: 'intro',
position: 'left',
label: 'doc',
},
修改为
{
type: 'doc',
docId: 'intro',
position: 'left',
label: '技术文档',
},
3、将presets:
下的blog:
修改为
blog: {
path: "./blog",
routeBasePath: "/",
showReadingTime: true,
// Please change this to your repo.
editUrl:'https://github.com/facebook/docusaurus/edit/main/website/blog/',
},
index.js
将src/pages/index.js
的文件名改为src/pages/index.js.bak
这样才能实现更换主页。