降价链接到标题

时间:2018-07-07 09:23:02

标签: hyperlink gitlab markdown

我正在使用GitLab编写一个read.me文件。

我试图创建一个到标题的链接。根据Wiki,应该自动创建一个ID:

see here

我使用以下方法创建了标题:

### 1. This is my Header

并尝试创建指向它的链接:

[link](#1--this-is-my-header)

,但是它不起作用。 我究竟做错了什么?

2 个答案:

答案 0 :(得分:2)

在文档中,您链接到我们了解到...

  

ID是根据标头的内容生成的   以下规则:

     
      
  1. 所有文本均转换为小写。
  2.   
  3. 所有非单词文本(例如标点符号,HTML)都将被删除。
  4.   
  5. 所有空格都转换为连字符。
  6.   
  7. 连续的两个或多个连字符转换为一个。
  8.   
  9. 如果已经生成了具有相同ID的标头,则会附加一个唯一的递增编号,从1开始。
  10.   

注意规则4:“ 连续的两个或多个连字符转换为一个。 ”。但是,您尝试的示例连续有两个连字符( 1)。删除其中之一,您应该拥有它。

[link](#1-this-is-my-header)

我有时会遇到一个唯一的标头,它以某种非显而易见的方式转换为ID。确定ID的一种快速方法是使用浏览器的view source和/或inspect工具查看HTML源代码。例如,您可能会在示例中找到以下HTML:

<h3 id="1-this-is-my-header">1. This is my Header</h3>

然后仅使用id属性的内容和哈希值链接到该标头:#1-this-is-my-header

答案 1 :(得分:0)

降价ID是使用我已经能够在Google上搜索的一些规则生成的:(文本转换为小写,删除了非单词标点符号,将空格转换为连字符,将一行中的两个或多个连字符转换为1,命名冲突的编号递增附加,...)

我找到了一种简单的方法来确定锚链接应该是什么。使用浏览器的HTML检查器检查要链接的标题。标头标签的ID应该是您使用的ID。因此,例如,我的标题在HTML检查器中如下所示:

<h2 id="markdown-header-changing-plsql-parameters-and-shared-developers-lifecycle">
  Changing PL/SQL parameters and shared developer's lifecycle
</h2>

我可以像这样在标记中链接到它:

[See instructions below](#markdown-header-changing-plsql-parameters-and-shared-developers-lifecycle)

现在“查看下面的说明”已链接到我的标题锚点。