如何在RST文件中用%APPDATA%创建独立于用户的本地文件链接？

浏览器不支持解析Windows环境变量（如%APPDATA%），直接写在RST的file://链接里会导致无法找到文件，以下是几种可行的解决方法：

• 预编译脚本替换环境变量
  在生成HTML前，用脚本把RST中的环境变量替换为实际路径。比如用Python实现：

  import os
  
  # 读取原始RST文件
  with open("你的文档.rst", "r", encoding="utf-8") as src_file:
      rst_content = src_file.read()
  
  # 获取实际APPDATA路径并转义为URL兼容格式
  appdata_path = os.environ["APPDATA"].replace("\\", "/")
  processed_content = rst_content.replace("%APPDATA%", appdata_path)
  
  # 保存处理后的RST文件，再用工具生成HTML
  with open("处理后的文档.rst", "w", encoding="utf-8") as dest_file:
      dest_file.write(processed_content)
  

  处理后的RST链接会变成类似The link to my file <file:///C:/Users/你的用户名/AppData/Roaming/Apps/myfile.html>_，浏览器可以正常解析。

• 使用相对路径（场景受限）
  如果目标本地文件和最终生成的HTML文件有固定的相对位置关系，可以改用相对路径。比如HTML在build/html目录，目标文件在同级的apps文件夹，链接可写为The link to my file <../apps/myfile.html>_，但这种方式只适用于文件位置固定的情况。

• 自定义RST扩展（适合频繁需求）
  若使用Sphinx构建文档，可以编写一个简单扩展，在解析RST时自动识别并替换链接中的环境变量。核心逻辑是在文档构建阶段，遍历链接节点，将环境变量替换为系统实际路径。

内容的提问来源于stack exchange，提问作者PiWi