【问题标题】:Publish Word documents with Sphinx使用 Sphinx 发布 Word 文档
【发布时间】:2016-10-26 19:56:26
【问题描述】:

我的项目正在将其文档从 Word 文档转换为 Sphinx。带有 Sphinx 输出的 Intranet 页面已经启动并运行。

我们想做的是让 Sphinx 也将 Word 文档复制到 Intranet 页面,并从第一个文件中引用带有超链接的那些。最好以这样的方式仍然可以阅读明文链接(例如,对./file.doc 的引用是完全可以接受的)。

文档不需要indexed,也不需要转换或生成 - 只需发布即可。

有什么方法可以让 Sphinx 做到这一点,还是我需要手动构建一些脚本?

【问题讨论】:

  • 我不确定我是否理解这个问题,但也许您可以使用download 角色:sphinx-doc.org/en/latest/markup/inline.html#role-download
  • “最好以这样的方式链接在明文中仍然可读”。这是什么意思?明文不可读的链接是什么样的?
  • @mzjn 如果链接是完全限定的 URL,那将被视为“纯文本不可读”。
  • @mzjn download 角色正是我所需要的,谢谢!如果你把它放在一个答案中,我可以接受它。

标签: ms-word python-sphinx


【解决方案1】:

download 文本角色可以用来做你想做的事。从以下标记中,Sphinx 会将 Test.docx 复制到输出目录的_downloads 子目录并生成一个链接:

See :download:`this Word document <../Test.docx>`.

【讨论】:

    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 2017-01-16
    • 1970-01-01
    • 1970-01-01
    • 2018-12-02
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多