使用GitHub wiki中具有重构文本的引用



我正试图使用内部引用将wiki页面顶部的索引与文档中的几个部分链接起来。这里有一个例子:

 * `My index`_
    + Foreword_
    + `Technical details`_

 My index
 --------
 Foreword
 ~~~~~~~~
 Technical details
 ~~~~~~~~~~~~~~~~~

如果我通过rest2html生成HTML页面,我会得到正确的结果。然而,GitHub wiki在引用中插入了额外的单词,链接不起作用。例如:

 https://github.com/myaccount/myproject/wiki/Page#wiki-my-index
 https://github.com/myaccount/myproject/wiki/Page#wiki-foreword
 https://github.com/myaccount/myproject/wiki/Page#wiki-technical-details

我在GitHub页面上找不到任何相关的文档,所以我有点迷路了。

生成的div中似乎缺少类id。检查页面源以(不)查看它们。我认为这就是它应该看起来的样子:

<ul>
  <li><dl class="first docutils">
    <dt><a class="reference internal" href="#my-index">My index</a></dt>
  <li><a class="reference internal" href="#foreword">Foreword</a></li>
  <li><a class="reference internal" href="#technical-details">Technical details</a></li>
</ul>
<div class="section" id="my-index">
  <h1>My index</h1>
</div>
<div class="section" id="foreword">
  <h2>Foreword</h2>
</div>
<div class="section" id="technical-details">
  <h2>Technical details</h2>
</div>

编辑:用户凭直觉在GitHub标记问题中提到了同样的问题

我在README.rst文件中也注意到了这个问题。以及标题,.rst文件中的内联目标,例如_ some target,不工作内联目标文本被包装在中,但没有制成任何类型的链接目标。我应该把这个单独归档吗问题

最新更新