【问题标题】:Link an "external" file in docsify在 docsify 中链接“外部”文件
【发布时间】:2020-04-13 18:33:52
【问题描述】:

这是我的文档文件结构

|__docs/
| |__config-docsify.js
| |__index.html
| |__README.md
|__README.md

如您所见,Docsify 文件位于 docs/ 目录中,我想将 /docs/README.md 文件链接到 README 文件 (/README.md) 的根目录。即,当我单击 /docs/README.md 文件中的链接时,我会被重定向到 /README.md 文件,或者至少我以某种方式获得了它的内容。

但是,当我尝试添加这样的链接时

<!-- projectfolder/docs/README.md file -->
See the [README](../README.md) file in the root directory.

我被重定向到不存在的localhost:3000/../README.md

有人知道如何链接不在 docsify 文件的同一文件夹(或子文件夹)中的文件吗?


编辑

我正在使用 docs 文件夹提供服务

docsify serve docs/

【问题讨论】:

  • 看看这个,它可能会有所帮助:docsify.now.sh/configuration?id=relativepath
  • @alcaprar 我试过你的建议,但它仍然不起作用。我试图与basePath 结合,但没有。可能该文件无法访问,因为 docsify 提供的文件夹与我尝试打开的文件处于同一级别。你怎么看?
  • 是的,我认为你是对的。 Docsify 应该为 docs 文件夹内的所有内容提供服务(所有内容都在 index.html 的同一级别)

标签: docsify


【解决方案1】:

您可以使用嵌入文件嵌入外部文件(或 raw.github...):https://docsify.js.org/#/embed-files

【讨论】:

  • 我试过你的建议,但还是不行。我更新了问题,说我正在为docs 目录提供服务。也许这就是它无法获取 README 文件的原因。他们都在同一级别。
  • 如果托管在guthub上,您可以获得原始文件而不是使用文件路径。因此,您的路径可能类似于:https://raw.githubusercontent.com/&lt;user&gt;/&lt;repo&gt;/master/README.md
  • @Blizzard 这行得通,甚至在文档中也有提及,但它仅在文档在线托管后才有效。您无法在本地系统上使用实时预览对其进行测试。
  • 我可以使用docsify serve /path/to/site 进行测试,然后导航到本地地址。
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 2021-08-19
  • 1970-01-01
  • 2023-03-07
  • 2019-04-28
  • 2012-11-07
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多