如何更改通过下载角色引用的文件的文件路径以不使用散列文件夹？答案

【问题标题】：How can I change the file path of files referenced via the download role to not use a hashed folder?如何更改通过下载角色引用的文件的文件路径以不使用散列文件夹？
【发布时间】：2022-01-06 12:27:44
【问题描述】：

我想在我的项目中提供一个文件的链接，但我希望这个链接是人类可读和永久的。

这样做：

Link to file for reference :download:`myfile.json <../myproject/myfile.json>`.

生成如下所示的链接：

...../myproject/docs/_build/html/_downloads/b4c73f3851c188db23a20daeed2c/myfile.json

我可以控制这个吗？我希望链接是这样的：

...../myproject/docs/_build/html/_downloads/myfile.json

我实际上希望链接位于根目录中，所以它只是：

...../myproject/myfile.json

【问题讨论】：

目前没有，开箱即用。有一个未解决的问题：github.com/sphinx-doc/sphinx/issues/823
这是否意味着每次我更改文件时都会更改路径？

标签： python-sphinx restructuredtext

【解决方案1】：

download role 执行文档中所说的操作，即，它创建具有唯一哈希的链接。除非更改实现，否则我看不到解决方法。

但是

我实际上希望链接位于根目录中

在这种特殊情况下，我们可以（ab）使用html_extra_path，将其添加到conf.py

html_extra_path = ['../myproject/myfile.json']

并使用常规hyperlink 引用文件：

Link to file for reference `myfile.json <myfile.json>`_.

该文件必须位于（构建的 HTML 文档的）根文件夹中，正如 html_extra_path 所做的那样。不能放在_downloads等子文件夹中。

【讨论】：