利用Docusaurus搭建个人网站

» 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

参考链接:sudo运行npm/node出现找不到命令情况

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这样才能实现更换主页。