跳转至

内链

符号细则#

GibboK 在 stackoverflow 分享了以下列表:

符号 意义
/ Root directory
. This location
.. Up a directory
./ Current directory
../ Parent of current directory
../../ Two directories backwards

演示测试#

[CSGO](../game/CSGO.md)
[CSGO](../game/CSGO.md)
[CSGO](./game/CSGO.md)
[CSGO](../game/CSGO.md)

[CSGO](../game/CSGO)
[CSGO](../game/CSGO)
[CSGO](./game/CSGO)
[CSGO](../game/CSGO)

以上这些内部链接,只有 [CSGO](../game/CSGO.md) 这样的效果最好,该方法来自于 froschdesignlink in page goes to a relative path 这个 Issues 的回答。

所以此 Wiki 的内链全部都使用 ../ 这样的格式。

主要原因是 [CSGO](../game/CSGO.md) 这样的内链会声称 /game/CSGO.md 这样的域名,而不是 /game/CSGO.html 这样的域名。

详情跳转至 mkdocs 指南的 Linking to pages 条目。

之所以我需要使用完整的路径,是因为我主要会使用 VS code 编辑这些条目,而 mkdocs 没有支持绝对路径,所以可以使用一个更好的插件: abs-to-rel 。

abs-to-rel#

GitHub 简介如下:

Mkdocs absolute to relative link converter1

Mkdocs officially only supports relative links. While this makes sense there are situation where it is useful to make use of absolute links. For example when creating a document with absolute links to an image folder. If that file is to be moved later on, links are kept intact.

这是一款非常棒的插件。

(由于更新时间是手动更新的,所以部分页面内容已更新,但忘记修改新的日期了……)