跳转到主要内容

Sphinx扩展,用于生成JavaScript驱动的重定向,用于已移动的页面

项目描述

此贡献扩展程序 sphinxcontrib.redirects,为Sphinx提供了一个扩展,用于生成JavaScript驱动的重定向,用于已移动的页面。它目前仅支持 html 构建器 (sphinx.builders.html.SingleFileHTMLBuilder)。

用法

要启用此扩展,您应将其添加到您的 conf.py 文件

extensions = [
    'sphinxcontrib.redirects',
    ...
]

此扩展依赖于一个 重定向文件。默认情况下,此文件位于源目录中的 redirects,但它可以被覆盖。要覆盖此值,请将以下内容添加到您的 conf.py 文件中

redirects_file = '<path to redirects file>'

重定向文件 是一个简单的空格分隔的 old_path - new_path 对的文件。这些路径相对于源目录,应包括它们的扩展名。例如,如果您将文件 test.rst 重命名为 testing.rst,则可以编写

test.rst testing.rst

这也适用于在不同目录之间移动的文件。如果您将 test.rst 移动到 testing/index.rst,则可以编写

test.rst testing/index.rst

有关示例,请参阅 tests 中使用的示例。

贡献

有关贡献的信息,请参阅 贡献指南

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

sphinxcontrib-redirects-0.1.0.tar.gz (7.2 kB 查看哈希值)

上传时间 源代码

构建分发

sphinxcontrib_redirects-0.1.0-py3-none-any.whl (5.6 kB 查看哈希值)

上传时间 Python 3

支持者