我们的gitbook文档必须具有指向同一服务器上位于其他位置的其他文档的交叉链接。
我们有以下链接:
<a href="/stuff/documentation/api-reference.html">API Reference</a>
[API Reference](/stuff/documentation/api-reference.html)
这两个链接都被Gitbook转换为相对于当前页面的链接(这是针对嵌套比索引页面深1级的页面):
<a href="../stuff/documentation/api-reference.html">API Reference</a>
如果带有链接的页面嵌套得更深:
<a href="../../../stuff/documentation/api-reference.html">API Reference</a>
我们需要的是Gitbook,以使链接中的相对URL保持“原样”,这样它们将在最终文档服务器上指向正确的路径:
<a href="/stuff/documentation/api-reference.html">API Reference</a>
到目前为止,唯一可行的解决方案是将JS代码放入markdown内的HTML <a>
标签中所需的相对路径,但这是一个非常丑陋的解决方法。