GitLab:从议题等链接Wiki页面的最佳方式及../数量?
GitLab Wiki页面链接最佳实现方式
推荐方案:优先使用项目内绝对路径
不管你是从议题、任务、仓库文件还是其他Wiki页面链接,绝对路径是最可靠的选择——完全不需要计算../的数量,也不会因为页面位置变动导致链接失效。
具体写法
- 完整绝对路径:
/命名空间/项目名/-/wikis/页面名称
例:若项目属于dev-team,项目名为web-app,Wiki页面是部署手册,则链接为/dev-team/web-app/-/wikis/部署手册 - 同项目内简化写法:
/-/wikis/页面名称
GitLab会自动识别当前项目,无需重复写命名空间和项目名
相对路径的使用(仅Wiki内部互链)
如果只在Wiki页面之间互链,且确定页面层级不会变动,可酌情使用相对路径:
- 同一层级页面互链:直接写页面名,如
[部署手册](部署手册) - 子页面跳父级页面:用1个
../,如在文档/部署手册页面链接根级首页,写法为[首页](../首页) - 父级页面跳子页面:直接写子页面路径,如
[部署手册](文档/部署手册)
但相对路径弊端明显——一旦页面移动层级,所有相关链接都会失效,因此不建议跨场景使用。
议题/任务/仓库文件中的链接注意事项
在这些场景下,绝对路径是唯一靠谱的选择。因为议题、任务、仓库文件和Wiki页面的层级关系不固定,根本没法确定需要多少个../,强行使用相对路径极易出错,绝对路径能一劳永逸解决问题。
内容的提问来源于stack exchange,提问作者McStack
相关产品推荐
相关产品推荐

