内部网络与外部网络不进行网络互通,进行组件查询及使用时,比较低效,如何能把ant-design的开发手册拿入到内网,作为帮助文档使用,是当前使用React开发的当务之急,那如何把ant-design在内网本地化部署呢?
部署方案
内网本地化部署,打算采用nginx+ant-design静态包部署,该过程中的难点是如何把ant-design的使用文件整包打下来。这里使用了Save_All_Resources_0.1.8.crx【提取码:6jqv 】的谷歌插件,可以把你在界面操作的网站保存下来。这里提供我打包好的静态文件:ant-design-site4.15.5.zip【提取码:34wp】,可以把该文件解压之后放在nginx的html目录下。
操作步骤
当前环境依赖node环境,这里不给出安装操作手册,关于node的环境部署可以从网上自行百度下载。
首先,生成site文件
我从github上获取的版本是4.15.5,下载并解压:
进入到ant-design-4.15.5目录下执行命令:
npm install
npm run site
命令执行完毕会在该目录下生成一个目录_site的文件。
其次,获取页面链接文件
进入到ant-design 选择到版本4.15.5,然后操作页面,一定要点击完所有页面,不然静态文件下载补全,会造成页面元素显示不全的情况。下图是插件页面:
这是保存的网站静态资源包,我主要获取红色框选出来的网站中的所有内容:
然后,把资源信息放入nginx的html
首先,把nginx的html目录下的文件全部删除,然后把_site目录下内容粘贴到html路径下。
然后,把插件抓包网站内容放入到html目录下:
然后,调整html目录下index.html、index-cn.html
本人使用的是vs code打开html:
调整index.html,移除该页面除了如下Script脚本的所有script标签:
<script src="/index-62c75dc8.js"></script>
调整index-cn.html,移除该页面除了如下Script脚本的所有script标签:
<script src="/index-62c75dc8.js"></script>
然后,查找替换html下的链接资源
把https://gw.alipayobjects.com替换为http://localhost
查找替换之后验证:
最后,断开网络链接验证
遗留问题
1、在设计页面,点击中文、英文,会跳转到404页面,但在组件页面切换中英文正常,然后再切换到其他页面中文显示正常
2、组件总览页面图片显示补全:
3、不支持离线组件查询。
上述图片显示不全的问题是由于,我没有充分点击页面,导致静态资源某些图片缺失。