企业官网建设流程全解析

1. 使用方式

1.1. 执行环境

在能够访问石墨文档的 Windows 环境中执行后续步骤

1.2. 从石墨文档下载文件

1.2.1. 获取附件

打开 Github releases 页面 https://github.com/Adrninistrator/download_shimo_docs/releases 下载附件“download_shimo_docs.zip”到本地并解压

以上附件中包含了完整的 Python 运行环境、依赖库及 Python 脚本，不需要额外安装 Python 环境

1.2.2. 修改配置文件

使用文本编辑器打开配置文件 config.properties，并修改以下参数

或者双击执行“edit.bat”脚本，使用记事本打开以上配置文件

1.2.2.1. sleep_time_seconds

当前参数用于指定每次请求石墨文档前等待的时间间隔，避免触发限制

单位为秒，支持指定浮点数，如“0.1”

若为 0 代表每次请求前不等待

1.2.2.2. root_folder_guid

当前参数用于指定需要下载的石墨文档工作空间或目录的 guid

可通过以下方式获得：

使用浏览器打开石墨文档网站并登录： https://shimo.im/

打开需要下载的石墨文档工作空间或目录，复制 URL 中最后的一串字符串作为当前参数值

例如打开石墨文档的工作空间后，URL 为“https://shimo.im/space/aaaaaaaaaaaaaaaa”，则当前参数需要指定为“aaaaaaaaaaaaaaaa”

假如打开石墨文档的目录后，URL 为“https://shimo.im/folder/bbbbbbbbbbbbbbbb”，则当前参数需要指定为“bbbbbbbbbbbbbbbb”

1.2.2.3. local_root_dir

当前参数用于指定需要下载的石墨文档文件保存到本地的根目录路径

1.2.2.4. cookie

当前参数用于指定本地浏览器打开石墨文档网站后的 Cookies

可通过以下方式获得：

使用 Chrome 等浏览器打开石墨文档网站并登录

按 F12 打开 Chrome 开发者工具

切换到“Network”标签页

等待浏览器自动刷新，或者人工刷新浏览器

查看 Chrome 开发者工具“Network”标签页，点击任意请求，例如“files?folder=xxx”

下拉到“Request Headers”，三击“Cookie”后面的内容并复制

这样会得到很长一串字符串，内容全部作为当前参数值

1.2.2.5. 完整示例

sleep_time_seconds = 0 root_folder_guid = aaaaaaaaaaaaaaaa local_root_dir = E:/my-desktop/temp/test_docs cookie = xxx

1.2.3. 执行程序

双击“run.bat”脚本开始下载石墨文档文件到本地

1.2.4. 执行结果检查

在附件解压的目录，会生成“log”目录，其中保存了执行的日志文件

检查下载的石墨文档文件保存到本地的根目录，是否包含了对应的文件

石墨文档的“文档”、“传统文档”、“表格”、“幻灯片”，分别会保存为后缀为“.docx”、“.docx”、“.xlsx”、“.pptx”的文件

其他的文件类型，保持原有的文件类型