npm yarn docusaurus

最近要自己安装一个Docusaurus便于查看md文档.它是基于nodejs编写的静态web网站.这里记录一下windows环境安装步骤.

安装流程:

1 安装nodejs
2 安装yarn,进行依赖管理.
3 下载docusaurus
4 启动docusaurus

1. 安装nodejs

安装nodejs

2. 安装yarn

yarn是nodejs的依赖管理工具.这里直接执行nodejs命令即可

// 全局安装yarn
npm install [-g] yarn
// 检测安装是否成功
yarn -v

windows环境下需要配置环境变量才能全局执行.yarn是nodejs的一个模块,如果全局安装它会在nodejs的 nodejs_home\node-global 目录下.可以通过 c:\USER_HOME.npmrc文件查看nodejs的环境配置信息.然后进行环境变量配置

安装yarn

3. 下载docusaurus

有两种方式:

  a 是直接从github下载源码进入项目根目录下执行yarn install
  b 执行命令 npm init docusaurus@latest website classic

推荐使用b方式,a方式本地实测存在文件名过长造成启动失败的问题.

4. 启动

执行命令:

cd website
yarn start

效果:

• 文件过长问题解决尝试,最终没有成功

github问题描述

文件名过长解决方式: 是修改注册表中长度控制,修改方式查询了两种,但是都没有成功
微软推荐解决方式
cmd regedit