Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 1.78 KB

File metadata and controls

47 lines (33 loc) · 1.78 KB

介绍在GitBook中如何进行交叉引用 参考:这里

绝对引用与相对引用

所谓的绝对引用就是用URL的形式来进行,这样导出的PDF即使是同一书籍内的引用也不能跳转,而且一旦URL发生变化,带来的工作量是巨大的,这里只是区别一下,以下内容不对绝对引用进行介绍。

相对引用

例如我们有如下目录

ch1/art1.md
    # head1 
         text
    # head2
ch1/art2.md
    # head3
    # head4
ch2/art3.md
    # head5 {#anchor1}
    # head6
ch2/art4.md
art5.md
  1. 需求1:在text处链接head2 -> [name](#head2)
  2. 需求2:在text处链接art1.md -> [name](./art1.md)
  3. 需求3:在text处链接art3.md -> [name](../ch2/art3.md)
  4. 需求4:在text处链接head3 -> [name](./art2.md#head3)
  5. 需求5:在text处链接head5 -> [name](../ch2/art3.md#head5)

使用anchor

有的时候我们的head 可能是中文,这就不好操作了,于是有了下面的方式:

head1 {#anchor-name} link to head1 -> [name](#anchor-name)

此方式相当于给每个head关联了一个ID,以消除中文的不便。

对于不是一个md文件内的anchor形式的引用需要指出md文件的路径如[name](../ch2/art3.md#anchor1)

使用拖拽

我们可以使用GitBook中将文件(包括图片以及md文件)拖拽到编辑器的功能完成引用的插入。 值得一提的是默认拖拽产生的图片的路径是相对路径,比如path/jjj/in.jpg这一路径就会映射到当前目录的/gitbook/path/jjj/in.jpg 然而我们往往把图片放在一个顶层固定的目录中,所以我们一般要用绝对路径。所以需要在路径上加上一/变成/path/jjj/in.jpg这样就不会加上前缀了。