Использование ссылок в GitHub wiki с реструктурированным текстом - PullRequest
Новая
       16

Использование ссылок в GitHub wiki с реструктурированным текстом

3 голосов
/ 12 марта 2012

Я пытаюсь использовать внутренние ссылки, чтобы связать индекс на моей вики-странице с несколькими разделами в документе.Вот пример: 

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


 My index
 --------

 Foreword
 ~~~~~~~~

 Technical details
 ~~~~~~~~~~~~~~~~~

Если я генерирую HTML-страницу с помощью rest2html, я получаю правильный результат.Тем не менее, 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 Ответ

3 голосов
/ 13 марта 2012

Похоже, идентификаторы классов отсутствуют в сгенерированных div. Проверьте источник страницы, чтобы (не) видеть их. Я думаю, вот как это должно выглядеть: 

<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, не Работа. Встроенный целевой текст обернут в, но не получает сделано в любой вид цели ссылки. Должен ли я подать это как отдельный вопрос

...