1. 如何维护本文档

1.1. 安装git,并clone该仓库到本地

安装git,clone该项目到本地

http://192.168.10.185:8081/whrdc/igis-docs.git

1.2. 安装WSL2

windows下建议使用WSL环境

windows默认开启的是WSL1,建议升级到WSL2

下载并安装 wsl_update_x64 http://172.20.20.190/software/wsl_update_x64.msi

powershell输入命令

设置默认版本为2

wsl –set-default-version 2

查看已安装发行版的版本

wsl –list -v

转换发行版的版本

wsl –set-version Debian 2

转换很慢,强烈建议删除发行版重新安装

如果重新后WSL系统内无法联网

wsl –shutdown

再开启就行了

1.3. 安装VScode及插件

安装VSCode 为了方便编写表格,vscode 安装插件 vscode-table-formatter

vscode左下角切换WSL模式

../_images/vscode-wsl.png

选择reopen folder in wsl

1.4. 依赖安装(仅需一次)

打开terminal

python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

1.5. 编译发布

source venv/bin/activate

docs根目录下运行make html

可直接打开build/html/index.html预览

如需发布运行./deploy.sh