如何维护本文档
================================================================================

安装git，并clone该仓库到本地
--------------------------------------------------------------------------------

安装git，clone该项目到本地

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

安装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

再开启就行了


安装VScode及插件
--------------------------------------------------------------------------------

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

vscode左下角切换WSL模式

.. image:: ./vscode-wsl.png

选择reopen folder in wsl


依赖安装（仅需一次）
--------------------------------------------------------------------------------
打开terminal

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

编译发布
--------------------------------------------------------------------------------

source venv/bin/activate

docs根目录下运行make html

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

如需发布运行./deploy.sh