使用GitHub wiki中的引用和重构文本

时间:2012-03-12 17:41:38

标签: github wiki restructuredtext

我正在尝试使用内部引用将我的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页面找不到任何相关文档,所以我有点迷失。

1 个答案:

答案 0 :(得分:3)

看起来生成的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>

编辑:用户直觉在a GitHub markup issue

中提及相同的问题
  

我也注意到了README.rst文件的这个问题。以及   标题,.rst文件中的内联目标,例如_ some target,不要   工作。内联目标文本包含在但未获取   制成任何类型的链接目标。我应该单独提交   问题