我正试图使用内部引用将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
,不工作内联目标文本被包装在中,但没有制成任何类型的链接目标。我应该把这个单独归档吗问题