Github-pages / kramdown не будет правильно отображать мою смешанную уценку / html - PullRequest
Новая
       35

Github-pages / kramdown не будет правильно отображать мою смешанную уценку / html

0 голосов
/ 12 марта 2020

У меня есть смешанная страница HTML / Markdown, которую я считал довольно простой, но Github-страницы дают необъяснимые визуализации.

Он настроен на использование kramdown / GFM.

Это фрагмент кода, который меня достает: 

QuickFIX Settings
-----------------

* [Session](#session)
* [Validation](#validation)
* [Initiator](#initiator)
* [Acceptor](#acceptor)
* [Socket Configuration](#socketConfiguration)
* [Storage](#storage)
* [File Storage](#file)
* [Logging](#logging)
* [SSL](#ssl)
* [Sample Settings File](#sample)

<a name="session"/>

## Session

<table>
  <tr>
    <th>Setting</th>
    <th>Description</th>
    <th>Valid Values</th>
    <th>Default</th>
  </tr>

[more table code follows...]

Когда я предварительно просматриваю код уценки в других анализаторах Markdown (например, анализаторе описания проблем), это нормально. Но когда я отправляю sh в ветку gh-pages, я получаю такой вид мусора:

screenshot of bad github-pages render

Почему эти три-близкие и теги закрытия таблицы есть? (Еще ни одна таблица не была запущена!) И почему эта таблица фактически появляется под заголовком next ?

Ничего в этом не имеет смысла!

Это проект с открытым исходным кодом , так что вы можете увидеть текущий рендер и источник прямо здесь:

1 Ответ

1 голос
/ 12 марта 2020

Причина, по которой ваш стол сломан, заключается в несбалансированном (незамкнутом) td в вашей таблице, фактически нарушающем поток HTML: 

  <tr>
    <td class='setting'>SendRedundantResendRequests</td>
    <td class='description'>
<!-- ^-- this td element is never closed -->
      If set to Y, QuickFIX will send all necessary resend requests, even if they appear redundant.
      Some systems will not certify the engine unless it does this.
      When set to N, QuickFIX will attempt to minimize resend requests.
      This is particularly useful on high volume systems.
    <td class='valid'>
      <div>Y</div>
      <div>N</div>
    </td>
    <td class='default'>N</td>
  </tr>
...